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 MobileControl II
    • 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
          • IP Address and Port
          • Discovered Servers List
          • Recent Server List
        • Disconnections
      • Turn Track Power On
      • Selecting & Releasing Locos
        • Selecting a Single loco
          • DCC Address
          • Server Roster
          • Recent Locos
        • On the fly / In Phone Consists (Multiple Units)
          • One at a time
          • Recent Consists
      • Running Trains
        • Controlling Speed
          • Sliders
          • Speed Buttons
          • Stop button
          • Volume Keys
          • Emergency Stop - Action Bar button
          • Pause button
          • Limit Speed button
          • Gamepad keys - Speed Control
        • Controlling Direction
          • Direction Buttons
          • Sliders - Switching/Shunting Throttle Screen layouts
          • Gamepad keys - Direction Control
        • DCC Functions
          • Activating DCC Functions via the Function Buttons
          • Activating the DCC Function via the Gamepad Keys
          • Function Labels
          • Functions in consists
        • Virtual Sounds - In Phone Loco Sounds (IPLS)
          • Automatic Loco Speed Step Sounds
        • Action Bar and Menu
          • Action Bar
          • Overflow Menu (Throttle Screen)
      • 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
          • Connection Method Options
            • IP Address and Port
            • Discovered Servers
            • Recent Servers
          • Action Bar (Connection Screen)
          • Overflow Menu (Connection Screen)
        • Throttle Screen
          • Throttle Area
            • Loco Select Button
            • Speed indicator
            • Speed Slider Area
            • Stop Button
            • Speed Buttons
            • Direction Buttons Area
            • Function Buttons Scroll Area
            • DCC Function buttons
            • Pause and Limit Speed buttons
            • In Phone Loco Sounds buttons (IPLS)
            • Load Slider Area
            • Brake Slider Area
          • Web View Area (Throttle Web View)
          • Action Bar (Throttle Screen)
          • Overflow Menu (Throttle Screen)
          • Background
          • Immersive Mode (Full Screen)
          • Swipe Left / Right (From Throttle)
          • Swipe Up / Down
          • Accelerometer (Shake)
        • Turnouts/Points Screen
          • Action Bar (Turnouts/Points Screen)
          • Overflow Menu (Turnouts/Points Screen)
          • Swipe Left / Right (From Turnouts/Points)
        • Routes Screen
          • Action Bar (Routes Screen)
          • Overflow Menu (Routes Screen)
          • Swipe Left / Right (From Routes)
        • Web View Screen
          • Action Bar (Web View Screen)
          • Overflow Menu (Web View Screen)
          • Swipe Left / Right (Web View Screen)
      • Secondary / Support Screens
        • Intro/Setup Wizard Screen
        • Loco Select Screen
          • Selection Method
          • Select by DCC Address
          • Select from Sever Roster
            • Filter the Roster
            • Download to the Roster
            • Icons / Loco Images
          • Select from Recent Locos List
            • Remove Recent Loco entries
            • Naming a Recent Loco
          • Select from Recent Consists (MU) list
            • Naming a Recent Consist (MU)
            • Remove Recent Consists (MU) Entries
          • Select Loco - Core On Screen Buttons
            • Acquire
            • Release
            • Edit Order & Facing
            • Edit Lights
            • Loco Sounds
        • Consist (MU) Edit Screen
          • Lead Loco
          • Trailing Loco
          • Change Facing
          • Remove a Loco
        • Consist (MU) Lights Edit Screen
        • Power Screen
        • Preferences Screen
        • In Phone Loco Sounds Screen
        • Function Defaults Screen
          • Number of Default Functions
          • Number of Default Functions for Roster
          • Use Default Function Labels
          • Override WiThrottle Default Latching
          • Use Defaults for Roster Entries With no functions
          • Function List
        • Function Latching Settings Screen
        • DCC-EX Function Settings Screen
        • DCC-EX Screen
        • WiThrottle - Programming on the Main Screen
        • Gamepad Test Screen
        • View Log Screen
          • Saving a log file
        • About Screen
        • Reconnecting Screen
      • Common Elements and Features
        • Theme / Styles
        • Localisation
        • Action Bar
          • Emergency Stop Button
          • Track Power Button
          • Flashlight Button
          • Throttle Web View Button
          • Layout Switch Button
          • DCC-EX Button
          • In Phone Loco Sound Button
          • Children’s Timer Button
          • Fast Clock
          • Children’s Timer Status and Countdown
          • Full Screen or Action Bar Only left/right swipe
          • WiThrottle Server Name
        • 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
          • Brakes - With the Air Reservoir and Air Line Enabled
          • Brakes - Without the Air Reservoir and Air Line Enabled
        • Decoder Integration
          • Braking - With Decoder Brake Functions
      • 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
        • Not Recommended Gamepads
        • Unsupported Gamepads
      • Keyboard Commands
    • ESU MobileControl II
    • 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
          • Show Advanced Preferences?
        • Device Preferences
          • Throttle Name
          • Screen orientation
          • Theme/Style
          • Localisation
          • Left/Right Swipe Preferences
            • Disable full screen Swipe?
            • Swipe through Web?
            • Swipe Through Turnouts/Points?
            • Swipe through Routes?
          • Double Back Button to Exit?
          • Hide Instructional Hints
        • Throttle Screen Appearance Preferences
          • Throttle Screen Layout
          • Number of throttles
          • Speed Slider and Buttons Preferences
            • Increase Slider/Speed Height?
            • Throttle Speed Slider Margin
            • Display Speed buttons?
            • Hide Speed Slider?
            • Hide Slider AND Speed Buttons?
            • Tick Marks on Speed Sliders?
            • Switching throttle Dead Zone
            • Stop Button Vertical Margins
          • Haptic Feedback (Vibration) Preferences
            • Haptic Feedback (Vibration)
            • Haptic Feedback Duration
            • Haptic Feedback on Button Presses
          • Direction Button Preferences
            • Swap Direction buttons?
            • Long press Swap Direction buttons?
            • Direction button Long Press Delay
            • Left Direction button Label
            • Right Direction button Label
            • Short Left Direction button Label
            • Short Right Direction button Label
          • Decrease Loco No. height?
          • Loco Address instead of Name?
          • Default Function Preferences
            • Use default function labels?
            • Number of Default Functions
            • Number of Default Functions for Roster
          • Hide function buttons on non-selected throttle?
          • Function Buttons Area size
          • Throttle Web View Preferences
            • Throttle Web View?
            • Larger Throttle Web View?
            • Initial throttle Web Page
          • Swipe Up-Down Preferences
            • Use Immersive Mode for Throttle view?
            • Hide Toolbar in Immersive Mode?
            • Swipe down action in the Throttle view?
            • Swipe up action in the Throttle screen?
            • Screen Dimming % Value
          • Accelerometer (Shake) Preferences
            • Shake Action
            • Shake Threshold
          • Background Image Preferences
            • Background Image
            • Background Image File Name
            • Background Image Position
          • Semi-Realistic Throttle Preferences
            • Acceleration Speed Step Repeat Delay
            • Deceleration Speed Step Repeat Delay
            • Speed Step Amount
            • Maximum Throttle Percentage (SRT)
            • 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)
        • Throttle Screen Action Bar Preferences
          • Emergency Stop button?
          • Layout Power button?
          • Flashlight button?
          • Fast Clock Display
          • Throttle Web View button?
          • Layout Switch Button Preferences
            • Show Layout Switch button?
            • Cycle Through All Layouts?
            • First Screen Layout
            • Second Screen Layout
          • In phone sounds button
          • Show Server Description
          • App Icon button?
          • DCC-EX button?
        • Throttle Control Preferences
          • Speed Units
          • Maximum throttle Percentage
          • Maximum throttle Change
          • Speed button Change Amount
          • Speed button Repeat Delay
          • Speed step on Decrement?
          • Stop on Phone call?
          • Direction change while moving?
          • Stop on direction change?
          • ‘Limit Speed’ & ‘Pause’ button Preferences
            • Show ‘Limit Speed’ button?
            • ‘Limit Speed’ button
            • Show ‘Pause’ button?
            • ‘Pause’ button Rate
            • ‘Pause’ button Step
        • Consist Function Follow Preferences
          • Consist Functions - Follow Rule Style
          • Selective Lead Unit Sound?
          • Always treat F1 as Sound?
          • Always treat F2 as Sound?
          • If All matches Fail Action
          • Headlight specific String 1
          • Headlight specific Action 1
          • String 2, 3, 4, 5
          • Action for String 2, 3, 4, 5
        • Additional Throttle Control Source Preferences
          • Volume Button Preferences
            • Speed button Change Amount (Volume)
            • Disable Volume keys?
            • Volume keys follow touch?
          • Gamepad Preferences
            • Gamepad type
            • Only One Gamepad?
            • Test Gamepad settings now!
            • Speed button Change Amount (Gamepad)
            • Gamepad Button Click Volume %
            • Speed button Repeat Delay (gamepad)
            • Gamepad button action <!– X –>
            • Gamepad button action <!– Y –>
            • Gamepad button action <!– A –>
            • Gamepad button action <!– B –>
            • Gamepad button action <!– Start(Lower) –>
            • Gamepad button action <!– Return(Upper) –>
            • Gamepad DPAD Up action
            • Gamepad DPAD Right action
            • Gamepad DPAD Down action
            • Gamepad DPAD Left action
            • Swap Direction buttons with Screen buttons?
            • Enforce Gamepad Testing?
            • Use Simple Test?
          • ESU MobileControl II Options
          • Device Stop button options
            • Stop Button long-press delay
            • Enable Short Press
          • Device side button options
            • Top-left button action
            • Bottom-left button action
            • Top-right button action
            • Bottom-right button action
            • Button repeat delay
          • Control Knob options
            • Control Knob Zero Trim
            • Direction Change at end-stop
            • Show disable Knob button
          • Additional selected loco Indicator
          • Voice Response Preferences
            • Voice Response
            • On Gamepad Throttle change
            • On Gamepad Speeds
            • On Gamepad Test start
            • On Gamepad Test complete
            • On Gamepad Test key press
        • Select Loco Preferences
          • Stop on Release?
          • Drop Loco before acquire?
          • Allow loco select while moving?
          • Default Address Length
          • Roster in Recent Locos?
          • Roster Names in Recent Locos?
          • Maximum Recent Locos
          • Control consist Lights on long click
          • Filter Roster
          • Filter Roster by Roster Owner
          • Roster Sort Order
          • Always use function labels from server
        • In Phone Loco Sounds
          • Throttle 1 Loco Sounds
          • Throttle 2 Loco Sounds
          • Additional Preferences
            • In Phone Momentum
            • Don’t clip loco step sounds
            • In Phone Loco Sounds Volume
            • In Phone Bell Sounds Volume
            • In Phone Horn/Whistle Sounds Volume
            • Bell button Latching/Momentary
            • F1 and F2 activate Bell and Horn?
        • Connect Preferences
          • Maximum Recent Connections
          • Auto-Connect to WiThrottle Server?
          • Hide Demo Server
          • Initial Connection Timeout
          • Socket Timeout
          • Mobile Data connection?
          • Feedback on Disconnect
          • Show WiThrottle PoM Page
          • Background Alert
          • DCC-EX EX-CommandStation Preferences
            • Use Native DCC-EX commands
            • Show protocol option
        • Web Screen Preferences
          • Web Screen Orientation
          • Initial Web Screen Page
        • Turnouts/Points and Routes Preferences
          • Hide Sys Route Names?
          • Location Delimiter
          • Hide if no user name?
          • Turnouts/Points Sort Order
          • Routes Sort Order
          • Always Show Throw/Close?
        • Children’s (Timer) Preferences
          • Time limited running
          • Restart Password
          • Reset/Disable Password
          • Allow Reverse?
          • Show Timer button?
          • Default time for Button
        • Import/Export/Reset & Log Preferences
          • Import, Export or Reset
          • Auto import from all Servers?
          • Include recent loco list?
          • Auto host specific import/export?
          • Manual host specific import/export
          • Show Timestamps on Log?
      • Function Buttons
        • DCC Functions
        • What Function Buttons Are Shown
        • How Functions Behave
          • Which locos in a Consist/Multiple Unit the functions are sent to
            • Lead Loco Sounds preferences
            • Consist Follow Functions - Advanced Consist Function Mapping
        • Linking DCC Functions to IPLS buttons
        • Functions and Gamepads
      • In Phone Loco Sounds (IPLS)
        • Virtual Sounds / In Phone Loco Sounds (IPLS)
          • Loco Sounds
          • Bell, Horn/Whistle
        • Custom .ipls Files
          • .ipls File Format
          • Sample .ipls
          • Sourcing sound files to use in custom .ipls
      • 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
      • Appearance
    • 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
    • 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

  • Attribution

  • Screenshots

Glossary

Term

Meaning

Command Station
DCC Command Station
DCC Base Station

TODO

Consist
Multiple Units

Multiple locos hauling a singe train

DC

Direct Current

DCC

Digital Command Control

JMRI

Java Model Railroad Interface

Loco
Locomotive
Engine

TODO

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.

Turnouts
Points

TODO

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

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

  • 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.