← Интеграция ESPHome | Содержание | Далее: Обзор Lambda →
DimmerLink — Интеграция ESPHome Lambda
Интеграция AC TRIAC-диммера DimmerLink с Home Assistant через ESPHome с использованием lambda-функций.
Tip
Если вы хотите обойтись без lambda-кода, воспользуйтесь [External Component](https://github.com/robotdyn-dimmer/DimmerLink/tree/main/components).
Содержание
Основные разделы
- Введение — Обзор, требования, подключение, базовая конфигурация
- Сущности — Готовые сущности для вашей конфигурации
- Примеры — Полные рабочие YAML-конфигурации
- Справочник Lambda — Справочник по I2C-регистрам и lambda-функциям
- Устранение неполадок — Интеграция с Home Assistant, устранение неполадок, дорожная карта
Быстрый старт
1. Подключение
text
ESP32 DimmerLink
───── ──────────
3.3V → VCC
GND → GND
GPIO21 → SDA
GPIO22 → SCL
2. Минимальная конфигурация
yaml
esphome:
name: dimmerlink
esp32:
board: esp32dev
logger:
api:
ota:
wifi:
ssid: "YOUR_WIFI"
password: "YOUR_PASSWORD"
i2c:
sda: GPIO21
scl: GPIO22
id: bus_a
output:
- platform: template
id: dimmer_out
type: float
write_action:
- lambda: |-
uint8_t level = (uint8_t)(state * 100.0f);
uint8_t data[2] = {0x10, level};
id(bus_a).write(0x50, data, 2, true);
light:
- platform: monochromatic
name: "Dimmer"
output: dimmer_out
gamma_correct: 1.0
3. Прошивка
bash
esphome run dimmerlink.yaml
30 строк — и диммер уже в Home Assistant!
Типы сущностей
| Сущность | Платформа | Описание |
|---|---|---|
| Light | monochromatic |
Основной диммер с регулировкой яркости |
| Sensor | template |
Частота AC, уровень, версия |
| Binary Sensor | template |
Статус готовности, флаг ошибки |
| Text Sensor | template |
Код ошибки (текст) |
| Select | template |
Выбор кривой диммирования |
| Number | template |
Прямое управление уровнем |
| Button | template |
Сброс, повторная калибровка |
Примеры конфигурации
| Пример | Описание | Ссылка |
|---|---|---|
| Минимальный | Light + базовый I2C | → |
| Стандартный | Light + датчики + Select | → |
| Расширенный | Все сущности + диагностика | → |
| Мульти-устройство | 2+ диммера на одной шине | → |
| С кнопкой | Управление физической кнопкой | → |
| Продакшн | Для производственной среды | → |
Карта регистров (кратко)
| Адрес | Название | R/W | Описание |
|---|---|---|---|
0x00 |
STATUS | R | Статус устройства |
0x01 |
COMMAND | W | Команды управления |
0x02 |
ERROR | R | Последний код ошибки |
0x10 |
DIM0_LEVEL | R/W | Яркость 0–100% |
0x11 |
DIM0_CURVE | R/W | Кривая 0–2 |
0x20 |
AC_FREQ | R | Частота AC |
0x30 |
I2C_ADDRESS | R/W | I2C-адрес |
Связанная документация
| Документ | Описание |
|---|---|
| External Component | Компонент ESPHome DimmerLink (без lambda) |
| I2C Communication | Детали протокола I2C |
| Hardware Connection | Схемы подключения |
История версий
| Версия | Дата | Изменения |
|---|---|---|
| 1.0 | 2026-02 | Первый выпуск |