RAD Developer Docs
RADRHardwareSpecifications

Feedback and Indicators

LED colors, buzzer sounds, and vibration patterns for RADR

RADR provides visual, audio, and haptic feedback to communicate device state without requiring you to look at the screen.

LED System

RADR has three RGB LEDs (WS2812B) positioned around the device:

PositionLocationPrimary Purpose
LED 0Left encoderSpeed mode indicator
LED 1MiddleConnection/play state
LED 2Right encoderActive mode indicator

LED Colors and Meanings

System States

StateLEDColorHSV ValueBrightness
Searching/ScanningAllBlue150255 (pulsing)
Idle (Main Menu)AllSoft White18050
Device ConnectedMiddleWhite50
Paused/StoppedMiddleRed255

OSSM Control Modes

When controlling an OSSM, the encoder LEDs indicate the active mode:

ModeLEDColorDescription
SpeedLeftPurpleAlways active (speed is always controlled by left encoder)
DepthRightCoral/RedRight encoder is adjusting depth
SensationRightBlueRight encoder is adjusting sensation
StrokeRightGreenRight encoder is adjusting stroke

LED Behavior Patterns

PatternMeaning
SolidStatic state (connected, paused, etc.)
PulsingActive scan or searching
Quick flashFeedback for button press or mode change

Buzzer Patterns

RADR uses a piezoelectric buzzer (GPIO 2) to provide audio feedback for key events.

Boot Sound

Pattern: 4-note ascending sequence

NoteFrequencyDuration
1523 Hz (C5)100ms
2659 Hz (E5)100ms
3784 Hz (G5)100ms
41047 Hz (C6)150ms

Played when RADR powers on.

Shutdown Sound

Pattern: 4-note descending sequence

NoteFrequencyDuration
11047 Hz (C6)100ms
2784 Hz (G5)100ms
3659 Hz (E5)100ms
4523 Hz (C5)150ms

Played when entering sleep mode.

Device Connected

Pattern: 3-note ascending sequence

NoteFrequencyDuration
11047 Hz (C6)80ms
21319 Hz (E6)80ms
31568 Hz (G6)120ms

Played when successfully connecting to a device.

Device Disconnected

Pattern: 3-note descending sequence

NoteFrequencyDuration
11568 Hz (G6)80ms
21319 Hz (E6)80ms
31047 Hz (C6)120ms

Played when a device disconnects.

Paused

Pattern: Double beep

NoteFrequencyDuration
1800 Hz150ms
Gap100ms
2800 Hz150ms

Played when pausing playback.

Play/Resume

Pattern: Two-tone ascending

NoteFrequencyDuration
11200 Hz100ms
21400 Hz100ms

Played when resuming playback.

Mario Coin (Easter Egg)

Pattern: Classic coin sound

NoteFrequencyDuration
12637 Hz (E7)80ms
23136 Hz (G7)300ms

Special feedback for certain interactions.

Vibration Feedback

RADR includes a vibration motor (GPIO 47) for haptic feedback. Vibration patterns generally mirror buzzer patterns, providing tactile feedback that works without sound.

Vibration Use Cases

EventVibration
Button pressShort pulse
Mode changeQuick vibration
ConnectionDouble vibration
Pause/StopStrong vibration

Vibration Pattern Timings

PatternDescriptionPulse Durations (ms)
Single PulseQuick tap feedback50
Double PulseConfirmation feedback50, pause 200, 50
Triple PulseStrong confirmation10, pause 50, 20, pause 50, 30
Error PulseLong error indication500
ShutdownDescending pulses150, 100, 100, 100
Device ConnectedAscending pulses100, 100, 150
Device DisconnectedDescending pulses150, 100, 100
PausedDouble pulse150, 150
Play/ResumeQuick double pulse100, 100

Vibration feedback helps you operate RADR by feel, especially useful in low-light or when the device is out of direct view.

UI Color Scheme

RADR's display uses a consistent color scheme:

Background Colors

ElementColor CodeDescription
Background0x10c5Dark gray (Gray 900)
Text BackgroundWhitePrimary text color
Secondary Text0xDEFBLight gray
Disabled0x1082Very dark gray

OSSM Mode Colors

ModeColor CodeColor Name
Speed0x5013Royal Purple
Depth0xE186Warm Coral
Sensation0x3C9FOcean Blue
Stroke0x4E8AForest Green

State Colors

StateColor
Active/NormalWhite
Paused/StoppedRed
DisabledDark Gray
Selected/HighlightedAccent colors

Feedback Timing

EventResponse Time
Button press< 10ms
Encoder change< 10ms
Mode switch< 50ms
LED color change< 20ms

Tips for Using Feedback

Learn the buzzer sounds to operate RADR without looking. The connected sound (ascending) vs disconnected sound (descending) clearly indicates state.

The left LED (purple for speed) and right LED (mode color) tell you which parameter each encoder controls at a glance.

Red middle LED always means paused or stopped. White means active and ready.

On this page