Перенесення панелі з MQTT

Досі екран, світлодіоди, кнопки й датчики панелі потрапляли до Home Assistant через інтеграцію MQTT. Тепер Panel Assistant може сам керувати цими сутностями, зв’язуючись із панеллю через власне з’єднання Home Assistant замість брокера. Підтримку MQTT буде вилучено з ha-paneld до версії 1.0, після чого панелі взагалі не потрібен буде брокер, а ця сторінка пояснює, як перейти заздалегідь.

Ви переносите по одній панелі за раз, і кожне перенесення можна скасувати. Сутності панелі зберігають свої ідентифікатори сутностей, історію та будь-яку назву, піктограму чи приміщення, які ви їм призначили, тож інформаційні панелі й автоматизації, що їх використовують, і далі працюють.

Ранній доступ

Перенесення — нова функція. Спершу спробуйте його на одній панелі й розкажіть нам, як усе пройшло, у Discord або в issues.

Перш ніж почати

• Panel Assistant 0.3.0 або новіший у Home Assistant, встановлений через HACS, як описано на сторінці Встановлення інтеграції.
• ha-paneld 0.9.8-rc1 або новіший на панелі. Це попередній випуск: на сторінці стану панелі встановіть для Канал автооновлення ha-paneld значення prerelease, а потім встановіть оновлення із сутності оновлення панелі в Home Assistant.
• Панель увійшла в Home Assistant — так і є, якщо вона показує вашу інформаційну панель.
• Залиште налаштування MQTT без змін. Панель продовжує використовувати брокер під час перенесення, і на ній нічого змінювати не потрібно.

1. Увімкніть сутності Panel Assistant

Додайте це до configuration.yaml, а потім перезапустіть Home Assistant:

panel_assistant:
  native_entities: true

Поки що нічого не переноситься. Кожна панель, про яку знає Panel Assistant, отримує другий набір сутностей на своєму пристрої Panel Assistant, поруч із сутностями MQTT, щоб їх можна було порівняти. Коли ви переносите панель, її сутності MQTT займають місце цього другого набору.

2. Додайте панель до Panel Assistant

Пропустіть цей крок, якщо панель уже є в розділі Panel Assistant у Налаштування, Пристрої та сервіси.

Виберіть Додати інтеграцію, потім Panel Assistant, потім Додати панель у вашій мережі і введіть ім’я хоста або адресу панелі. Panel Assistant виявить, що ha-paneld уже працює, і запропонує Підключити до Home Assistant. На панелі нічого не перевстановлюється.

3. Підтвердіть користувача панелі

Коли панель підключається вперше, Home Assistant показує проблему для виправлення: Підтвердьте користувача Home Assistant для вашої панелі. Відкрийте її в Налаштування, Виправлення проблем, перевірте, що вказаний користувач — це обліковий запис, з яким входить панель, і підтвердьте.

Панель сама повторює спроби, тому до появи цієї проблеми може минути до 15 хвилин, а після вашого підтвердження панелі може знадобитися ще до 15 хвилин, щоб підключитися.

4. Перенесіть панель

Відкрийте запис Panel Assistant цієї панелі в розділі Пристрої та сервіси, виберіть Налаштувати, встановіть для Управління значення Panel Assistant і збережіть.

Запис перезавантажується, і панель знову підключається. Її сутності MQTT переходять до Panel Assistant, а коли панель підтвердить перенесення, пристрій MQTT цієї панелі видаляється. Сутності на кілька секунд стануть недоступними, а потім ще раз приблизно через 30 секунд, поки все встановлюється. Журнал активності пристрою заповнюється змінами стану, коли кожна сутність звітує; так і має бути.

Відтепер зміна налаштування або натискання кнопки в сутностях панелі проходить через Panel Assistant. До перенесення панелі ці самі елементи керування відповідають, що панель керується через MQTT.

Що не переноситься

Дві кнопки MQTT, Update ha-paneld і Update Companion app, не мають відповідника в Panel Assistant, тому їх видаляють разом із будь-якою залишеною сутністю оновлення MQTT для ha-paneld. Їхню роботу виконує сутність оновлення Panel Assistant цієї панелі.

Якщо ви дали одній із них власну назву, піктограму чи приміщення, приховали чи вимкнули її, Panel Assistant не видалить її за вас. Натомість з’явиться проблема для виправлення з цією сутністю, а панель зберігатиме свої сутності MQTT, доки ви не видалите ту сутність або не скинете ці налаштування.

Повернення панелі назад

Знову відкрийте Налаштувати і встановіть для Управління значення MQTT із вбудованими звітами для порівняння або MQTT. Сутності повертаються до інтеграції MQTT з тими самими ідентифікаторами сутностей та історією, а панель знову оголошує свій пристрій MQTT.

Завжди повертайте панель саме так. Не видаляйте запис Panel Assistant панелі, поки нею керує Panel Assistant: Home Assistant під час видалення прибирає сутності цього запису, і хоча Panel Assistant спершу повертає їх назад, сутність із власними налаштуваннями може дорогою втратити назву, піктограму чи приміщення.

Відомі обмеження

• Деякі датчики лишаються недоступними. Панель може пропонувати сутності для датчиків, про які її обладнання не звітує, як-от наближення, температура чи вологість. Це нові сутності Panel Assistant, а не перенесені, тож їх вимкнення нічого не втрачає.
• Старіший ha-paneld на перенесеній панелі. Якщо на перенесеній панелі згодом встановити версію, нижчу за 0.9.8-rc1, вона знову оголосить свої сутності MQTT. Panel Assistant вимикає дублікати й створює проблему для виправлення Оновіть ha-paneld, яка зникає, щойно панель оновлено.
• Сповіщення про перезапуск. Поки Home Assistant перезапускається, панель, обліковий запис якої не є адміністратором, досі дізнається про це через MQTT — ще одна причина поки що не вимикати брокер.