Skip to main content
DEJA.jsDEJA.js
Sign up

Devices

The Devices section is where you register and manage the hardware controllers that make up your layout. Each device represents a physical piece of hardware — a DCC-EX EX-CommandStation, an Arduino Mega, an ESP32, or a Raspberry Pi Pico W — connected to your DEJA Server via USB or WiFi/MQTT.

Devices on the Cloud dashboard

Adding a Device

Click the Add tile to expand the device registration form. Specify:

  • Device ID -- A unique identifier (e.g., commandstation-1, turnout-board-east).
  • Device Type -- One of the supported types:
    • dcc-ex -- DCC-EX EX-CommandStation (USB serial)
    • deja-arduino -- Arduino Mega 2560 IO board (USB serial)
    • deja-esp32 -- ESP32 IO board (USB serial, same sketch as deja-arduino)
    • deja-esp32-wifi -- ESP32 IO board (WiFi + MQTT)
    • deja-mqtt -- Raspberry Pi Pico W IO board (WiFi + MQTT, CircuitPython)
  • Connection -- USB serial or WiFi/MQTT. Auto-defaulted from the device type — deja-esp32-wifi and deja-mqtt default to wifi, everything else to usb.
  • Port -- The serial port path (for USB devices, e.g., /dev/ttyACM0).
  • Topic -- The MQTT topic prefix (for WiFi devices, default DEJA).
  • WiFi / MQTT credentials -- For deja-esp32-wifi and deja-mqtt, surface fields for SSID, password, and broker IP that get baked into the firmware at deploy time.

📟 See Arduino & ESP32 Setup and Pico W Setup for the firmware setup steps for each device type.

Device Details

Click any device card to view its details page. This includes:

  • Connection status -- USB or WiFi, port/topic, and live connected/disconnected indicator.
  • Assigned turnouts -- Table of all turnouts wired to this device with index, name, pins, type, and state.
  • Assigned effects -- Table of all effects on this device with name, type, and pin.
  • WLED scenes -- For WLED-capable devices, a scenes panel (see below).
  • Developer configuration -- Auto-generated configuration snippet for firmware flashing, plus the exact PlatformIO and Arduino CLI commands needed to build and upload, matching what deja deploy runs.

WLED Scenes

WLED-capable devices get a scenes panel on their device detail page. A scene is a saved WLED animation config -- brightness, transition time, and one or more LED segments, each with an effect, palette, colors, speed, and intensity.

  • Save a scene -- Build a segment configuration with the segment editor, name it, and save it as a scene on the device.
  • Activate a scene -- Tap a saved scene to apply it to the physical strip.
  • Power toggle -- Turn the WLED strip on or off independently of which scene is active.
  • Delete a scene -- Remove a saved scene you no longer need.

Scenes are also activated from the Throttle app's WLED tab -- one card per WLED device, with the same power toggle and scene buttons.

Managing Devices

  • Drag to reorder -- Prioritize devices by dragging cards in the list.
  • Connect/disconnect -- Quick-connect buttons on the dashboard with port selection.
  • Reconnect -- One-tap reconnect for devices that lost connection.
  • Refresh ports -- Re-scan for available serial ports.

Related Pages

  • Connect -- Manage live connections between Cloud and your hardware.
  • Layout Configuration -- Tags, ports, modules, and layout metadata.
  • Turnouts -- Assign turnouts to registered devices.
  • Effects -- Assign effects to registered devices.