Smart ambient-light sensor for Windows displays, wrapped in a printable flower-shaped ESP32-C6 device.
LumaBloom reads room light from a KY-018 sensor on an ESP32-C6, streams raw JSON telemetry over USB, and lets the Windows companion app adjust monitor brightness automatically.
- ESP32-C6 firmware for Waveshare
ESP32-C6-LCD-1.47with an ambient-light-driven pixel-art flower animation. - Raw
ADCtelemetry from the ESP32-C6, with normalization kept local to firmware UI and the Windows app. - Live Windows terminal dashboard for status, manual brightness, settings, events, and diagnostics.
- In-app firmware updates with automatic COM-port selection and a refreshed manual port dropdown.
- Printable enclosure with
.3mfplates, STEP sources, STL exports, photos, and demo media. - User-tunable brightness curve, including anchoring the curve to the current room light, plus smoothing, hysteresis, gamma, language, and autostart settings.
| Path | Purpose |
|---|---|
firmware/firmware_esp32c6/ |
ESP-IDF firmware for the device |
pc-app/ |
Windows-only .NET companion app |
hardware/ |
Wiring, BOM, assembly, printable enclosure, and hardware revisions |
docs/ |
Protocol, settings, setup, firmware, and build docs |
| Start here | What it covers |
|---|---|
docs/getting-started.md |
End-to-end setup from device to Windows app |
docs/firmware.md |
ESP32-C6 firmware build, flash, monitor, and release binary notes |
docs/build.md |
PC app restore, build, test, run, and publish commands |
hardware/README.md |
Hardware index, assembly, wiring, BOM, and enclosure assets |
docs/protocol.md |
USB JSONL telemetry contract |
docs/sensor-transports-and-monitor-ddc.md |
Sensor transport and monitor DDC/CI brightness control docs, with English and Russian variants |
docs/device-profiles.md |
Single-device runtime defaults and settings model |
CONTRIBUTING.md |
Contribution workflow and validation expectations |
- The ESP32-C6 reads the KY-018 sensor and visualizes ambient light with an animated flower plus percentage and ADC overlays on the onboard LCD.
- The Windows app discovers the device over a COM port.
- The device streams raw light telemetry over USB.
- The app maps ambient light to monitor brightness using the active settings, response curve, and smoothing settings.
- The LCD shows a local normalized percentage derived from the configured raw range.
Telemetry example:
{"id":"lumabloom","ts":1234567,"raw":1840}- Board: Waveshare
ESP32-C6-LCD-1.47 - Sensor: KY-018 analog light sensor
- Desktop app: Windows 10/11
- Firmware: ESP-IDF
- App runtime: .NET SDK 10.0+
Repository code and documentation use the root repository license.
Custom physical enclosure assets in hardware/3d-print/ are licensed separately under CC BY-NC 4.0; see hardware/3d-print/LICENSE.md.