Go to file
peteGSX fe24671ad2 Fix memory leak - only track vpin once 2024-04-21 09:28:58 +10:00
.github Update FUNDING.yml 2022-03-29 11:59:40 -04:00
Release - Architecture Doc Update version.h 2023-02-22 21:28:16 +00:00
Release_Notes EXRAIL ONBUTTON 2024-04-13 09:14:55 +01:00
.gitattributes do not touch CR or CRLF of svg files 2020-11-26 15:55:52 +01:00
.gitignore Update .gitignore 2023-10-10 12:11:49 +01:00
.travis.yml Initial commit 2020-05-25 01:43:34 -06:00
CONTRIBUTING.md Create CONTRIBUTING.md 2020-12-08 07:34:59 -05:00
CommandDistributor.cpp Functions for DC frequency: Use func up to F31 2024-03-11 14:52:55 +01:00
CommandDistributor.h EXRAIL MESSAGE() 2024-03-08 20:33:11 +00:00
CommandStation-EX.ino compile time check WIFI_PASSWORD length for reasonable value 2024-03-04 15:07:03 +01:00
DCC.cpp Consist version. 2024-04-06 23:49:26 +01:00
DCC.h <W CONSIST cmd 2024-04-06 23:41:25 +01:00
DCCACK.cpp Extended consist <R> and <W> 2024-04-06 13:19:56 +01:00
DCCACK.h Extended consist <R> and <W> 2024-04-06 13:19:56 +01:00
DCCEX.h _hk in myAutomation 2024-01-10 12:11:14 +00:00
DCCEXParser.cpp Squashed commit of the following: 2024-04-09 20:45:28 +01:00
DCCEXParser.h <W CONSIST cmd 2024-04-06 23:41:25 +01:00
DCCRMT.cpp ESP32: Use SOC_RMT_MEM_WORDS_PER_CHANNEL to determine if the RMT hardware can handle DCC 2024-01-07 22:22:38 +01:00
DCCRMT.h Send inverted signal (DCC and DC mode) on ESP32 if signalPin2 defined in MotorDriver 2022-08-13 09:12:53 +02:00
DCCTimer.h ESP32 fix PWM LEDC inverted pin mode 2024-04-05 14:05:12 +02:00
DCCTimerAVR.cpp Merge devel-freq 2024-02-20 15:06:07 +01:00
DCCTimerESP.cpp ESP32 fix PWM LEDC inverted pin mode 2024-04-05 14:05:12 +02:00
DCCTimerMEGAAVR.cpp Merge devel-freq 2024-02-20 15:06:07 +01:00
DCCTimerSAMD.cpp Merge devel-freq 2024-02-20 15:06:07 +01:00
DCCTimerSTM32.cpp ESP32 fix PWM LEDC inverted pin mode 2024-04-05 14:05:12 +02:00
DCCTimerTEENSY.cpp Merge devel-freq 2024-02-20 15:06:07 +01:00
DCCWaveform.cpp ESP32 Bugfix: Uninitialized stack variable. Will bite you with infinite loop if no tracks are defined 2024-04-02 00:03:51 +02:00
DCCWaveform.h fill in debug and unsupported drivers 2024-02-07 21:24:48 +00:00
DIAG.h Rename LCDDisplay class to Display; renameEXRAIL LCD2 macro to SCREEN 2023-02-11 23:37:09 +00:00
Display.cpp exchange pin number to track letter part 2 2023-03-20 21:22:48 +01:00
Display.h Define scroll rows in config 2023-11-15 19:29:24 +00:00
DisplayInterface.cpp Revert "Update DisplayInterface.cpp" 2023-02-24 09:39:00 +00:00
DisplayInterface.h Update DisplayInterface.h 2023-02-23 10:36:42 +00:00
Display_Implementation.h Fix @ reporting on startup 2023-11-23 09:00:49 +00:00
EEStore.cpp (c) and version tag 2022-07-30 23:08:42 +02:00
EEStore.h SAMD Support Initial Patches 2022-05-17 18:06:08 +08:00
EX-CommandStation-installer.exe Rename installer exe 2023-04-11 11:48:35 +10:00
EXRAIL.h Rename RMFT files and references to EXRAIL (#201) 2022-01-30 12:31:26 -05:00
EXRAIL2.cpp ONBUTTON/ONSENSOR use latch 2024-04-13 10:16:26 +01:00
EXRAIL2.h ONBUTTON/ONSENSOR use latch 2024-04-13 10:16:26 +01:00
EXRAIL2MacroReset.h Squashed commit of the following: 2024-04-13 08:12:35 +01:00
EXRAIL2Parser.cpp Squashed commit of the following: 2024-04-09 20:45:28 +01:00
EXRAILMacros.h ONBUTTON/ONSENSOR use latch 2024-04-13 10:16:26 +01:00
EXRAILSensor.cpp ONBUTTON/ONSENSOR use latch 2024-04-13 10:16:26 +01:00
EXRAILSensor.h Squashed commit of the following: 2024-04-13 08:12:35 +01:00
EthernetInterface.cpp Bugfix: Ethernet fixed IP start 2024-01-10 15:09:22 +01:00
EthernetInterface.h Make EthernetInterface code more robust 2022-11-07 11:53:56 +01:00
FSH.h EXRAIL ling segment 2023-11-21 21:14:54 +00:00
GITHUB_SHA.h version 5.2.45 2024-04-06 19:48:02 +02:00
I2CManager.cpp Update I2C hints 2024-04-21 06:48:08 +10:00
I2CManager.h Fixes to timeout handling (due to STM32 micros() difference). 2023-03-28 18:07:52 +01:00
I2CManager_AVR.h Remove redundant commented out code. 2023-02-23 20:16:29 +00:00
I2CManager_Mega4809.h I2CManager: Update native drivers for MUX support from the common code. 2023-02-10 15:47:44 +00:00
I2CManager_NonBlocking.h Fixes to timeout handling (due to STM32 micros() difference). 2023-03-28 18:07:52 +01:00
I2CManager_SAMD.h Update I2CManager_SAMD.h 2023-02-10 18:21:06 +00:00
I2CManager_STM32.h eliminate warning 2024-01-20 23:35:30 +01:00
I2CManager_Wire.h Update I2CManager_Wire.h 2023-02-25 11:43:36 +00:00
IODevice.cpp HAL defaults control 2024-01-14 20:20:22 +00:00
IODevice.h HAL defaults control 2024-01-14 20:20:22 +00:00
IO_AnalogueInputs.h Correct display of high VPIN numbers in diagnostic output. 2023-03-27 13:08:14 +01:00
IO_DCCAccessory.cpp Correct display of high VPIN numbers in diagnostic output. 2023-03-27 13:08:14 +01:00
IO_DFPlayer.h Update IO_DFPlayer.h 2023-03-31 17:58:30 +01:00
IO_EXFastclock.h Update IO_EXFastclock.h 2023-02-23 20:23:08 +00:00
IO_EXIOExpander.h Fix memory leak - only track vpin once 2024-04-21 09:28:58 +10:00
IO_EXTurntable.cpp surpress warnings 2024-02-24 17:24:55 +01:00
IO_ExampleSerial.h Correct display of high VPIN numbers in diagnostic output. 2023-03-27 13:08:14 +01:00
IO_GPIOBase.h Correct display of high VPIN numbers in diagnostic output. 2023-03-27 13:08:14 +01:00
IO_HALDisplay.h HALDisplay bug fix 2024-04-12 17:25:00 +08:00
IO_HCSR04.h Correct display of high VPIN numbers in diagnostic output. 2023-03-27 13:08:14 +01:00
IO_I2CDFPlayer.h Prepend I2CDFPlayer with DF_ to solve Nucleo RESET directive 2024-02-04 18:57:30 +00:00
IO_MCP23008.h Prepare HAL device drivers to support Extended I2C Addresses 2023-02-07 14:55:14 +00:00
IO_MCP23017.h Prepare HAL device drivers to support Extended I2C Addresses 2023-02-07 14:55:14 +00:00
IO_PCA9555.h Update IO_PCA9555.h 2023-09-23 16:10:16 +01:00
IO_PCA9685.cpp Correct display of high VPIN numbers in diagnostic output. 2023-03-27 13:08:14 +01:00
IO_PCA9685pwm.h Correct display of high VPIN numbers in diagnostic output. 2023-03-27 13:08:14 +01:00
IO_PCF8574.h Prepare HAL device drivers to support Extended I2C Addresses 2023-02-07 14:55:14 +00:00
IO_PCF8575.h Prepare HAL device drivers to support Extended I2C Addresses 2023-02-07 14:55:14 +00:00
IO_RotaryEncoder.h Rotary Encoder address 0x67 2024-03-23 13:31:34 +10:00
IO_Servo.cpp Servo driver - split PCA9685 into a filter + PWM driver. 2023-02-07 17:24:05 +00:00
IO_Servo.h Correct display of high VPIN numbers in diagnostic output. 2023-03-27 13:08:14 +01:00
IO_TouchKeypad.h Correct display of high VPIN numbers in diagnostic output. 2023-03-27 13:08:14 +01:00
IO_VL53L0X.h Correct display of high VPIN numbers in diagnostic output. 2023-03-27 13:08:14 +01:00
IO_duinoNodes.h 4.2.41 Hal setup and DNOU8 fix 2023-04-05 23:19:43 +01:00
IO_trainbrains.h Trainbrains block occupancy 2023-11-26 12:31:41 +00:00
KeywordHasher.h Fix asserts for Teensy 2024-01-10 16:08:11 +00:00
LCN.cpp LCN bugfix 2023-02-12 20:38:03 +01:00
LCN.h update copyright notes 2022-01-07 02:28:35 +01:00
LICENSE Create LICENSE 2020-06-12 22:51:42 -06:00
LiquidCrystal_I2C.cpp Update LiquidCrystal_I2C.cpp 2023-02-22 21:06:39 +00:00
LiquidCrystal_I2C.h Update LCD driver to make it more reliable 2023-02-21 11:00:27 +00:00
MotorDriver.cpp ESP32 set frequency after DC speed 2024-04-05 20:30:26 +02:00
MotorDriver.h ESP32 fix PWM LEDC inverted pin mode 2024-04-05 14:05:12 +02:00
MotorDrivers.h Allow no shield 2024-03-18 21:17:51 +01:00
Outputs.cpp update copyright notes 2022-01-07 02:28:35 +01:00
Outputs.h update copyright notes 2022-01-07 02:28:35 +01:00
README.md README.md: dead link to rewrite (#217) 2022-03-24 11:37:29 -04:00
RingStream.cpp Ensure correct functions are called for strcpy_P, strncmp_P, strlen_P etc. on non-AVR targets.. 2023-01-23 22:28:43 +00:00
RingStream.h HIGHMEM + WITHROTTLE 2022-12-16 13:14:48 +00:00
SSD1306Ascii.cpp Update SSD1306Ascii.cpp 2023-02-25 11:42:43 +00:00
SSD1306Ascii.h Support for multiple displays 2023-02-16 16:41:13 +00:00
Sensors.cpp JMRI_SENSOR exrail 2024-02-07 22:11:27 +00:00
Sensors.h JMRI_SENSOR exrail 2024-02-07 22:11:27 +00:00
SerialManager.cpp Bugfix: Catch stange input to parser 2023-11-16 00:27:23 +01:00
SerialManager.h Command Distributor 2022-06-10 12:22:28 +01:00
StringBuffer.cpp Command Distributor 2022-06-10 12:22:28 +01:00
StringBuffer.h HIGHMEM + WITHROTTLE 2022-12-16 13:14:48 +00:00
StringFormatter.cpp Save progmem with DISABLE_VDPY on Uno 2023-11-23 22:14:24 +01:00
StringFormatter.h Virtual LCD phase 1 2023-11-14 19:41:05 +00:00
TrackManager.cpp ESP32 Trackmanager reset cab number to 0 when track is not DC 2024-04-06 19:46:23 +02:00
TrackManager.h Allow no shield 2024-03-18 21:17:51 +01:00
Turnouts.cpp No EEPROM so you do not need this 2023-05-07 23:58:47 +02:00
Turnouts.h save another 2 bytes in turnouts if eeprom is disabled 2023-05-09 14:17:30 +02:00
Turntables.cpp fix warning and indent proper 2024-02-20 15:13:22 +01:00
Turntables.h Missed one i 2023-10-12 13:42:14 +10:00
WiThrottle.cpp Functions for DC frequency: Use func up to F31 part 2 2024-03-12 11:45:28 +01:00
WiThrottle.h HIGHMEM + WITHROTTLE 2022-12-16 13:14:48 +00:00
WifiESP32.cpp ESP32: Can all Wifi channels. Only write Wifi password to display if it is a well known one 2024-01-21 21:09:55 +01:00
WifiESP32.h copyright, version and compile warnings fix 2023-07-08 08:58:00 +02:00
WifiInboundHandler.cpp HIGHMEM + WITHROTTLE 2022-12-16 13:14:48 +00:00
WifiInboundHandler.h HIGHMEM + WITHROTTLE 2022-12-16 13:14:48 +00:00
WifiInterface.cpp Add F439ZI serial setup in WifiInterface 2023-12-22 12:29:17 +08:00
WifiInterface.h copyright, version and compile warnings fix 2023-07-08 08:58:00 +02:00
config.example.h DISABLE_DIAG by default for Uno and Nano 2024-04-07 09:26:32 +02:00
defines.h DISABLE_DIAG by default for Uno and Nano 2024-04-07 09:26:32 +02:00
install_via_powershell.cmd Add exe version 2023-04-11 10:26:15 +10:00
installer.json Frightrisk ver4 (#205) 2022-02-16 12:02:11 -05:00
installer.ps1 Add exe version 2023-04-11 10:26:15 +10:00
installer.sh Do not invoke graphical install on Raspbian 2023-07-06 16:58:36 +02:00
myAutomation.example.h Update myAutomation.example.h 2023-03-18 18:53:48 +00:00
myEX-Turntable.example.h Add myEX-Turntable.example.h 2022-08-14 07:11:38 +10:00
myHal.cpp.txt Add FLAGS device for EX-RAIL state communications. Improve VPIN display in messages. 2023-03-27 12:39:11 +01:00
myHal.cpp_example.txt Rotary Encoder address 0x67 2024-03-23 13:31:34 +10:00
objdump.bat smaller random 2022-06-18 13:58:46 +01:00
objdump.sh fix objdump.sh 2020-09-26 22:28:29 +02:00
platformio.ini get it into nano and uno again 2024-02-11 23:19:51 +01:00
release_notes.md Update release_notes.md 2022-02-17 15:00:59 -05:00
version.h ONBUTTON/ONSENSOR use latch 2024-04-13 10:16:26 +01:00

README.md

What is DCC++ EX?

DCC++ EX is the organization maintaining several codebases that together represent a fully open source DCC system. Currently, this includes the following:

  • CommandStation-EX - the latest take on the DCC++ command station for controlling your trains. Runs on an Arduino board, and includes advanced features such as a WiThrottle server implementation, turnout operation, general purpose inputs and outputs (I/O), and JMRI integration.
  • exWebThrottle - a simple web based controller for your DCC++ command station.
  • BaseStation-installer - an installer executable that takes care of downloading and installing DCC++ firmware onto your hardware setup.
  • BaseStation-Classic - the original DCC++ software, packaged in a stable release. No active development, bug fixes only.

A basic DCC++ EX hardware setup can use easy to find, widely avalable Arduino boards that you can assemble yourself.

Both CommandStation-EX and BaseStation-Classic support much of the NMRA Digital Command Control (DCC) standards, including:

  • simultaneous control of multiple locomotives
  • 2-byte and 4-byte locomotive addressing
  • 28 or 128-step speed throttling
  • Activate/de-activate all accessory function addresses 0-2048
  • Control of all cab functions F0-F28 and F29-F68
  • Main Track: Write configuration variable bytes and set/clear specific configuration variable (CV) bits (aka Programming on Main or POM)
  • Programming Track: Same as the main track with the addition of reading configuration variable bytes
  • And many more custom features. see What's new in CommandStation-EX?

Whats in this Repository?

This repository, CommandStation-EX, contains a complete DCC++ EX Commmand Station sketch designed for compiling and uploading into an Arduino Uno, Mega, or Nano.

To utilize this sketch, you can use the following:

  1. (beginner) our automated installer
  2. (intermediate) download the latest version from the releases page
  3. (advanced) use git clone on this repository

Not using the installer? Open the file "CommandStation-EX.ino" in the Arduino IDE. Please do not rename the folder containing the sketch code, nor add any files in that folder. The Arduino IDE relies on the structure and name of the folder to properly display and compile the code. Rename or copy config.example.h to config.h. If you do not have the standard setup, you must edit config.h according to the help texts in config.h.

What's new in CommandStation-EX?

  • WiThrottle server built in. Connect Engine Driver or WiThrottle clients directly to your Command Station (or through JMRI as before)
  • WiFi and Ethernet shield support
  • No more jumpers or soldering!
  • Direct support for all the most popular motor control boards including single pin (Arduino) or dual pin (IBT_2) type PWM inputs without the need for an adapter circuit
  • I2C Display support (LCD and OLED)
  • Improved short circuit detection and automatic reset from an overload
  • Current reading, sensing and ACK detection settings in milliAmps instead of just pin readings
  • Improved adherence to the NMRA DCC specification
  • Complete support for all the old commands and front ends like JMRI
  • Railcom cutout (beta)
  • Simpler, modular, faster code with an API Library for developers for easy expansion
  • New features and functions in JMRI
  • Ability to join MAIN and PROG tracks into one MAIN track to run your locos
  • "Drive-Away" feature - Throttles with support, like Engine Driver, can allow a loco to be programmed on a usable, electrically isolated programming track and then drive off onto the main track
  • Diagnostic commands to test decoders that aren't reading or writing correctly
  • Support for Uno, Nano, Mega, Nano Every and Teensy microcontrollers
  • User Functions: Filter regular commands (like a turnout or output command) and pass it to your own function or accessory
  • Support for LCN (layout control nodes)
  • mySetup.h file that acts like an Autoexec.Bat command to send startup commands to the CS
  • High Accuracty Waveform option for rock steady DCC signals
  • New current response outputs current in mA, overlimit current, and maximum board capable current. Support for new current meter in JMRI
  • USB Browser based EX-WebThrottle
  • New, simpler, function control command
  • Number of locos discovery command <#>
  • Emergency stop command <!>
  • Release cabs from memory command <-> all cabs, <- CAB> for just one loco address
  • Automatic slot (register) management
  • Automation (coming soon)

NOTE: DCC-EX is a major rewrite to the code. We started over and rebuilt it from the ground up! For what that means, you can read HERE.

More information

You can learn more at the DCC++ EX website

  • November 14, 2020