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


© Copyright M Steve Todd.

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