У тебя уже крутится 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. Он находится чуть ниже и сделает всё остальное.Получите код привязки
Восьмизначный код на панели «Показать устройства»: одноразовый, действует 15 минут. Как это сделать, показано ниже.Введите код один раз
Мост обменивает его на ключ, который хранится на вашем компьютере. После этого код сразу становится недействительным.
Подключите первое устройство
Перейдите в раздел Сеть вашего координатора. Там есть кнопки Открыть окно привязки для нового устройства и Принять устройства для уже подключённых.
Установка занимает минуту
Выберите свою систему и запустите установщик. Он всё подготовит, запросит код привязки и настроит автоматический запуск моста.
Мост 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. Код одноразовый и действует 15 минут.
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 использует ячеистую сеть: устройства передают данные друг через друга. С координатора вы запускаете сканирование сети и видите, какое устройство связано через какое.
Карта сети
Все устройства, все связи и их качество. Слабое звено видно раньше, чем датчик пропадёт из сети.
Что не так
Устройство с единственным соседом, слишком слабая связь, устройство слишком далеко от координатора. С указанием правила, на котором основан вывод.
Динамика во времени
Мы сохраняем результаты каждого сканирования. Так видно, как слабеет связь или как устройство постоянно меняет соседа, и вы узнаёте об этом раньше, чем оно замолчит.
Сканирование запрашивает у каждого роутера таблицу соседей и занимает эфирное время, поэтому автоматически оно не запускается. Если роутер не отвечает, мы не объявляем его молча изолированным, а честно пишем, что данных нет.
Если что-то не получится, мы увидим причину
Установка проверяет вашу систему и записывает, что происходит.
Сначала проверка, потом привязка
Порты, права доступа, драйверы, задача автозапуска. Почти все сбои происходят за пределами моста.
Половина журнала уже у нас
Каждой попытке присваивается ссылка. По ней хранится всё, что пришло с вашей стороны, даже если привязка так и не удалась.
Отправить можно одной кнопкой
В разделе «Ваши координаторы» есть кнопка «Отправить журнал». Пароли скрываются сразу при получении.
Какое оборудование 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. Ключ сразу становится недействительным. Ваши устройства останутся в списке, но новых измерений от них больше не будет.
А если мост какое-то время не работает?
Ничего страшного. Измерения приостанавливаются и возобновляются, как только мост снова заработает. На карточке видно, сколько времени прошло с последнего сообщения.
Что будет, если устройство пропадёт из сети?
Каждые пять минут мост сообщает, какие устройства видит ваш координатор. Если устройство замолчало, это видно на карточке координатора вместе с причиной: неисправно само устройство или роутер, через который оно было подключено. Если на связь перестал выходить мост, мы сообщаем об этом в первую очередь: в этом случае кажется, что пропало всё, хотя остановился только мост.
Подключите свой координатор
Напишите, какой у вас стик и что вы хотите измерять. Мы пройдём привязку вместе с вами.