Illuminance-sensor

Актуально начиная с версии прошивки v13.6

Назначение

Датчик освещённости измеряет уровень света в помещении и передаёт значение в люксах или процентах, в зависимости от типа устройства.

Используется для:

• управления освещением
• адаптации яркости светильников
• мониторинга света в комнатах и сценариях

Что настраивает интегратор

📏 Формат данных от датчика

Уточните, в каком формате физический датчик передаёт значение:

• Если датчик отправляет в люксах — свяжите адрес состояния с характеристикой Освещённость (люксы)
• Если датчик сразу отправляет значение в процентах — свяжите с характеристикой Освещённость (%)

⚠️ Важно: для входного показания датчика задайте адрес состояния. Адрес управления для измерения освещённости не нужен: XIOT получает данные от датчика, но не отправляет в него команды. Возможность ручного изменения характеристики отдельно определяется её типом и правами.

🔢 Порог максимальной освещённости

Если используется формат люксы, задайте порог максимального значения — это граница, при которой будет считаться 100%.

Пример:

• Порог = 200 люкс → при 200 и выше характеристика Освещённость (%) будет равна 100
• При 100 люкс → будет рассчитано 50%

Это значение используется для расчёта относительной яркости и может участвовать в логике комнаты или сценариях.

Как это работает

💡 Приём значения от физического датчика

• XIOT получает значение по адресу состояния
• В зависимости от настройки:

 * либо сохраняется в характеристику Освещённость (люксы)
 * либо напрямую в Освещённость (%)

📊 Расчёт процента яркости (если люксы)

Если подключен датчик в люксах и задан порог максимума — XIOT автоматически рассчитывает процент:

• Значение больше порога → 100%
• Ниже → пропорциональное значение от 0 до 100%
• Отрицательные и ошибочные значения → 0%

Результат сохраняется в характеристику Освещённость (%)

🏠 Передача данных в комнату

Датчик всегда принадлежит комнате. При изменении характеристик:

• Значение люксов → автоматически передаётся в комнату
• Значение процента (если используется) → также передаётся

Комната может использовать эти данные в своей логике освещения.

Что увидит пользователь

📱 Интерфейс приложения

• Отображается текущее значение освещённости:

 * либо в люксах
 * либо в процентах (если используется)

• Может отображаться на карточке комнаты или в сценарии

📌 Рекомендации

• Для жилых помещений порог 100% обычно 150–300 люкс
• Для рабочих зон — 300–500 люкс
• Если датчик отдаёт проценты — расчёт внутри XIOT не нужен

Примечания

• Характеристика Освещённость (%) необязательна — используется при необходимости
• Для входного показания связывается адрес состояния независимо от формата данных
• Значения автоматически передаются в комнату, к которой относится устройство

🔗 Типовые применения

• Комнаты — адаптация освещения по текущей яркости
• Сценарии — проверка условий: «если темно — включить свет»
• Интеграция с логикой: Адаптивное освещение, диммирование, ночной режим