Skip to main content
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.