HACS-интеграции LocalTuya и Adaptive Lighting: локальный умный дом без облака

Зачем это нужно?

Давайте честно признаемся: когда я впервые собрал свой умный дом на Home Assistant, у меня было штук пять разных Wi-Fi розеток от неизвестных китайских брендов. Они работали, но через облако. А это значит — каждое нажатие кнопки в приложении проходило через серверы где-то в Шэньчжэне. И вот однажды провайдер этих розеток просто... закрылся. Устройства превратились в бесполезные куски пластика с светодиодом.

Именно тогда я понял: локальное управление — это не паранойя, а вопрос здравого смысла. Сегодня расскажу о двух мощных инструментах, которые помогают мне держать умный дом полностью локальным, даже когда речь идёт о дешёвых Tuya-устройствах и сложных сценариях освещения.

LocalTuya: возвращаем локальный контроль над Tuya-устройствами

Что такое LocalTuya и почему это важно

LocalTuya — это HACS-интеграция для Home Assistant, которая позволяет управлять устройствами на базе чипов Tuya (ESP8266, BK7231 и другие) напрямую, через локальную сеть, без обращения к облачным серверам Tuya. Это работает даже с теми устройствами, которые вы уже привязали к облаку через приложение Smart Life или Tuya Smart.

Главная фишка LocalTuya в том, что она использует тот же протокол, что и официальные приложения Tuya, но общается с устройствами напрямую. Для этого нам понадобятся ключи API от Tuya IoT Platform — они дают доступ к локальным ключам шифрования устройств.

Установка LocalTuya через HACS

Если у вас ещё не установлен HACS — самое время это исправить. Пошаговую инструкцию я подробно расписывал в отдельной статье, здесь же кратко пройдусь по основным шагам.

# Убеждаемся, что HACS установлен и работает
# Заходим в HACS → Интеграции → Три точки в правом верхнем углу → Пользовательские репозитории
# Добавляем репозиторий: https://github.com/xZetsubou/hass-localtuya
# Тип: Интеграция

После добавления репозитория жмём «Загрузить» и перезапускаем Home Assistant.

Получение ключей Tuya API

Это самый «замороченный» этап, но без него никуда. Заходим на Tuya IoT Platform, регистрируемся как разработчик (можно тем же email, что и в приложении Smart Life).

Дальше по шагам:

1. Создаём облачный проект — выбираем тип «Smart Home»
2. В настройках проекта добавляем устройство — вам предложат связать аккаунт Smart Life/Tuya Smart
3. После связывания в проекте появятся ваши устройства
4. В разделе «Devices» находим нужное устройство и копируем его Local Key (он же локальный ключ)

Важный момент: если вы используете приложение Tuya Smart, а не Smart Life, убедитесь, что регион в проекте совпадает с регионом вашего аккаунта. Иначе устройства просто не найдутся.

Настройка интеграции

Теперь добавляем LocalTuya в Home Assistant:

# configuration.yaml — добавляем базовую конфигурацию
localtuya:
  - host: 192.168.1.100        # IP-адрес устройства в локальной сети
    device_id: "1234567890abcdef"  # Device ID из Tuya IoT Platform
    local_key: "your_local_key_here"  # Local Key из Tuya IoT Platform
    friendly_name: "Розетка на кухне"
    protocol_version: 3.3       # Версия протокола, обычно 3.1 или 3.3
    entities:
      - platform: switch
        friendly_name: "Розетка на кухне"
        id: 1                   # ID DP (Data Point) для включения/выключения

Но я рекомендую добавлять устройства через UI — так нагляднее и меньше шансов ошибиться. В Home Assistant: Настройки → Устройства и службы → Добавить интеграцию → LocalTuya.

В мастере настройки вам предложат указать: - Host — IP устройства (можно найти в роутере или через приложение) - Device ID и Local Key — берём из Tuya IoT Platform - Protocol version — если не знаете, попробуйте 3.3, большинство современных устройств используют именно её

Типичные ошибки и как их избежать

Устройство не находится в локальной сети. Проверьте, что устройство и Home Assistant находятся в одной подсети. Если у вас несколько VLAN — это частая проблема.

Ошибка аутентификации при добавлении. Скорее всего, неверный Local Key. Иногда ключ меняется после сброса устройства или перепривязки к другому аккаунту. Обновите ключ на Tuya IoT Platform.

Устройство работает нестабильно. Попробуйте изменить protocol_version. Некоторые дешёвые розетки используют 3.1, хотя заявляют 3.3.

Важно! Не обновляйте прошивку устройств через официальное приложение после настройки LocalTuya — это может изменить Local Key, и интеграция перестанет работать.

Adaptive Lighting: умное освещение, которое подстраивается под вас

Что такое Adaptive Lighting

Adaptive Lighting — это гениальная в своей простоте интеграция, которая автоматически подстраивает цветовую температуру и яркость ваших умных ламп в течение дня. Утром — холодный бодрящий свет, вечером — тёплый расслабляющий. Всё как с естественным освещением.

Интеграция работает с любыми лампами, которые поддерживают управление цветовой температурой или RGB: от Philips Hue до дешёвых Zigbee-ламп от IKEA. И да, она отлично сочетается с LocalTuya — можно управлять даже Tuya-лампами.

Установка и настройка

Установка стандартная через HACS:

# HACS → Интеграции → Ищем "Adaptive Lighting" → Устанавливаем
# Перезапускаем Home Assistant

После перезапуска добавляем интеграцию через UI. В настройках самое интересное:

# Пример конфигурации для продвинутой настройки
adaptive_lighting:
  living_room:
    name: "Гостиная"
    lights:
      - light.gostinaya_potolochnaya
      - light.gostinaya_torsher
    initial_transition: 60          # Плавный переход при старте (секунды)
    transition: 30                  # Длительность перехода при изменении (секунды)
    interval: 60                    # Интервал проверки (секунды)
    min_brightness: 25              # Минимальная яркость (%)
    max_brightness: 100             # Максимальная яркость (%)
    min_color_temp: 2500            # Минимальная цветовая температура (К)
    max_color_temp: 5500            # Максимальная цветовая температура (К)
    sleep_brightness: 20            # Яркость в режиме сна (%)
    sleep_color_temp: 2200          # Цветовая температура в режиме сна (К)
    only_once: false                # Применять настройки только один раз
    prefer_rgb_color: true          # Использовать RGB вместо цветовой температуры

Сценарии использования

Режим сна. Adaptive Lighting может плавно снижать яркость и теплоту света вечером. Настройте sleep_brightness и sleep_color_temp, и свет сам станет приглушённым после 22:00.

Адаптация к погоде. Интеграция умеет учитывать облачность — в пасмурный день свет будет теплее. Для этого нужно добавить сенсор погоды:

adaptive_lighting:
  living_room:
    lights:
      - light.gostinaya
    weather_sensor: weather.home

Работа с датчиками присутствия. Комбинируйте Adaptive Lighting с датчиками движения: свет включается с правильной цветовой температурой в зависимости от времени суток.

Типичные ошибки

Лампы мигают при изменении. Увеличьте transition до 30-60 секунд. Резкие изменения параметров некоторые лампы не переваривают.

Адаптация не работает для конкретной лампы. Проверьте, поддерживает ли лампа управление цветовой температурой. Если нет — используйте prefer_rgb_color: true.

Конфликт с другими автоматизациями. Если у вас есть сценарии, которые включают свет с определённой яркостью, они могут конфликтовать с Adaptive Lighting. Решение — использовать take_over_control: true, тогда адаптация приостановится, если вы вручную измените настройки света.

Связка LocalTuya + Adaptive Lighting: практический пример

Теперь самое интересное — объединяем обе интеграции. У меня дома есть бюджетная Tuya-лента под потолком в гостиной. Раньше она работала через облако, и задержка при управлении была просто невыносимой. После настройки LocalTuya лента стала откликаться мгновенно, а Adaptive Lighting сделала её умной.

Вот как это выглядит в конфиге:

# configuration.yaml
localtuya:
  - host: 192.168.1.150
    device_id: "abcdef1234567890"
    local_key: "your_key_here"
    friendly_name: "LED-лента гостиная"
    protocol_version: 3.3
    entities:
      - platform: light
        friendly_name: "LED-лента гостиная"
        id: 1                    # DP для включения
        brightness_id: 2         # DP для яркости
        color_temp_id: 3         # DP для цветовой температуры
        brightness_scale: 255    # Максимальное значение яркости у устройства

adaptive_lighting:
  living_room:
    name: "Гостиная"
    lights:
      - light.led_lenta_gostinaya
    transition: 45
    min_color_temp: 2700
    max_color_temp: 5000

Обратите внимание на brightness_scale — у Tuya-устройств часто своя шкала яркости (например, 0-255 или 0-1000). Без правильного значения яркость будет работать некорректно.

Проверка результата

После настройки обеих интеграций давайте убедимся, что всё работает как надо.

Тест LocalTuya

1. Пинг устройства:

ping 192.168.1.150

Если пинг проходит — устройство в сети.

2. Проверка в Home Assistant: - Перейдите в Настройки → Устройства и службы → LocalTuya - Убедитесь, что статус устройства — «Исправен» - Попробуйте включить/выключить устройство через UI — реакция должна быть мгновенной

3. Отключение облака: Отключите интернет на роутере (или на устройстве через приложение) и проверьте, что управление работает. Если работает — мы победили облако!

Тест Adaptive Lighting

1. Проверка текущего состояния:

# В инструментах разработчика (Developer Tools → States)
# Ищем светильник, которым управляет Adaptive Lighting
# Проверяем атрибуты: color_temp, brightness

2. Визуальная проверка: Измените время на сервере Home Assistant на пару часов вперёд/назад. Свет должен плавно измениться в течение заданного transition.

3. Проверка режима сна: Если настроили sleep_brightness и sleep_color_temp, дождитесь времени сна и убедитесь, что свет стал приглушённым и тёплым.

4. Мониторинг логов:

# В логах Home Assistant должны появиться записи вида:
# "Adaptive Lighting: living_room - adjusting light.led_lenta_gostinaya"

Если записи есть — интеграция работает. Если нет — проверьте, что светильник добавлен в lights в конфигурации.

Заключение

Локальный умный дом — это не роскошь, а необходимость. Я потерял несколько устройств из-за закрытия облачных сервисов производителей, и теперь принцип «сначала локально, потом облако» — мой главный закон.

LocalTuya и Adaptive Lighting — это две интеграции, которые реально меняют опыт использования умного дома. Первая возвращает контроль над устройствами, которые, казалось бы, навсегда привязаны к китайским серверам. Вторая делает освещение по-настоящему умным, избавляя от необходимости вручную крутить яркость и цветовую температуру.

Если вы только начинаете свой путь в мир Home Assistant, советую изучить и другие полезные интеграции — я собрал список лучших в этой статье. А если хотите пойти дальше и автоматизировать всё на свете — загляните в подборку автоматизаций.

Помните: умный дом должен работать на вас, а не на облачные корпорации. Локальное управление — это свобода, надёжность и скорость. И с правильными инструментами это проще, чем кажется.

Статья обновлена в 2024 году. Все описанные интеграции проверены на Home Assistant 2024.1 и выше.