1
0
mirror of https://github.com/DCC-EX/CommandStation-EX.git synced 2024-11-27 01:56:14 +01:00
Go to file
Neil McKechnie 08cfe41cf3 Revert to original DCC++ Classic Turnout command polarity.
Revert to <T id 1> command being 'throw' and <T id 0> being 'close', for turnouts.
2021-08-24 22:18:51 +01:00
.github/workflows Update main.yml to use up-to-date pio for builds. 2021-03-31 21:00:07 +01:00
.vscode Add readme add back extensions and settings from Dave and fix gitignore 2020-07-01 09:06:03 -04:00
Release - Architecture Doc Remove obsolete docs 2021-08-04 08:54:29 +01:00
Release_Notes Update release_notes_v3.1.0.md 2021-05-15 22:13:33 -04:00
.gitattributes do not touch CR or CRLF of svg files 2020-11-26 15:55:52 +01:00
.gitignore Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
.travis.yml Initial commit 2020-05-25 01:43:34 -06:00
CommandDistributor.cpp AYSNC prog cmds from Wifi/Ethernet 2021-03-08 10:40:32 +00:00
CommandDistributor.h Passing outbound Ring to Withrottle 2020-10-26 13:31:51 +00:00
CommandStation-EX.ino Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
config.example.h Revert to original DCC++ Classic Turnout command polarity. 2021-08-24 22:18:51 +01:00
CONTRIBUTING.md Create CONTRIBUTING.md 2020-12-08 07:34:59 -05:00
DCC.cpp Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
DCC.h Fix auto rejoin after prog cmd (needs version n umber!) (#148) 2021-05-07 18:24:34 +01:00
DCCEX.h Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
DCCEXParser.cpp Revert to original DCC++ Classic Turnout command polarity. 2021-08-24 22:18:51 +01:00
DCCEXParser.h Revisions to support Teensy 3.x and Teensy 4.x 2021-03-25 13:16:12 -04:00
DCCTimer.cpp Teensy/nanoEvery compiler warnings 2021-04-12 09:18:48 +01:00
DCCTimer.h copyright messages 2021-04-14 22:46:29 +02:00
DCCWaveform.cpp Fix auto rejoin after prog cmd (needs version n umber!) (#148) 2021-05-07 18:24:34 +01:00
DCCWaveform.h Fix auto rejoin after prog cmd (needs version n umber!) (#148) 2021-05-07 18:24:34 +01:00
defines.h Update defines.h 2021-08-23 10:46:12 +01:00
DIAG.h Nano every2 (#129) 2021-03-07 15:58:35 -05:00
DisplayInterface.cpp Refactor OLED and LCD drivers (#178) 2021-07-13 21:15:38 +01:00
DisplayInterface.h Refactor OLED and LCD drivers (#178) 2021-07-13 21:15:38 +01:00
EEStore.cpp Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
EEStore.h Bump EESTORE_ID version. 2021-08-19 20:17:48 +01:00
EthernetInterface.cpp Add loop to retry Ethernet cable connection (#173) 2021-06-10 19:02:20 -04:00
EthernetInterface.h Some additional fixes for typos. 2021-03-30 18:11:22 -04:00
freeMemory.cpp Fix a few bugs as a result of latest version 2021-03-25 14:02:33 -04:00
freeMemory.h Memory monitoring updates 2021-03-09 22:43:41 +00:00
FSH.h Merge branch 'master' into copyrightmessages 2021-07-31 15:32:02 +02:00
GITHUB_SHA.h Committing a SHA 2021-07-31 13:41:32 +00:00
I2CManager_AVR.h Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
I2CManager_Mega4809.h Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
I2CManager_NonBlocking.h Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
I2CManager_Wire.h Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
I2CManager.cpp Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
I2CManager.h Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
IO_DCCAccessory.cpp Various HAL enhancements. (#182) 2021-08-17 23:41:34 +01:00
IO_ExampleSerial.cpp Various HAL enhancements. (#182) 2021-08-17 23:41:34 +01:00
IO_ExampleSerial.h Various HAL enhancements. (#182) 2021-08-17 23:41:34 +01:00
IO_GPIOBase.h Various HAL enhancements. (#182) 2021-08-17 23:41:34 +01:00
IO_HCSR04.h Various HAL enhancements. (#182) 2021-08-17 23:41:34 +01:00
IO_MCP23008.h Various HAL enhancements. (#182) 2021-08-17 23:41:34 +01:00
IO_MCP23017.h Various HAL enhancements. (#182) 2021-08-17 23:41:34 +01:00
IO_PCA9685.cpp Turnouts: adjust the split of code between .h and .cpp file. No functional changes. 2021-08-22 22:25:23 +01:00
IO_PCF8574.h Various HAL enhancements. (#182) 2021-08-17 23:41:34 +01:00
IODevice.cpp Enable pullups for Arduino input pins as a default 2021-08-24 22:15:50 +01:00
IODevice.h Improvements to PCA9685 operation 2021-08-21 23:13:34 +01:00
LCD_Implementation.h Refactor OLED and LCD drivers (#178) 2021-07-13 21:15:38 +01:00
LCDDisplay.cpp Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
LCDDisplay.h Changes associated with RCN-213 DCC Accessory Packet format 2021-08-23 12:43:14 +01:00
LCN.cpp Restructure Turnout class. 2021-08-19 21:22:59 +01:00
LCN.h copyright messages 2021-04-14 22:46:29 +02:00
LICENSE Create LICENSE 2020-06-12 22:51:42 -06:00
LiquidCrystal_I2C.cpp Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
LiquidCrystal_I2C.h Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
MotorDriver.cpp Some additional fixes for typos. 2021-03-30 18:11:22 -04:00
MotorDriver.h Final Fix for T4 interrupts 2021-03-30 16:12:47 -04:00
MotorDrivers.h copyright messages 2021-04-14 22:46:29 +02:00
myAutomation.example.h SENDLOCO/START mixup 2021-08-15 17:17:41 +01:00
mySetup.cpp_example.txt Create mySetup.cpp_example.txt 2021-08-23 20:41:30 +01:00
objdump.bat Nano every2 (#129) 2021-03-07 15:58:35 -05:00
objdump.sh fix objdump.sh 2020-09-26 22:28:29 +02:00
Outputs.cpp Fix EEPROM handling for outputs. 2021-08-12 11:59:32 +01:00
Outputs.h Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
platformio.ini Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
README.md Update README.md 2021-05-15 21:37:33 -04:00
release_notes.md Update release_notes.md 2021-05-15 22:12:09 -04:00
RingStream.cpp <* *> wrapped diags 2021-03-25 14:23:38 +00:00
RingStream.h AYSNC prog cmds from Wifi/Ethernet 2021-03-08 10:40:32 +00:00
RMFT.h Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
RMFT2.cpp Merge branch 'EX-RAIL-neil2' into EX-RAIL 2021-08-22 19:36:08 +01:00
RMFT2.h int->int16_t to keep pedantic compilers happy 2021-08-21 13:17:14 +01:00
RMFTMacros.h Deeay long values 2021-08-22 17:01:55 +01:00
Sensors.cpp Various HAL enhancements. (#182) 2021-08-17 23:41:34 +01:00
Sensors.h Various HAL enhancements. (#182) 2021-08-17 23:41:34 +01:00
SSD1306Ascii.cpp Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
SSD1306Ascii.h Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
StringFormatter.cpp 3.0.9 newlines 2021-03-30 22:01:37 +01:00
StringFormatter.h Assorted bits (#138) 2021-03-23 10:37:05 -04:00
Turnouts.cpp Revert to original DCC++ Classic Turnout command polarity. 2021-08-24 22:18:51 +01:00
Turnouts.h Turnouts - make code clearer. 2021-08-23 17:36:50 +01:00
version.h fix version.h of merge 2021-07-31 15:40:32 +02:00
WifiInboundHandler.cpp Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00
WifiInboundHandler.h copyright messages 2021-04-14 22:46:29 +02:00
WifiInterface.cpp Frightrisk hostname fix (#144) 2021-04-27 10:37:54 -04:00
WifiInterface.h Nano every2 (#129) 2021-03-07 15:58:35 -05:00
WiThrottle.cpp Restructure Turnout class. 2021-08-19 21:22:59 +01:00
WiThrottle.h Squash all commits on RMFT branch to create EX-RAIL branch 2021-08-03 17:12:25 -04:00

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 manu 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. All sketch files are in the folder named CommandStation-EX and its subforlders.

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 to you, click HERE.

More information

You can learn more at the DCC++ EX website

  • November 14, 2020