Document individual options for Zigbee devices

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/).
+Уникальные опции позволяют при необходимости переопределять любые параметры, указанные в библиотеке, для конкретного устройства.