WiTcontroller – A WiFi Connected Withrottle Controller

The WiTcontroller is a hand-held throttle that connects to a WiFi DCC-EX CommandStation or any WiThrottle Protocol server. This is entirely based on Peter Aker’s WiTcontroller project which can be found on his GitHub page at https://github.com/flash62au/WiTcontroller

Peter’s design philosophy was to take some relatively inexpensive and easily sourced parts allowing a handheld rechargeable battery powered throttle to be built.

It can connect via WiFi to any WiThrottle protocol server meaning that it can easily connect to a DCC-CommandStation with a WiFi interface. (USB/Bluetooth DCC-EX CommandStations are not supported).

Being WiThrottle compatible it can also connect (via WiFi) to other WiThrottle server capable systems eg. JMRI, (see https://www.jmri.org/help/en/package/jmri/jmrit/withrottle/Protocol.shtml ).

Peter’s design is based on an Expressiff ESP32 microcontroller module, OLED Display, 3×4 Keypad, rechargeable Lithium-Ion Polymer battery and rotary encoder module. Extra push-buttons are also supported in his software and may be used to provide easier access to DCC Functions (eg. Lights, Horn etc) rather than activating these using the keypad/control knob. 

Locomotive speed and direction is controlled by the rotary encoder (white chicken-head knob see above). The keypad is used to allow connection to WiThrottle server SSID’s via menus displayed on the OLED display. In addition the keypad is used to select operations displayed on the OLED display to allow for example adding/deleting loco DCC addresses to the throttles. The 7 colour coded push buttons can be assigned user configurable ‘commands’ allowing them to be used as shortcuts to control for example DCC function codes/ E-Stop command.

After creating a hard-wired prototype to check functionality I took Peter’s basic design and then went on to create a printed circuit board to make building far easier than hard-wiring/breadboarding plus a 3D printed enclosure.

A WiTcontroller controls a Bachmann sound decoder fitted shunter

WiTcontroller Functionality

The WiTcontroller functionality is programmed from a ‘sketch’ which may be loaded into the Arduino IDE (Integrated Development Environment) then downloaded from the IDE (via USB-C cable) into the onboard ESP32 microcontroller.

  • WiFi connection to a suitable WiThrottle Protocol server (eg DCC-EX CommandStation (WiFi fitted), JMRI)
  • Portable rechargeable lithium-ion polymer battery operation
  • Rechargeable from USB-C charger
  • Up to 6 throttles supported, 2 by default
  • Activate any DCC function from 0 to 31
  • Select multiple locos to form a consist
  • Main track power ON/OFF
  • Throw/Close points (throwouts) for first 50 defined by the WiThrottle Server

Note that the software for the WiThrottle is a work in progress at the time of writing this. A more comprehensive list of functionality and Peter’s ‘sketch’ may be found at https://github.com/flash62au/WiTcontroller