-
Notifications
You must be signed in to change notification settings - Fork 3
V1 Receiver Build Guide User Manual
TODO.
Incomplete, but will cover high level points
- Dont grab or otherwise move a v1 receiver by the antenna. The antennas, while each is custom-tuned and performant, are inherently cheap and will break if handled aggressively. Later iterations will use nicer antennas, and if you want to use a different one, go for it - The mount is an SMA (Not RP-SMA)
- Don't submerge in water. It won't like that.
A receiver charges over USB-C, requiring a USB-PD enabled charger that can support 12v charging. Your little wall wart likely won't have PD charging, but any fast charger or 'nicer' charger will be able to. When charging, the diffused light by the charging port will light up red. When fully charged, it will be green.
This version requires a specific antenna that is connected directly to the board. It's much easier to replace or remove the antenna if the top is removed. The battery is very snug against the bottom of the antenna.
The 3 lights on a v9+ receiver board will fade in/out 3 different times to show 3 different things: 1- The version number 2- The battery % (Red=0, green=100 and a gradient in between) 3- The Receiver ID
For 2 and 3 each digit is represented by one of the lights with the following legend: // 0 red 1 blue 2 yellow 3 green 4 purple // 5 cyan 6 orange 7 white 8 pink 9 lime So a receiver running v21 firmware, charged 100 % with the label of RX128 would start with:
- Fade Red, Yellow, Blue (version)
- Fade Green (100% battery)
- Fade Blue, Yellow, Pink (128)
The receiver has 3 small status LEDs (LED 0, LED 1, LED 2). During normal operation they mean:
| LED | Meaning | Pattern / Color |
|---|---|---|
| LED 0 | Radio activity | Flashes white when a message is received from the dongle, then fades out over ~1.5s. Off means no recent message. |
| LED 1 | Sync / battery / running state | When idle, briefly flashes every ~2s in the current battery color. Longer flash means the receiver is start-ready. Solid purple means a show is actively playing. |
| LED 2 | Show/load state | Orange = show load in progress. Cyan = show loaded but not start-ready. Magenta = show is playing but waiting for scheduled start time. White = show is actively running. Off = no active show state. |
When battery color is shown, it fades from:
- Red / orange = lower battery
- Yellow = mid battery
- Green = higher battery
On power-up, the status LEDs show three short displays:
- Firmware version as three colored digits.
- Battery level: 1, 2, or 3 LEDs lit, colored by battery level.
- Receiver
NODE_IDas three colored digits.
Digit colors:
| Digit | Color |
|---|---|
| 0 | Red |
| 1 | Blue |
| 2 | Yellow |
| 3 | Green |
| 4 | Purple |
| 5 | Cyan |
| 6 | Orange |
| 7 | White |
| 8 | Pink |
| 9 | Lime |
- Slow magenta breathing on all 3 LEDs: receiver is unprovisioned (
NODE_ID == 0) and needs identity setup. - Slow dim white breathing on all 3 LEDs: receiver firmware OTA update in progress.
- Green breathing during OTA: OTA completed and receiver is about to reboot.
Getting started
- Overview
- Desktop installers (macOS / Windows)
- macOS
- Linux
- Windows
- Production vs Development
- Connecting the dongle
- Flash a receiver
- Flash a dongle
- OTA flashing
Raspberry Pi
System overview
Subsystems
Hardware
- Receiver firmware
- Dongle firmware
- RF protocol
- Contributor Portal — BOMs, schematics, and board resources
UI walkthrough
Reference
Downloads
- Firmware
- Installers
Module Build & User Guides
- Cue
- Receiver
- Dongle