Ошибка is NOT supported означает, что устройство подключилось к Zigbee-сети, но в установленной версии Zigbee2MQTT для него нет конвертера - описания, по которому у устройства появляются сущности. В одной из веток помогло обновление аддона Zigbee2MQTT. Если устройства нет и в актуальной версии, остается официальная инструкция Zigbee2MQTT по добавлению поддержки новых устройств, в том числе через внешний конвертер.
Как выглядит проблема
В обсуждениях Zigbee2MQTT сообщает, что устройство не поддерживается:
- Inovelli VZM31-SN подключается к сети UZG-01, но Zigbee2MQTT пишет, что устройство не поддерживается.
- Поливочный клапан TS0601 определяется как неподдерживаемый, и среди сущностей у него остается только Linkquality (уровень сигнала).
- Устройство, купленное на AliExpress, помечается как неподдерживаемое, автор не смог его добавить.
В логе при этом появляются предупреждения:
Warning Device '0x94deb8fffef4c1f3' with Zigbee model 'VZM31-SN' and manufacturer name 'Inovelli' is NOT supported, please follow https://www.zigbee2mqtt.io/how_tos/how_to_support_new_devices.html
2m: Device '0x4c97a1fffef0bffd' with Zigbee model 'TS0601' and manufacturer name '_TZE284_fhvpaltk' is NOT supported, please follow https://www.zigbee2mqtt.io/advanced/support-new_devices/01_support_new_devices.htmlЕще одно сообщение - про внешний конвертер, который Zigbee2MQTT проигнорировал:
z2m: Invalid external converter 'valve_converter.js' was ignored and renamed to prevent interference with Zigbee2MQTT.Причины
Одна причина названа в 1 ветке форума из 3 - старая версия аддона Zigbee2MQTT, в которой устройство еще не поддерживается. В остальных ветках причина не названа.
| Причина | Как проверить | Что сделать |
|---|---|---|
| Старая версия аддона Zigbee2MQTT, в которой нет поддержки устройства (подтверждена в 1 ветке) | Посмотреть версию установленного аддона. В логе при этом есть строка is NOT supported с моделью и производителем устройства | Обновить аддон Zigbee2MQTT до актуальной версии |
Решения
Помогли четыре решения, каждое в 1 ветке форума из 1, где его пробовали. Три из них - опыт пользователей форума, четвертое подтверждено документацией Zigbee2MQTT.
Обновление аддона
Если аддон давно не обновлялся, поддержка устройства могла уже появиться. В ветке с Inovelli VZM31-SN и сетью UZG-01 устройство заработало после обновления - в обсуждении упоминается релиз 1.19.0. Это опыт одного пользователя форума.
Внешний конвертер в папке external_converters
Конвертер - это файл с описанием устройства. Его кладут в папку external_converters Zigbee2MQTT, а не в configuration.yaml. У одного пользователя поливочный клапан TS0601 заработал именно после того, как файл оказался в правильной папке. Подробнее об аддоне - в гайде по установке и настройке Zigbee2MQTT в Home Assistant.
Готовое исправление из pull request
Для клапана TS0601 с кодом производителя _TZE284_fhvpaltk у пользователя сработал конвертер из комментария к pull request в репозитории zigbee-herdsman-converters, где лежат конвертеры Zigbee2MQTT. Это опыт одного пользователя форума.
Официальная инструкция по новым устройствам
Если устройства нет в базе, следуйте официальной инструкции Zigbee2MQTT по добавлению поддержки новых устройств - на нее Zigbee2MQTT ссылается в предупреждении. Гайд описывает, как добавить новое устройство, в том числе через временные внешние конвертеры. Документация подтверждает, что такой гайд есть, а решение помогло в 1 ветке из 1.
Если не помогло
В собранных ветках нет сообщений, что перечисленные решения не сработали. Есть один неподтвержденный вариант: перейти с Zigbee2MQTT на ZHA и использовать для устройства quirk - модуль поддержки в ZHA. Это предложение с форума, подтверждений нет, никто не сообщил, что переход помог. Про другой клапан в ZHA есть отдельная страница: клапан полива GIEX GX-02 не управляется.
Частые вопросы
Почему у устройства только Linkquality и нет других сущностей?
Linkquality - это уровень сигнала. Если Zigbee2MQTT пишет, что устройство не поддерживается, из сущностей может остаться только он. Так было у поливочного клапана TS0601. Если устройство поддерживается, но сущности до Home Assistant не доходят или пропадают, это другие проблемы: устройства Zigbee2MQTT не появляются в Home Assistant или сущность лампы удалилась и не возвращается.
Что делать, если устройства нет в списке поддерживаемых?
Следовать официальной инструкции по добавлению поддержки новых устройств - прямую ссылку Zigbee2MQTT сам пишет в предупреждении рядом с моделью устройства. Гайд описывает шаги для новых моделей, включая временные внешние конвертеры. Перед этим стоит обновить аддон: иногда устройство уже поддерживается в свежем релизе. В одной из веток этот путь закрыл вопрос с устройством, купленным на AliExpress.
Помогает ли переход на ZHA?
Подтверждений нет. На форуме предлагали перейти на ZHA и использовать quirk - модуль поддержки устройства для этой платформы. В собранных ветках никто не сообщил, что это помогло, ни одного подтвержденного случая нет.
Всегда ли помогает обновление Zigbee2MQTT?
Нет, только если поддержка устройства уже добавлена в новый релиз. В ветке с Inovelli VZM31-SN обновление до релиза 1.19.0 решило проблему, но это опыт одного пользователя. Если устройство не поддерживается и в актуальной версии аддона, обновлением вопрос не закрыть - понадобится внешний конвертер в папке external_converters или работа по официальной инструкции.
