Устройства Tuya

Экспериментально

Устройства Tuya в Homer 1.0 — эксперимент: мост tuya_bridge настроен и проверен на одном доме, а ключи устройств берутся из облачной интеграции Tuya путём, который производитель не обещал и может закрыть. На вашем доме может потребовать доводки.

Wi-Fi устройства Tuya — розетки, реле, лампы и датчики — заводятся в дом напрямую, через localtuya. Обычная интеграция Tuya отправляет каждое нажатие через облако: нет интернета — розетка не переключается. Через localtuya команда идёт по домашней сети.

Где это

	Где
Приложение	Настройки → Устройства → Устройства Tuya → «Добавить устройства»
Веб	Настройки → Устройства Tuya, тот же блок на странице «Дом» (только владельцу)

Подготовка дома к Tuya и вход в облако Tuya есть только в приложении.

Что нужно дому

• Мост tuya_bridge — компонент Homer для Home Assistant, включается строкой tuya_bridge: в configuration.yaml. Подбирает к найденным адресам ключи и версию протокола и пишет устройства в localtuya.
• localtuya — в неё заводятся устройства. Нужна закреплённая версия: мосту не хватает возможностей в других.
• Облачная интеграция Tuya в Home Assistant, с обычным входом по QR. Убирать её нельзя: из неё берутся ключи устройств (local_key). Проект на iot.tuya.com не нужен.
• Ключ администратора HA — команды моста только для администратора.

Новый дом ставит всё это себе сам — см. ниже.

Подготовить дом к Tuya

Вверху экрана «Устройства Tuya» в приложении — карточка «Подготовить дом к Tuya». В ней шаги и что с каждым: мост tuya_bridge, localtuya, строка tuya_bridge в конфиге HA, перезапуск Home Assistant, запись localtuya без облака, облако Tuya. Что уже стоит — отмечено, что сервер дома может сделать сам — сделает, что только руками — написано, как.

1. «Подготовить». Сервер дома ставит мост и localtuya, дописывает строку в конфиг и заводит запись localtuya без облака.
2. Новые компоненты HA подхватывает только при запуске, поэтому приложение спросит «Перезапустить Home Assistant?» — около минуты дом без управления. «Не сейчас» откладывает перезапуск.
3. Если что-то не вышло, всё возвращается как было: «Не вышло: …» и кнопка «Повторить».
4. Вход в облако. Впишите «Код пользователя» из Smart Life («Я» → настройки → «Учётная запись и безопасность») и нажмите «Войти в Tuya». Снимите QR приложением Smart Life (или Tuya Smart), подтвердите вход и нажмите «Готово».

localtuya скачивается с GitHub: на время подготовки серверу дома нужен выход в интернет.

Добавить в приложении

1. Подключите телефон к домашней Wi-Fi: локальный протокол Tuya дальше своей сети не ходит.
2. Откройте экран — поиск начнётся сам: «Ищу розетки в сети…», затем «Подбираю ключи…». Телефон слушает широковещалку и обходит свою подсеть, чтобы найти и тех, кто молчит. У найденного написано, что это: розетка или выключатель, свет, датчик.
3. У найденного устройства — «добавить». После заведения приложение сразу предложит комнату.
4. Лампе в комнате, где уже есть группа света, приложение предложит «Добавить в «…»» — в группу, «Заменить «…»» — вместо лампы группы, или «Без группы». При замене новая лампа встаёт на место старой и забирает её корпус, старая уходит с плана и из всех групп комнаты.
5. Заведённое видно в списке «Заведённые устройства»; у неразмещённых — «разместить», у остальных — «на плане».

Поиск идёт, только пока экран открыт. «Искать заново» — повторить.

Добавить в вебе

Браузер не слышит широковещалку, поэтому подсеть обходит сервер дома.

1. Впишите подсеть дома — первые три числа адреса, например 192.168.1. Веб подставит подсеть, если открыт по локальному адресу, и запомнит введённую.
2. «Искать устройства». Сервер обходит адреса .1–254 по порту Tuya 6668, затем мост подбирает ключи — до минуты.
3. У найденной — «Добавить». Готово — «сущностей: N — расставьте их на плане».
4. Поставьте устройство на план в правке дома.

Строка вверху — «В облаке Tuya: N, с ключом: M». «Перечитать облако» обновляет список.

Прежний entity_id

Устройство после переезда с облака на localtuya сохраняет свой entity_id: мост переименовывает облачную сущность в …_cloud и отдаёт локальной прежний id, так что план, группы, сценарии и Алиса переезда не замечают. Приложение показывает «Сохранены прежние id: …». Облачные сущности при этом гасятся, чтобы не двоиться с локальными.

Пары облачной и локальной сущности ищутся по коду точки данных. Если пара неоднозначна, мост ничего не трогает: локальная сущность получает хвост _2, как sensor.monitor_1_voltage_2 рядом с погашенной sensor.monitor_1_voltage. Кому мешает — переименуйте сущность в HA руками.

Устройствам, заведённым до того, как мост этому научился, прежние id возвращает команда моста adopt_ids. Повторный вызов безвреден: уже переданное мост пропускает.

Смена адреса

Роутер выдал устройству новый IP — localtuya его теряет. При поиске приложение сверяет адреса заведённых устройств и обновляет адрес в localtuya без повторного заведения: «Адрес обновлён: …».

Если не получилось

Сообщение	Что делать
«Готовых к добавлению не нашлось»	Устройство не в этой сети или уже заведено — заведённое мост пропускает нарочно
«В этой подсети никто не отвечает на порт Tuya (6668)»	Проверьте подсеть
«устройства нет в облаке — возможно, ключ протух после перепривязки»	Ключ меняется при каждой перепривязке устройства в приложении Tuya. «Перечитать облако» и повторите
«Не удалось завести: …»	«ещё раз»
«код пользователя не подошёл»	Код — в Smart Life: «Я» → настройки → «Учётная запись и безопасность». Проверьте и впишите заново
«вход ещё не подтверждён в приложении»	Снимите QR в Smart Life и подтвердите вход, потом «Готово»
«подготовка не вышла, всё возвращено: …»	Дом вернулся к прежнему состоянию. Прочитайте причину и нажмите «Повторить»
«localtuya … не скачалась с GitHub»	Серверу дома нужен доступ к github.com. Повторите, когда сеть будет

Шлюзы Tuya

Облако не отдаёт ключ шлюзу Tuya (Multimode gateway). Его дочерние Zigbee-устройства делят ключ шлюза, поэтому напрямую недоступны и они. Такие устройства лучше перевести в свою сеть Zigbee.