Где найти User Code для интеграции Tuya в Home Assistant

После обновления Home Assistant до версии 2024.2.1 интеграция Tuya просит пройти повторную аутентификацию: запрашивает User Code и предлагает сканировать QR-код приложением Smart Life. Помогали два шага, у каждого по одному успешному отчету: найти User Code в приложении Smart Life и ввести его или заново войти в интеграцию по QR-коду. Сам запрос ожидаем: релиз 2024.2 перевел интеграцию Tuya на вход по QR-коду. Подробности про процесс обновления собраны в руководстве по обновлению Home Assistant.

Как проявляется проблема

Проблема возникает после обновления до 2024.2.1: интеграция Tuya требует повторную аутентификацию, но нужный для нее User Code или QR-код не удается получить. Варианты симптома в ветках форума:

  • после обновления до 2024.2.1 интеграция Tuya просит пройти повторную аутентификацию;
  • в окне запрашивается Tuya User Code, но найти его в приложении не получается;
  • в окне запрашивается Smart User Code, которого нет в приложении Tuya;
  • QR-код, который предлагают отсканировать приложением Smart Life, уже недействителен.

Причины

Известны две причины: новая аутентификация в релизе 2024.2 и устаревшее приложение Smart Life. Первая названа в ветке форума, вторая остается предположением.

ПричинаКак проверитьЧто сделать
Релиз 2024.2 перевел интеграцию Tuya на аутентификацию по QR-коду, поэтому запрашивается повторный входЗапрос появился после обновления Home Assistant до 2024.2.1Пройти повторную аутентификацию: ввести User Code из приложения или отсканировать QR-код
Старая версия приложения Smart Life не показывает User Code (предположение с форума)В приложении нет пункта User Code в разделе Account and SecurityОбновить или переустановить приложение Smart Life и искать код заново

Решения

Ниже шесть шагов. Первые два подтверждены документацией, шаги 3, 4 и 6 - опыт отдельных пользователей форума.

1. Найти User Code в приложении Smart Life. Помогло в 1 ветке из 2, где его пробовали, во второй результат остался неизвестным. Путь в приложении: вкладка Me, шестигранная иконка в правом верхнем углу, раздел Account and Security, пункт User Code. Путь подтвержден документацией Home Assistant: Me, Account and Security, User Code внизу страницы. Шестигранная иконка в документации не упоминается, это подсказка участников форума. Если после ввода кода появляется ошибка Unknown error occurred, разбирать ее нужно отдельно, см. Unknown error occurred после ввода User Code.

2. Заново войти в интеграцию по QR-коду. Отсканируйте QR-код, показанный на экране Home Assistant, приложением Tuya Smart или Smart Life. Помогло в 1 ветке из 2, в другой сканирование не помогло. Способ подтвержден документацией интеграции Tuya.

3. Обновить или переустановить приложение Smart Life. Помогло одному пользователю форума. Обновите приложение до свежей версии, затем ищите User Code заново. Документацией не подтверждено, идет как опыт пользователей.

4. Ввести код через Firefox. Когда ввод user code в Chrome заканчивается неудачей, одному пользователю помог браузер Firefox. Документацией не подтверждено.

5. Убедиться, что аккаунт разработчика не нужен. В примечаниях к релизу 2024.2 прямо сказано: «Having a developer account with Tuya is no longer required;». Вход теперь идет по QR-коду. Один пользователь также написал, что запрос появляется в Repairs dashboard; такого утверждения в документации нет, оно остается опытом форума.

6. Перезагрузить интеграцию и нажать Regenerate. Если QR-код стал недействительным, перезагрузите интеграцию Tuya, нажмите Regenerate и отсканируйте новый код. Помогло одному пользователю, документацией не подтверждено.

Если не помогло

Решений, которые однозначно не помогли, в ветках не отмечено, но три варианта остались без подтверждения:

  • сопрячь устройство в приложении Smart Life вместо приложения Tuya; результат частичный, без подтверждения. Документация говорит лишь, что интеграция подхватывает все устройства Powered by Tuya, добавленные в обоих приложениях Tuya Smart и Tuya Smart Life, в каком именно сопрягать новые - не сказано;
  • откатиться на бэкап 2024.1.6; один пользователь пошел этим путем и бросил его, подтверждений нет;
  • поставить интеграцию Smart Life из HACS (каталог кастомных интеграций сообщества); тоже закончилось отказом от затеи. Если после установки HACS не появляется в списке интеграций, это отдельная проблема с HACS.

Общая настройка интеграции описана в руководстве Tuya и Tuya Local в Home Assistant.

Частые вопросы

Нужен ли аккаунт разработчика Tuya

Нет, не нужен. В примечаниях к версии 2024.2 прямо сказано: «Having a developer account with Tuya is no longer required;». Вход идет через QR-код, показанный на экране Home Assistant, а если запрашивается User Code, он берется из приложения Smart Life.

Каким приложением сканировать QR-код

Подойдет и Tuya Smart, и Smart Life. Документация интеграции описывает шаг как сканирование QR-кода, показанного на экране Home Assistant. Участники форума сканировали обоими приложениями. В одной ветке сканирование помогло, в другой сначала не сработало, а помогло после перезагрузки интеграции и нажатия Regenerate.

Почему в Smart Life нет пункта User Code

Возможно, приложение устарело: так предположили в одной ветке. Код должен находиться по пути Me → Account and Security → User Code внизу страницы, это подтверждено документацией. Если пункта нет, одному пользователю помогло обновление и переустановка приложения. По пути участники форума также называют шестигранную иконку в правом верхнем углу вкладки Me.

В каком приложении сопрягать устройства, чтобы их видел Home Assistant

Прямой инструкции в документации нет. Интеграция Tuya подхватывает все устройства Powered by Tuya, добавленные в обоих приложениях Tuya Smart и Tuya Smart Life, так написано на странице интеграции. Один пользователь частично получил результат, сопрягая устройство в Smart Life вместо приложения Tuya, но способ остался без подтверждения. Какое приложение предпочесть для новых устройств, не сказано.

Андрей Ковалев, редактор. Собирает решения из веток форума Home Assistant и сверяет команды и настройки с официальной документацией.