Digitrax Duplex Network Configuration Tool

CONTENTS UR92 image

Overview

The JMRI Digitrax Duplex Configuration Tool provides a mechanism to read and modify the Duplex Group identification information associated with a Digitrax Duplex wireless network. It also can scan the Duplex channels for radio interference.

This tool supports both the UR92 and the UR92CE. For clarity, this text and this tool uses the term UR92.

This tool provides the same basic features as provided by the Digitrax program "DuplexGroupSetup". Duplex network "identification" information may read and changed by using the fields availble in the "Group Identity" tab. Scanning the Duplex channels for radio interference me be performed using the "Channel Scan" tab. Each tab is described below.

If the Duplex Group identity information is changed, then throttles must join the network with the new identity information in order to communicate properly. Join the network using any of the mechanisms which apply for the throttle(s) you use.

This configuration tool has no effect on Digitrax infrared or simplex network configuration, and has no useful effect if there are no UR92 devices connected to LocoNet.

Disclaimer

This tool was not developed by Digitrax. This tool is not supported by Digitrax. The tool's original author reverse-engineered the operations of the DigiGroupSetup software package to determine how this tool should operate. It is not possible to guarantee that this tool will work properly with future Digitrax Duplex-related hardware.

Note that this tool can have some effect on the configuration of the Digitrax LNWI device. This is a "feature" of the Digitrax design. The Digitrax software package "DigiGroupSetup" has the same sorts of effects. See Effect on LNWI device configuration.

Starting the Duplex Network Configuration Tool

This tool is available in DecoderPro under the LocoNet menu, as the item "Configure Duplex Group". Other tools may provide different methods to start this tool.

When this tool is started, the tool automatically determines if it can access any UR92 devcies. If the tool is able to find and read the UR92 Duplex Group identification information, the identification information is updated in the display. A sample is shown below.

Duplex Configuration Tool

If the tool cannot communicate with any UR92 devices, then this tool cannot provide any useful function. In this case, the tool disables all Duplex Group identification entry fields and displays a status message. This is shown (in part) below.

Status message showing no UR92s found

Once LocoNet communication between the computer and the UR92(s) is restored, the user can press the "Read Group Information" button to re-try the UR92 query.

If the tool finds more than one UR92, and they are configured with different Duplex Group identity information, then the display will show configuration information from the first UR92 to respond to the tool's identity query. The tool reports the number of UR92s found, and shows a message in the status line at the bottom of the tool, such as shown (in part) below.

Display when UR92s have non-matching Duplex Group identity information

In this case, it is advisable to Set all of the UR92s to the same Duplex Group identity information by modifying the Duplex Group identification fields as required and then pressing the "Set Group Information" button to configure all UR92s to the same Duplex Group identity information.

The Group Identity Tab

The "Group Identity" tab is used to read and change the identification information associated with the Digitrax Duplex network. This information is used by the devices which support the Digitrax Duplex radio system, which includes the UR92, the DT402D, and the UT4D.

As fields are modified, they are marked in orange, as shown below:

Tool showing modified fields

The "Set Group Information" button may be used to write the displayed Duplex Group identification information to the UR92(s). All values are checked for validity before being written to the UR92(s). If any invalid values are found, the incorrect data will be shown in red text and a message will be shown near the bottom of the tool, but no information will be written to the UR92(s).

After changing the Digitrax Duplex Group identification information, it is necessary for each Duplex throttle to join the network to learn the updated identification. Rejoining must be done for each throttle. This tool cannot inform throttles that they will need to rejoin, and cannot cause throttles to rejoin. Rejoining can be as simple as unplugging and plugging each Duplex throttle into LocoNet, or done wirelessly on the DT402D. See DT402D throttle instructions for information on wirelessly joining a Duplex Group network.

Changes to the Duplex Group identification information happens immediately when the UR92(s) accept the Duplex Group identity information. Any Duplex throttle which was communicating with a UR92 using the old Duplex Group identification information will no longer be able to communicate with the UR92 until it re-joins the Duplex network using the new Duplex Group identification information. Because of this, it is recommended that all Duplex throttle users stop their trains and exit programming modes as necessary before changing the Duplex Group identity information.

To ensure that the Duplex throttles understand any changes to the Duplex Group identity information, it is necessary for each throttle to join the Duplex Group network. See throttle documentation for details on joining the Duplex Group network. Re-joining may be as simple as plugging the throttle into a LocoNet jack. Re-joining may be done on the DT402D throttle by "find"ing the Duplex Group name on the correct Duplex Group channel, and, if necessary, entering the Duplex Group password.

The "Read Group Information" button may be used to request a read of Duplex Group identity information from UR92(s) on LocoNet. This will refresh the displayed Duplex Group identity information and UR92 count information based on the response(s) from the UR92 devices.

The Duplex Group Identification Fields

A Duplex Group is identified by a Duplex Group Name, a Duplex Group "Password" a Duplex channel number, and a "Duplex Group ID". Each of these is described below.

Duplex Group Name

The Duplex Group Name is a field of 8 characters which is used to help distinguish one Duplex Group network from another. It may be configured with an 8 character text message which is meaningful to the user.

The Duplex Group Name is stored in the UR92(s). Each Duplex-capable throttle must be configured to a specific Duplex Group Name in order to be able to communicate with a UR92.

If you enter a Duplex Group Name with less than 8 characters, this tool will automatically add spaces after the characters you have entered to fill it out to 8 characters. When entering the Duplex Group Name on a DT402D, a Duplex Group Name of less than 8 characters must similarly be padded with spaces to fill it out to 8 characters.

If you enter more than 8 characters, this tool will report an error message in the status line at the bottom of the tool window, as shown below. The tool will not update the Duplex Group identification information in the UR92(s) if this field (or any other field) contains unacceptable data.

Tool showing too many name characters

Duplex Group Channel

The Duplex Group Channel number controls which frequency band the UR92(s) and throttle(s) will use to communicate. By default, the UR92 uses Duplex Group Channel number 11. The Digitrax Duplex radio system supports channel numbers 11 through 26 (inclusive).

If an invalid Duplex Group Channel Number is entered, this tool will report an error message in the status line at the bottom of the tool window.

Because there are other electronic communication systems which may use the same frequency bands which are available to the Digitrax Duplex radio system, it may be useful to select a Duplex Group Channel number other than the default.

Duplex Group Password

The Duplex Group Password is a four character security code which can be used to control access to a Duplex Group network. It is stored in the UR92(s).

The Duplex Group Password is always four characters. The Duplex Group Password may contain characters between 0 and 9 (inclusive). Although not documented by Digitrax, the UR92 and DT402D also support the use of the characters "A", "B", and "C". This tool supports use of these additional characters. To help ensure compatibility with future Digitrax devices, it is advised that the password characters should be chosen to use only the numbers 0 through 9 (inclusive); the letter characters should not be used.

If an invalid Duplex Group Password is entered, this tool will report an error message in the status line at the bottom of the tool window.

A Duplex throttle does not need to know the Duplex Group Password if joining a Duplex Group network by plugging into the LocoNet. When the Duplex Group Password is "0000", untethered DT402D throttles can join the Duplex Group network easily and without entering a Password. As such, a Duplex Group network which is configured with a Duplex Group Password of "0000" should be considered un-secured.

When the Duplex Group Password is other than "0000", untethered throttles may only join a Duplex Group network if the tetherless throttle user enters the correct Duplex Group Password when attempting to join the network. Since UT4D throttles do not allow the user to enter the Duplex Group Password, a UT4D must be plugged into LocoNet to join a Duplex Group network when that network uses a Duplex Group Password that is other than "0000".

For a variety of technical reasons, the Duplex Group Password cannot provide a highly-secured Duplex wireless network. Please do not expect the Duplex Group password system to prevent unauthorized users from joining the Duplex network.

Duplex Group ID

The Duplex Group ID number is a number between 0 and 127. The UR92 device(s) stores and reports the Duplex Group ID setting. It appears that the UR92, DT402D, and UT4D do not make any active use of this setting. Changing the Duplex Group ID number does not appear to have any effect on operation of the Duplex Group network.

The default Duplex Group ID setting of 0 is recommended to help ensure compatibility with future Digitrax devices.

The Channel Scan Tab

The Channel Scan tab allows the user to temporarily use the UR92(s) to "scan" the Duplex Radio channels for interfering signal sources. Results are shown graphically, in a way similar to that used by the Digitrax "DigiGroupSetup" program.

The Channel Scan is started by pressing the "Scan Duplex Channels" button. This begins a loop which scans each available Duplex Group channel number sequentially, then repeating, for a total of 25 scans of each channel. As each channel is scanned, the graphical chart area is updated to show the channel being scanned, the reported signal strength, and the average and maximum signal strength reported for the channel. The channel being scanned is indicated by a diamond-shaped icon which is shown just above the channel number near the bottom of the graphical area.

The data reported by the UR92(s) is shown graphically on the chart, with a light blue vertical bar shown for each channel as it is scanned, a red horizontal line which represents the highest value reported for the channel, and a green horizontal line which represents the average value reported for the channel.

Values higher on the chart indicate stronger interfering sources than values shown lower on the chart.

The chart also shows a horizontal dashed yellow line, which corresponds roughly to the dashed yellow line shown on the Digigrax "DigiGroupSetup" program channel scan display. It is believed that this Digitrax may intend this dashed yellow line to represent a recommendation for maximum amount of interfering radio signal.

The best Duplex Group channel to use is one which never has any interfering radio signals. In this case, the red line for the channel will be shown at the bottom of the chart, indicating a very low maximum interfering radio signal strength. In some environments, there may be not be any channels where the maximum interfering signal strength is very low. In this case, choose a Duplex Group channel number where the maximum interfering signal strength is lowest. It may be advisable to run the radio scan occasionally to determine that the radio signal environment has not changed over time.

The image below shows a sample Channel Scan tab display. Note the diamond above the lower line showing channel numbers - it indicates the channel being scanned at that time.

Sample Channel Scan display

The image below shows a sample Channel Scan tab display which has indicates some channels which should be avoided due to high levels of radio signal from interfering sources.

Sample Channel Scan display with bad channels

Channel Scan Limitations

Notes

Effect on LNWI device configuration

Like the Digitra DigiGroupSetup program, this tool can have an effect on the LNWI device.

If a LNWI device is connected to LocoNet and has certaion OpSw settings, when this tool is used to configure the Duplex Group identity information, the LNWI device can also be re-configured. The UR92 and LNWI are configured by default to use the same "name" and "net number". They also, under the default configuration, configure their "channel" number to be related but not identical values. This is summarized below:

Note that any time that the LNWI "name", "channel" number, "net" number, or "passcode" is chaged, all LNWI WiFi connections are "dropped" it will need to be re-established using the new WiFi SSID "connection name" and/or new security passcode.

Some possible interference sources

All of the available Duplex Group channel numbers specify frequencies in the 2.4 GHz "ISM" frequency range. Some electronic devices which are known to use the 2.4 GHz "ISM" frequency range, and thus can interfere with Duplex radio operation include:

Note that, by default, the LNWI "WiFi" device "channel" shares some frequency spectrum with the Duplex "channel". This can cause "contention" between the LNWI radio signal and the Duplex radio signal. Ideally, each radio system would operate within non-overlapping frequency spectra. The table below summarizes the "overlap" between WiFi channels and Duplex channels:

WiFi ChannelOverlapping Duplex Channels
111, 12, 13, 14
212, 13, 14, 15
313, 14, 15, 16
414, 15, 16, 17
515, 16, 17, 18
616, 17, 18, 19
717, 18, 19, 20
818, 19, 20, 21
919, 20, 21, 22
1020, 21, 22, 23
1121, 22, 23, 24
1222, 23, 24, 25
1323, 24, 25, 26
Note that the table above reflects regulatory requirements for North America only.

As such, it may be appropriate to configure the LNWI so that it does not respond to Duplex "channel" changes. This may be done by following the steps listed below:

Digitrax Simplex radio system interaction

It is believed that the Digitrax Simplex radio throttle system (UR91, DTx00R, DT402R, UT4R) has no effect on the Duplex Channel Scan tool, because the Simplex radio throttle system operates in the 915 MHz "ISM" frequency range, while the Duplex radio throttle system operates in the 2.4GHz "ISM" frequency range.

Because the Simplex and Duplex radio systems use different radio frequency ranges, the Duplex Channel Scan tool cannot be used to analyze the Simplex radio frequency range. To the best knowledge of the tool's original author, the Simplex radio system does not provide any mechanisms to allow creation of a similar tool for analyzing Simplex radio interference.

See Also

The LocoNet ID Tool allows reading and writing the LocoNet ID number

Support for this software tool is available through the JMRI User forum at "groups.io". Digitrax does NOT provide support for this tool.

The Digitrax web site offers official Digitrax documentation, their "Tech Support Depot", and the Digitrax program "DigiGroupSetup", which is available for Windows operating systems.

LocoNet® is a registered trademark of Digitrax, Inc.