Changelog

All notable changes to this project will be documented here.
Format follows Keep a Changelog.
This project uses Semantic Versioning.

[Unreleased] — v1.1.0

Radar Bluetooth switch — toggle onboard BLE on/off from Home Assistant without the HLKRadarTool app. Uses protocol command 0x00A4 followed by a two-phase commit sequence: End config (writes to radar flash) → re-enter config → Reboot. Defaults to OFF matching the LD2411S factory default.
Documented that the OUT pin is hardwired to GND in LD2411S firmware and cannot be used as a presence output

example.yaml buttons broken — Apply Settings, Reboot Radar, and Factory Reset buttons referenced nonexistent C++ methods (ld2411s_component.set_config(), .reboot(), .factory_reset()) that were never implemented in the component. Replaced with raw uart.write commands and a script block matching the working implementation. Fixes #1.
Bluetooth toggle only worked in one direction — BT ON worked but BT OFF had no effect. Root cause: without End config between the BT command and the reboot, the setting was only in RAM and lost on restart. Fixed by committing via End config before rebooting.

example.yaml now includes the Radar Bluetooth switch
README updated with full Bluetooth section, OUT pin clarification, and unoccupied timeout / delayed_off explanation
BT switch restore_mode changed from RESTORE_DEFAULT_ON to RESTORE_DEFAULT_OFF — the LD2411S ships with Bluetooth disabled; previous setting caused switch to show ON on first boot while hardware was OFF

Initial release of ESPHome external component for the HLK-LD2411S
Binary presence sensor with configurable delayed_off
Binary motion sensor with configurable delayed_off
Target distance sensor (cm)
Runtime zone configuration via HA number entities (motion min/max, presence min/max, unoccupied timeout)
Apply Settings button — commits all zone config to radar in a single UART transaction
Radar Reboot button — reboots LD2411S module without restarting ESP32
Factory Reset button — restores LD2411S to factory defaults
Crash diagnostics: Reset Reason, Heap Free, Heap Max Block, Loop Time
Full power supply guidance (2A minimum, Apple 10W confirmed working)
ESP-IDF framework documentation and rationale
Tested on ESP32-WROOM-32 with ESPHome 2026.2.4 and ESP-IDF 5.5.2