We are temporarily unavailable because of our losses in the massive Black Forest Forest Fire.

Introducing the
µSmartDigi
TM APRS® Digipeater
and
µSmartDigi
TM D-GateTM D-STAR Gateway
A postage-stamp-sized DSP microcontroller imbedded
in the TNC-X eliminates the dedicated laptop or PC.

USmartDigi PCB Photo

µSmartDigi expansion board for the TNC-X
(Actual board size is 1.46 in. x 2.4 in.)

TNC-X Box Photo
Top Front View Installed View
Side View Closeup
Oblique View
Installed Side View

Click HERE for the voltage regulator mounting methods and procedure and HERE for more photos.

What is the µSmartDigi?

The uSmartDigi is a daughter printed circuit board to be used exclusively with the Coastal ChipWorks' TNC-X. The uSmartDigi comes in two versions: APRS Digipeater and D-STAR D-Gate Gateway.

The APRS Digipeater is a very smart digipeater controller eliminating the need for a computer
(PC, laptop, etc.) to operate the TNC-X and providing filtering, editing and other advanced features. No other APRS digipeater TNC has these features!

The D-STAR D-Gate is the same PCB but with very different firmware. This is used to take D-STAR position data from a D-STAR radio's serial data port, convert it to the APRS format and gate it to an analog RF transmitter using the TNC-X to control the radio. This allows APRS local
monitoring users using tools such as UIVIEW to see local D-STAR users in addition to the local APRS users. D-Gate also has advanced features to control filtering and rate limiting of the D-STAR transmissoins.



Note- All USA orders will be shipped US Mail First Class. All international shipments will be by the new US Postal Service International First Class Rate.  If you want some other method, additional charges will apply and you will need to contact me PRIOR to placing your order!


Order µSmartDigi APRS Digipeater or D-Gate NOW!
The µSmartDigi and TNC-X can be ordered by selecting the links below.  These use John Hansen's PayPal Shopping Cart for your convenience.  You can also obtain more information or order the TNC-X directly from tnc-x.com.  John will ship you the TNC-X products and I will ship you the µSmartDigi and integrated TNC-X. Under certain conditions I may ship your µSmartDigi to John for incorporation with his shipment to you.

US$70 µSmartDigi APRS Digipeater (USA Purchases- includes S&H&Insurance)
Note: This requires a TNC-X.
US$78 µSmartDigi APRS Digipeater (Non-USA Purchases- includes S&H&Insurance)
Note: This requires a TNC-X.
US$70 µSmartDigi APRS D-Gate for D-STAR (USA Purchases- includes S&H&Insurance)
Note: This requires a TNC-X.
US$78 µSmartDigi APRS D-Gate for D-STAR (Non-USA Purchases- includes S&H&Insurance)
Note: This requires a TNC-X.
US$80 Painter Engineering TNC-X Kit Assembly, Integration and Testing with µSmartDigi (includes case mounting the 7805 V-regulator)
Note: This requires a µSmartDigi, TNC-X and Enclosure.
US$50
TNC-X rev 2.5 Kit without enclosure or USB - plus S&H)
US$20
USB Option for TNC-X
Note: This comes soldered to 2.5 TNC-X boards and must be ordered at the same time as TNC-X.
US$18
Metal Enclosure- Custom drilled for TNC-X. Has DIN recepticle on rear panel.
Note: This enclosure will only work with revision 2.2 to 2.5 boards.
US$2
DIN plug for constructing a cable to mate with the TNC-X DIN recepticle.


µSmartDigi News and Updates!

30 January 2012 - No Hyperterm in Windows 7! I don't use Windows 7 yet so I was not aware that this was omitted. Throughout my documentation I make references to using Hyperterm terminal emulator to connect to and configure the µSmartDigi. So I turned to my trusty RealTerm and Putty and discovered that neither can do CR to CRLF input mapping, an essential terminal emulator function and needed for this device! So after some searching and testing I have settled on TeraTerm, a free emulator from SourceForge Japan. You can find information here http://logmett.com/index.php?/products/teraterm.html. Thanks to Greg Flanagan for reporting the Windows 7 loss of Hyperterm. Coastal ChipWorks, the source of the TNC-X, has changed the ordering method a bit for the TNC-X. Instead of having two entries, one for USA and one for non-USA, he has made a single entry priced at $50 and will adjust the shipping fee depending on the destination. The order table above now reflects this change. Also note that I have added to the order table the optional 5-pin DIN plug so you can construct cables to mate with the DIN recepticle on the current TNC-X. This is made available from Coastal ChipWorks as a convenience and is not special in any way. You can get these plugs at DigiKey and other electronics distributors.

3 May 2011 - Version 2.83f of the Digi firmware has been posted. This corrects 2 related issues when processing a very large APRS packet. The first was a Microchip IDE option that interferred with the CPU traps preventing it from resetting under buffer overflow conditions. The second was that the processing buffer was not large enough to handle the absolute maximum APRS packet. Thanks to Mauro Olivieri, IW3ROW and Peter Martin, KF4VIZ for discovering this issue!

13 November 2010 - Version 2.3b of the D-Gate firmware has been posted. This corrects the MIC-E beacon Latitude encoding for the southern hemisphere.

6 November 2010 - Version 2.83e of the Digi firmware has been posted. This corrects the MIC-E beacon Latitude encoding for the southern hemisphere. Thanks to Larry  Munns, VK5LY for identifying this bug and testing the changes.

1 December 2009 - Version 2.3a of the D-Gate firmware has been posted. This corrects a rule distance calculation for the GPS-A mode messages.

24 November 2009 - Version 2.83d of the Digi firmware and PC Utility have been posted. This version makes the UITrace mode ON as the default and removes the usage warning.

17 October 2009 - Version 2.3 of the D-STAR D-Gate firmware and PC Utility have been posted. This version has a change required by Pete Loveall for DPRS compatibility and fixes a problem with handling GPS mode messages correctly. A number of optimizations were implemented too. D-Gate now will gateway any combination of GPS and GPS-A mode messages. Thanks to Ken Adkisson, WB4FAY for reporting the problem and providing a LOT of field testing for this new version!

24 September 2009 - Version 2.83c of the Digi firmware has been posted to fix a problem with wild character in DST and SRC rule processing. Thanks to Huseyin Odabap, TA1DF for reporting this problem.

7 September 2009 - Version 2.83b of the Digi and PC Utility have been posted. There was an inconsistancy between the documentation, the PC Utility processing and the Monitor command for the angle specification. All have been changed. Now, you cannot imbed any white space (spaces and tabs) within an angle spec because white space is used as one way to separate command arguments. Thanks to J.B. Davis, N5THS for reporting this problem.

4 August 2009 - A new version of the Digi PC Utility 2.83a has been posted. This makes a change to allow special characters normally considered configuration file comment starters to be used in the bcomment command argument. This implies that this command has no trailing comment field in the configuration file. Thanks to Stephen Genusa, WD5EAE for reporting this problem.

31 July 2009 - I have updated the Assembly and Testing Guide to provide an easy method for measuring and setting the Transmit Delay. Included is a scope trace of a typical measurement.

4 May 2009 - µSmartDigi Digi 2.83 firmware and PC Utility updates are available. This update corrects a typo in the dropmangled command and an issue with a lat-lon for beaconing that was not updated until a reset. It also expands the debugging output from the debug command to show the decoded transmitted packet. Thanks to Randy Allen for finding the dropmangled error and beacon problem!

10 April 2009 - µSmartDigi Digi 2.81 firmware update is available. This update fixes a bug with the Mic-E beacon encoding for longitudes < 10 degrees. Thanks to Helge Abrahamsen  LA3QR and Steinar Lote LA5VX of Norway for identifying this and testing my correction!

18 January 2009 - µSmartDigi Digi 2.8 firmware update is available. This update has been a long time coming and includes a lot of new control and filter features as you can see below.

5 May 2008 - µSmartDigi D-Gate 2.2b firmware update is available. This update fixes a design problem that came about from the change in the GPS-A mode line terminators. The previous terminators were CR LF. GPS-A is just CR. I am also preparing an added feature to help limit the rate at which gated messages reach the APRS RF side. The µSmartDigi Digipeater has had a Packet Rate Limiter since 2.7. I will be porting this same feature to D-Gate soon.

23 March 2008 - I have added an Assembly and Testing Guide to assist those who assemble their own TNC-X. This guide provides procedures to test the TNC-X without the µSmartDigi and then integrated with it.

12 March 2008 - µSmartDigi D-Gate 2.2a replaces 2.2. Some D-Gates' serial port did not respond to a CPU soft reset which prevented the startup flashing process from working without a power reset. The flashing procedure for your pre version 2.2a is:
    1. Configure the D-Gate serial jumpers for flashing.
    2. Run the PC Utility Version 2.1a and select the new 2.2a firmware. It will instruct you to power cycle the D-Gate to start.
    3. For later firmware updates you can use the latest PC Utility and will not have to power cycle the D-Gate.

5 March 2008 -
µSmartDigi D-Gate 2.2 is released! The long-awaited updates are done! I have taken a number of the enhancements that are in the Digi and put them in the D-Gate. Now you do not have to cycle the power to perform firmware flashing and config and rule downloading. It also supports the new GPS-A Mode. Other features such as fully configurable beacon, rate limiting all packets and the serialtest have been added too.

2 March 2008 - µSmartDigi 2.7 is released! Use PC Utility 2.62 or earlier to install this upgrade! After installing this upgrade you do not have to cycle the power to perform firmware flashing and config and rule downloading.It also has a new feature for rate limiting all packets. To aid users in testing their serial ports used with µSmartDigi a new command serialtest has been added to the PC Host Utility. The new rule features are being worked on and will be released in version 2.8 as soon as possible. Thanks go to Peter Martin for all his help in testing 2.7!

6 December 2007- Due out shortly is Digi version 2.7. This is being beta tested now and has eliminated the requirement for the power cycling to perform the firmware flashing and config and rule downloading. It also has a new feature for rate limiting all packets. This release may also have a new drop rule heuristic. This rule will recognize packets with lat-lon that are to be dropped from the normal geo rules and then later drop packets from the same source call which don't have the lat-lon.

5 November 2007- Digi version 2.61 and 2.62a were made to provide a more flexible download configuration in that you now don't need to first set the Call Sign in order to download configurations. Several printf() problems affecting the displaying of the configuration and rules were also fixed. Version 2.62 was made to set the DEFAULT host serial port speed to 19,200 baud. Some users were having problems with the initial setting of 57 kbaud. You may experiment and set the baud to whatever seems to work for downloading configs and rules, which is the most taxing on the PC host.

26 August 2007- Digipeater update 2.6 is ready! This has a number of enhancements. A new command uitrace has been added to enable and disable the UITrace feature for digipath debugging. It can be downloaded with other config commands or entered directly to the console monitor. A monitor-only command debug has been added. It is volatile since it is not saved in EEPROM. Debug enables a detailed decoding of the incoming packet and is displayed on the console monitor. This will assit you in reporting any problems. An altitude command has been added in preparation for the change to the Beacon format. Four other changes were made: 1) don't repeat your own beacon, 2) back-space key deletes previous character entry for the console monitor (cursor is moved but the display is NOT updated), 3) all of the path elements are now counted for comparison with the WIDEMAX and WIDETOTAL config parameters, and 4) a "path correction" has been implemented.

Some APRS sources produce bad path elements that violate the APRS spec. The "path correction" was implemented where it could be determined that a digipath element with say WIDE2-0 had an H=0 bit (in the AX.25 HDLC structure). If this path element was preceded by an unambiguous, unexhausted path element then the current hop count would be "corrected" to WIDE2-2, for example. Without this, it MUST NOT be repeated with the current hop count being zero (-0) even though H=0. Prior to this 2.6 release if an element had a -0 and H=0 it was summarily dropped.

I'm considering changing the names of WIDEMAX and WIDETOTAL, maybe PATHMAX and PATHTOTAL or HOPMAX and HOPTOTAL, since this is more descriptive. Let me know if you DON'T want this changed for some reason or would like some other names.

5 August 2007- I have discovered a Main serial port flashing problem on recent TNC-X containing the USB option module. This is not an issue during normal operation nor with the Aux serial port.  The problem happens when the USB is not connected to a host computer (ie. the module is not powered) and you are attempting to flash firmware using the Main Serial port.  The flash may fail at the start.

I have created an updated for the Digi PC Utility
2.52 to help identify this condition. If you have the USB option and you want to use the Main serial port for flashing then the workaround is to do one of the following: connect the USB cable to a host OR remove the USB chip in the TNC-X. If you have the USB you are likely to use it to do the flashing. In this case there is no problem. Please report any problems like this and your results with this workaround.

24 July 2007- The 2.52a update uses the "#" Primary Digi symbol for the Beacon by default.

19 July 2007- The 2.52 update uses the "In Service" MIC-E message format for the Beacon. Also, the USB drivers have been updated on the Linx site. See the USB Driver section below.

11 July 2007- The 2.51 update uses the MIC-E message format for the Beacon.

1 July 2007- The 2.5 update contains the Beacon Icon command and Configuration Parameter. See the descriptions below.

A rare problem has been discovered with some TNC-X RS232 chips from ST Microelectronics. Only a few of the chips in the field appear to have this problem. The problem only impacts using the serial port (not the USB port) when flashing the µSmartDigi firmware. This flashing is done immediately after doing a power reset. If you use USB as most people do then you won't be affected. If you use the serial port and have problems flashing new firmware then contact me so I can assist you in diagnosing the problem. If it is confirmed this is the cause, a new RS232 chip will be sent to you. Alternatively, you can send me the entire µSmartDigi+TNC-X and I will diagnose and fix it.

17 March 2007- The Digipeater has been updated with a number of features that have been planned and some that were requested by users. Version 2.4 has added Beaconing and support for digi path name styles such as SSn-n. A digipath command has been added to the Monitor to allow changes to the Digi Path without the PC Utility.  Likewise beacon and bcomment commands have been added to the Monitor and Configuration file for Beaconing.

Another change that will affect you is the relay command. It has been changed to relaydrop to improve clarity in both the
Monitor and Configuration file. The significance here is that the drop-pass notion has reversed its logic.  Setting relaydrop y (enabling) will cause packets to be dropped if they contain RELAY in Digi1.  The abbreviated command relay still works but acts as relaydrop now so you will have to edit your Configuration files to reverse the logic from previous versions.

Setting beacon 0 disables Beaconing.  Beaconing can be set for 10 to 65,535 seconds. Now you will be required to enter a Call Sign.  If you do not do this with the PC Utility you must do it with the Monitor before it will operate.  Likewise, you will be required to enter a Digi Path if you enable Beaconing.

Another new feature is the addition of APRS Software Version TOCALLs specific to µSmartDigis. Our version identifiers are of the form APnnnU.  See APRS Software Versions for specifics.

A side effect of these additions was the need to reduce the maximum number of Rules that can be configured to 50 from 100 due to on-chip memory limitations.  This should not affect anyone since the 100 limit was likely excessive anyway.

Previews of Upcoming Changes

Here is a list of changes I'm working on. Please send me your suggestions and ideas. Be as specific and detailed as possible so I can spec out the implementation.

TNC-X Update!

John has recently changed the PCB for the TNC-X.  Uints shipping now contain this revised PCB.  The revision changes TNC-X jumper JP3.

Pre December 2006 Rev 2.4 Revisions

Prior to this revision JP3 was a 2-pin jumper that enabled (jumper IN) the RS232 input and disabled it (jumper OUT).  In these older PCB the USB serial input to the TNC was hardwired.  So if you don't have the USB you simply install the JP3 jumper.  However, if you installed the USB it had to be the serial input since it was hardwired and you had to remove the JP3 jumper.  If you wanted to use the RS232 for input you had to remove the USB cable or the USB module itself.

December 2006 Revision 2.4

The latest PCB revision changes the JP3 to a 3-pin jumper.  This allows you to have the USB module installed and USB cable active while still using the RS232 for input.  It also provides output to both ports simultaneously.  The input is controlled by JP3.  Install the jumper on the 2 pins closest to the USB and the USB is used for input.  Alternatively, install the jumper on the 2 pins closest to the MAX RS232 chip and the RS232 is used for input.

µSmartDigi APRS Digipeater Technical Stuff

Special Note for both Digi and D-Gate

When powering the
µSmartDigi-TNC-X with input voltages above 9 volts DC you will need to either add a heat sink to the 7805 voltage regulator or relocate the regulator to use the TNC-X metal enclosure as a heat sink.  You may use the PCB-mounted 7805 without a heat sink if you are using an input from 7.5v to 9v DC. This is the preferred method since the TNC-X PCB can be serviced without removing or unbolting the regulator. The PCB hold-down screws and DB9 screws can be removed and the PCB can be rotated upward. Here are the instructions for mounting the 7805 to the metal enclosure.
  1. Remove the 7805 from the PCB.  If you find it too difficult to unsolder it just cut the 2 inboard legs and desolder the remaining leg.  Then clean the first 2 holes.  There is plenty of leg left to solder wires to in Step 4.
  2. Drill a 9/64-inch hole in the enclosure base, 1.25 inch from the front and 9/16 inch from the left side (looking from the front). Debur the hole on both sides.  This hole is located such that the PCB will not cover it making it easy to install the regulator.
  3. Cut 3 wires about 3 inches long, remove the insulation from the ends and tin them.
  4. Cut 3 short pieces of heat-shrink tubing (or use electrical tape) and place over the wires.  Solder the 3 wires to the 7805 and secure the heat shrink over the soldered legs or tape them.
  5. Observing the 3 terminal assignments, solder the other wire ends to the 3 holes in the PCB.
  6. Apply some silicone heat sink grease to the 7805 and secure it to the TNC-X base with a screw, lock washer and nut.
An alternate method is to mount the regulator on the PCB in the normal location and construct a right-angle bracket of aluminum where it is then bolted to the case. This method is not convienent for servicing the TNC-X since it must be removed from both the case and regulator.

Photos for the mounting of the regulator are HERE.


The µSmartDigi, an expansion board to embed in Coastal ChipWorks’ TNC-X produced by John Hansen, eliminates the host computer (PC, laptop, etc.), eliminates duplicate packets and filters any packet with advanced rule-based controls.  These features offer unprecedented control, flexibility, portability and low-power use at a low cost in a tiny package. This will especially benefit amateurs to quickly and easily deploy a custom configured APRS repeater for emergency service.  Different functional products are based upon this foundation platform.

The first products are the µSmartDigi APRS Digipeater and the µSmartDigi D-Gate Icom® D-STAR Gateway.

Assembly and Testing Guide

An Assembly and Testing Guide to assist those who assemble their own TNC-X provides procedures to test the TNC-X without the µSmartDigi and then integrated with it.

Features
Features
Benefits
Tiny Size- It plugs into the TNC-X and fits within its case.
Self contained in TNC-X.  Very Portable.  Easily fits in a vehicle.
Low Power Consumption (typical 130 mA, maximum 220mA)
Battery Operation.
Performs Duplicate Packet checking based on the Source, Source SSID, Destination and Info Fields Only!
Correctly eliminates repeating of Duplicate Packets after filtering.
User Configurable Rules for Packet Filtering with a rich set of parameters.
Precisely control Repeater Traffic, especially for emergency service operation.
User-Configurable settings for limiting the WIDE and WIDEn counts in the VIA Path. Provides Repeater Operators better control over malformed paths.
GPS RS-232 Serial Interface for connecting a GPS unit.
Provides automatic location or supports mobile operation.
Configure Configuration and Rules once with a PC or Laptop.  Saved in EEPROM.
Completely computer- and hands-free operation after configuring.
Configuration Parameters can be changed using Hyperterminal (or similar) directly connected to the µSmartDigi Fast changes and no need for the µSmartDigi PC Configuration Program.
Flash Program Updates using a PC or Laptop computer.
Easy to update firmware without requiring a programmer.
Support planned for No Source Routing (NSR) [not fully implemented in Version 2]
You can use conventional routing or NSR.
Windows 32-bit Console program is used to download the Configuration Parameters, Rules and Firmware updates.
Common platform.

Technical Specifications [under construction]
The µSmartDigi is based upon Microchip's dsPIC30F6012 Digital Signal Processing (DSP) microcontroller. It is planned that the production boards will use either the dsPIC30F6012A or the newer 33FJ series.  This will depend on the Microchip production schedule and quality for the new chip.
The software, written in Microchip's C30 C compiler, is completely native to the microcontroller.  The is no additional operating system.  The dsPIC30F6012 features 144Kbytes of program flash memory, 8Kbytes of RAM and 4Kbytes of EEPROM.  It is clocked to run at 30 MHz. This chip sports two serial interfaces that are used to interface with the TNC-X and optional GPS unit.
The GPS and Monitor Port are shared on a single TNC-X serial port.  The µSmartDigi can be configured without a GPS.  If one is configured, the µSmartDigi detects this on startup.  The Monitor Port is detected when no GPS NMEA messages are received or no GPS is configured.
The Configuration Parameters have defaults with only the Call Sign being required to set.  All parameters are contained in an ASCII file and read in and processed by the µSmartDigi PC Configuration Program.  These parameters can also be changed by connecting a serial terminal or terminal emulator, like Hyperterminal on a PC or laptop, without the need for the µSmartDigi PC Configuration Program.
The device supports flash programming over the serial line from the µSmartDigi PC Configuration Program from a firmware hex file.  Firmware may be updated from time to time and will be available on this web site.  You will download this firmware hex file and use the µSmartDigi PC Configuration Program to flash the new firmware into the device.  You can also use the Microchip ICD2 programmer. A 5-pin header is provided to interface with the ICD2.
Configuration Parameters are specified with optional leading white space and arguments are separated by white space or commas.  White space is one or more spaces and tabs in any combination. Abbreviating commands is allowed to the extent that the result is not ambiguous.

The Configuration Parameters are summarized below:

Parameter
Arguments
Description
Ver
call
CALL
Sets the Call Sign
ssid SSID Sets the SSID with Decimal, Octal or Hex number
position Lat Lon Sets the Base Latitude and Longitude (alias base)
base
Lat Lon same as position

lat
Lat
Sets the Base Latitude
lon
Lon
Sets the Base Longitude
altitude
nF | nM
Specify station's altitude in feet (F) or meters (M) [Use NO decimal points!]
digipath string Comma or space separated (no tab) Digi Path
uitrace1

Toggles ON and OFF UITrace digipath debugging mode. Default is ON.

beacon seconds
Sets the beacon period in seconds, 0 for OFF, range [10..65535]

icon xx
2 characters representing the Symbol Table ID or Overlay and Symbol Code

bcomment string
Sets the beacon comment string4
2.83a
havegps1
y | n
Sets existence of a GPS

log
y | n
Enables | Disables Logging to the Monitor/GPS Port

nonaprs1 y | n
Enables | Disables repeating of packets without valid position info

dropmangled y | n Enables | Disables dropping mangled packets
haltonerr y | n Enables | Disables halting on error [for testing only]

host [baud] Sets optional Host baud
tnc
[baud]
Sets optional TNC baud

gps1 [baud] Sets optional GPS baud

dstar2 [baud] Sets optional D-STAR baud
nsr3 y | n Enables | Disables No Source Routing
relaydrop1 y | n Enables | Disables dropping anything with RELAY in Digi1 path
widemax1
N
Sets the maximum wideN in the remaining path

widetotal1
N
Sets the maximum total wide for the remaining path

ratelimcall seconds
Sets the Rate Limit Window in seconds for all Call Signs. 0 disables feature.
2.7
dupewin
seconds
Sets the Duplicate Check Window Time in seconds

deletepath1 MI MS DI Deletes digipath component matching the arguments. MI is the Match Index (0, *, 1-8). MS is the Match String (*, xxx*, xxx-SSID). DI is the Delete Index (0, *, 1-8). 2.8
substitutepath1 MI MS SI DL1,DL2... Substitutes the DL Digi List matching the arguments. MI is the Match Index (0, *, 1-8). MS is the Match String (*, xxx*, xxx-SSID). SI is the Substitution Index (0, *, 1-8) where the substitution takes place. DL is a comma separated list of digis with optional * 2.8
controlcall1 CALL-SSID Source call allowed to perform the OTA run control 2.8
fixvalid2 y | n
Enables | Disables requiring the GPS fix to be valid

deditpath

Displays the Substitution
2.8

Notes:
1. Digipeater parameter only.
2. D-Gate parameter only.
3. Not fully implemented in Digipeater Version 2.
4. The bcomment command within the configuration file cannot have a trailing comment since it cannot be distinguished.

µSmartDigi Digi Packet Processing Order

All packets are processed in a certain order with respect to Control, DigiPath Editing, Rules, etc. as follows:
  1. Check for Run Control
  2. Check for my own Beacon (don't ever repeat my own Beacon)
  3. Perform any Digipath Edits
  4. Perform Call Rate Limiting
  5. Check for duplicate
  6. Perform Rule Checks

µSmartDigi Rules

The latest Rules are described HERE.  The rules for versions 2.7 and older are HERE. The Rules are also contained in an ASCII file and read in and processed by the µSmartDigi PC Configuration Program. Extensive error and format checking and reporting are performed for the Configuration Parameters and Rules by the Configuration Program.

µSmartDigi Digi Run Control

Version 2.8 and later feature OTA and Monotor Command Run Control. At the Monitor type "run" to toggle the run mode to ON or OFF. Using the Configuration Parameter "controllcall" you set the CALL-SSID of the source that is allowed to send the OTA commands. Using your radio, such as a D700, to send a "stop" command that changes the run mode to OFF you would set the MSG to "?a62374". To send a "start" command that changes the run mode to ON set the MSG to "?j77923". The µSmartDigi remembers the run mode through resets and power cycles.

µSmartDigi Digi Digipath Editing

Version 2.8 and later features a powerful digipath editing mechanism. Each incoming packet is examined for a match to a digipath component to determine if something in the digipath is to be deleted or substituted. ALL editing commands are applied against a packet. This means an earlier modification could be re-edited with a later entry. Individual editing entries are NOT recursive (maybe in the future). That is, if one had a path of "WIDE1-1,WIDE1-1" and used a command "sub 1 wide1-1 1 wide2-2" it would only substitute the FIRST WIDE1-1. If you wanted to catch the second one you could
add a second "sub" command. Alternatively you could get both by doing this "sub * wide1-1 * wide2-2" since this type of substitution replaces the entire path.

The formats for the substitute and delete commands are:

    substitutepath Match_Index Match_String Sub_Index Digi_List

    deletepath Match_Index Match_String Del_Index

Where
    Match_Index is
        0 or *    to match any of the digis
        1 to 8    to match a specific digi

    Match_String is
        *    to match any digi
        xxx*    wild char match xxx anything
        xxx-n    to match the digi xxx AND ssid n

    Sub_Index
        0 or *    to substitute ALL the entries
        1 to 8    to substitute this digi and insert

    Digi_List
Comma separated list of digis with optional ssid and optional trailing *. If just 1 digi is specified then it simply performs a 1-to-1 substitution. If more than 1 digi is specified then the matched entry is replaced with the first digi from this list and the rest are inserted. The remaining digis are shifted out and possibly lost if they exceed the max of 8 entries. Appending an * (splatting) to a digi with or without an ssid causes it to be splatted (indicates it has been exhausted for repeating). Using WIDE is a special case. if the ssid with any WIDE in this list is 0 then it splats this entry. If you splat a WIDE that has a non-zero ssid it will make that ssid 0.

    Del_Index is
        0 or *    to delete the entry that matched
        1 to 8    to match a specific digi

    Examples
del * ab0vo-11 *    # remove this UITrace call to make the path shorter
sub * WIDE1-1 * WIDE2-2    # replace entire path with WIDE2-2 if there was a WIDE1-1 anywhere in the path
sub 2 WIDE4-4 2 WIDE1-1    # change a WIDE4-4 to WIDE2-2 in position 2
del * RELAY *    # remove RELAY from the path
sub * wide * wide1-1,wide2-2    # replace entire path if it has a wide anywhere

µSmartDigi PC Configuration Program Commands

Commands are specified with optional leading white space and arguments are separated by white space or commas.  White space is one or more spaces and tabs in any combination.  Abbreviating commands is allowed to the extent that the result is not ambiguous. The following table summarizes the PC Configuration Program Commands:

Command
Arguments
Description
Ver
help

Displays the Commands (alias ?)

?

same as help

angles

Displays the Angles format used for Lat, Lon and Rules

baud
baud
Changes the baud rates on host and µSmartDigi once connected
configure
file_name
Reads a Configuration File named file_name

rules
file_name
Reads a Rule File named file_name
dconfigure

Displays the current Configuration

drules

Displays the current Rules
connect
com_port [baud]
Connects to the µSmartDigi on com_port at optional baud to enable a download

disconnect

Disconnects from the µSmartDigi
download

Downloads the Configuration and Rules to the µSmartDigi (requires connection)

firmware
com_port file_name
Updates µSmartDigi firmware on com_port from HEX file file_name

serialtest
iterations
Performs a write and read loop test between the serial port and µSmartDigi 2.7
.

[Period] Repeat the last command. Normal DOS/WIN edit commands apply.

exit

Exits the program

quit

same as exit

x

same as exit


µSmartDigi Monitor Commands

These commands are almost identical to those used within the configuration file and processed by the PC Utility. Once major difference is that Monitor commands cannot have trailing comments.

Commands are specified with optional leading white space and arguments are separated by white space or commas.  White space is one or more spaces and tabs in any combination. 
Abbreviating commands is allowed to the extent that the result is not ambiguous. When entering commands the back-space key will delete the previous character. The cursor will move left but the display will not be updated (you will still see the previous character until you type a new one). When in normal operating mode commands will be ignored. To return to the command prompt enter a control-c (hold the control key and hit the c key). To return to normal operating mode enter the TNC or RESET command or power cycle the TNC-X.

The following table summarizes the commands supported using a serial terminal or terminal emulator connected to the Monitor Port:

Command
Arguments
Description
Ver
version

Displays the firmware version
2.7
help

Displays the Commands (alias ?)

?

same as help

monitor

Enables TNC and enters Monitor mode

debug

Toggles ON and OFF decoded display of incoming packet (VOLATILE)

log
y | n
Enables | Disables Logging to the Monitor/GPS Port
havegps1
y | n
Sets existence of a GPS. Monitor/GPS Port switches to baud set by command gps
tnc
[baud]
Sets optional baud, enables TNC and enters Monitor mode

control-c

Breaks out of Monitor mode and returns to the command prompt

gps1
[baud] Sets optional baud and enters GPS mode

dstar2 [baud]
Sets optional baud and enters D-STAR mode
host
[baud]
Sets optional Host baud

call
CALL
Sets the Call Sign

ssid
SSID
Sets the SSID with Decimal, Octal or Hex number

digipath string Comma or space separated (no tab) Digi Path
uitrace1

Toggles ON and OFF UITrace digipath debugging mode. Default is ON.
beacon seconds Sets the beacon period in seconds, 0 for OFF, range [10..65535]
icon
xx
2 characters representing the Symbol Table ID or Overlay and Symbol Code
bcomment string
Sets the beacon comment string
implicit
drop | pass
Sets the Implicit Rule Action (drop or pass)

widemax1
N
Sets the maximum for any element of the digipath

widetotal1
N
Sets the maximum total of all elements for the digipath

ratelimcall
seconds
Sets the Rate Limit Window in seconds for all Call Signs. 0 disables feature 2.7
dupewin
seconds
Sets the Duplicate Check Window Time in seconds
deletepath1 MI MS DI
Deletes digipath component matching the arguments. MI is the Match Index (0, *, 1-8). MS is the Match String (*, xxx*, xxx-SSID). DI is the Delete Index (0, *, 1-8). 2.8
substitutepath1 MI MS SI DL1,DL2...
Substitutes the DL Digi List matching the arguments. MI is the Match Index (0, *, 1-8). MS is the Match String (*, xxx*, xxx-SSID). SI is the Substitution Index (0, *, 1-8) where the substitution takes place. DL is a comma separated list of digis with optional *
2.8
deditpath1
Displays the Substitution and Delete digipath entries
2.8
rmeditpath1 N
Removes a Substitution or Delete digipath entry in position N
2.8
run1
Toggles the run mode On and Off
2.8
controlcall1 CALL-SSID
Source call allowed to perform the OTA run control
2.8
nsr3
y | n
Enables | Disables No Source Routing

relaydrop1
y | n Enables | Disables dropping anything with RELAY in Digi1 path
nonaprs1
y | n
Enables | Disables repeating of packets without valid position info

dropmangled
y | n
Enables | Disables dropping mangled packets

haltonerr
y | n
Enables | Disables halting on error [for testing only]
fixvalid
y | n
Enables | Disables requiring GPS fix to be valid

position
Lat Lon
Sets the Base Latitude and Longitude (alias base)

base
Lat Lon same as position
lat
Lat
Sets the Base Latitude

lon
Lon
Sets the Base Longitude

altitude
nF | nM
Specify station's altitude in feet (F) or meters (M) [Use NO decimal points!]

dconfigure

Displays the Configuration

drules

Displays all the Rules

clearrules

Temporarily clears the Rules.  EEPROM Rules are not affected.  Restored by RESET

angles

Displays the Angles format used for Lat and Lon and Rules

boot

Reboots the system (aliases reboot, reset)

reboot

same as boot

reset

same as boot


Notes:
1. Digipeater parameter only.
2. D-Gate parameter only.
3. Not fully implemented in Digipeater Version 2.

µSmartDigi Angles and Lat-Lon Specification
The µSmartDigi uses a very flexible format to specify angles such as Latitude, Longitude and actual angles found in the Rules file.  This allows users to enter these angles in a format that is easy and familiar while not being restrictive.  Here are some examples: -38:33:29.222, 38.33.379, 42d23.7m33.9c, W104D40.6m
A complete description for the the Angles Specification is found in the latter part of the Rules description found  HERE and can also be displayed from the µSmartDigi Monitor mode using the angles command.

Getting Started

µSmartDigi comes with a 2-page Getting Started Guide.  See the Versions tables below for the latest edition.

µSmartDigi Digi and D-Gate D-STAR Gateway Technical Stuff

[Under Construction]

Here are some presentations on topics related to APRS...

Title
Date
Event
Presentation µSmartDigi™ Jun 2006 Texas Ham-Com
Paper µSmartDigi™: an APRS® Digipeater and D-Gate™ D-STAR Gateway v5
Sep 2006
ARRL-TAPR Digital Communications Conference
Presentation µSmartDigi™ Sep 2006 ARRL-TAPR Digital Communications Conference
Presentation µSmartDigi™ Alabama D-STAR Project Oct 2006
Huntsville D-STAR Training Conference
Presentation µSmartDigi™ Use and Configuration Jun 2007
Texas Ham-Com
Presentation µSmartDigi™ New Features
Jun 2008
Texas Ham-Com
Presentation Intro to APRS® May 2009
Colorado HamCon
Presentation APRS®, KISS & AX.25 Protocols May 2009 Colorado HamCon


Cables
Instructions for making serial cables for the µSmartDigi can be found HERE. Cabling for the TNC-X to the Radio can be found in the TNC-X manual included with your TNC-X and also at Coastal ChipWorks http://www.tnc-x.com/documentation.htm. A TNC-X Radio wiring diagram for the older stereo connector model is http://www.tnc-x.com/hookup.gif and for the new DIN connector model is http://www.tnc-x.com/hookup2.gif. But in either case use the µSmartDigi serial cabling instructions instead of the serial wiring in these images.

Software and Documentation Downloads
µSmartDigi PC Configuration software and Firmware can be downloaded by selecting the appropriate link from the table below.  Make certain you have selected the correct PCB and Chip Versions!  Due to the small size of the PC Utility it is the actual executable program file. A general rule is to use the latest versions for each of the Firmware, PC Utility and Instructions.

µSmartDigi APRS Digipeater Versions
Firmware
Firmware Version PCB Version
Chip
Comments
2.1  Released 20 Jun 2006 1.0
dsPIC30F6012A Initial Release; Requires PC Utility 2.1 and higher
2.2  Updated 17 Aug 2006 1.0 dsPIC30F6012A Added commands nonaprs and clearrules; Requires PC Utility 2.2 and higher
2.3  Updated 10 Nov 2006 1.0
dsPIC30F6012A Sync rev to PC Utility; Requires PC Utility 2.3 and higher
2.3a  Updated 30 Nov 2006 1.0
dsPIC30F6012A Added Monitor Mode serial interrupt crtl-c; Requires PC Utility 2.3 and higher
2.3b  Updated 2 Jan 2007 1.0
dsPIC30F6012A Expand dupe time window; Requires PC Utility 2.3 and higher
2.4  Updated 18 Mar 2007 1.0
dsPIC30F6012A Add APnnnU, Beaconing, Monitor commands, add SSn-n, change relaydrop; Requires PC Utility 2.4 and higher
2.5  Updated 1 Jul 2007
1.0, 2.0
dsPIC30F6012A Add Beacon Icon; Requires PC Utility 2.5 and higher
2.52a  Updated 24 Jul 2007 1.0, 2.0 dsPIC30F6012A Beacon uses MIC-E message format. Symbol # for Digi; Requires PC Utility 2.5 and higher
2.6  Updated 26 Aug 2007 1.0, 2.0 dsPIC30F6012A uitrace, altitude, debug commands; don't repeat beacon; back space; digi counts; Requires PC Utility 2.6 and higher
2.61  Updated 2 Nov 2007 1.0, 2.0 dsPIC30F6012A fix config & rule display, fix download; Requires PC Utility 2.61 and higher
2.62a  Updated 5 Nov 2007 1.0, 2.0 dsPIC30F6012A change default host serial speed to 19200 baud; Requires PC Utility 2.62 and higher
2.7  Updated 2 Mar 2008 1.0, 2.0 dsPIC30F6012A add version, ratelimcall commands; add serialtest; eliminate power cycle; Requires PC Utility 2.7 and higher. Use PCU 2.62 to upgrade.
2.8  Updated 18 Jan 2009
1.0, 2.0
dsPIC30F6012A Add run control, path editing and digipath rule; Requires PC Utility 2.8 and higher.
2.81  Updated 10 Apr 2009 1.0, 2.0
dsPIC30F6012A Fix Mic-E beacon encoding for lon < 10deg; Requires PC Utility 2.8 and higher.
2.83  Updated 4 May 2009 1.0, 2.0 dsPIC30F6012A Fix dropmangled spelling, beacon lat-lon not updated after download w/o rest, expand debug output; Requires PC Utility 2.8 and higher.
2.83b  Updated 7 Sep 2009 1.0, 2.0 dsPIC30F6012A Fix angle spec; Requires PC Utility 2.83b and higher.
2.83c  Updated 24 Sep 2009 1.0, 2.0 dsPIC30F6012A Fix DST, SRC * rule; Requires PC Utility 2.83b and higher.
2.83d  Updated 24 Nov 2009 1.0, 2.0
dsPIC30F6012A Make UITrace ON by default; Requires PC Utility 2.83d and higher.
2.83e  Updated 6 Nov 2010 1.0, 2.0
dsPIC30F6012A Fixes MIC-E beacon Latitude for southern hemisphere; Requires PC Utility 2.83d and higher.
2.83f  Updated 4 May 2011 1.0, 2.0 dsPIC30F6012A Increase output buffer size and fix cpu trap for reset; Requires PC Utility 2.83d and higher.

PC Utility
PC Utility Version PCB Version
Chip
Comments
2.1  Released 20 Jun 2006 1.0
dsPIC30F6012A Initial Release; Requires Firmware Version 2.1 and higher
2.2  Updated July 2006 1.0 dsPIC30F6012A Added commands nonaprs and clearrules; Requires Firmware Version 2.2 and higher
2.2b  Updated 17Aug 2006 1.0 dsPIC30F6012A Requires Firmware Version 2.2 and higher
2.2b-1  Updated 11 Oct 2006 1.0 dsPIC30F6012A Allow imbedded spaces in file names; Requires Firmware Version 2.2 and higher
2.3  Updated 10 Nov 2006 1.0
dsPIC30F6012A Comm ports >9; Requires Firmware Version 2.3 and higher
2.3b  Updated 2 Jan 2007
1.0
dsPIC30F6012A Requires Firmware Version 2.3 and higher
2.4  Updated 18 Mar 2007 1.0
dsPIC30F6012A Add Beaconing, change relaydrop; Requires Firmware Version 2.4 and higher
2.4a  Updated 17 Jun 2007 1.0, 2.0
dsPIC30F6012A Allow additional initial NULLS in sync from current lot of dsPIC; Requires Firmware Version 2.4 and higher
2.5  Updated 1 Jul 2007 1.0, 2.0
dsPIC30F6012A Add Beaconing Icon; Requires Firmware Version 2.5 and higher
2.52  Updated 6 Aug 2007 1.0, 2.0
dsPIC30F6012A More diagnostics during flashing; Requires Firmware Version 2.5 and higher
2.6  Updated 26 Aug 2007 1.0, 2.0
dsPIC30F6012A Added uitrace and altitude commands; Requires Firmware Version 2.5 and higher
2.61 Updated 2 Nov 2007 1.0, 2.0 dsPIC30F6012A Fix config & rule display; Requires Firmware Version 2.61 and higher
2.62 Updated 2 Nov 2007 1.0, 2.0 dsPIC30F6012A Change default host serial speed to 19200 baud; Requires Firmware Version 2.62 and higher
2.7 Updated 2 Mar 2008 1.0, 2.0 dsPIC30F6012A Add version, ratelimcall commands; add serialtest; eliminate power cycle; Requires Firmware Version 2.7 and higher
2.8 Updated 18 Jan 2009
1.0, 2.0
dsPIC30F6012A Add run control, path editing and digipath rule; Requires Firmware Version 2.8 and higher
2.83 Updated 4 May 2009 1.0, 2.0 dsPIC30F6012A Fixed duplicate rule false notice; Requires Firmware Version 2.8 and higher
2.83a Updated 4 Aug 2009 1.0, 2.0 dsPIC30F6012A Fixed bcomment command processing to allow special characters; Requires Firmware Version 2.83 and higher
2.83b Updated 7 Sep 2009 1.0, 2.0 dsPIC30F6012A Fix angle spec; Requires Firmware Version 2.83b and higher
2.83d Updated 24 Nov 2009 1.0, 2.0 dsPIC30F6012A Make UITrace ON by default; Requires Firmware Version 2.83d and higher.

Getting Started Instructions
Getting Started Instructions PCB Version
Chip
Comments
2.1b  Released 21 Jun 2006 1.0
dsPIC30F6012A Initial Release; For Firmware Version 2.0 and higher
2.2a  Updated 17 Aug 2006 1.0 dsPIC30F6012A Added commands nonaprs and clearrules; Requires Firmware Version 2.2 and higher
2.3  Updated 4 Nov 2006 1.0
dsPIC30F6012A Added 7805 heat sinking instructions; Requires Firmware Version 2.2 and higher
2.3a  Updated 17 Dec 2006 1.0
dsPIC30F6012A Minor edits; Requires Firmware Version 2.2 and higher
2.3b  Updated 2 Jan 2007
1.0
dsPIC30F6012A Requires Firmware Version 2.3 and higher
2.4  Updated 18 Mar 2007 1.0
dsPIC30F6012A Requires Firmware Version 2.4 and higher
2.4a  Updated 9 May 2007 1.0
dsPIC30F6012A Requires Firmware Version 2.4 and higher
2.4b  Updated 30 May 2007 1.0
dsPIC30F6012A Requires Firmware Version 2.4 and higher
2.5  Updated 11 Jul 2007 1.0, 2.0
dsPIC30F6012A Requires Firmware Version 2.5 and higher
2.52  Updated 24 Jul 2007 1.0, 2.0 dsPIC30F6012A Requires Firmware Version 2.5 and higher
2.6  Updated 3 Oct 2007 1.0, 2.0 dsPIC30F6012A Requires Firmware Version 2.6 and higher
2.62 Updated 16 Nov 2007
1.0,2.0
dsPIC30F6012A Requires Firmware Version 2.62 and higher
2.62a Updated 16 Dec 2007 1.0,2.0
dsPIC30F6012A Requires Firmware Version 2.62 and higher
2.7 Updated 2 Mar 2008
1.0,2.0 dsPIC30F6012A Requires Firmware Version 2.7 and higher
2.7a Updated 23 Mar 2008 1.0,2.0 dsPIC30F6012A Requires Firmware Version 2.7 and higher
2.7b Updated 27 July 2011
1.0,2.0 dsPIC30F6012A Requires Firmware Version 2.7 and higher


µSmartDigi D-Gate Versions Firmware
Firmware Version PCB Version
Chip
Comments
2.0  Released 17 Aug 2006 1.0
dsPIC30F6012A Initial Release, uses 3rd-party APRS packet; Requires PC Utility 2.0 and higher
2.1  Updated 26 Oct 2006 1.0 dsPIC30F6012A Sync rev to PC Utility; Requires PC Utility 2.1 and higher
2.1a  Updated 2 Jan 2007
1.0
dsPIC30F6012A Expand dupe time window; Requires PC Utility 2.1 and higher
2.2a Updated 12 Mar 2008
1.0, 2.0
dsPIC30F6012A Add GPS-A D-STAR Mode; eliminate power cycle; add rate limiting & serialtest; Requires PC Utility 2.2a and higher
2.2b Updated 5 May 2008 1.0, 2.0 dsPIC30F6012A Fix GPS-A mode line terminator; Requires PC Utility 2.2a and higher
2.3 Updated 17 October 2009 1.0, 2.0 dsPIC30F6012A Fix GPS mode, change for DPRS; Requires PC Utility 2.2a and higher
2.3a Updated 1 December 2009 1.0, 2.0 dsPIC30F6012A Fix GPS-A mode msg range calculation; Requires PC Utility 2.2a and higher
2.3b Updated 13 November 2010
1.0, 2.0 dsPIC30F6012A Fixes MIC-E beacon Latitude for southern hemisphere; Requires PC Utility 2.2a and higher

PC Utility
PC Utility Version PCB Version
Chip
Comments
2.0  Released 17Aug 2006 1.0 dsPIC30F6012A Initial Release, uses 3rd-party APRS packet; Requires Firmware Version 2.0 and higher
2.0-1  Updated 11 Oct 2006 1.0
dsPIC30F6012A Allow imbedded spaces in file names; Requires Firmware Version 2.0 and higher
2.1  Updated 1 Nov 2006 1.0 dsPIC30F6012A COM ports > 9; Requires Firmware Version 2.1 and higher
2.1a  Updated 2 Jan 2007
1.0
dsPIC30F6012A Requires Firmware Version 2.1 and higher
2.2a  Updated 12 Mar 2008
1.0, 2.0
dsPIC30F6012A Eliminate power cycle; add rate limiting & serialtest; Requires Firmware Version 2.2a and higher
2.2b  Updated 20 Jul 2008 1.0, 2.0
dsPIC30F6012A Provide com ports up to 40; Requires Firmware Version 2.2b and higher
2.3  Updated 17 October 2009 1.0, 2.0 dsPIC30F6012A misc changes for 2.3 firmware; Requires Firmware Version 2.2b and higher

Getting Started Instructions
Getting Started Instructions PCB Version
Chip
Comments
2.0  Released 30 Aug 2006 1.0
dsPIC30F6012A Initial Release, uses 3rd-party APRS packet; For Firmware Version 2.0 and higher
2.1  Updated 4 Nov 2006 1.0
dsPIC30F6012A Added 7805 heat sinking instructions; For Firmware Version 2.0 and higher
2.1a  Updated 2 Jan 2007
1.0 dsPIC30F6012A For Firmware Version 2.1 and higher
2.2  Updated 5 Mar 2008
1.0, 2.0
dsPIC30F6012A For Firmware Version 2.2a and higher

TNC-X USB Drivers
TNC-X USB Drivers for the optional USB are listsed below.  These devices use the Virtual Comm Port (VCP) drivers. Make certain you use the correct set for the version of USB you have- there are several!
USB Module Description
Version
Driver Information
Guides
Version
Windows 7, XP & 2K Drivers
Version
Windows 98 & ME Drivers
FTDI FT232RL SMT
all
FTDI USB Driver Info FTDI Installation 2.08.14
FTDI VCP Drivers
1.09.06
FTDI USB VCP Win 98 & ME Driver
DLP-USB232M USB Module
all
DLP USB Info
DLP XP DLP 2K DLP 98/ME
1.00.2176 DLP VCP Win 2K & XP Driver

??
Linx QS USB Module
3.0
Linx DLP QS Driver Info Linx Installation
1.00.2154 Linx QS VCP Win 2K & XP Driver
1.00.2154
Linx QS VCP Win 98 & ME Driver
Linx QS USB Module
4.0
FTDI USB Driver Info
FTDI Installation
2.02.04
FTDI VCP Drivers 1.09.06
FTDI USB VCP Win 98 & ME Driver


Under Construction

Hopefully soon I will completely revamp the web site to better organize and present the info.  Please send me your comments and suggestions to make the site and product even better!

Rich Painter, abØvo
painter@usmartdigi.com

© Copyright 2005 - 2012 Painter Engineering, Inc., All Rights Reserved.
µSmartDigi, uSmartDigi and D-Gate are Trademarks of Painter Engineering, Inc.
Icom is a Registered Trademark of Icom Incorporated.
APRS is a Registered Trademark of APRS Engineering LLC

Valid HTML 4.01 Transitional