LED Strip Club
Live at https://nukemberg.github.io/cheap-leds/. An offline PWA that drives cheap BLE LED controllers via Web Bluetooth, one driver per brand (web/drivers/):
- MR Star: advertises as
GATT--DEMO (drivers/mrstar.js)
- BanlanX SP621E:
SP6* SPI controllers (drivers/banlanx.js). Protocol from uniled; checked on a real SP621E (power, colours, brightness, effects). No timers or LED-count command.
- Lotus Lamp X:
MELK-O* Symphony controllers (drivers/melk.js). They advertise intermittently, so power-cycle one if it's missing from the picker.
Full protocol details for both are in PROTOCOL.md. A new brand needs a driver module, plus an entry in drivers/index.js and in web/sw.js.
MR Star protocol
| |
|---|
| Advertised service | 0x2022 (discovery filter) |
| GATT service | 0xFFF0 |
| Write char | 0xFFF3 (write without response) |
| Notify char | 0xFFF4 (silent, no state readback) |
Frame: BC <op> <len> <args…> 55, big-endian u16s.
| op | command | args |
|---|
01 | power | 00/01 |
03 | LED count | u16, 8–300 |
04 | color | hue u16 (0–360), sat×10 u16 (0–1000), 00 00 |
05 | brightness | u16 (0–1024), 00 00 00 00 |
06 | effect | u16 id (see web/protocol.js) |
07 | reverse | 00/01 |
08 | speed | u8 0–100 |
Examples: off bc01010055, red bc0406000003e8000055, 25% bc050601000000000055.
Command map from mishamyrt/mr-star-ble, verified on hardware with probe.py.
Full decoded protocol (extra opcodes, timers, mic mode, hidden effects, no state readback): PROTOCOL.md.
Run
just serve — http://localhost:8765 (Web Bluetooth needs localhost or HTTPS)just android — phone over USB: adb reverse then open http://localhost:8765 in Chrome, menu → Install app- Or host
web/ on any HTTPS static host, open once, install. Works offline afterwards.
just test — protocol byte testsjust scan / just gatt / just probe — BLE tooling
Bump VERSION in web/sw.js when changing files so installed copies update.
