Як це працює

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

У Home Assistant: інтеграція

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

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

На панелі: застосунок

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

• Відображає вашу інформаційну панель. Застосунок сам завантажує вашу наявну інформаційну панель Home Assistant, з’ясовує, які сутності ця інформаційна панель справді показує, і запитує в Home Assistant лише їх. На дешевій панелі саме в цьому й полягає більша частина різниці між гальмуванням і його відсутністю.
• Керує обладнанням панелі. Екран, його яскравість і сон, світлодіоди, кнопки, реле, датчики наближення й освітленості та все інше, що є в моделі, керуються напряму й з’являються в Home Assistant як сутності на пристрої панелі. Кожну модель описує профіль обладнання: звичайний текст, який можна читати, редагувати й перевіряти в браузері на самій панелі, без жодних інструментів розробника. Панель, з якою проєкт ще не стикався, стартує з обережного загального профілю, який дає їй інформаційну панель, датчики, яскравість, звук і навігацію, доступні на будь-якому пристрої Android, а решту отримує в міру заповнення її профілю. Під час роботи панель перевіряє кожну заявлену можливість, перш ніж нею скористатися, тож відсутня функція показується заблокованою з поясненням, а не лишається зламаною, а профіль, що дає збій під час запуску, відкочується до останнього робочого.
• Поводиться як побутовий прилад. Застосунок заміняє лаунчер виробника, дає панелі без кнопок екранний спосіб навігації, надає власну сторінку стану у вашій мережі й сам відновлюється, коли щось іде не так, тож панель можна один раз встановити й більше не чіпати.

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

Чому це може бути відкритим кодом

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

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

Де що знаходиться

Компонент	Що це	Де
Panel Assistant	Інтеграція для Home Assistant: інсталятор, пристрої та сторінка всіх панелей.	panel-assistant/ha-integration
ha-paneld	Застосунок на панелі: інформаційна панель, обладнання, лаунчер, сторінка стану.	panel-assistant/android
Профілі обладнання	Описи для кожної моделі, які кажуть застосунку, що є в панелі і як цим керувати.	Довідка з обладнання
Довідкова документація	Докладно про API, профілі обладнання та модель безпеки.	Довідка

Чим це не є

Він призначений для спеціальних настінних панелей. Планшети й телефони теж можуть його запускати, але будь-що з акумулятором доведеться тримати на кабелі, а задум розрахований на панель із живленням від мережі, яку налаштовують один раз і більше не чіпають. Це не конструктор інформаційних панелей: він запускає ті інформаційні панелі, які у вас уже є. І він ще не завершений: мета — універсальна підтримка обладнання та керування кожною панеллю без втручання.