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
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
Index
Edit on GitHub
Index