JMRI: WiFi Throttle

This window controls the connection between WiFi throttles, e.g. an iPhone, iPod Touch, or Android Phone, and JMRI.

It can be set to start automatically with the "Start Up" section in the "JMRI Preferences".

Preferences for the WiFi throttles can be found in the JMRI Preferences under the heading WiThrottle.

This utility broadcasts its connection information across the local network, so it can be picked up by any device looking for the service. This eliminates having to enter connection information into the device. If the computer running JMRI is protected by a software firewall, you may need to disable the firewall to allow the WiFi throttle to connect.

When using a WiFi throttle, if the computer enters sleep mode, control will be lost. System preferences may need to be adjusted to prevent the computer from putting itself to sleep when it is inactive. EngineDriver for Android devices WiThrottle for Apple devices DigiTrains for Android devices

To use your iPhone, iPad or iPod Touch with JMRI as a throttle, you run the WiThrottle app on the iPhone or iPod Touch. The basic application is available for free download from the iTunes store.

To use your Android device with JMRI as a throttle, you run the Engine Driver program or Digitrains on the Android device. These free apps are available from the Google Play Store or the EngineDriver site

The protocol is described on a separate page. For more on JMRI networking, see the networking technical page.

You can also use a web browser in your device to run trains if for some reason you can't install an app on the device.

Function Labels

Function labels can be customized for each roster entry through JMRI, using the Labels & Media button. These labels will then be displayed in place of the generic F1, F2... on the screen of the mobile device. The labels can be added when a new roster entry is created, or by editing an existing roster entry under the Function Labels tab.

Routes & Turnouts

The app can control any turnouts (and routes) that JMRI can control. NOTE: EngineDriver only lists turnouts and routes which have User Names.

Additionally, you can limit what turnouts appear. In JMRI, with the WiThrottle window active, there is a menu named WiThrottle. It has an item titled "Filter Controls" that will let you pick which turnouts to display or hide.

Advanced Consisting

There are now two options for how Advanced (or Decoder Assisted) Consisting is handled. This can be selected from the WiThrottle portion of JMRI Preferences.

The default is NMRA Format. This will build a consist using NMRA consisting commands. It does not use any techniques specific to the connected DCC system. This allows WiFi throttles to work in a DCC manufacturer independent way. These consists may perform better for building and controlling with WiFi devices.

The second option is DCC Brand-Specific which will build consists in a manner where they will function as though built using a throttle from the DCC manufacturer. This will follow manufacturer specific features as to how consists are built and controlled. These consists should perform better when built with a WiFi device, but controlled by a throttle from the DCC manufacturer of your system.

This is the package/jmri/jmrit/withrottle/UserInterface help page