About

This free Android application connects to a WiThrottle Server. Supported servers include JMRI, DCC-EX, MRC Prodigy WiFi, Digitrax LnWi, and WifiTrax (for NCE). 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.33.155 includes:

  • 'Stop' button cancels 'Pause' if stationary
  • Volume 'Pause' and 'Mute' hardware buttons stop then toggle direction
  • Fix: gamepad buttons when some default function labels not set
  • New: Option to specify only one gamepad, defaults to true
  • Fix: manual turnout buttons not enabling
  • Fix: tolerate FKeys > 28
  • New: Preference to alter the Heartbeat Response Factor (percentage of the heartbeat period)
  • New: Preference to have the App Icon and App Name act as an emergency stop
  • Fix: Several crashes reported to Play Store
  • Add link to Privacy Policy, per Google requirement

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.