RACELINK
Quickstart · Node button

One button.
Three modes.

The user button on every RaceLink node does different things depending on what the node is paired with. Pick the section that matches your setup — every row shows the gesture, what the LEDs do, and why.

Mode 1 · Default

Gateway + Host setup

Paired with a host. The master is talking on the channel — the master-quiet gate is closed, so local gestures that would fight the host are silenced.

Single click ≤ 0.6 s

Gated. No reaction — the master owns this node's state. The gesture only fires after 60 s of master silence.

Triple click 3× rapid

AP opens. Always — this gesture ignores the quiet gate. Connect to WLED-AP to recover or reconfigure the node.

5-click 5× rapid

Probe rejected. Red strobe for 5 s — the gateway answered the headless probe, so this node stays as a slave.

Long press ≥ 0.6 s hold

Gated. No brightness fade — the host owns brightness in this mode.

Mode 2 · No host needed

Headless master

This node is the broadcast master. It pairs in unconfigured peers, sends scenes, and persists across reboot until you exit explicitly.

Single click ≤ 0.6 s

Next scene. Picks the next catalog scene and broadcasts it to the fleet — per-group offsets and flags are preserved.

Triple click 3× rapid

AP opens. Push presets or change config without leaving headless mode.

5-click 5× rapid

Exit headless. Amber strobe for 5 s — slaves are released, persistence cleared.

Long press ≥ 0.6 s hold

Brightness fade. Ping-pongs up and down while held; on release the final value is broadcast to the fleet once and persisted across reboot.

Mode 3 · Solo

Standalone

Solo node. No master, no paired host — either fresh out of the box, or the master has been quiet for ≥ 60 s.

Single click ≤ 0.6 s

Colour cycle. Steps red → green → blue → random with each click. Idles back to red after 10 s.

Triple click 3× rapid

AP opens. Initial setup or recovery — the node exposes its AP so you can reach the WLED UI.

5-click 5× rapid

Becomes headless master. Cyan strobe for 5 s — the probe found no master, this node is promoted and persists across reboot.

Long press ≥ 0.6 s hold

Brightness fade (local). Ping-pongs up and down; on release the final value is saved locally. No fleet broadcast.

Master-quiet gate. Single-click colour cycling and long-press brightness fading only fire when no master has spoken to this node for 60 s. Triple-click AP recovery always works.

Double-click and 4× or 6+ clicks are reserved typo guards — no action.

Going deeper

Full operator guide

The complete protocol, setup walkthroughs and developer reference live in the documentation.

Open the docs Hardware How it works