EX‑Toolbox can be installed on your phone or tablet via the Google Play Store .
Open the Play Store app on your phone or tablet and search for “EX-Toolbox”.
Once installed, open EX‑Toolbox and it will go through the initial setup wizard where it will ask for one permission, and for which which theme you would like to use.
After you complete the setup wizard, you will be shown the ‘Connection’ Screen.
This is the most common way to connect. If the server you want to connect to is in the list, simply click on it and you will be taken to the ‘CV-Programming’ screen.
If the server does not appear in the recent list try one of the other two methods. Your server not appearing in the recent list is not necessarily a problem and there can be a number of reasons why.
If the server you want to connect to is in the list, simply click on it and you will be taken to the ‘CV-Programming’ screen.
A server being in this list does not necessarily mean that you will be able to connect it now. It just means that you have successfully connected to it in the past.
Type in the IP address and Port of the EX‑CommandStation and press Connect.
To find your EX-CommandStation’s IP address and Port refer you original setup or, if you have a OLED screen on your command station the details will be displayed on it.
If you only ever connect to one EX‑CommandStation you can effectively bypass this screen by setting the ‘Auto-Connect to WiThrottle Server?’ preference.
on the main line (MAIN) - Operation mode / Ops Mode
By default EX‑Toolbox shows the Service Mode options. To switch to Operation Mode, select “Program on Main (Operation Mode)” on the drop down list at the top of the screen.
Service Mode CV Programing is available form the ‘CV Programming’ screen, when ‘Programming Track (ServiceMode)’ is selected in the drop down list at the top of the screen.
Service Mode CV Programming allows you to both Read (if the decoder/loco supports it) and Write CVs.
You do not need to know the DCC Address of the decoder being changed, as all decoders/locos currently on the programming track will have the CV changed at the same time.
On this screen you can:
read the decoder’s DCC Address
write a new DCC Address to the decoder
read a CV value from the decoder
write a CV value to the decoder
select from a list of named, common CVs
issue <> commands to the EX‑CommandStation
To read the DCC Address of the decoder click the Read button on the DCC Address row.
To write a DCC Address to the decoder, enter the address and click the Write button on the DCC Address row.
To read a CV of the decoder, enter the CV number and click the Read button on the CV row.
To write a CV value to the decoder, enter the CV number, enter the value and click the Write button on the CV row.
If you select a ‘common CV value’ it will enter the CV number into the field. From there follow the instructions above for reading or writing the CV.
Note: Issuing a read or write will automatically turn the track power on.
Operation Mode CV Programing is available form the ‘CV Programming’ screen, when ‘Program on Main (Operation Mode)’ is selected in the drop down list at the top of the screen.
Operation Mode CV Programming ONLY allows you to Write CVs.
To use Operation Mode CV Programming you must know the DCC Address of the decoder/loco you want to change. Note: you should never try to change the DCC Address of the decoder/loco using Operation Mode CV Programming.
On this screen you can:
write a new DCC Address to the decoder
write a CV value to the decoder
select from a list of named, common CVs
issue <> commands to the EX‑CommandStation
To write a CV value to the decoder, enter the DCC Address of the decoder, enter the CV number, enter the value and click the Write button on the CV row.
If you select a ‘common CV value’ it will enter the CV number into the field. From there follow the instructions above for writing the CV.
Note: Issuing a read or write will automatically turn the track power on.
Track Manager allow you to change up to 8 channels (depending on the Motor Shield you are using)
Each channel can be one of:
DCCPROG - Programming Track
DCCMAIN - Main Track
DC
DCreversedpolarity(DCX)
OFF
Select the value you want for the channels and click Set
Note. If you select DC or DCX you must select a DCC address for the channel before pressing Set. What ever address you select, selecting that address on your throttle (e.g. Engine Driver) will result in the DC locomotive on the track connected to that channel to respond.
Note. Only one channel can be PROG. If you select more that one, one will turned OFF.
THe servo motor test screen will allow you to test and fine tune the settings needed for configuring servo motors attached to the EX‑CommandStation. This is intended to be temporary. To permanently configure a servo motor you will need to record the values and include the in the configuration of your EX‑CommandStation.
To access the Servo configuration screen either:
Swipe Right from the Sensor Screen
Swipe Left from the CV Programming Screen
Select ‘Servos’ from the Menu
On the Servo motor screen,
Enter the VPin of the servo motor you want adjustment
Enter any known starting values for Close, Mid, Throw
Test the Close, Mid, Throw positions by pressing the appropriate button. The servo will move to that position.
Fine adjust any of the three positions by using the + or - buttons The servo will gradually move.
when you are happy, record the three values
EX‑Toolbox remembers the servos that you have changed (up to 10) in this and previous sessions, and you can select one of the previous servos from the drop down list. EX‑Toolbox will restore the last settings you used for the selected servo to the main fields.
There are two ways to turn the Track Power on/off:
Power Screen - accessed from the menu
Power Action Bar button - needs to be enable in the preferences
The Power Screen can be accessed from the Menu ‣ Power. This will open the Power Screen where there is a simple button that to turn the power on or off. Use the Close button or Android’s Back button to return to the CV-Programming Screen.
If the Power Action Bar button is enabled, simply click on it to turn track power on or off.
Note
You can also optionally enable the Power Button on the Action bar in the preferences.
Accessed from any of the main screens via Menu ‣ View Log.
This screen allows you to view the internal Engine Driver log of events.
This is sometimes useful for analysing problems.
The option to Start recording to file creates a user-accessible file that can be sent to the EX‑Toolbox app developers to assist you in resolving a problem.
The file will be located on your mobile phone at:
Internal storage /Android/data/dcc_ex.toolbox/files and will be named something like: logcat9999999999999.txt
Enable the preference to include the timestamp on each line of the log.
EX‑Toolbox can’t normally connect to an EX‑CommandStation via USB, however it is possible to temporarily create a USB to IP connection on you PC using tools like socat or SerialToIPGUI (for windows).
Note: Change S11 to the appropriate USB port. Whatever ‘COM’ number appears in the Device Manager, subtract 1.
i.e. ‘COM12’ in the Windows Device Manager becomes ‘/dev/ttyS11’
Using SerialToIPGUI (For Microsoft Windows) (Recommended):
Select the correct COM port for the command station
Enter the port of ‘2560’
Click Start
Once started…
Open EX‑Toolbox on your Android device
Enter the IP address of your PC (The one running socat or SerialToIPGUI)
Enter the port of ‘2560’
Click connect
Warning
This ‘trick’ only supports a single connection at a time. So it is important that JMRI (if you are using it), or the Arduino IDE serial monitor, or anything else that might be using the COM (USB) port are shut down first.
