This browser can’t talk to USB devices
The clock is configured over the Web Serial API, which needs Chrome or Edge on desktop (Windows, macOS or Linux). Firefox and Safari do not implement it, and neither do mobile browsers.
The Python tool in software/main.py works everywhere as
an alternative.
Connecting
- Plug the USB-C cable into this computer.
- Press the clock’s button once to wake it. While idle it deep-sleeps and stays detached, so it will not appear in the port list until you do.
-
Press Connect and pick the STM32 serial port
(
0483:5740).
Only one program can hold the port at a time — close
main.py or any serial monitor first.
Light looks
Not read yet.
Button press
A short press toggles the lamp between these two looks. The “off” one can settle on a dim ambient rather than going fully dark.
LED chain
How many LEDs a look is rendered across: the onboard one plus
anything chained from the WS2812B breakout connector.
Test an LED
Lights one LED straight away without storing anything, for checking a strip is wired and the right length. The next look, alarm or lamp press paints over it, and the index has to be inside the chain length above.
Add a light look
Sound slots
Not read yet.
Playback
Playing a slot starts it on the clock straight away, at the volume it was stored with.
Long press
A long press on the button plays this sound. An id with nothing stored in it means the long press stays silent.
Upload
Anything this browser can play works — WAV, MP3, FLAC, OGG or M4A — and is mixed to mono and resampled here before it is sent. Nothing is uploaded to a server; the decode happens on this machine.
Format, rate, level and test tones
A test tone is used when no file is chosen. Trim is the quickest way to fit a long song into a slot.
Stored alarms
Not read yet.
Add an alarm
Factory reset
This erases everything the clock stores: every alarm, every light look, the lamp and button choices, the LED count, and the index of stored sounds. The firmware itself is untouched, and the time keeps running. It cannot be undone.
Without this the sounds are forgotten but their bytes stay on the flash until something overwrites them. Scrubbing erases the whole audio region, which takes several minutes with the clock unusable meanwhile.