Уже користуєтеся Zigbee2MQTT на власному стіку? Тоді підключите його до FairGrow за чотири кроки. Обладнання залишається вашим, а у фаєрволі нічого відкривати не потрібно.
Чотири кроки, один раз
Після цього ваш координатор відображається в FairGrow карткою, як будь-який інший пристрій.
Завантажте міст
Інсталятор для Windows, macOS або вашого Raspberry Pi. Він трохи нижче і бере решту на себе.Отримайте код прив’язки
Восьмизначний код із панелі «Показати пристрої», одноразовий і дійсний чверть години. Нижче показано, як.Введіть код один раз
Міст обмінює його на ключ, який зберігається на вашому комп’ютері. Сам код одразу після цього стає недійсним.
Підключіть перший пристрій
Відкрийте Мережа у картці вашого координатора. Там є Відкрити вікно прив’язки для нового пристрою і Прийняти пристрої для тих, що вже підключені.
Встановлення займає хвилину
Оберіть свою систему й запустіть інсталятор. Він усе підготує, запитає код прив’язки і налаштує автоматичний запуск мосту.
Міст FairGrow
Працює з вашим власним Zigbee2MQTT або напряму з ZHA у Home Assistant. Обмінюється даними лише з вашим координатором і з FairGrow, більше ні з чим.
curl -fsSL https://fairgrow.eu/wp-json/fg-zb/v1/brug/fairgrow-brug.sh -o fairgrow-brug.sh && sh fairgrow-brug.shcurl -fsSL https://fairgrow.eu/wp-json/fg-zb/v1/brug/fairgrow-brug.sh -o fairgrow-brug.sh && sh fairgrow-brug.shУвага: міст не встановлюється на сам Home Assistant. Це не інтеграція і не доповнення, а в Home Assistant OS неможливо доставити Python. Встановіть його на інший постійно ввімкнений пристрій у тій самій мережі: комп’ютер, Raspberry Pi, NAS або віртуальну машину. З ZHA він підключається до Home Assistant звідти через мережу.
Що саме робить інсталятор
- Перевіряє, чи є на комп’ютері Python 3, а якщо ні, підказує, де його взяти.
- Створює окрему теку з власним середовищем Python, ізольованим від вашої системи.
- Завантажує міст і звіряє його відбиток із тим, що повідомляє платформа. Якщо не збігається, нічого не запускається.
- Запитує ваш код прив’язки та адресу, де працює ваш Zigbee2MQTT або Home Assistant.
- Виконує прив’язку один раз і налаштовує автозапуск мосту разом із комп’ютером.
Усе зберігається в окремій теці, системний Python залишається недоторканим. Видалити можна командою fairgrow-brug.bat /verwijderen або sh fairgrow-brug.sh --verwijderen; саму прив’язку ви відкликаєте в картці координатора. Хочете вручну? Окремий скрипт мосту й далі доступний: fgzb_brug.py.
Оновити до новішої версії можна командою fairgrow-brug.bat /bijwerken або sh fairgrow-brug.sh --bijwerken. З’єднання і налаштування зберігаються, тож новий код не потрібен.
Як отримати код прив’язки
Три кліки в FairGrow. Код одноразовий і діє чверть години.
1. Панель Показати пристрої
2. Оберіть координатор
3. Ваш код
Куди потрапляють ваші вимірювання
Кожне з'єднання встановлюється з вашого боку назовні. Усередину нічого не заходить.
Кожна стрілка спрямована назовні. Координатор і пристрої залишаються у вашій мережі.
Три речі
Підтримуваний координатор
Будь-який стік, який підтримує Zigbee2MQTT: SONOFF ZBDongle-E або P, SLZB-06, ConBee III.
Робочий Zigbee2MQTT
Версія 2.x із MQTT-брокером у вашій мережі. Ваші поточні налаштування продовжують працювати.
Постійно ввімкнений комп'ютер
Міст є невеликою програмою на Python. Достатньо Raspberry Pi поруч із координатором.
Новий Zigbee-пристрій чекає на ваше рішення
Сам по собі на панелі нічого не з'являється.
Він у карантині
Пристрій чекає. Поки що ні вимірювань, ні відображення на панелі.
Ми з'ясовуємо, що це за пристрій
Марка, модель, можливості. На картці видно, що виміряно, а що взято з довідника.
Вирішуєте ви
Прийняти або відхилити. Відхилений пристрій видаляється, і повторно він уже не підключиться.
Що ваш координатор Zigbee вміє в FairGrow
Координатор іншої марки не гірший. Він просто влаштований інакше.
Працює
- Відкривати вікно прив'язки прямо з FairGrow
- Зчитувати марку, модель і можливості пристрою
- Визначати, чи може пристрій ретранслювати трафік інших
- Видаляти пристрій і блокувати його повторне підключення
- Запускати сканування мережі: які пристрої з'єднані через які і наскільки сильний зв'язок
- Розпізнавати ваш адаптер і прошивку та попереджати про відомі проблемні поєднання
Не працює
- Zigbee2MQTT не може запитати те, чого пристрій не повідомляє. Тут ми спираємося на власну бібліотеку пристроїв.
- Не кожен пристрій через Zigbee2MQTT підтримує блимання для пошуку.
Те, чого ми не змогли виміряти самі, картка так і позначає. Запозичене значення ми ніколи не видаємо за вимірювання.
Подивіться, наскільки стабільна ваша мережа Zigbee
Zigbee є комірчастою (mesh) мережею: пристрої передають дані один через одного. З координатора ви запускаєте сканування мережі й бачите, хто з'єднаний через кого.
Карта
Кожен пристрій, кожне з'єднання та його сила. Слабку ланку видно раніше, ніж датчик відпаде.
Що не так
Пристрій з єдиним сусідом, надто слабке з'єднання, щось надто далеко від координатора. З поясненням, чому ми так вважаємо.
Історія
Ми зберігаємо кожне сканування. Так видно, як слабшає зв'язок або як пристрій постійно змінює сусіда, і не доводиться чекати, поки він замовкне.
Сканування запитує в кожного маршрутизатора його таблицю сусідів і займає ефірний час, тому ніколи не запускається автоматично. А маршрутизатор, який не відповідає, ми не позначаємо мовчки як ізольований: там так і написано, що ми не знаємо.
Якщо щось не вийде, ми побачимо чому
Інсталятор перевіряє вашу систему й записує, що відбувається.
Спершу вимірюємо, потім прив'язуємо
Порти, права доступу, драйвери, завдання автозапуску. Майже все, що ламається, ламається поза мостом.
Частину даних ми бачимо у себе
Кожна спроба отримує номер. Під ним зберігається все, що надійшло з вашого боку, навіть якщо прив'язка так і не вдалася.
Надіслати можна однією кнопкою
У розділі «Ваші координатори» є кнопка «Надіслати журнал». Паролі маскуються одразу під час отримання.
Яке обладнання Zigbee працює. Що не працює з адаптерами й пристроями з магазину і що ми беремо на себе. Подивитися, що працює
Ваш координатор Zigbee підключений. Що далі. Додайте пристрій, схваліть його і знайте, де він з'явиться. І за чим ми потім стежимо для вас. Додайте перший пристрій
Що в нас запитують
Які координатори я можу під'єднати?
Zigbee2MQTT і Home Assistant ZHA, обидва вже сьогодні й обидва самостійно: завантажте міст, під час встановлення вкажіть, який із двох у вас, отримайте код, і готово. Якщо у вас ZHA, встановлювати Zigbee2MQTT взагалі не потрібно, і у вашій системі нічого не змінюється. Для обох ми ще завершуємо випробування на реальному обладнанні, тож повідомте нам, якщо щось піде не так. Наступним у черзі є deCONZ / Phoscon; його поки що не можна вибрати. Вашого координатора немає в списку? Напишіть нам, який у вас.
Що передається з моєї мережі?
Дані вашого координатора і пристроїв, які ви прив'язуєте під час сеансу: адреса, марка, модель і їхні вимірювання. Пристрої, що вже є у вашому Zigbee2MQTT і не прив'язуються, залишаються осторонь.
Чи треба відкривати порт?
Ні. Міст відкриває лише вихідні з'єднання. З нашого боку у вашу мережу нічого не надходить.
Як це припинити?
Відв'яжіть координатор у FairGrow. Ключ одразу стає недійсним. Ваші пристрої залишаються в списку, просто більше не отримують нових вимірювань.
А якщо мій міст якийсь час не працює?
Нічого страшного. Вимірювання припиняються і відновлюються, щойно міст знову запрацює. На картці видно, скільки часу минуло від останнього повідомлення.
Що буде, якщо пристрій відвалиться?
Ваш міст кожні п'ять хвилин повідомляє, що бачить ваш координатор. Якщо пристрій замовк, це видно в картці координатора разом із причиною: сам пристрій або маршрутизатор, через який він працював. Якщо зник зв'язок із самим мостом, ми повідомляємо про це насамперед, бо тоді здається, що зникло все, хоча зупинився лише міст.
Підключіть свій координатор
Напишіть, який стік у вас працює і що ви хочете вимірювати. Ми пройдемо прив'язку разом із вами.
