zigbridge-esp

0
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
7 месяцев назад
README.md

ESP Fake Transmitter (ESP32-C6)

Проект — прошивка для ESP32-C6, эмулирующая Zigbee-устройство (On/Off Light) для интеграции с Home Assistant через проект zigbridge.

Кратко: прошивка создаёт Zigbee End Device (emulated_light), регистрирует Basic / Identify / On/Off кластеры и позволяет управлять состоянием света (вкл/выкл) через Zigbee. В качестве аппаратной части используется один светодиод на LED-строке (RMT), управляемый компонентом

led_strip
.

Важно: при использовании этого кода указывайте авторство:

kallibr44
.

Ссылка на интеграцию Home Assistant: https://gitverse.ru/kallibr44/zigbridge

Поддерживаемая платформа и зависимости

  • Платформа: ESP-IDF >= 5.0.0
  • Зависимости (см.
    idf_component.yml
    ):
    espressif/esp-zigbee-lib
    ,
    espressif/esp-zboss-lib
    ,
    espressif/led_strip

Функциональность (из исходного кода)

  • Режим устройства: Zigbee End Device (ZED).
  • Создаёт один или несколько endpoint'ов с профилем Home Assistant HA On/Off Light.
  • Поддерживаемые ZCL кластеры: Basic, Identify, On/Off.
  • Обработка входящих команд ZCL: установка атрибута On/Off — приводит к включению/выключению LED-ленты.
  • Конфигурация LED: GPIO и число светодиодов задаются через
    CONFIG_EXAMPLE_STRIP_LED_GPIO
    и
    CONFIG_EXAMPLE_STRIP_LED_NUMBER
    .
  • Консольные команды (через USB/JTAG консоль):
    • init <ep1> <ep2> ...
      — добавить один или несколько endpoint'ов (числа) и запустить регистрацию Zigbee-устройств с этими endpoint'ами.
    • rst
      — перезагрузить устройство.

Как это работает

  • Включаете устройство, подключаетесь к консоли USB/JTAG.
  • Выполняете
    init 1
    (или
    init 2 3
    ) — добавляются endpoint'ы и запускается Zigbee стек.
  • После успешного подключения к Zigbee-сети устройство начинает принимать команды On/Off от координатора (например, zigbridge → Home Assistant).

**Параметры конфигурации (menuconfig)

  • Конфигурация RMT/LED:
    CONFIG_EXAMPLE_STRIP_LED_GPIO
    ,
    CONFIG_EXAMPLE_STRIP_LED_NUMBER
    .
  • При необходимости укажите
    ZB_ED_ROLE
    в конфиге для компиляции как End Device.

Сборка и прошивка (пример)

  1. Установите ESP-IDF (версия >= 5.0.0) и зависимости.
  2. Подготовьте окружение ESP-IDF и активируйте его.
  3. Выполните сборку и прошивку через обычные команды ESP-IDF (пример):

Замените

COMx
на порт вашего устройства.

Авторство и вклад

  • Исходная рабочая реализация и идеи:
    kallibr44
    .
  • Если вы используете код или хотите внести улучшения — указывайте авторство
    kallibr44
    в документации/описании.
  • PR / Merge Request: внесите изменения в форк и откройте merge request в репозиторий автора (
    kallibr44
    ).

Если вам понравилась данная разработка и вы хотите меня отблагодарить, мне будет очень приятно :) отблагодарить тык