2.2.0

Included In This Release

Ready-to-flash firmware for both supported Waveshare ESP32-C6 1.47-inch boards, plus the self-contained Windows companion app package.

Firmware:

• supports the KY-018 ambient-light sensor
• includes dedicated builds for ST7789 and JD9853 displays
• shows the ambient percentage, raw ADC value, and animated flower on the LCD
• sends raw telemetry over USB Serial
• can be selected and flashed from the Windows application

What Changed

• Added firmware support for both Waveshare ESP32-C6-LCD-1.47 (ST7789) and Waveshare ESP32-C6-Touch-LCD-1.47 (JD9853).
• Added a nine-frame pixel-art flower animation, smooth percentage transitions, a progress bar, and live ADC text on the device display.
• Added manual bundled-firmware selection and refreshed COM-port selection to the Windows Update screen.
• Split the Update screen into separate PC application and device firmware tabs.
• Added manifest-driven firmware discovery and flashing parameters, including full semantic version support.
• Added project-owned merged-binary scripts that build every firmware variant, remove stale same-version artifacts, and emit a manifest beside each binary.
• Updated the portable release workflow to bundle every matching firmware binary and manifest with the standalone flashing tool.

Supported Hardware

• Waveshare ESP32-C6-LCD-1.47 with ST7789 display — select esp32c6-display
• Waveshare ESP32-C6-Touch-LCD-1.47 with JD9853 display — select esp32c6-touch
• KY-018 ambient-light sensor

Wiring:

• VCC -> 3V3
• GND -> GND
• AO -> GPIO4

Do not power the sensor from 5V, and avoid GPIO0 on ESP32-C6 because it can interfere with startup.

How To Flash

The recommended path is the bundled Windows application:

1. Extract luma-bloom-pc-app_2.2.0_win-x64-portable.zip.
2. Run BrightnessSensor.ConsoleApp.exe.
3. Open Update -> Device firmware.
4. Select the firmware variant matching the board and select its COM port.
5. Click Flash firmware.

For a manual fallback, run one of these commands from the extracted package directory.

Standard ESP32-C6-LCD-1.47 (ST7789):

& ".\Tools\esptool.exe" --chip esp32c6 --port COM8 --baud 460800 write-flash 0x0 ".\Firmware\luma_bloom_esp32c6-display_2.2.0_merged.bin"

Touch ESP32-C6-Touch-LCD-1.47 (JD9853):

& ".\Tools\esptool.exe" --chip esp32c6 --port COM8 --baud 460800 write-flash 0x0 ".\Firmware\luma_bloom_esp32c6-touch_2.2.0_merged.bin"

Replace COM8 with the board's port. If the board is not detected, hold BOOT, press and release RST, then release BOOT.

Telemetry

The firmware sends newline-delimited JSON at 115200 baud. The transmitted value is the raw ADC reading; normalization and brightness processing happen in the Windows application.

{"id":"lumabloom","ts":1234567,"raw":1872}

2.0.1

Release notes for LumaBloom from 2.0.0 to 2.0.1.

Included In This Release

Ready-to-flash firmware for Waveshare ESP32-C6-LCD-1.47 plus the Windows companion app package.

Firmware:

• works with the KY-018 light sensor
• shows the current reading on the LCD
• shows the sensor status on screen
• sends telemetry over USB Serial
• stays compatible with the Windows application from this repository

Release Files

• luma-bloom-pc-app_2.0.1_win-x64-portable.zip - Windows app package with BrightnessSensor.ConsoleApp.exe, Tools/esptool.exe, and the bundled firmware release folder in Firmware/ for the Update screen

What Changed

• Added the animated LCD flower screen for ESP32-C6, including the generated sprite asset pipeline and updated on-device layout.
• Refined the firmware UI to show the ambient percentage and ADC overlay while keeping telemetry compatible with the Windows app.
• Bundled the official standalone Windows esptool.exe into the portable package for the in-app Update flow and manual flashing fallback.
• Fixed the portable release packaging flow so the Windows zip reliably carries the flashing tool and bundled firmware payload.

Supported Hardware

• Waveshare ESP32-C6-LCD-1.47 board
• KY-018 sensor

Wiring:

• VCC -> 3V3
• GND -> GND
• AO -> GPIO4

How To Flash

For 2.0.1, the recommended update path is from the Windows companion app itself. Open the packaged BrightnessSensor.ConsoleApp.exe, go to the Update screen, and start the firmware update from there. The portable package already includes Tools/esptool.exe and the bundled firmware file in Firmware\.

If you need a manual fallback, run:

& ".\Tools\esptool.exe" --chip esp32c6 --port COM8 --baud 460800 write-flash 0x0 .\Firmware\luma_bloom_esp32c6_2.0.1_merged.bin

If you run the command outside the portable package folder, use the full paths to Tools\esptool.exe and the merged firmware file inside Firmware\.

If the board is not detected, enter the bootloader mode:

1. hold BOOT
2. press and release RST
3. release BOOT

Telemetry

Example:

{"id":"lumabloom","ts":1234567,"raw":1872}

2.0.0

Release notes for LumaBloom from 1.4.0 to 2.0.0.

Included In This Release

Ready-to-flash firmware for Waveshare ESP32-C6-LCD-1.47 plus the Windows companion app package.

Firmware:

• works with the KY-018 light sensor
• shows the current reading on the LCD
• shows the sensor status on screen
• sends telemetry over USB Serial
• stays compatible with the Windows application from this repository

Release Files

• luma-bloom-pc-app_2.0.0_win-x64-portable.zip - Windows app package with BrightnessSensor.ConsoleApp.exe, Tools/esptool.exe, and the bundled firmware release folder in Firmware/ for the Update screen

What Changed

• Added in-app release awareness and application update flow in the Windows companion app.
• Added bundled firmware discovery and firmware flashing support from the portable package Update flow.
• Added automatic app version handling for release builds.
• Refined runtime state and dashboard update behavior to support the new update actions.
• Expanded project documentation with the new sensor transport and monitor DDC/CI notes.
• Included the post-2.0.0-rc.1 fix for updating appsettings.json during application update.

Supported Hardware

• Waveshare ESP32-C6-LCD-1.47 board
• KY-018 sensor

Wiring:

• VCC -> 3V3
• GND -> GND
• AO -> GPIO4

How To Flash

For 2.0.0, the recommended update path is from the Windows companion app itself. Open the packaged BrightnessSensor.ConsoleApp.exe, go to the Update screen, and start the firmware update from there. The portable package already includes Tools/esptool.exe and the bundled firmware file in Firmware\.

If you need a manual fallback, run:

& ".\Tools\esptool.exe" --chip esp32c6 --port COM8 --baud 460800 write-flash 0x0 .\Firmware\luma_bloom_esp32c6_2.0.0_merged.bin

If you run the command outside the portable package folder, use the full paths to Tools\esptool.exe and the merged firmware file inside Firmware\.

If the board is not detected, enter the bootloader mode:

1. hold BOOT
2. press and release RST
3. release BOOT

Telemetry

Example:

{"id":"lumabloom","ts":1234567,"raw":1872}

For this release, raw is the sensor ADC reading sent over USB. The normalized percentage is derived locally by the firmware UI and by the Windows app, and is not mirrored into telemetry as a separate measurement field.

2.0.0-rc.1

Release Notes 2.0.0 Prerelease

Included In This Release

Ready-to-flash firmware for Waveshare ESP32-C6-LCD-1.47 plus the Windows companion app package.

Firmware:

• works with the KY-018 light sensor
• shows the current reading on the LCD
• shows the sensor status on screen
• sends telemetry over USB Serial
• stays compatible with the Windows application from this repository

Release Files

• luma-bloom-pc-app_2.0.0_win-x64-portable.zip - Windows app package with BrightnessSensor.ConsoleApp.exe, Tools/esptool.exe, and the bundled firmware release folder in Firmware/ for the Update screen

What Changed

• Added in-app GitHub release discovery for the Windows portable package, including a prerelease toggle for testing newer builds before a stable rollout.
• Added the application self-update flow that downloads the latest portable package, stages it locally, and relaunches from the updated bundle.
• Added bundled firmware detection and flashing support in the desktop app so the portable package can carry a ready-to-use Firmware/ folder alongside Tools/esptool.exe.
• Standardized the portable packaging flow around versioned artifact names and explicit firmware bundling for the Update screen.
• Documented the Windows build and packaging flow in more detail and added the new sensor transport and monitor DDC/CI reference in both English and Russian.
• Kept the current ESP32-C6 telemetry and firmware contract compatible with the desktop app while expanding the release workflow around prerelease distribution.

Supported Hardware

• Waveshare ESP32-C6-LCD-1.47 board
• KY-018 sensor

Wiring:

• VCC -> 3V3
• GND -> GND
• AO -> GPIO4

GPIO0 is no longer recommended for KY-018 on ESP32-C6 because it can interfere with normal board startup.

How To Flash

& ".\Tools\esptool.exe" --chip esp32c6 --port COM8 --baud 460800 write-flash 0x0 .\Firmware\luma_bloom_esp32c6_2.0.0_merged.bin

If you run the command outside the portable package folder, use the full paths to Tools\esptool.exe and the merged firmware file inside Firmware\.

If the board is not detected, enter the bootloader mode:

1. hold BOOT
2. press and release RST
3. release BOOT

Telemetry

Example:

{"id":"lumabloom","ts":1234567,"raw":1840}

• raw is the active telemetry measurement field for the current ESP32-C6 release.
• The Windows app uses raw for brightness processing, diagnostics, and the current-light curve anchoring flow.
• The LCD still derives a local normalized ambient percent from the configured raw range, but that normalized value is not sent over USB Serial.

1.4.0

Included In This Release

Ready-to-flash firmware for Waveshare ESP32-C6-LCD-1.47 and the Windows portable companion app.

Firmware:

• works with the KY-018 light sensor
• shows the current reading on the LCD
• sends telemetry over USB Serial
• stays compatible with the Windows application from this repository

Windows app:

• reads live raw telemetry from the device
• applies monitor brightness from the configured response curve
• keeps manual brightness control available even when live sensor telemetry is temporarily missing

Release Files

• luma-bloom-pc-app_1.4.0_win-x64-portable.zip - folder with the exe file
• luma_bloom_esp32c6_1.4.0_merged.bin - firmware binary for flashing the device

What Changed

• simplified the firmware and desktop contract around the raw ADC telemetry field as the single live sensor measurement on the wire
• removed the legacy startup auto-calibration flow from the Windows app and related config/profile plumbing
• kept compatibility calibration messages available in firmware for manual or legacy flows, while normal runtime now works directly from raw
• fixed manual brightness mode so it still works when the app has no current sensor telemetry
• dropped the old ESP32-C3 firmware track and aligned the repo around the ESP32-C6 release target
• refreshed docs and examples to match the current telemetry and setup flow

Supported Hardware

• Waveshare ESP32-C6-LCD-1.47 board
• KY-018 sensor

Wiring:

• VCC -> 3V3
• GND -> GND
• AO -> GPIO4

GPIO0 is no longer recommended for KY-018 on ESP32-C6 because it can interfere with normal board startup.

How To Flash

& "C:\Espressif\tools\python\v6.0\venv\Scripts\esptool.exe" --chip esp32c6 --port COM8 --baud 460800 write-flash 0x0 luma_bloom_esp32c6_1.4.0_merged.bin

1.3.0

Included In This Release

This release packages the current LumaBloom build as 1.3.0.

Included components:

• Windows companion app portable package for win-x64
• merged ESP32-C6 firmware binary for Waveshare ESP32-C6-LCD-1.47
• the existing calibration-based telemetry flow used by the current desktop app and firmware

Release Files

• luma-bloom-pc-app_1.3.0_win-x64-portable.zip - portable Windows application package
• luma_bloom_esp32c6_1.3.0_merged.bin - merged firmware image for direct flashing at �x0

What Changed

• bumped the visible desktop app version from �1.2.0 to �1.3.0
• refreshed the release packaging for the Windows portable build and ESP32-C6 merged firmware artifact
• kept runtime behavior unchanged versus 1.2.0, including startup calibration and normalized sensor telemetry

Supported Hardware

• Waveshare ESP32-C6-LCD-1.47
• KY-018 analog light sensor

Wiring:

• VCC -> 3V3
• GND -> GND
• AO -> GPIO4

GPIO0 is still not recommended for KY-018 on ESP32-C6 because it can interfere with normal startup.

How To Flash

& "C:\Espressif\tools\python\v6.0\venv\Scripts\esptool.exe" --chip esp32c6 --port COM8 --baud 460800 write-flash 0x0 luma_bloom_esp32c6_1.3.0_merged.bin

If you run the command outside the artifact folder, use the full path to luma_bloom_esp32c6_1.3.0_merged.bin.

If the board is not detected, enter bootloader mode:

1. Hold BOOT
2. Press and release RST
3. Release BOOT

1.2.0

Included In This Release

Ready-to-flash firmware for Waveshare ESP32-C6-LCD-1.47.

Firmware:

• works with the KY-018 light sensor
• shows the current reading on the LCD
• shows the sensor status on screen
• sends telemetry over USB Serial
• stays compatible with the Windows application from this repository

Release Files

• luma-bloom-pc-app_0.3.0_win-x64-portable.zip - folder with the exe file
• luma_bloom_esp32c6_0.3.0_merged.bin - firmware binary for flashing the device

What Changed

• Added ESP32-C6 startup calibration driven by pc-app, with calibrate command handling and calibration result responses.
• Changed ESP32-C6 telemetry so value is now a calibrated normalized reading in the 0..1000 range, with additional raw and calibrated fields.
• Updated the Windows application to detect the ESP32-C6 normalized profile, collect startup samples, send calibration data, and use the calibrated values for brightness control.
• Reworked the ESP32-C6 LCD layer around generated screen layout files and runtime placeholders {{NORMALIZED}}, {{RAW}}, and {{STATUS}}.
• Refreshed the docs and release workflow to match the new calibration, telemetry, and packaging flow.

Supported Hardware

• Waveshare ESP32-C6-LCD-1.47 board
• KY-018 sensor

Wiring:

• VCC -> 3V3
• GND -> GND
• AO -> GPIO4

GPIO0 is no longer recommended for KY-018 on ESP32-C6 because it can interfere with normal board startup.

How To Flash

& "C:\Espressif\tools\python\v6.0\venv\Scripts\esptool.exe" --chip esp32c6 --port COM8 --baud 460800 write-flash 0x0 luma_bloom_esp32c6_0.3.0_merged.bin

Full Changelog: 0.2.1...0.3.0

1.1.0

Included In This Release

Ready-to-flash firmware for Waveshare ESP32-C6-LCD-1.47.

Firmware:

• works with the KY-018 light sensor
• shows the current reading on the LCD
• shows the sensor status on screen
• sends telemetry over USB Serial
• stays compatible with the Windows application from this repository

Release Files

• luma-bloom-pc-app_1.1.0_win-x64-portable.zip - folder with the exe file
• luma_bloom_esp32c6_1.1.0_merged.bin - firmware binary for flashing the device

What Changed

• added the Terminal.Gui settings UI for the Windows companion app
• refreshed the main project documentation and contributor-facing docs
• added ESP32-C6 enclosure assets, assembly materials, and hardware presentation content
• added repo-local release skills for firmware, portable Windows packaging, and GitHub release note workflows

Supported Hardware

• Waveshare ESP32-C6-LCD-1.47 board
• KY-018 sensor

Wiring:

• VCC -> 3V3
• GND -> GND
• AO -> GPIO4

GPIO0 is no longer recommended for KY-018 on ESP32-C6 because it can interfere with normal board startup.

How To Flash

& "C:\Espressif\tools\python\v6.0\venv\Scripts\esptool.exe" --chip esp32c6 --port COM8 --baud 460800 write-flash 0x0 luma_bloom_esp32c6_1.1.0_merged.bin