diff --git a/docs/zigbee/library.md b/docs/zigbee/library.md index 3930f91..62393c9 100644 --- a/docs/zigbee/library.md +++ b/docs/zigbee/library.md @@ -177,3 +177,39 @@ title: 'ZigBee: Библиотека устройств' !!! warning "" Пользовательские расширения имеют приоритет над основной библиотекой, список файлов расширений сортируется по имени, парсер библиотеки прекращает поиск описания устройства, как только найдет первое совпадение. + +## Индивидуальные опции устройств + +Кроме настроек, заданных в библиотеке устройств, сервис Zigbee позволяет задавать **индивидуальные опции для конкретных устройств**. Для этого в [конфигурации сервиса Zigbee](/zigbee/configuration/) предусмотрен параметр `options`, указывающий путь к JSON-файлу с пользовательскими настройками. + +Формат файла полностью соответствует структуре объекта опций, где: + +- **ключ** — IEEE-адрес устройства или назначенное имя устройства; +- **значение** — объект с индивидуальными опциями. + +!!! info "" + + Рекомендуется использовать **IEEE-адрес**, поскольку имя устройства может быть изменено пользователем. + +Пример задания опций: + +```json +{ + "11:22:33:44:55:66:77:88": { "availability": 3600 } + "00:11:22:33:44:55:66:77": { "occupancyResetTimeout": 30 }, +} +``` + +### Общедоступные опции + +Некоторые опции являются универсальными и могут быть заданы для любого устройства, вне зависимости от его модели. +К таким опциям относится: + +- `availability` — максимальный интервал (в секундах), в течение которого устройство считается доступным. +Если за это время от устройства не поступает никаких сообщений, оно будет отмечено как недоступное. + +### Уникальные опции + +Дополнительные опции зависят от модели устройства и описаны в его библиотечном файле в секции `options`. +Файлы библиотеки находятся в каталоге указанном в параметре `external` в [конфигурации сервиса Zigbee](/zigbee/configuration/). +Уникальные опции позволяют при необходимости переопределять любые параметры, указанные в библиотеке, для конкретного устройства.