Logo
  • About Engine Driver
    • What is ‘Engine Driver’
    • What’s a ‘WiThrottle Server’?
    • WiThrottle protocol VS DCC-EX Native protocol
    • Where can I get Engine Driver
    • Roadmap
    • Alternates to Engine Driver
  • Prerequisites for Using Engine Driver
    • To Use Engine Driver You must…
    • Android Device/Phone
      • ESU Mobile Control Pro
    • WiThrottle and DCC-EX Native Servers
      • For JMRI
      • For DCC-EX WiFi
      • For MRC WiFi
      • For Digitrax LnWi
  • Operation - Using Engine Driver
    • Quick Start / Getting Started
    • Detailed Instructions
      Operating Engine Driver
      • Connecting
        • Connecting to the WiFi network
        • Connecting Engine Driver to the Command Station/Server
        • Disconnections
      • Turn Track Power On
      • Selecting & Releasing Locos
        • Selecting a Single loco
        • On the fly / In Phone Consists (Multiple Units)
      • Running Trains
        • Controlling Speed
        • Controlling Direction
        • DCC Functions
        • Virtual Sounds - In Phone Loco Sounds (IPLS)
        • Action Bar and Menu
      • Turnouts / Points
        • DCC Address (Turnout/Point)
        • Server Defined Turnout/Point list
        • Filter by location (Turnouts/Points)
        • Recent Turnout/Point list
        • Turnout/Point Preferences
        • Overflow Menu (Turnouts/Points Screen)
      • Routes
        • By System name
        • From the Server
        • Filter by location (Routes)
        • Route Preferences
        • Overflow Menu (Routes Screen)
      • Panels and Web Pages
        • Throttle Web View VS Web View Screen
        • Overflow Menu (Web View Screen)
        • Swipe (Web View Screen)
        • Auto Web Orientation
      • Pushing the app to the Background
      • DCC-EX - Features when using the Native DCC-EX Protocol
      • Exiting Engine Driver
    • User Interface
      • Main Screens
        • Connection Screen
        • Throttle Screen
        • Turnouts/Points Screen
        • Routes Screen
        • Web View Screen
      • Secondary / Support Screens
        • Intro/Setup Wizard Screen
        • Loco Select Screen
        • Consist (MU) Edit Screen
        • Consist (MU) Lights Edit Screen
        • Power Screen
        • Preferences Screen
        • In Phone Loco Sounds Screen
        • Function Defaults Screen
        • Function Latching Settings Screen
        • DCC-EX Function Settings Screen
        • DCC-EX Screen
        • WiThrottle - Programming on the Main Screen
        • Gamepad Test Screen
        • View Log Screen
        • About Screen
        • Reconnecting Screen
      • Common Elements and Features
        • Theme / Styles
        • Localisation
        • Action Bar
        • Overflow Menu
    • Semi-Realistic Throttle (SRT)
      • Overview
        • Key SRT Controls/Displays
      • Basic Operation
        • Example: Normal throttle
        • Example: SRT throttle with decoder momentum
        • Example: SRT throttle with no, or little, decoder momentum
      • Detailed Operation
        • a) Throttle
        • b) Direction
        • c) Load
        • d) Brakes
        • Decoder Integration
      • Preference Settings for the SRT
        • Acceleration Speed Step Repeat Delay
        • Deceleration Speed Step Repeat Delay
        • Speed Step Amount
        • Maximum Throttle Percentage
        • Throttle Notches
        • Stop Button Action
        • Number of Brake Steps
        • Maximum Brake Percentage
        • Disable the Air Reservoir
        • Rate the air brakes refresh
        • Number of Load Steps
        • Maximum Load Percentage
        • Decoder Brake Type
        • Decoder Low Function Number(s)
        • Decoder Low Brake Value (Percent)
        • Decoder Mid Function Number(s)
        • Decoder Mid Brake Value (Percent)
        • Decoder High Function Number(s)
        • Decoder High Brake Value (Percent)
      • Example Cases
        • General Note - Decoders
        • Conclusion
    • Gamepads
      • Connecting your Gamepad
      • Running Engine Driver with the Gamepad
      • Remapping gamepad buttons
      • Multiple gamepads
      • Example Gamepads
        • Tested Gamepads
        • Future Support Planned
        • Not Recommended Gamepads
        • Unsupported Gamepads
      • Keyboard Commands
    • ESU Mobile Control 2/Pro
      • Download
        • ESU Mobile Control Pro
        • ESU Mobile Control 2
      • Operation
      • Configuration
        • Default configuration
        • Recommended Configuration
        • Other Configuration
      • Updating Engine Driver on the ESU Mobile Control Pro
        • Instructions
        • Alternate instructions
    • Advanced Operation
      • Consist Follow Functions
      • Direction Buttons
        • Renaming Direction Buttons
        • Swapping Direction Buttons
      • Conserving Power
      • Children’s Timer
    • WiFi Issues
      • Bonjour/mDNS
        • Use location
        • Incompatible Routers
      • Firewalls
      • Routers and Mesh networks
        • 2.4GHz and 5GHz
        • Mesh Routers
      • Using Mobile Data instead of WiFi
      • Disconnections
        • Other networks on the same channel
        • Distance to router / location of the router
        • Objects in the way
        • Too Many Devices Are Connected
    • Frequently Asked Questions
      • Connecting - Wifi and WiThrottle
        • Connecting to different servers/railroads
        • Save/load preferences for different servers
      • Running Engine Driver in Background
      • Selecting locomotives to control
      • Changing the appearance of Engine Driver
        • Global changes (Themes)
        • Changing the Throttle screen
        • Speed slider VS speed buttons
        • Direction Buttons
        • Hiding the title bar and navigation bar
        • Immersive mode (Full Screen)
        • Showing the web page on the throttle screen
        • Showing the Turnouts/Points or Routes on the throttle screen
      • Loco selection screen
        • Locos in the roster not showing
      • Changing the Connection screen
      • Changing the Turnouts/Points screen
      • Changing the Routes screen
      • Conserving power on your phone/tablet
      • Virtual Sounds / In Phone Loco Sounds (IPLS)
      • Reading/Writing Decoder CVs
      • DCC-EX Features
  • Configuration
    • Configuring Your Server
      • JMRI
      • DCC-EX EX-CommandStation WiFi
      • MRC Prodigy WiFi
      • Digitrax LnWi
      • WifiTrax (for NCE)
    • Configuring Engine Driver
      • Preferences
      • Configuring Functions
      • Configuring In Phone Loco Sounds (IPLS)
    • Detailed Information
      Preferences & Configuration
      • Preferences
        • Advanced Preferences
        • Device Preferences
        • Throttle Screen Appearance Preferences
        • Throttle Screen Action Bar Preferences
        • Throttle Control Preferences
        • Consist Function Follow Preferences
        • Additional Throttle Control Source Preferences
        • Select Loco Preferences
        • In Phone Loco Sounds
        • Connect Preferences
        • Web Screen Preferences
        • Turnouts/Points and Routes Preferences
        • Children’s (Timer) Preferences
        • Import/Export/Reset & Log Preferences
      • Function Buttons
        • DCC Functions
        • What Function Buttons Are Shown
        • How Functions Behave
        • Linking DCC Functions to IPLS buttons
        • Functions and Gamepads
      • In Phone Loco Sounds (IPLS)
        • Virtual Sounds / In Phone Loco Sounds (IPLS)
        • Custom .ipls Files
      • Gamepads
        • Selecting a Gamepad Type
        • Configuring the buttons
      • Loco Icons in the Roster
      • Setup Wizard
        • Initial Screen
        • Permission Screens
        • Throttle Name
        • Theme / Style
        • Throttle Screen Layout
        • Speed Sliders and Buttons
        • DCC-EX
        • Ready
      • Moving to a new phone/device
      • Conserving Battery Power

Help & Support

  • Videos
    • Connecting
    • Preferences
    • Gamepads
    • Turnouts/Points and Routes
    • Default Functions
    • DCC-EX Native Support
    • In Phone Loco Sounds (IPLS)
    • Children’s Timer
    • Import/Export/Reset Preferences
      • Server Specific Preferences
    • Preserving the battery in your device
  • Support & Contact
    • email
    • Forums
    • Facebook

Get Engine Driver

  • Play Store & Downloads
    • Production Version
    • Beta Versions
    • Older or Other Versions - Manual Install
  • Changes / Updates
    • Production Changes
    • Beta Changes
    • Complete ChangeLog

Additional Info

  • Privacy Policy
    • Required Permissions
    • Optional Permissions
  • Glossary / Copyright / Screenshots
    • Glossary
    • Copyright & Warranty
    • Attribution
    • Screenshots
  • Contributing
    • Contributing to the Code
    • Contributing to the Localisation (Languages)
    • Contributing to the Documentation
      • Style Guidelines
      • TODO
Engine Driver - Documentation
  • Glossary / Copyright / Screenshots
  • Edit on GitHub

Glossary / Copyright / Screenshots

On This Page

  • Glossary

  • Copyright & Warranty

  • Attribution

  • Screenshots

Glossary

Term

Meaning

Command Station
DCC Command Station
DCC Base Station

Refer to https://en.wikipedia.org/wiki/Digital_Command_Control

Consist
Multiple Unit (MU)

Multiple locos hauling a single train

DC

Direct Current

DCC

Digital Command Control

DCC-EX
EX-CommandStation

Refer to the DCC-EX web site

JMRI

Java Model Railroad Interface

Loco
Locomotive
Engine

A powered rail vehicle that provides the motive power for a train.

Main Screens

The screens: ‘Throttle’, ‘Turnouts/Points’, ‘Routes’, ‘Web’ and, to a lesser extent, ‘Connection’.

Switching
Shunting

The process of moving individual carriages to/from specific locations on yards or sidings.
In North America this is called ‘Switching’ and in the rest of the English speaking world it is called ‘Shunting’.

Turnouts
Points

Track devices that allow trains to change from one track to another.
In the North America they are called ‘Turnouts’ and in the rest of the English speaking world they are called ‘Points’.

USB

Universal Serial Bus

WiThrottle

1. Trademark owned by Brett Hoffman
2. Proprietary iOS app developed by Brett Hoffman

WiThrottle protocol

Proprietary protocol developed by Brett Hoffman

Copyright & Warranty

Copyright (C) 2025 M. Steve Todd mstevetodd@mstevetodd.com

This documentation is free; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This documentation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Attribution

  • Blue background texture from https://www.sketchuptextureclub.com/#google_vignette

  • Paper background texture from https://www.sketchuptextureclub.com/textures/materials/paper/cotton-paper-texture-seamless-10870

  • Semi-Realistic Throttle text by John Geddes

  • Consist Function Following Documentation by John Geddes

  • Translations by:

    • Luis Zamora

    • Petr Šídlo

    • Alain Carasso

    • Yvéric Patry

    • Daniel Sieber

    • Roberto Falorni

    • Luis Zamora

    • Futoshi Yanagi

Screenshots

../_images/Big-Buttons-Right.png ../_images/Conductor_in_Throttle_Web_View.png ../_images/connect.png ../_images/consist_edit.png ../_images/consist_lights_edit.png ../_images/Import_Preferences.png ../_images/roster_details.png ../_images/select_dcc_address.png ../_images/select_roster.png ../_images/TabletWithWebConductor.png ../_images/Throttle-Vertical-Left.png ../_images/Throttle-Vertical-Right.png ../_images/throttle_big_buttons.png ../_images/throttle_buttons.png ../_images/throttle_buttons_only.png ../_images/throttle_consist_10step.png ../_images/throttle_default.png ../_images/throttle_simple_4.png ../_images/throttle_simple_6.png ../_images/throttle_type_big_buttons.png ../_images/turnouts.png ../_images/vertical_slider.png
Previous Next

© Copyright M Steve Todd.

Built with Sphinx using a theme provided by Read the Docs.