Reference

Using a Serial Monitor

Conductor Hat Propeller Beanie Engineer Hat

What is a Serial Monitor and Why Do I Need One?

A Serial Monitor is another name for a “terminal” program. It is software that runs on your computer or phone and connects to a serial port, like the USB connector on an Arduino, and lets you interact with your Command Station. The Arduino IDE has one built in as does our very own EX‑Installer, which makes it a bit of a “Swiss Army Knife” in that it provides a way to upload software to your Command Station, and connect to it to view logs and send manual commands. If anything goes wrong with the CS, we will ask you to check the startup log with a Serial Monitor. With a Serial Monitor you can:

  • Test your Command Station

  • View startup and other diagnostic logs to fix issues or help us support you

  • Turn on extra diagnostic commands

  • Get the ID of a loco on the programming track

  • Diagnose communication issues with your loco on the programming track (ACK failure/Error 308)

  • Send commands to your WiFi board

  • Manually control your locos

  • Program CVs without the need for any other software

If you know how to use a terminal program it is as simple as connecting your device to the Command Station, opening a session and selecting the right baud rate (115200) and line endings (Carriage Return and Line Feed). For the rest of us, we will include detailed instructions on how to use a computer or a phone app to connect to your Command Station.

Connect with EX-Installer and Device Monitor

This is the simplest way to connect to the serial console of your device, and allows for a simple way to share your startup or serial console logs with the DCC-EX team.

For details, refer to Using the EX-Installer Device Monitor.

Connect with the Arduino Serial Monitor

What You Will Need

  • The Arduino IDE

  • A Computer (Just about any Windows, Mac or Linux machine including the Raspberry Pi)

  • The USB cable for your Arduino

Download and install the Arduino IDE

Rather than go into details that are already covered in great detail on the Arduino web page, just follow the instructions in the following link and then return here.

Arduino IDE Guide

Run the Arduino IDE

Start the Arduino IDE. You should see something like this:

Arduino IDE

Figure 217 Arduino IDE

Select the Correct COM Port

Select “Port” and find the port on your computer that recognises the Arduino. If you don’t see a port listed there and are using a clone board, you may have to install a driver for a CH340 USB chip that is on these boards: see here Drivers for the CH340

Select the COM Port

Figure 218 Select the correct COM Port

Open the Serial Monitor

The Arduino IDE has a built in serial monitor. That means that in addition to uploading updates to your Command Station, we can interact with the Command Station. Select “Tools -> Serial Monitor”, or click on the “serial monitor” icon near the upper right of the window.

Open the Serial Monitor

Figure 219 Open the Serial Monitor

Make sure the baud rate at the lower right of the window is set to “115200”. This is the data communication speed, equivalent to 115.2kb/s! Make sure the dropdown next to that says “Both NL & CR”. That makes sure you send a ‘new line’ command and ‘carriage return’ which the Arduino expects.

Serial Monitor

Figure 220 Serial Monitor - Note line ending and baud rate settings!

Opening the Serial Monitor always resets the Arduino board. Therefore, you should see a startup (boot) log immediately display in the window. If you have a Network shield or WiFi shield connected, you will see the Command Station setup its AP, or connect to your network if you gave it your credentials. If you don’t have a network, that’s fine; the Command Station will sense that, the network test will fail, but everything else will be working as it should.

Enter Commands to the CS

There is an entire language that EX‑CommandStation understands. We call this the DCC-EX API for “Application Programming Interface”. If you are interested, the list of all the commands is here in the DCC-EX Command Reference. Let’s just try two commands to make sure everything is working.

All DCC-EX commands begin with a < and end with a >. In the command window, type <1> and press the send button, or Enter on your keyboard. Power should come on to the main track. You should see 2 red LEDs light on the “A” power output of the motor shield.

Now enter <s> (lowercase). You should see status information for your Command Station appear in the log.

Turn off the power to the track by sending <0> to the CS. That is a “zero”.

There are diagnostics to test CV reads and writes on the programming track, WiFi Diagnostics to test your connection to throttles like Engine Driver, Ethernet debugging, and more. Read the documentation and experiment!

If you run into trouble, remember to send us a log by cutting and pasting the text from the Serial Monitor window to our support channel in Discord or one of the other methods of contacting us mentioned here: https://dcc-ex.com/support/index.html.

Connect with a Smart Phone

What You Will Need

  • A Smart Phone

  • A Terminal program (see below)

  • A USB “On The Go” Cable (aka. OTG Cable)

  • The USB Cable for your Arduino

OTG Cable

You will need to find one that is compatible with your phone. Some phones come with one. It is usually Micro USB or USB-C or Apple Lightning on one end and USB 2.0 Female on the other. It acts like an adapter to connect a regular cable that would normally plug into a computer or laptop, and let it connect to your phone instead.

Here is an adapter:

https://www.amazon.com/Thunderbolt-Compatible-Chromebook-Pixelbook-Microsoft/dp/B07KR45LJW/

Here is one for Android or MacBook Pro with USB-C with a short pigtail:

https://www.amazon.com/Adapter-JSAUX-Compatible-MacBook-Samsung/dp/B07L749R9R/

And one for an iPad or iPhone:

https://www.amazon.com/dp/B09KBZDDGL/

Every smart phone OS such as Android or iOS has a program or two that will work as a serial monitor. For Android, here are a few: