1
0
mirror of https://github.com/DCC-EX/CommandStation-EX.git synced 2024-12-27 06:11:25 +01:00
Go to file
2022-08-09 15:03:22 +08:00
.github Update FUNDING.yml 2022-03-29 11:59:40 -04:00
.vscode Frightrisk ver4 (#205) 2022-02-16 12:02:11 -05:00
Release - Architecture Doc Remove obsolete docs 2021-08-04 08:54:29 +01:00
Release_Notes Merge branch 'ThrottleInfo' into TrackManager 2022-04-12 23:16:41 +01:00
.gitattributes do not touch CR or CRLF of svg files 2020-11-26 15:55:52 +01:00
.gitignore Privatize HAL constructors 2022-06-14 15:23:27 +01:00
.travis.yml Initial commit 2020-05-25 01:43:34 -06:00
CommandDistributor.cpp implement Withrottle client handles to remember clients over reconnects 2022-08-07 20:12:42 +02:00
CommandDistributor.h Command Distributor 2022-06-10 12:22:28 +01:00
CommandStation-EX.ino extra catch for buggy compiler/preprocessor 2022-08-03 09:31:03 +02:00
config.example.h pin assignment for uno form factor board 2022-07-30 21:33:25 +02:00
CONTRIBUTING.md Create CONTRIBUTING.md 2020-12-08 07:34:59 -05:00
DCC.cpp alternate implementation of DCC::issueReminders() 2022-08-07 20:05:40 +02:00
DCC.h clean up getThrottleSpeed functions 2022-06-05 23:07:03 +02:00
DCCACK.cpp take into account that the reset packets are sent first #repeat packets into the future 2022-08-04 09:50:20 +02:00
DCCACK.h rename FAIL to CALLFAIL because of conflict in ESP32 IDE 2022-03-04 23:35:14 +01:00
DCCEX.h ESP32 wifi added to startup and loop 2022-07-31 08:49:12 +02:00
DCCEXParser.cpp check M command against max DCC packet size 2022-08-05 15:15:42 +02:00
DCCEXParser.h Parse strings with more than one command (<s><Q>) correct 2022-05-13 16:18:47 +02:00
DCCRMT.cpp size send buffer for RMT channel including DCC checksum byte 2022-08-05 15:16:43 +02:00
DCCRMT.h ESP32 RMT pin add function 2022-08-04 01:19:11 +02:00
DCCTimer.h Teensy build support, STM32F411RE first beta 2022-08-06 16:53:14 +08:00
DCCTimerAVR.cpp DCCTimer::reset 2022-07-08 15:01:40 +01:00
DCCTimerESP.cpp compiles (but no waveform) on ESP32 2022-07-30 23:02:26 +02:00
DCCTimerMEGAAVR.cpp DCCTimer::reset 2022-07-08 15:01:40 +01:00
DCCTimerSAMD.cpp DCCTimer::reset 2022-07-08 15:01:40 +01:00
DCCTimerSTM32.cpp STM32F411 fix to DCC period 2022-08-09 12:28:15 +08:00
DCCTimerTEENSY.cpp Update TEENSY copyright 2022-08-09 14:57:33 +08:00
DCCWaveform.cpp take into account that the reset packets are sent first #repeat packets into the future 2022-08-04 09:50:20 +02:00
DCCWaveform.h take into account that the reset packets are sent first #repeat packets into the future 2022-08-04 09:50:20 +02:00
defines.h SAMD21 I2C native interrupt capable driver 2022-08-06 17:51:13 +08:00
DIAG.h update copyright notes 2022-01-07 02:28:35 +01:00
DisplayInterface.cpp update copyright notes 2022-01-07 02:28:35 +01:00
DisplayInterface.h update copyright notes 2022-01-07 02:28:35 +01: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
EthernetInterface.cpp loop over WiThrottle so that broadcast commands get into outbound ring and get sent 2022-08-06 00:34:35 +02:00
EthernetInterface.h add ESP defines 2022-03-04 23:37:27 +01:00
EXRAIL2.cpp smaller random 2022-06-18 13:58:46 +01:00
EXRAIL2.h Signal fixes and DCC_SIGNAL/VIRTUAL_SIGNAL 2022-06-18 12:31:54 +01:00
EXRAIL2MacroReset.h Signal fixes and DCC_SIGNAL/VIRTUAL_SIGNAL 2022-06-18 12:31:54 +01:00
EXRAIL.h Rename RMFT files and references to EXRAIL (#201) 2022-01-30 12:31:26 -05:00
EXRAILMacros.h Signal fixes and DCC_SIGNAL/VIRTUAL_SIGNAL 2022-06-18 12:31:54 +01:00
FSH.h Copyright addition 2022-08-09 15:03:22 +08:00
GITHUB_SHA.h eliminate wrong ringread due to peek (eliminated peek as well) - new version 2022-08-08 13:00:53 +02:00
I2CManager_AVR.h I2CManager - support slower I2C speeds. 2021-10-08 13:28:43 +01:00
I2CManager_Mega4809.h I2C code corrections 2022-04-16 23:35:58 +01:00
I2CManager_NonBlocking.h SAMD21 I2C native interrupt capable driver 2022-08-06 17:51:13 +08:00
I2CManager_SAMD.h SAMD21 I2C native interrupt capable driver 2022-08-06 17:51:13 +08:00
I2CManager_Wire.h fix compiler Werror 2022-07-30 10:40:45 +02:00
I2CManager.cpp SAMD21 I2C native interrupt capable driver 2022-08-06 17:51:13 +08:00
I2CManager.h Copyright addition 2022-08-09 15:03:22 +08:00
installer.json Frightrisk ver4 (#205) 2022-02-16 12:02:11 -05:00
IO_AnalogueInputs.h I2C overlap checks (working but messy) 2022-06-14 17:21:11 +01:00
IO_DCCAccessory.cpp HAL catch pin overlaps 2022-06-14 15:15:42 +01:00
IO_DFPlayer.h Privatize HAL constructors 2022-06-14 15:23:27 +01:00
IO_ExampleSerial.cpp HAL catch pin overlaps 2022-06-14 15:15:42 +01:00
IO_ExampleSerial.h Privatize HAL constructors 2022-06-14 15:23:27 +01:00
IO_GPIOBase.h I2C address checks cleaned up 2022-06-14 17:35:29 +01:00
IO_HCSR04.h HAL minor simplification 2022-06-14 17:50:57 +01:00
IO_MCP23008.h Copyright addition 2022-08-09 15:03:22 +08:00
IO_MCP23017.h I2C overlap checks (working but messy) 2022-06-14 17:21:11 +01:00
IO_PCA9685.cpp I2C overlap checks (working but messy) 2022-06-14 17:21:11 +01:00
IO_PCF8574.h Copyright addition 2022-08-09 15:03:22 +08:00
IO_VL53L0X.h I2C overlap checks (working but messy) 2022-06-14 17:21:11 +01:00
IODevice.cpp Implement HAL macro in exrail 2022-06-15 11:44:46 +01:00
IODevice.h HAL minor simplification 2022-06-14 17:50:57 +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 Incoming LCN turnout throw. 2022-03-31 15:46:50 +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 Neil bugfixes. (#186) 2021-08-26 23:04:13 +01:00
LiquidCrystal_I2C.h Neil bugfixes. (#186) 2021-08-26 23:04:13 +01:00
MotorDriver.cpp Teensy build support, STM32F411RE first beta 2022-08-06 16:53:14 +08:00
MotorDriver.h Teensy build support, STM32F411RE first beta 2022-08-06 16:53:14 +08:00
MotorDrivers.h approx conversion factor for 12bit ADC of ESP32 2022-08-02 21:46:00 +02:00
myAutomation.example.h Remove EXRAIL/ENDEXRAIL from myAutomation.example.h (#215) 2022-03-06 10:07:44 -05:00
myHal.cpp_example.txt balance if/endif 2022-01-05 01:23:36 +01: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
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
platformio.ini STM32F411 fix to DCC period 2022-08-09 12:28:15 +08:00
README.md README.md: dead link to rewrite (#217) 2022-03-24 11:37:29 -04:00
release_notes.md Update release_notes.md 2022-02-17 15:00:59 -05:00
RingStream.cpp Revert "add RinStream::peek()" 2022-07-31 09:23:02 +02:00
RingStream.h repair peek 2022-07-31 10:41:27 +02:00
Sensors.cpp update copyright notes 2022-01-07 02:28:35 +01:00
Sensors.h update copyright notes 2022-01-07 02:28:35 +01:00
SerialManager.cpp Serial/SerialUSB cleanup 2022-07-08 15:52:46 +01:00
SerialManager.h Command Distributor 2022-06-10 12:22:28 +01:00
SSD1306Ascii.cpp define GETFLASHP for pointers 2022-07-30 15:32:02 +02:00
SSD1306Ascii.h Simplify OLED driver initialisation. 2021-11-24 12:53:03 +00:00
StringBuffer.cpp Command Distributor 2022-06-10 12:22:28 +01:00
StringBuffer.h Command Distributor 2022-06-10 12:22:28 +01:00
StringFormatter.cpp disable ringstream read from flash 2022-07-31 10:42:03 +02:00
StringFormatter.h Serial/SerialUSB cleanup 2022-07-08 15:52:46 +01:00
TrackManager.cpp Adopt setTrackMode to RMT channel pins 2022-08-04 01:21:28 +02:00
TrackManager.h idle waveform through RMT 2022-08-01 22:56:56 +02:00
Turnouts.cpp rename all RMFT_ACTIVE to EXTAIL_ACTVE 2022-01-31 03:00:29 +01:00
Turnouts.h better bugfix for bitfield in turnout struct 2022-05-07 08:47:34 +02:00
version.h version update 2022-08-02 21:56:06 +02:00
WifiESP32.cpp eliminate wrong ringread due to peek (eliminated peek as well) - new version 2022-08-08 13:00:53 +02:00
WifiESP32.h first ESP32 compile 2021-10-05 10:39:08 +02:00
WifiInboundHandler.cpp update copyright notes 2022-01-07 02:28:35 +01:00
WifiInboundHandler.h update copyright notes 2022-01-07 02:28:35 +01:00
WifiInterface.cpp make service start to be outside the DONT_TOUCH_WIFI_CONF area 2022-08-01 09:47:29 +02:00
WifiInterface.h add ESP defines 2022-03-04 23:37:27 +01:00
WiThrottle.cpp implement Withrottle client handles to remember clients over reconnects 2022-08-07 20:12:42 +02:00
WiThrottle.h implement Withrottle client handles to remember clients over reconnects 2022-08-07 20:12:42 +02: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 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