Подключение устройств Tuya

Введение в Tuya

Tuya (涂鸦) - это крупнейшая в мире платформа умного дома (IoT), на базе которой создаются тысячи устройств от различных производителей. Устройства Tuya продаются под множеством брендов, включая Smart Life, Tuya Smart, Gosund, Teckin, Moes и многие другие.

В HomeAssistant существует два основных способа интеграции устройств Tuya:

• Tuya Cloud - официальная облачная интеграция через API Tuya
• Tuya Local - локальная интеграция для прямого управления устройствами

Метод 1: Tuya Cloud (официальная интеграция)

Официальная интеграция Tuya Cloud позволяет управлять устройствами через облачные API Tuya. Этот метод поддерживает большинство устройств Tuya, но требует интернет-соединения.

Шаг 1: Установка через HACS

1. Откройте HACS в HomeAssistant
2. Перейдите в раздел "Integrations"
3. Нажмите кнопку "+" в правом нижнем углу
4. В поиске введите "Tuya"
5. Выберите "Tuya Integration" и нажмите "Download"
6. После завершения загрузки нажмите "Restart" для перезапуска HomeAssistant

Шаг 2: Создание учётной записи Tuya

Для работы с облачным API необходимо создать учётную запись на платформе разработчиков Tuya:

1. Перейдите на https://iot.tuya.com
2. Зарегистрируйте новую учётную запись или войдите через существующую
3. Перейдите в "Cloud" → "Development"
4. Создайте новый проект "Smart Home" или "Custom"
5. Запишите Access ID и Access Secret

Шаг 3: Добавление интеграции в HomeAssistant

1. Откройте HomeAssistant и перейдите в "Settings" → "Devices & Services"
2. Нажмите кнопку "+ Add Integration"
3. В поиске введите "Tuya" и выберите "Tuya"
4. Введите полученные Access ID и Access Secret
5. Выберите регион вашего аккаунта Tuya (China, America, Europe, etc.)
6. Следуйте инструкциям мастера настройки для добавления устройств

Шаг 4: Получение Device ID

Для некоторых устройств может потребоваться manual ввод Device ID:

• Откройте приложение Smart Life на телефоне
• Выберите нужное устройство
• Нажмите на иконку редактирования (обычно три точки)
• Выберите "Device Info" или "Информация об устройстве"
• Скопируйте Device ID

Метод 2: Tuya Local (локальная интеграция)

Tuya Local - это пользовательская интеграция, которая позволяет управлять устройствами Tuya локально, без использования облачных сервисов. Это обеспечивает более быстрый отклик и работу без интернета.

Шаг 1: Установка Tuya Local

1. Откройте HACS в HomeAssistant
2. Перейдите в раздел "Integrations"
3. Нажмите кнопку "+" и найдите "Tuya Local"
4. Установите интеграцию и перезапустите HomeAssistant

Шаг 2: Получение локального ключа

Для работы Tuya Local потребуется получить локальный ключ устройства:

Шаг 3: Добавление устройства

1. Откройте "Settings" → "Devices & Services" в HomeAssistant
2. Нажмите "+ Add Integration" и найдите "Tuya Local"
3. Введите IP-адрес устройства, Device ID и Local Key
4. Выберите протокол устройства (обычно auto-detect)
5. Нажмите "Submit" для добавления устройства

Поддерживаемые устройства Tuya

Платформа Tuya поддерживает тысячи различных устройств. Вот основные категории:

Создание автоматизаций

После успешного подключения устройств Tuya вы можете создавать автоматизации:

Пример автоматизации YAML

automation:
  - alias: "Включение света при движении"
    trigger:
      - platform: state
        entity_id: binary_sensor.motion_sensor_123
        to: "on"
    action:
      - service: switch.turn_on
        entity_id: switch.living_room_light

  - alias: "Выключение света через 5 минут"
    trigger:
      - platform: state
        entity_id: binary_sensor.motion_sensor_123
        to: "off"
        for:
          minutes: 5
    action:
      - service: switch.turn_off
        entity_id: switch.living_room_light

Пример автоматизации через UI

1. Откройте "Settings" → "Automations & Scenes"
2. Нажмите "Create Automation"
3. Выберите триггер (например, "Device" → ваш датчик движения)
4. Добавьте действие (например, "Call service" → "Turn on" → ваш свет)
5. Сохраните автоматизацию

Решение проблем

Устройство не обнаруживается

Если устройство не обнаруживается автоматически:

• Убедитесь, что устройство и HomeAssistant в одной сети
• Проверьте firewall и правила маршрутизатора
• Попробуйте добавить устройство вручную через IP-адрес
• Перезагрузите устройство и HomeAssistant

Неверный Local Key

Если Local Key не работает:

• Получите новый ключ через Tuya IoT Platform
• Убедитесь, что выбираете правильный регион (China, America, Europe)
• Попробуйте удалить и повторно добавить устройство в приложение Smart Life

Устройство работает нестабильно

• Проверьте качество Wi-Fi сигнала
• Перезагрузите устройство
• Проверьте логи HomeAssistant (Settings → System → Logs)
• Попробуйте переключиться между Tuya Cloud и Tuya Local

Продвинутые возможности

Альтернативные прошивки

Для продвинутых пользователей доступны альтернативные прошивки для некоторых устройств Tuya:

• Tasmota - популярная прошивка для устройств на ESP8266/ESP32
• ESPHome - интеграция с HomeAssistant через ESP
• OpenBeken - прошивка для устройств на BK7231

MQTT интеграция

Устройства Tuya можно интегрировать через MQTT после установки альтернативной прошивки:

mqtt:
  light:
    - schema: json
      command_topic: "tuya/bedroom/light/command"
      state_topic: "tuya/bedroom/light/state"
      brightness: true
      rgb: true

Полезные ресурсы

• Tuya Local на GitHub
• Официальная интеграция Tuya
• Обсуждение на форуме HA
• Tuya IoT Platform