Updating the UWT-100 Using JMRI PanelPro

This page will teach you how to use JMRI PanelPro to manually update the firmware on a TCS WiFi-enabled Throttle. This procedure is the same for any operating system, but currently applies primarily for users who are on Mac or Linux which currently do not have support for TCS D.E.P.O.T.

Prerequisites

  • The firmware file for your device must be available on the computer you will be using to update.
  • JMRI must be installed on the computer, and should be the current version, or at the least reasonably recent.
  • You will need a WiFi access point connected and paired to the computer and the device you are updating.

You can request the firmware file be sent to you via email by contacting Technical Support.

Note: It is recommended that you copy or move the firmware file into the JMRI profile, since this is where PanelPro will default to when looking for firmware files. For example - C:\Users\[yourusername]\JMRI\[yourJMRIprofilename.jmri]

Procedure

  1. Ensure that there is no TCS/LCC command station connected to the same WiFi network you are using to update your throttle. There must be no openmrn hubs running on that network (either on the current computer, or in a Virtual Machine, or on another computer on your network) -- if you don’t know what these words mean, you are probably fine. It is recommended that you also shut down any active JMRI WiThrottle servers. Your computer must be connected to the WiFi network you want to use for updating your throttle. If you are already controlling your layout via this WiFi and JMRI, you can skip to Step 3.
  2. If your device is NOT connected to the same network:
    1. Boot the throttle normally
    2. Navigate to the Network Settings menu
    3. Connect the throttle to the correct network
    4. Power down the throttle
  3. Once your device is connected to the same network simply power on the throttle, and press 7 at the startup prompt (instead of 2) to enter Bootloader mode.
  4. Wait to connect to WiFi. Do not do anything during the following phases (about 30 sec).
    1. Connecting to LCC (a)
    2. Connecting to LCC (m)
    3. Connecting to LCC (h)
    4. The throttle should report “No LCC server connection”
  5. Start PanelPro.
    1. If this is your first time using JMRI to update a throttle, go through the section below for Setting up a New Profile in PanelPro.
    2. If you have configured a profile in the past, but received an error during the startup, click the Edit Connections button and skip to Step 9 of the section below for configuring a JMRI profile. In most cases the IP address of the throttle has changed and needs to be corrected.
    3. If you select the throttle update profile and JMRI connected without an error message and see that the LCC menu is displayed, you are good to go.
  6. From the main PanelPro window open the LCC menu and click Firmware Upgrade. The following window will pop up:
  7. In the Target Node ID field, select the Node ID for your throttle (also shown on the throttle screen)
    1. NOTE:TCS devices will share the same preamble: 09.00.99.(…)
  8. To load the Firmware file, click the Select button, and choose the desired “.bin” file.
    1. NOTE: This file may be located in your Downloads folder. If you copied the file into your JMRI profile folder, it should show up immediately without any need to go find it.
  9. Click the Load button and wait for the process to complete. You can see the progress bar in the dialog. The throttle will reboot automatically into the new firmware when done.


To flash another throttle, you MUST quit PanelPro and start over from Step 2.

Setting up a new PanelPro Profile for Your Device

  1. Start JMRI PanelPro
  2. When prompted to select a profile, click “New…”
  3. Enter a name for your profile, such as “UWT-100 Firmware Updater”
  4. On the profile selection window, select your new profile name and click “Ok”
  5. The Preferences window will open since there are no options configured (shown below):
  6. Under “System Manufacturer” select LCC
  7. Under “System Connection” select CAN via GridConnect Network Interface
  8. “Settings” field will appear
    1. Set the IP address to match what is displayed by the throttle
    2. Set the port number to 12021
    3. Make sure the Connection Protocol is set to OpenLCB
    4. You may leave the other fields at the default settings
  9. When finished, your Preferences window should look like this:
  10. Press Save and tell PanelPro to Restart
    1. NOTE: If your throttle is powered on in bootloader mode and PanelPro fails to connect, exit PanelPro, restart your throttle, then start PanelPro again.