DCC++ EX Web Throttle
This is a new DCC++ EX Throttle/Controller that can connect to the DCC++ EX Commmand Station directly through the USB port of a computer.
What you need to setup the project
- Chromium-Based Browser version 80 or above (Chrome, Opera, Edge)
- You must enable the experimental Web Serial API
To enable the Web Serial API, in your browser URL bar type:
Then set the #enable-experimental-web-platform-features flag by looking on the page for "Experimental Web Platform Features" and click on the "enable" button.
Note: Substitute the name of your browser above if you don't use Chrome
What you’ll need to use this application
You don't need anything to test it out and to run in emulator mode, to run trains you will need:
- An Arduino Mega or Uno Microcontroller
- An Arduino Motor Control Shield
- Chromium based browser version 80 or later
If you don't have your hardware yet or just want to play with the throttle and see commands being sent to the log window, you can skip to the operation section.
To get started, connect your Command Station to a computer that has a USB port and have a compatible browser installed. Use a USB serial cable from your computer to the serial connector on the Arduino. Click on the "index.html" or "exwebthrotle.html" file to load the webpage.
To use the program, you can either click on the "Serial" dropodown button and select "Emulator" to run in emulator mode or after making sure your hardware is properly connected, select "Serial"
Next, click on the "Connect DCC++ EX" button.
If you are in "emulator mode", you can skip to the next step. When using the serial connection, if the program finds a compatible device, it will open a popup a window showing you a selection. It may show a line at the top such as "Arduino Mega 2560 (COM3)". Your com port may vary. Click on your board to select it and then click the "Connect DCC++ EX" button.
You should then be connected to the Command Station (CS) and should see the response from the CS in the log textbox of the debug console at the bottom of the throttle window. Make sure your debug console is open. If it isn't, use the slider button in the lower left to open it. You can also open the DevTools window in your browser to see more developer logging.
Once you are connected, you can enter the
<s> command in the "direct command" textbox to get status information from your Command Station. To do this just enter
s (without the quotes) and press the SEND button. You can send any DCC++ API command in this way. You should see
Now you are ready to run trains! Place your loco on the track and click the power slider button to turn on power to your track. You should see lights on your Arduino Motor Shield and an indication that your loco has power.
Make sure you place the loco on the MAIN track, not the PROGRAM track. Check your wiring. On an Arduino Motor Shield, Motor Output "A" should connect to your MAIN track and "B" to the PROGRAM track.
Next go to the "Locomotive ID" textbox and enter the address of your loco and press the "Acquire" button. You should now have full control over your loco.
All the function buttons should be working, so you can play with the headlight, horn and bell and any other function assigned to a function button. The commands being sent to the CS and its responses will display in the log window if it is open
In the throttle control area to the left of the function buttons are vertical controls to control direction. The up arrow selects forward, the square button is stop and the down arrow is reverse.
The circular control or vertical slider (chosen by the throttle select slider) can be moved by clicking and holding down the mouse button and dragging, clicking at a spot where you want the throttle to move, or clicking the + and - buttons.
The options button lets you save labels to go on your function buttons for each of your locos. We will be updating this document soon to give you more information on this and other new features.
Not all CS functions are fully supported in the emulator yet. This means that although the software works, not all the responses will be shown in the debug console. This will be completed in a next release.
Try it now
Just click this button and it will load a web page from our server that will run the web throttle on your machine. You can connect it to DCC++ EX or just run it in emulator mode where you don't have to have any hardware. Please read the instructions above for what is required to run exWebThrottle in your browser.
Just download this zip file and extract it to any folder you have run permission on. Then run the index.html file.
Going Further / Developing
If you want to really delve into how this works and help us improve it with your comments or your development skills, please contact us.
To load the Chrome DevTools to look at logging and be able to manually enter "write" commands for testing, click on the Menu (the 3 vertical dots in the upper right hand corner of the Chrome Window), then select "more tools" and then "Developer Tools". Or you can just hit "Ctrl-Shift-I".
Copyright 2020 DCC-EX
Licensed under the GNU open source licese.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.