У тебе вже працює Zigbee2MQTT або ZHA на власному свистку? Підключи його до FairGrow за чотири кроки. Залізо лишається твоїм, у мережевому екрані нічого відкривати не треба, а твої показання потрапляють на платформу, де супутникові, погодні та агрономічні дані, якими живе розсадник, уже є.
Вже маєш Home Assistant? Підключи його, більше нічого встановлювати не треба
Без другої машини і без моста. Твої пристрої залишаються в Home Assistant, з ZHA, Zigbee2MQTT чи будь-якою іншою інтеграцією. Ти позначаєш, які датчики може бачити FairGrow, і лише вони виходять за межі твого дому.
Додай FairGrow до Home Assistant
Завантаж інтеграцію і розпакуй папку fairgrow у config/custom_components свого Home Assistant (за допомогою доповнення File editor або Samba). Потім перезапусти Home Assistant. Щойно FairGrow з'явиться у списку HACS, цей крок стане одним кліком.
Завантажити інтеграціюОтримай код підключення
Код працює один раз і діє п'ятнадцять хвилин.
Увійди, щоб створити код підключенняВстав код у Home Assistant
Налаштування, Пристрої та служби, Додати інтеграцію, FairGrow. Встав код, і ти підключений.
Додати FairGrow у мій Home AssistantВибери, чим ділишся
Познач датчики, які може бачити FairGrow: температура, вологість повітря, вологість ґрунту, освітлення, потужність тощо. Пізніше це можна змінити через Налаштувати. Показники надходять щохвилини; якщо зникне інтернет, Home Assistant збереже їх і надішле пізніше.
Припини ділитися будь-коли: видали інтеграцію в Home Assistant або відключи її в розділі Твої координатори. Твоя історія на FairGrow залишається.
Для досвідчених: окремий міст
Використовуєш Zigbee2MQTT чи ZHA і хочеш, щоб FairGrow сам керував мережею Zigbee (вікно сполучення, карантин, сканування мережі)? Тоді міст нижче для тебе. Він працює на твоїй власній машині поруч із координатором.
Чотири кроки, один раз
Після цього ваш координатор відображається в 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 підключений. Що далі. Додайте пристрій, схваліть його і знайте, де він з'явиться. І за чим ми потім стежимо для вас. Додайте перший пристрій
Твої автоматизації теж можуть переїхати
Підключення координатора переносить показання. На цьому можна не зупинятися.
FairGrow може запитати твій Home Assistant, які автоматизації він виконує, і скопіювати їх до редактора робочих процесів, залишивши оригінали недоторканими, а кожну копію вимкненою, доки ти не вирішиш інакше. Річ не в тому, що Home Assistant робить це погано. Річ у тому, що тут та сама автоматизація може заодно подивитися на знімок Sentinel-2, цифру випаровування FAO-56 чи модель шкідника, і тобі не доведеться спершу будувати це самому.
Що в нас запитують
Чи доведеться мені відмовитися від Home Assistant?
Ні, і ми про це не просимо. Твоя мережа Zigbee лишається на місці, і дім далі на ній працює. Ми кажемо про інше: для землі FairGrow краще місце для твоїх показань. Copernicus, NASA POWER, FAO-56 і захист рослин за кодами EPPO є тут одразу, тоді як у Home Assistant кожне з цього окремий проєкт, який підтримуєш ти. Твої готові автоматизації можуть переїхати одним кліком.
Які координатори я можу під'єднати?
Zigbee2MQTT і Home Assistant ZHA, обидва вже сьогодні й обидва самостійно: завантажте міст, під час встановлення вкажіть, який із двох у вас, отримайте код, і готово. Якщо у вас ZHA, встановлювати Zigbee2MQTT взагалі не потрібно, і у вашій системі нічого не змінюється. Для обох ми ще завершуємо випробування на реальному обладнанні, тож повідомте нам, якщо щось піде не так. Наступним у черзі є deCONZ / Phoscon; його поки що не можна вибрати. Вашого координатора немає в списку? Напишіть нам, який у вас.
Що передається з моєї мережі?
Дані вашого координатора і пристроїв, які ви прив'язуєте під час сеансу: адреса, марка, модель і їхні вимірювання. Пристрої, що вже є у вашому Zigbee2MQTT і не прив'язуються, залишаються осторонь.
Чи треба відкривати порт?
Ні. Міст відкриває лише вихідні з'єднання. З нашого боку у вашу мережу нічого не надходить.
Як це припинити?
Відв'яжіть координатор у FairGrow. Ключ одразу стає недійсним. Ваші пристрої залишаються в списку, просто більше не отримують нових вимірювань.
А якщо мій міст якийсь час не працює?
Нічого страшного. Вимірювання припиняються і відновлюються, щойно міст знову запрацює. На картці видно, скільки часу минуло від останнього повідомлення.
Що буде, якщо пристрій відвалиться?
Ваш міст кожні п'ять хвилин повідомляє, що бачить ваш координатор. Якщо пристрій замовк, це видно в картці координатора разом із причиною: сам пристрій або маршрутизатор, через який він працював. Якщо зник зв'язок із самим мостом, ми повідомляємо про це насамперед, бо тоді здається, що зникло все, хоча зупинився лише міст.
Підключіть свій координатор
Напишіть, який стік у вас працює і що ви хочете вимірювати. Ми пройдемо прив'язку разом із вами.