Координатор V4 (cc2652p) для одноплатных компьютеров

Шилд (Pi Hat) V4 - это координатор V4 для Raspberry Pi и прочих одноплатных компьютеров. Его можно установить внутрь корпуса одноплатника и снаружи будет только антенна. Как и стик V4, шилд является рекомендованным устройством для Zigbee2MQTT. Работает и c ZHA.

Установка и конфигурация

Помните, что устройство боится статического электричества и переплюсовки! Устанавливать аккуратно! Контакты не трогать!

Шилд устанавливается на край гребенки GPIO (для Raspbery Pi это пины 1-10).

Аккуратно с разъемом антенны! При отсоединении кабеля разъем может оторваться от платы, если прилагать усилия [и/или выбрать неудачный угол].

Конфигурация операционной системы

Существует множество одноплатных компьютеров, совместимых по гребенке с Raspberry Pi. Операционные системы постоянно совершенствуются. Я не могу следить за всеми и давать конкретные инструкции. Но то, что сам проверял, и то, что писали пользователи, собрал в этом файле.

Адаптер для подключения к USB

Настройка шилда - задача для героев :) Но можно превратить шилд в обычный USB стик с помощью адаптера:

Конфигурация ZIGBEE2MQTT

Информация про конфигурирование Zigbee2MQTT изложена в документации. Если коротко, нужно в файле configuration.yaml прописать две строчки:

serial:
    port: /dev/ttyAMA0 # <- скорректировать на то, что у вас
    adapter: zstack

Если нужно поменять мощность передатчика или отключить светодиоды - это здесь:

advanced:
    transmit_power: 5
    disable_led: false

Примечание: в Home Assistant конфиг аддона Zigbee2MQTT находится тут:
/homeassistant/zigbee2mqtt/configuration.yaml

Смена типа адаптера (запуск координатора с другим чипом)

Если вы имеете живую сеть и планируете перейти с одного типа адаптера на другой (речь об адаптерах Zigbee2MQTT - например с zstack на ember), скорее всего вам придется заново провести сопряжение всех Zigbee устройств - бэкапы разных адаптеров несовместимы между собой.

То есть, физическая замена координатора в пределах одного типа адаптера условно не вызовет проблем (для zstack это координаторы на чипах cc2652, cc2538, cc2531, для ember - на чипах efr32mg21, efr32mg24). А вот поменять координатор, например с cc2652 на efr32mg24 безболезненно не получится - у них разные типы адаптеров в Zigbee2MQTT.

Существуют два костыльных метода переноса сети между адаптерами. Оба они не гарантируют ничего и не факт, что будут применимы завтра. Но если хочется заморочиться - вот раз, вот два :)

Варианты шилдов и прошивка

Существуют две модификации шилда V4, различающиеся типами используемых Zigbee модулей. В работе нет никакой разницы, что за модуль установлен - функционально шилды одинаковые.

Прошивка

Единственный случай, когда необходимо учитывать тип модуля - это обновление прошивки. Для устройств на модулях RF-Star следует использовать мои прошивки, или прошивки JetHome, или прошивки _launchpad_ Koenkk. Для устройств на модулях EBYTE E72 используйте мои прошивки, или прошивки Koenkk, содержащие в названии _other_.

Рекомендую использовать мои прошивки - они актуальные, не смотрите на дату выхода. Как только будет смысл переходить на новые - я их выложу. Но это не догма, конечно - в ряде специфических случаев имеет смысл обновляться c гитхаба Koenkk.

Для перепрошивки шилда воспользуйтесь моей инструкцией.

Возможна также перепрошивка стика (и очистка nvram) с помощью ZigStarGW-MT.

Прошивка в Zigbee роутер

Шилд можно перепрошить из координатора в Zigbee роутер для расширения покрытия сети. Прошивки роутера следует брать у Koenkk, так же обращая внимание на зависимость от модуля. Краткое описание прошивок роутера тут (если коротко - для сопряжения с новой сетью нужно снова перепрошить устройство).

Важная информация

Помехи на частоте 2.4ГГц

Сеть Zigbee работает на тех же частотах, что и WiFi, Bluetooth и USB3. Также на частотах 2.4ГГц могут быть помехи от радаров и микроволновок.

Следует разносить каналы WiFi и Zigbee, исходя из этой схемы:

Антенна

Если поставить антенну с бОльшим усилением, она усилит не только сигнал, но и помехи.

Сети Zigbee рядом

Следует использовать уникальный PANID - идентификатор сети Zigbee для каждой сети. Если при старте координатор унюхает в эфире PANID сети, которую он сам хочет поднять - он не сможет стартовать. Кстати, из-за помех координатор тоже может не стартовать.

Долгий отклик на команды

И это может быть из-за помех. Но иногда в этом виноваты глючные (или внезапно заглючившие) роутеры сети Zigbee.

Link quality

Такие же попугаи, как и карта сети - лубок. Даже если LQI ноль, девайс может успешно работать. А другой и при 40 - не очень. И нюанс - попугаев на стиках с EFR32 больше. Но это значит, что их считают иначе, а не что они жирнее.

Как приобрести

Приобрести это и другие устройства, которые я произвожу, можно на Avito (Egony) или обратившись напрямую ко мне.

Перед приобретением обязательно ознакомьтесь с нюансами приобретения и важной информацией.