System
Boot tone
Played once after self-check reaches a runnable state.
RecommendedShort upward phrase that says the device is awake.
AlternateA softer two-note boot acknowledgement.
Buzzer Audio Preview
Buzzer Audio Preview
This page migrates the original tools/buzzer_audio_preview/ workbench into the
documentation site. It keeps the same timing table used by the firmware cue design, but presents it
with the docs-site theme and bilingual navigation.
Use it to compare cue shape, rhythm, and priority before touching firmware constants. The browser generates square waves with Web Audio; firmware still owns the final GPIO7 LEDC playback path.
GPIO7 PWM buzzer
Buzzer audio workbench
Audition the passive-buzzer cues used by firmware. The page uses browser Web Audio square waves and keeps the source timing visible for review.
13audible events
2two candidates each
GPIO7PWM
squarewaveform, 3ms fade
Click any play button to unlock browser audio output.
Front-panel input
Operation cue
Played when a button press actually performs an operation.
RecommendedQuick confirmation that does not compete with alarms.
AlternateSingle crisp short note.
Front-panel input
Operation denied tone
Played when a button action is rejected by safety policy.
RecommendedFalling double note, clear but not harsh.
AlternateShort double pulse, more forceful.
Port power
Port power-on tone
Played when a port output changes from disabled to enabled.
RecommendedShort rising phrase, distinct from the boot tone.
AlternateSingle high note with more action.
Port power
Port power-off tone
Played when a port output changes from enabled to disabled.
RecommendedShort falling phrase paired with the power-on tone.
AlternateLower single note for disconnect.
Continuous alarms
Over-temperature alarm
Loops with a short gap until the over-temperature condition clears.
RecommendedThree mid-high notes, persistent but distinct from short-circuit.
AlternateHigh-low sweep to indicate thermal protection.
Continuous alarms
Input over-power alarm
Loops with a short gap until input power returns to a safe envelope.
RecommendedTwo equal pulses to communicate total input pressure.
AlternateShort descending phrase with a more severe feel.
Continuous alarms
Port short-circuit alarm
Loops with a short gap when a port has very low voltage and high current.
RecommendedFast low double pulse, highest urgency.
AlternateHarder repeated low note.
Interval alarms
Port current above 5 A
Loops with a long gap when a port remains above 5 A; lower priority than fault alarms.
RecommendedTwo notes per cycle with a long reminder gap.
AlternateSingle brief marker, least intrusive.
Port hints
Current reached 3 A
Played once when a port first crosses the 3 A current threshold.
RecommendedLight notification, not alarm-like.
AlternateSingle mid-high note.
Port hints
Current reached 5 A
Played once when a port first crosses 5 A; sustained current then becomes an interval alarm.
RecommendedClearer than 3 A, but not a fault alarm.
AlternateMore noticeable high double-tap.
Port hints
Insert hint
Played once when a port voltage rises past 3.3 V.
RecommendedBright single rise.
AlternateVery short attach cue.
Port hints
Remove hint
Played once when a port voltage falls below 3 V.
RecommendedShort falling phrase paired with insert.
AlternateLower-intensity offline cue.
Rules Carried Into Firmware
- Undefined or no-op input events stay silent.
- One-shot cues are below active alarm priority.
- Continuous alarms loop until the matching protection condition clears.
- Score JSON, MIDI, and WAV review assets are generated by
tools/buzzer_audio_preview/generate_assets.py; runtime firmware does not read web assets.
References
docs/specs/7gf6b-firmware-buzzer-audio/SPEC.mddocs/software_design.mdtools/buzzer_audio_preview/README.md