DCC Controller allows users to operate model railway systems (which support the DCC protocol) through a desktop GUI application.
The described functionality is achieved by using a 2 part system:
- Java desktop application (DCC Controller)
- Arduino control code arduino/sketch_dcc_controller_v1.
Download 1.0 Release (DCC_Controller.jar)
- Install the device control code for Arduino (arduino/sketch_dcc_controller_v1)
- Open DCC Controller
- Create a new device (
File
→New Device
or use theAdd Device button
) - Open the device detail window (
Open
button from the device list) - Connect the arduino board to your computer and select the corresponding port from DCC Controller (
Tools
→Port
).
You should now be able to control the speed and direction of the device. For more functionality use configurations.
You can extend the functionality of the application by using configuration files.
A configuration file is a comma-separated values (CSV) file with 2 columns: command_display_name
& command
.
In order to import your configuration files, go to File
→ Import
configuration or use the Add configuration
button (device detail window).
For an example configuration file check configuration/default_train.csv.
Column | Description |
---|---|
command_display_name |
The string that will describe the command in the GUI. |
command |
The string that will be interpreted by the Arduino code. * |
* This will be the suffix of the command string. The command structure is the following:
DCC_CTRL:<address>
:<command>
<address>
: (number
) The device address (starts from 0, up to 127). This is set when you create the device.
For the REVERSE & FORWARD commands the following structure is used:
DCC_CTRL:<address>
:<command>
:<arg>
<arg>
: (number
) The speed value (starts from 0, up to 15). This is set by the GUI slider.
- Device List Overview
- Create Device Screen
- Default Device Screen
- Configured Device
This project is MIT licensed. Please see the LICENSE file for more information.