Frequently Asked Questions

Connecting - Wifi and WiThrottle

  1. Why doesn’t my Android device automatically connect to my WiFi network?

  1. I have noticed that some older android phones won’t automatically reconnect to a network that does not have internet access, and nothing I have been able to do can resolve it.

I have in the past put a shortcut on the homepage to the network settings to make it easy to get there and select the network, before starting ED.

  1. I can’t connect to my Server /Railroad

    1. Check the following:

    1. Possible Mobile data connection problem

If Engine Driver can see the WiThrottle Server or DCC-EX Server but displays an error when you try to connect to it… If you are using a phone with a SIM, and the WiFi network your JMRI server is on does not have internet access. You may have to turn ‘mobile data’ off on your device. See [here] for more information.

  1. I am getting lots of ‘Disconnects’

  1. See the WiFi Issues page for assistance.

  1. Engine Driver Connects, but I can’t control any locos

  1. Powering the layout on

Some DCC Command Stations need you to turn the track power on before you can use it.

Note

See the Turn Track Power On notes for more information.

  1. Why doesn’t Engine Driver automatically find my WiThrottle Server or DCC-EX Server?

I can manually connect to my Server / Railroad by entering an IP address, but it never finds it automatically.

A1. Make sure that the Android System ‘Use Location’ is enabled. This must be enabled for Engine Driver to ‘find’ servers on the network.

A2. 4.5ghz and 5ghz. Some routers do not transfer the mDNS messages between clients on the 4.5ghz and 5ghz channels. So if your Command Station/Server is using 4.5ghz, make sure you device/phone is using a 4.5ghz channel as well. (Or both use 5ghz channels.)

A3. Mesh Routers. Many Mesh routers will not transfer the mDNS messages to other connected routers / modems. If you are using a mesh network, make sure both the Command Station/Server and the device/phone are using the same Mesh network.

A4. One reason can be your router doesn’t not support the Bonjour/mDNS protocol. There is not much you can do if this is the case other than trying a different router.

  1. If Engine Driver can’t find my Server/Railroad automatically

  1. Look for the IP address and port in the WiThrottle window in JMRI

Type them in the two fields and click Connect

  1. Why doesn’t Engine Driver remember the servers I have connected to?

  1. Check the Engine Driver preferences and make sure the Maximum Recent Locos preference is not set to zero.

Connecting to different servers/railroads

  1. I want to switch to a different server on the same network.

  1. You need to exit Engine Driver and restart.

  1. I want to switch to a different server on a different network.

  1. You need to exit Engine Driver, change WiFi networks in the Android settings, then restart Engine Driver.

Save/load preferences for different servers

You can set up different preferences for different server/railroads and have them automatically load when you connect to that WiThrottle Server or DCC-EX Server. The most common use of this (so far) is to remember the locos relevant to that railroad. e.g. I run N scale and HO Scale. When I connect to one of the N Scale layouts I use it shows me my N Scale locos in the recent locos list, but when I connect to one of the HO layouts I use, it shows me the my recently used HO locos.

Note

See the Auto Host Specific Import/Export preference for more information.

  1. What is this jmri.mstevetodd.com in the server list?

  1. jmri.mstevetodd.com is a demo server, which can be used for testing. It has Server Roster entries, turnouts, routes and an active panel for you to try.

Note

You can use the Hide Demo Server? preference to permanently remove it from the list if you wish.

  1. How do I clear unwanted servers from the list

  1. Swipe right on an entry to remove it.

Selecting locomotives to control

  1. Why can’t I can’t see my loco in the Server Roster?

  1. The loco needs to be added to the Server Roster on your server computer. Refer to your server documentation for specifics.

  1. Why is my loco is not remembered in the recent locos list?

    1. If the loco is in your Server Roster, check the preference Roster in Recent Locos? so that locos in the Server Roster will be included in the recent locos list.

    1. If no locos are remembered (and you have confirmed the preference above) make sure the Maximum Recent Locos preference is not set to zero.

  1. The loco list is too long, I can’t find my locos easily

  1. You can use the filter option to reduce the list

Todo

LOW: FAQ Selecting locomotives to control

  1. How do I work with Consists / Multiple Units / Multiple Units|

    1. On the fly Consists / Multiple Units in Engine Driver

Engine Driver can create Consists / Multiple Units on-the-fly by simply selecting multiple locos, one after the other…

Note: Make sure that the Drop Loco before acquire? preference is set to ‘No’.

    1. DCC ‘Advanced Consists’ (CV19)

Note you can’t create a DCC ‘Advanced Consists’ (CV19) with Engine Driver, but you can control one if it has already been setup.

Todo

LOW: FAQ DCC ‘Advanced Consists’ (CV19)

Remember that this type of Consist / Multiple Unit can cause problems later if the loco has not been removed from the consist first and you want to control it as an individual loco.

    1. JMRI Consists

Todo

LOW: FAQ JMRI Consists

Creating Consists / Multiple Units in JMRI effectively create DCC ‘Advanced Consists’ (CV19) and appear in the loco list in Engine Driver much like any other loco.

  1. I can’t create on-the-fly Consists / Multiple Units ?

  1. Make sure that the Drop Loco before acquire? preference is set to ‘No’.

  1. The lights of the locos in my consist are wrong?

    1. If you use on-the-fly Consists / Multiple Units, you can control the lights by clicking Select then click on the Edit Lights button

    1. You can control the lights with a Long click on the Select Loco button, if you set the Control consist Lights on long click preference.

  1. Can’t control my loco?

  1. If you can control the lights but not the motor, check that the loco is not in a ‘normal’ or ‘advanced’ consist.

  1. I sometimes accidently press the volume keys

  1. You can disable the volume keys with the Disable Volume keys? preference.

  1. I sometimes accidently press the direction button when changing speed

  1. No Locomotive Icons appear in the Server Roster

  1. The Server Roster List, and Recent Locos List on the Select Loco screen will automatically show icons for your locos only if:

  • The Web Server (not just the WiThrottle Server) is running on the JMRI server

  • The loco itself has an icon added for it in the JMRI Server Roster
    OR

  • A locally cached or manually chosen image is available for the loco (see ‘Locomotive Icons’ on the Operation screen)

Note the DCC-EX EX-CommandStation and all other known Commands stations cannot provide Server Roster icons. Only JMRI is know to be able to provide this service.

  1. Why can’t I control 6 locos

  1. only the ‘Simple’, ‘Tablet Switching/Shunting’ and ‘Tablet Vertical’ throttle layouts allows for (up to) 6 throttles.

Also, once you have selected a throttle layouts allows for more throttles, you must also increase the number of throttles displayed with the throttle layouts preference.

Changing the appearance of Engine Driver

Global changes (Themes)

  1. I want to change the appearance of the app

  1. You can switch between different themes by changing the preference.

  • The ‘Original’ (Checker Plate) theme

  • The ‘High Contrast’ Theme. Similar to the original theme, without the textured background with deeper blacks and brighter whites.

  • The ‘High Contrast Outline’ theme. For people who like white text on a black background.

  • The ‘Dark’ theme.

  • The ‘Colourful’ theme.

  • the ‘Neon Blue’ theme

Changing the Throttle screen

  1. I want to change the appearance of Throttle Screen

  1. There are a number of different Throttle Screen designs/layouts. Look at the Operation screen for details.

  • Default / Original /Horizontal

  • Simple

  • Vertical

  • Vertical Left

  • Vertical Right

  • Big Buttons - Left

  • Horizontal Switching/Shunting

  • Vertical Switching/Shunting

  • Vertical Switching/Shunting Left

  • Vertical Switching/Shunting Right

  • Tablet Switching/Shunting Left

  • Tablet Switching/Shunting Right

  • Semi-Realistic Left

Engine Driver will automatically reload the throttle sceen after closing the preferences screen.

See the Throttle Screen Layout preference for more information on the different layouts.

  1. I want vertical sliders, not horizontal

  1. See the ‘Simple’, ‘Vertical’ and ‘Tablet’ throttle screen type options above.

See the Throttle Screen Layout preference for more information on the different layouts.

  1. I want to control more than one train

  1. You can control between one and six trains with Engine Driver, depending on which Throttle Screen type (see above) you have chosen. Each train can have one or more locomotives in Consist / Multiple Unit.

The screen space is shared between throttles, so set the ‘Number of Throttles’ appropriately.

Note that the different Throttle Screen options (above) support different numbers on throttles.

  1. In want to change the labels of the function buttons that are displayed

    1. Change the function button defaults in Engine Driver, for locos without Server Roster Entries

    1. Server Roster entries include function button labels, and can be changed when defined to the server

  1. My locos have different functions but all the Function buttons appear the same for every locomotive

    1. There is a Preference “Use default function labels?” which can override the labels from the Server Roster entry. Confirm that you have not turned it on.

    1. You need to setup the individual functions for each of your locos in JMRI.

  1. My loco shows the wrong Function labels

  1. Functions of loco are generally set in the Server Roster. Engine Driver may be showing the functions of a loco with the same address from the Server Roster.

This can happen if you entered an address to select the loco rather than selecting from the Server Roster list.

You can force the default function labels in the preferences.

Speed slider VS speed buttons

Some people find the speed slider difficult to control.

There are options to:

  • Change the height of slider

  • Add speed buttons to the ends of the slider (with further options to increase the separation)

  • Replace the slider with large speed buttons only.

    (If you are using a gamepad or ESU MCII, then you may like to remove the slider AND the speed buttons.)

  1. I have a small screen Android device. It doesn’t fit well?

    1. Try the ‘Immersive mode’ (Full Screen) preference. (see below)

    1. Reduce the height of the loco select and direction buttons

    1. Keep the number of locos to 1 or two.

    1. If you are using one of the horizontal Throttle Layouts, try the Hide function buttons on non-selected throttle? preference.

Direction Buttons

  1. I don’t like the direction buttons in that order

  1. If you tend to think that forward should be to the right and reverse to the left, you can change the buttons positions in the preferences.

You can also change them on the fly.

Labelling the direction buttons for the directions/conventions of your railroad/railway.

e.g. North South, West East, Up Down.

Todo

LOW: FAQ Direction Buttons

Hiding the title bar and navigation bar

Refer to Immersive mode (Full Screen).

Immersive mode (Full Screen)

Immersive mode hides the system navigation buttons at the bottom of the screen on the Throttle screen only, to give you more screen real estate for the throttle UI.

It can optionally also hide the Android System Status Bar at the top of the page.

Swiping up from off screen will normally temporarily show the Android navigation buttons again.

Swiping up or Down

Todo

LOW: FAQ LOW: FAQ Swiping up or Down

Showing the web page at the bottom of the throttle screen

Todo

LOW: FAQ Showing the web page at the bottom of the throttle screen

See the Web Throttle view

See the Web Throttle view preference

<also point to the swipe up option>

Loco selection screen

Todo

LOW: FAQ Loco selection screen

Locos in the roster not showing

Todo

LOW: FAQ Locos in the roster not showing

    1. check you don’t have a filter

    1. ???

Changing the Connection screen

  1. You can’t remove test server by swiping right

  1. you can’t remove it with a swipe, but there is a preference to remove it.

Note

See the Hide Demo Server preference for more information.

Changing the turnouts/Points screen

Todo

LOW: FAQ Changing the turnouts screen

Conserving power on your phone/tablet

  1. My Phone/table runs out of power too quickly

  1. You should

  • Keep the brightness of the device/phone as low as practical

  • Disable Bluetooth and NFC if you are not using them

  • You can also try:

    • Set the preference to dim screen on swipe up. If you are not using the throttle temporarily (i.e the train does not need any control for a little while), dim the screen until you need it back.

    • Set the preference to dim screen on shake. If you are not using the throttle temporarily (i.e the train does not need any control for a little while), dim the screen until you need it back.

If your device has an AMOLED display, theoretically, the High Contrast Outline theme should use less power (though this is unproven).

Note

See the Conserving Battery Power page for more information.

Virtual Sounds / In Phone Loco Sounds (IPLS)

  1. I can’t hear the In Phone Loco Sounds (IPLS)

  1. Adjust the ‘Ring and Notification volume’ in the Andrtoid System Settings. (the volume buttons on the side of the device/phone don’t adjust this setting by default.)

The IPLS feature of Engine Driver uses the Notification features of Android, not the Media Player features.

That means that, at the Android system level, the volume is controlled by the ‘Ring and Notification volume’ not the ‘Media volume’.

DCC-EX Features

Todo

MEDIUM: FAQ DCC-EX Features