DialThrottle

Dial Throttle

An M5Stack Dial handheld throttle for JMRI WiThrottle and LCC layouts.

BoardM5Stack DialESP32-S3
ProtocolsWiThrottle · LCC
Throttle4–16 notchesspeed steps 0–126
InputDial · touch · keypadRFID loco select
The assembled throttle in its printed case: an M5Stack Dial with an orange knob above a twelve-key Qwiic keypad. The screen shows loco S3 at speed 24, notch 5 of 8, running forward.
Idle, no locoHalf-step between notchesRamping to notch 5Full speed
idlehalf steprampingfull
ReverseE-Stop latchedBattery gaugeSettings menu
reverseestopbatterysettings

What it does

  • Connects to your WiFi network and to a JMRI WiThrottle server (default port 12090), or to an LCC GridConnect server as a real OpenLCB node.
  • Uses the dial as a notched throttle with momentum. You choose 4, 8, 12 or 16 notches, and speed runs over steps 0..126.
  • Caps reverse at half the notches by default, so the dial only reaches half speed backwards.
  • Brakes while you hold the touchscreen. A press of the dial button stops the loco, or reverses it when already stopped.
  • Adds function, turnout and loco-select keys through a SparkFun Qwiic keypad.
  • Selects a loco by RFID tag, looked up in a MySQL table, a local map, or the tag UID itself.
  • Saves power on battery by dimming, turning the display off, suspending WiFi and finally powering off, but never while the train is moving.
  • Keeps WiFi, server and throttle settings in flash, editable on the device.

Where to go next

PageCovers
Getting startedHardware, wiring, building and flashing
Parts listWhat to order, with Digi-Key numbers
Using the throttleDial controls, keypad, settings menu
ProtocolsWiThrottle and LCC details
Power and batteryIdle tiers, battery gauge and charge detection
RFIDTag lookup and the MySQL table
Serial consoleDebug commands and screenshots
TroubleshootingJMRI setup and common problems