About

This free Android application connects to a WiThrottle Server. Supported servers include JMRI, DCC-EX, MRC Prodigy WiFi, Digitrax LnWi, WifiTrax (for NCE) and IoTT Stick. Once connected, you can control your locomotives and your entire model railroad. Speed, direction, and up to 29 DCC functions are supported for one to six locomotives or consists. You can create and edit consists (software-defined). You can also control layout power, turnouts, routes, and access JMRI web panels and windows.

Changes

Engine Driver version 2.37.187 includes:

  • Support for 32 Function Roster Entries
  • New WiThrottle "CV Programming on Main" page. (note: not supported on all Command Stations)
  • New preference to allow for double back button presses to exit the app
  • Option to have the Throttle WebView on the top of the page
  • Discovery of JMRI DCCppOverTCP Server.
  • Include any server with port 2560 as a DCC-EX server when connection preference set to 'Auto'
  • Change the owner filter pref default to false
  • UI improvements for the DCC-EX and Function Defaults pages
  • Added intro/setup wizard page for DCC-EX
  • Action Bar UI improvements
  • Change all toolbar/Action Bar icons to vectors for better scaling and reduce maintenance effort
  • Reworking of the 'Original' theme. Buttons changed to vectors
  • Removal of duplicate icons
  • Bug fixes for the 'keyboard' gamepad type
  • Bug fix for the close button in function_defaults
  • Bug fix for Consist Light Editing
  • Bug fix for DCC-EX default latching for non-roster locos
  • Bug fix for initial Auto-Web preference change
  • Bug fix for fastclock
  • lint removal
  • New Button to sort Turnouts/Points by Name or ID
  • New Button to sort Routes by Name or ID
  • Additional French Translations by Alain Carasso
  • New button to download the roster list to the Recents list
  • Selecting a loco from Recent Locos will attempt to restore the function button labels
  • Move targetSDK from 33 to 34 per Google requirement by 2024-8-30
  • Automatically reduce the font size of buttons if the first word is long or the total text length is long
  • Preference to always show the Throw and Close buttons for Turnouts/Points
  • Additional Google Translations

Configuration

Under Preferences, you can turn off the "stop on release" feature if desired, and you can set a Maximum value and Maximum change% for the throttle sliders. If the throttle slider is too small for your fingers, increase the size in Preferences. You can also set the initial web page for the full-size web panel, and enable the smaller web view on the throttle screen. There are also settings to help maximize the use of your device's smaller screen by hiding items not relevant to you.

Operation

On your device, make sure you are connected to the WiThrottle server network.

Start the Engine Driver app and wait for your server's address to show up in "Discovered Servers".

Click on the discovered address, or you can enter the address and port of your WiThrottle server directly. (Using the values shown on the WiThrottle window.)
NOTE: see [here] for wifi connection issues.

On the throttle screen, click on the "Select" loco button for each loco.

Prerequisites

Prerequisites (for JMRI):

Verify your Android device can connect to your network via WiFi and obtain an IP address.
Make sure you are running one of the latest versions of JMRI (3.8 works, 4.20+ works much better) on your PC, connected to your layout. Start up JMRI and verify you can use JMRI's included "Throttle" window to control a loco on your layout.

Start the WiThrottle function of JMRI, located in DecoderPro under Tools, Throttles.  It is also highly recommended that you start the JMRI Web Server function (Tools, Start JMRI Web Server). Both of these should be added to Preferences, Start Up as well.

Prerequisites (for MRC Wifi):

Connect the MRC WiFi module, and verify your device can connect to its network and obtain an IP address.
Note for MRC users: David Fuller has provided some additional setup information [here].

Prerequisites (for Digitrax LnWi):

Connect the Digitrax LnWi, and verify your device can connect to its network and obtain an IP address.

Privacy Policy

Engine Driver does not collect or use any private information from the user.

The device's "Android ID" is used internal to the app as a key when storing Preferences. The last 4 digits of this ID are used to create the default "Throttle Name", "Engine Driver nnnn".

The READ_PHONE_STATE permission is only used locally to your phone to (optionally) stop your locos while you are using the phone.

The ACCESS_FINE_LOCATION permission is required by Google for the app to read the WiFi SSID.