📡 Radar + Light

Совет

TL;DR. Радар HLK-LD2402 (через UART) + фоторезистор на ADC. В HA — binary_sensor присутствия, sensor дистанции, sensor освещённости 0–100% и 9 кнопок калибровки. Работает на ESP32 / C3 / C6 (рекомендуется C6).

🧩 Матрица поддержки плат

3 платы Wi-Fi 2 Zigbee каркаса

Плата	Wi-Fi (ESPHome)	Zigbee (ESP-IDF)
ESP32 (classic)	✅	❌
ESP32-C3 SuperMini	✅	❌
ESP32-C6 SuperMini (рек.)	✅	🐝 C6 Router
ESP32-H2	❌ нет Wi-Fi	🐝 H2 End Device
ESP8266	🚧 (RAM критичен)	❌

🔌 Подключение пинов

ESP32-C6 (рек.)

Сигнал LD2402	GPIO
TX (данные → ESP)	GPIO6
RX (команды ← ESP)	GPIO7
5V	5V
GND	GND
LDR (делитель 10kΩ)	GPIO4 (ADC)

Осторожно

GPIO4 на C6 — strapping pin. Используйте резистор ≥ 10 kΩ к 3.3 V в делителе LDR, иначе плата может не загружаться.

ESP32-C3

Сигнал LD2402	GPIO
TX	GPIO20
RX	GPIO21
5V	5V
GND	GND
LDR (делитель 10kΩ)	GPIO4 (ADC)

ESP32 (classic)

Сигнал LD2402	GPIO
TX	GPIO17
RX	GPIO16
5V	5V
GND	GND
LDR (делитель 10kΩ)	GPIO34 (input-only ADC1)

Заметка

UART: линия TX модуля всегда идёт на RX ESP (и наоборот). Скорость UART — 115200 (компонент hlk_ld2402).

📁 Структура шаблона

• Директорияfirmwares/ci-overrides/mihazzzold.espHome_radarLight/

  • espHome_radarLight.yaml.j2 единая точка входа
  • Директория_includes/

    • runtime.yaml.j2 Wi-Fi, API, OTA, UART, hlk_ld2402
    • logic.yaml.j2 RAD:* / LUX:* сущности, калибровка
    • maintenance.yaml.j2 OTA, SETUP, серийник, HELP
    • logic_radar_buttons.yaml.j2 9 кнопок (calibrate, save, …)
    • logic_radar_text_sensors.yaml.j2 firmware version, режим
  • README.md
  • HOME_ASSISTANT.md
  • hardware.yaml

📦 Сборка

1. Установите ESPHome (pip install esphome или через GUI).

2. Скопируйте секреты:

   cp firmwares/secrets.yaml.example firmwares/secrets.yaml
   # отредактируйте wifi_ssid / wifi_password / api_encryption_key

3. Синхронизируйте внешние репо + примените канон:

   python scripts/sync_firmwares.py
   python scripts/apply_ci_overrides.py

4. Прошейте устройство (выбор платы — см. Tabs ниже):

   ESP32-C6 (рек.)

   py -3.13 scripts/flasher.py --local `
     -f firmwares-external/mihazzzold.espHome_radarLight/espHome_radarLight.yaml.j2 `
     --board-profile esp32c6-supermini -a run --port COM5 -y

   ESP32-C3

   py -3.13 scripts/flasher.py --local `
     -f firmwares-external/mihazzzold.espHome_radarLight/espHome_radarLight.yaml.j2 `
     --board-profile esp32c3-supermini -a run --port COM5 -y

   ESP32 (classic)

   py -3.13 scripts/flasher.py --local `
     -f firmwares-external/mihazzzold.espHome_radarLight/espHome_radarLight.yaml.j2 `
     --board-profile esp32-supermini -a run --port COM5 -y

5. Добавьте устройство в Home Assistant через ESPHome integration. Появятся сущности с префиксами RAD: / LUX: / OTA: + HELP: инструкция с шагами калибровки.

🏠 Home Assistant и калибровка

В прошивке есть HELP: инструкция (text_sensor, Diagnostic) — многострочный текст с шагами калибровки LD2402.

Быстрый порядок калибровки:

1. Выйдите из зоны детекции на 30+ секунд.
2. Нажмите RAD: калибровка — следите за RAD: прогресс калибровки до 100%.
3. Нажмите RAD: сохранить настройки (запись в модуль).

Подробно: HOME_ASSISTANT.md на GitHub — карточки дашборда, troubleshooting, OTA manifest URLs.

🐝 Zigbee-вариант

Параллельная Zigbee-реализация на ESP-IDF — для устройств в Zigbee mesh:

🐝 esp32c6-radar (Router) Каркас Z3 на C6 с питанием от сети. Кластеры Occupancy + Illuminance — TODO.

🐝 esp32h2-radar (End Device) Каркас Z3 на H2 для батарейного варианта. Кластеры — TODO.

📚 Дальше

Каталог прошивок

Профили плат

OTA quickstart