frank/ruvnet--RuView
1
0
Fork 0
mirror of https://github.com/ruvnet/RuView synced 2026-07-23 17:33:20 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat(firmware): gate LED gamma viz behind CONFIG_LED_GAMMA_VIZ (ADR-183 follow-up) (#1129)

Browse Source 
The 40 Hz gamma flicker is now Kconfig-gated (default y, unchanged
behaviour). Set CONFIG_LED_GAMMA_VIZ=n for a dark, lower-power boot (the
LED is simply cleared) — important for photosensitive deployments, no
source edit needed. The colormap saturation point is now operator-tunable
via CONFIG_LED_MOTION_FULLSCALE_MILLI (default 250 = 0.25).

Build + flash confirmed on ESP32-S3 N16R8 (COM8): default y still arms the
gamma timer, CSI flows. ADR-183 updated (gate moved from follow-up to done).
This commit is contained in:
rUv
2026-06-17 22:22:20 -04:00
committed by GitHub
parent a4c2935a2f
commit 4bf88e1283
3 changed files with 50 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/adr/ADR-183-onboard-led-gamma-stimulus-csi-colormap.md
+7 -5
View File
@@ -74,11 +74,13 @@ therefore provably `ruv-neural-viz`'s, and the motion is provably real.
- Confirms #962's GPIO-48 fix visually (the LED lights on N16R8).
**Negative / risks**
- Changes *default* firmware behaviour: the onboard LED now animates instead of staying
off (minor power + a visible flicker some may not want). Gate behind a Kconfig
(`CONFIG_LED_GAMMA_VIZ`) if a dark default is preferred — follow-up.
- A 40 Hz flicker can be an issue for photosensitive users; document on the enclosure.
- `LED_MOTION_FULLSCALE` (0.25) is hand-tuned, not calibrated per-environment.
- Changes the *default* firmware behaviour: the onboard LED animates instead of staying
off. Now **gated by `CONFIG_LED_GAMMA_VIZ`** (default `y`); set it `n` for a dark,
lower-power boot (the LED is just cleared) — no source change needed.
- A 40 Hz flicker can be an issue for photosensitive users; document on the enclosure
and disable `CONFIG_LED_GAMMA_VIZ` in those deployments.
- The saturation point is now `CONFIG_LED_MOTION_FULLSCALE_MILLI` (default 250 = 0.25),
operator-tunable; still not auto-calibrated per-environment.
- The colour uses a baked LUT, not the live Rust `ColorMap` (FFI path deferred — needs
the ESP Rust/xtensa toolchain, not yet in CI).