Устройства Tuya из приложений Tuya Smart и Smart Life добавляются в Home Assistant через официальную интеграцию Tuya. Основной путь - облачная интеграция: она авторизуется по User Code и QR-коду из мобильного приложения. Для устройств с Wi-Fi есть локальная альтернатива Tuya Local, которую ставят через HACS. Если Home Assistant еще не установлен, сначала пройдите установку Home Assistant.
Что понадобится
Для подключения нужны четыре вещи, перечисленные в документации интеграции:
- аккаунт в приложении Tuya Smart или Smart Life, в который добавлено хотя бы одно устройство;
- приложение Smart Life или Tuya Smart на телефоне - им сканируют QR-код;
- второй экран для показа QR-кода - другой телефон, планшет или компьютер;
- User Code из приложения Smart Life или Tuya Smart - код нужен для входа.
Настройка облачной интеграции
Вся настройка сводится к пяти шагам: добавляете интеграцию, входите по User Code и QR-коду, дальше следуете подсказкам на экране.
1. Добавьте интеграцию Tuya
Добавьте хаб Tuya кнопкой My со страницы интеграции в документации или вручную: откройте Settings → Devices & services и выберите Tuya.
2. Откройте экран добавления интеграции
В правом нижнем углу нажмите Add Integration и выберите Tuya из списка.
3. Найдите User Code в приложении
Откройте приложение Smart Life или Tuya Smart, нажмите Me, затем значок шестеренки и выберите Account and Security. Внизу экрана отображается User Code - именно его запрашивает интеграция при входе.
4. Отсканируйте QR-код
Нажмите Scan в приложении и наведите камеру на QR-код, который показывает Home Assistant.
5. Завершите настройку
Следуйте инструкциям на экране, чтобы завершить настройку.
Tuya Local
Tuya Local - альтернатива для локального управления устройствами Tuya. Это кастомная интеграция: она не входит в состав Home Assistant и ставится через HACS (каталог пользовательских интеграций для Home Assistant). Устройства подключаются по Wi-Fi, а оборудование за хабами Tuya поддерживается ограниченно.
| Облачная интеграция Tuya | Tuya Local | |
|---|---|---|
| Что нужно для работы | Аккаунт Tuya Smart или Smart Life, User Code | HACS, device ID, local key и IP-адрес устройства |
| Как передаются команды | Через облако Tuya, IoT-класс Cloud Push | Локально, по сети |
| Какие устройства | Устройства из аккаунта | Устройства с Wi-Fi, через хабы - ограниченно |
Для настройки нужны данные конкретного устройства: device ID, local key (локальный ключ) и IP-адрес. Добавление проходит в режиме cloud-assisted, где интеграция проводит через авторизацию, либо в ручном режиме. Поддержка зависит от модели - актуальный список поддерживаемых устройств ведется в файле DEVICES.md, описание установки есть в README проекта. HACS ставится отдельно; если он не появляется в списке интеграций после установки, на сайте есть отдельный разбор этой проблемы.
Ограничения
Ограничения у двух вариантов разные.
Облачная интеграция Tuya:
- использует облако Tuya, ее IoT-класс - Cloud Push, поэтому нужен аккаунт Tuya Smart или Smart Life;
- когда Tuya обновляет условия использования
iot.tuya.com, интеграция требует повторной аутентификации; - построена на SDK Tuya (набор инструментов разработчика), который открывает не все функции приложения SmartLife, поэтому отдельные возможности устройства могут отсутствовать в Home Assistant;
- хаб Tuya появился в Home Assistant 0.74.
Ограничения Tuya Local:
- многие устройства Tuya, судя по документации, поддерживают только одно локальное соединение;
- local key устройства меняется при каждом сопряжении;
- питающиеся от батареи устройства - датчики открытия дверей и окон, дымовые извещатели - как правило не поддерживаются без хаба;
- минимальная версия Home Assistant для Tuya Local авторами не заявлена.
Частые проблемы
В таблице - три ситуации из веток форума и то, что в них помогало. Это опыт пользователей, а не правило из документации.
| Проблема | Что помогало пользователям |
|---|---|
| Не удается найти User Code для входа (4 ветки форума) | Пользователям помогал путь в приложении Smart Life: вкладка Me, шестигранный значок в правом верхнем углу, затем Account and Security и User Code. Подробности - разбор проблемы |
Unknown error occurred после ввода User Code (3 ветки форума) | У пользователей помогало отключение IPv6 в сетевых настройках Home Assistant. Подробности - как справиться с ошибкой |
Вход по QR-коду не проходит: код белый или просрочен, ошибка Login error (0): Login failed, please scan and try again! (2 ветки форума) | Помогало вернуть в профиле Home Assistant тему по умолчанию, открыть шаг входа в другом браузере или в приложении Home Assistant, очистить кэш браузера |
Частые вопросы
Можно ли управлять устройствами Tuya без облака?
Да, для устройств с Wi-Fi есть интеграция Tuya Local. Она ставится через HACS и настраивается по device ID, local key и IP-адресу устройства, поддержка зависит от конкретной модели и проверяется по списку в DEVICES.md. Полного отключения от облака она не дает: устройства продолжают отправлять статус в облако Tuya, так что Tuya Local не стоит рассматривать как способ защиты данных.
Почему интеграция снова просит войти в аккаунт?
Одна из причин: Tuya обновила условия использования iot.tuya.com, и интеграция запрашивает повторную аутентификацию, это описанное в документации поведение. Войдите заново по той же схеме: откройте шаг входа, введите User Code из приложения и отсканируйте QR-код. Если после ввода кода появляется ошибка Unknown error occurred, пользователям помогало отключение IPv6 в сетевых настройках Home Assistant.
Почему у устройства нет части функций из приложения?
Одна из причин - SDK Tuya. Официальная интеграция построена на нем, а SDK открывает не все функции приложения SmartLife, поэтому отдельные функции устройства могут быть в приложении и отсутствовать в Home Assistant. Для Tuya Local поддержка зависит от конкретной модели: список поддерживаемых устройств ведется в DEVICES.md.
Работают ли датчики на батарейках через Tuya Local?
Как правило, нет. Устройства на батареях - датчики открытия дверей и окон, дымовые извещатели - не поддерживаются Tuya Local без хаба. Устройства, подключенные через хабы, поддерживаются ограниченно, а поддержка зависит от модели. Перед подключением проверьте конкретное устройство по списку в DEVICES.md.
Tuya Local перестал работать после перепривязки устройства. Что делать?
Скорее всего, нужно обновить local key. Он меняется при каждом сопряжении устройства, поэтому после повторной привязки старое значение в настройках Tuya Local перестает подходить. Введите новый local key в настройках устройства. Если устройство по-прежнему не отвечает, учтите, что многие устройства Tuya, судя по документации, поддерживают только одно локальное соединение.
