Просмотр кода страницы Сценарий "Поддержание яркости по датчику освещенности"

__NOTOC__

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

= Поддержание яркости по датчику освещённости =

== Назначение ==

'''Поддержание яркости''' — это автоматическая логика регулировки освещения по значениям с одного или нескольких '''датчиков освещённости'''.

Позволяет:
* поддерживать заданный уровень освещённости в помещении
* управлять двумя группами светильников
* адаптировать яркость на основе внешнего освещения

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

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

=== 📥 При поступлении новых значений ===

* При каждом новом значении от датчика система сразу пересчитывает среднюю освещённость по всем подключённым датчикам
* Полученное значение преобразуется в проценты, исходя из заданного диапазона (минимум и максимум искусственной освещённости)
* Система сравнивает результат с желаемым уровнем и обновляет целевую яркость светильников

Это позволяет быстро реагировать, например, на включение внешнего света или солнечный свет из окна.

=== ⏱️ Каждые 30 секунд — если нет новых данных ===

* Если новые значения от датчиков не приходили, система всё равно запускает расчёт каждые 30 секунд
* Это защищает от ситуаций, когда датчик временно не передаёт данные

=== ⏱️ Каждые 5 секунд — управление включением ===

* Если включена опция '''Управление включением''', логика проверяет, нужно ли включить или выключить светильники
* Если целевая яркость больше 0% — свет включается
* Если целевая яркость опустилась до 0% — свет выключается

Если параметр '''Управление включением''' отключён — система регулирует только яркость, но не включает и не выключает светильники самостоятельно.


=== 🌗 Плавное изменение яркости ===

* Яркость регулируется пошагово с интервалом 0.5 секунды
* При изменении целевого значения система постепенно увеличивает или уменьшает яркость, без резких скачков
* Каждая группа светильников управляется независимо

=== 📌 Режим полностью автоматический ===

Пользователь задаёт только:
* желаемый уровень освещённости (%)
* пределы регулировки яркости

Всё остальное — вычисления, управление включением и диммированием — система выполняет самостоятельно.

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

=== 💡 Датчики освещённости ===

Добавьте один или несколько датчиков в блок '''Датчики освещённости'''.  
Логика будет использовать среднее значение от всех устройств.

=== 💡 Светильники ===

* '''Группа 1''' — первый набор светильников
* '''Группа 2''' — второй набор светильников (необязательно)

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

=== 🔢 Основные параметры ===

* '''Максимальная освещённость искусственным светом''' — верхняя граница (например, 500 люкс)
* '''Минимальная освещённость искусственным светом''' — нижняя граница (например, 0 люкс)

Используются для пересчёта текущей освещённости в проценты:

: '''Освещённость % = (текущее значение - минимум) / (максимум - минимум)'''

* '''Желаемая освещённость в %''' — целевое значение, к которому стремится система

=== 💡 Яркость светильников ===

* '''Ограничение максимальной яркости 1 группы''' — максимум в %
* '''Ограничение максимальной яркости 2 группы''' — аналогично

=== ⚙️ Режим управления группами ===

* '''вместе''' — яркость обоих групп регулируется одновременно
* '''поочерёдно''' — сначала используется группа 1, затем подключается 2-я при необходимости

=== ⬆️ Управление включением ===

* Если освещённость ниже желаемой — свет включается
* Если выше — яркость уменьшается вплоть до выключения

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

=== 📱 В интерфейсе ===

* Текущая освещённость — в люксах и в процентах
* Желаемая освещённость
* Фактическая и рассчитанная яркость светильников

== Примечания ==

* Логика работает только при включённой опции '''включение логики'''
* Все значения пересчитываются автоматически, вручную задаётся только желаемая освещённость
* Группы светильников могут быть любыми — логика не зависит от их типа

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

* Устанавливайте минимум и максимум освещённости по реальным замерам в комнате
* Для жилых помещений выбирайте желаемую яркость 60–80%
* Добавьте несколько датчиков освещённости для стабильной работы