mirror of
https://github.com/DCC-EX/CommandStation-EX.git
synced 2024-12-24 13:21:23 +01:00
1cc147cc98
Prevent loop2 from doing anything when lcdDisplay not set up. If there's a display configured but not one attached, then the OLED code will set lcdDisplay to null and no display will be configured or used by the loop() function. However, because of the way the initialisation code works, loop2() is called during initialisation. |
||
|---|---|---|
| .github/workflows | ||
| .vscode | ||
| Release - Architecture Doc | ||
| .gitattributes | ||
| .gitignore | ||
| .travis.yml | ||
| CommandDistributor.cpp | ||
| CommandDistributor.h | ||
| CommandStation-EX.ino | ||
| config.example.h | ||
| CONTRIBUTING.md | ||
| DCC.cpp | ||
| DCC.h | ||
| DCCEX.h | ||
| DCCEXParser.cpp | ||
| DCCEXParser.h | ||
| DCCTimer.cpp | ||
| DCCTimer.h | ||
| DCCWaveform.cpp | ||
| DCCWaveform.h | ||
| defines.h | ||
| DIAG.h | ||
| EEStore.cpp | ||
| EEStore.h | ||
| EthernetInterface.cpp | ||
| EthernetInterface.h | ||
| freeMemory.cpp | ||
| freeMemory.h | ||
| FSH.h | ||
| GITHUB_SHA.h | ||
| I2CManager.cpp | ||
| I2CManager.h | ||
| LCD_Implementation.h | ||
| LCD_LCD.h | ||
| LCD_NONE.h | ||
| LCD_OLED.h | ||
| LCDDisplay.cpp | ||
| LCDDisplay.h | ||
| LICENSE | ||
| LiquidCrystal_I2C.cpp | ||
| LiquidCrystal_I2C.h | ||
| MotorDriver.cpp | ||
| MotorDriver.h | ||
| MotorDrivers.h | ||
| objdump.bat | ||
| objdump.sh | ||
| Outputs.cpp | ||
| Outputs.h | ||
| platformio.ini | ||
| PWMServoDriver.cpp | ||
| PWMServoDriver.h | ||
| README.md | ||
| release_notes.md | ||
| RingStream.cpp | ||
| RingStream.h | ||
| Sensors.cpp | ||
| Sensors.h | ||
| SSD1306Ascii.cpp | ||
| SSD1306Ascii.h | ||
| SSD1306font.h | ||
| SSD1306init.h | ||
| StringFormatter.cpp | ||
| StringFormatter.h | ||
| Turnouts.cpp | ||
| Turnouts.h | ||
| version.h | ||
| WifiInboundHandler.cpp | ||
| WifiInboundHandler.h | ||
| WifiInterface.cpp | ||
| WifiInterface.h | ||
| WiThrottle.cpp | ||
| WiThrottle.h | ||
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
- 128-step speed throttling
- Activate/de-activate all accessory function addresses 0-2048
- Control of all cab functions F0-F28
- 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
What’s 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:
- (beginner) our automated installer
- (intermediate) download the latest version from the releases page
- (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
- WiFi and Ethernet shield support
- No more jumpers or soldering!
- Direct support for all the most popular motor control boards
- I2C Display support
- 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
- 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