/companion-module-dcc-ex-commandstation

A bitfocus companion module for model railway control using DCC++EX CommandStation-EX version 3

MIT LicenseMIT

companion-module-dcc-ex-commandstation

A bitfocus companion module for model railway control using DCC.

This module will allow you to control a DCC++EX CommandStation-EX from StreamDeck hardware controllers by making use of Bitfocus Companion. This combination makes it very easy to make a dynamic and fully customisable push-button DCC controller. It is similar in concept to web/app throttles but uses a relatively cheap hardware interface. Any button can send one or more commands to the CommandStation-EX. Buttons can be arranged in multiple pages, allowing for example one page for each loco.

Requirements

Updated 2nd May 2021: Companion now includes the DCC++EX module in the beta so there is no longer any need to install Companion from source.

  • CommandStation-EX running on Arduino Mega with motor shield and WiFi
  • Track power and external PSU wired to motor shield
  • PC/Mac/Linux/Pi computer running Companion version 2.2.0-6e48e317-3282 or later
  • Network connection between CommandStationEX and Companion (both on same LAN)
  • An instance of the DCC++EX module running in Companion
    • Enter the IP address of the Arduino running CommandStation (Example)
  • StreamDeck controller connected to Companion PC USB port
  • Desktop or laptop to view Companion web interface for setup
    • Using a web browser connect to Companion on port 8000
  • JMRI for programming of DCC decoders

Companion Configuration

When the system is up and running it is very easy to create and configure StreamDeck buttons in the Companion web interface.

Example StreamDeck Pages

The StreamDeck is completely configurable. Buttons can have any number of DCC commands assigned and can be set to latch. The button colour and text are also configurable.

Homepage

Buttons to control track power, emergency stop and to put all locos in idle. The power and stop buttons are latching. Any loco can be moved forward or backwards at speed 1. PNG images can be added to buttons too!

Loco Page

For each loco a range of speeds are available along with lighting control. This page controls loco 31110. Up and Down buttons move between pages.

Comments and Issues

Please open an issue if you have any problems or suggestions.

Updates

As the code for this module is now bundled with Companion it is held in a different Repo, please head here if you wish to access the code.