Перейти к содержанию

Constant-illuminance-scenario: различия между версиями

Материал из XIOT Wiki
← Предыдущая правка

Admin (обсуждение | вклад)

3 группы участника
3501 правка
ВизуальныйВики-текст
Английские адреса Wiki: обновление ссылок с сохранением русских подписей
 
(не показаны 4 промежуточные версии этого же участника)
Строка 1: Строка 1:
{{DISPLAYTITLE:Сценарий "Поддержание яркости по датчику освещенности"}}
__NOTOC__
__NOTOC__


''Актуально начиная с версии прошивки v13.6''
= Поддержание яркости по датчику освещенности =
 
= Поддержание яркости по датчику освещённости =


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


'''Поддержание яркости''' — это автоматическая логика регулировки освещения по значениям с одного или нескольких '''датчиков освещённости'''.
'''Поддержание яркости по датчику освещенности''' — сценарий XIOT, который поддерживает заданную освещённость, регулируя яркость одной или двух групп светильников.
 
Позволяет:
* поддерживать заданный уровень освещённости в помещении
* управлять двумя группами светильников
* адаптировать яркость на основе внешнего освещения
 
== Как это работает ==
 
Сценарий автоматически регулирует яркость светильников на основе освещённости, поступающей от датчиков.
 
=== 📥 При поступлении новых значений ===
 
* При каждом новом значении от датчика система сразу пересчитывает среднюю освещённость по всем подключённым датчикам
* Полученное значение преобразуется в проценты, исходя из заданного диапазона (минимум и максимум искусственной освещённости)
* Система сравнивает результат с желаемым уровнем и обновляет целевую яркость светильников
 
Это позволяет быстро реагировать, например, на включение внешнего света или солнечный свет из окна.
 
=== ⏱️ Каждые 30 секунд — если нет новых данных ===
 
* Если новые значения от датчиков не приходили, система всё равно запускает расчёт каждые 30 секунд
* Это защищает от ситуаций, когда датчик временно не передаёт данные
 
=== ⏱️ Каждые 5 секунд — управление включением ===
 
* Если включена опция '''Управление включением''', логика проверяет, нужно ли включить или выключить светильники
* Если целевая яркость больше 0% — свет включается
* Если целевая яркость опустилась до 0% — свет выключается
 
Если параметр '''Управление включением''' отключён — система регулирует только яркость, но не включает и не выключает светильники самостоятельно.
 
 
=== 🌗 Плавное изменение яркости ===
 
* Яркость регулируется пошагово с интервалом 0.5 секунды
* При изменении целевого значения система постепенно увеличивает или уменьшает яркость, без резких скачков
* Каждая группа светильников управляется независимо
 
=== 📌 Режим полностью автоматический ===
 
Пользователь задаёт только:
* желаемый уровень освещённости (%)
* пределы регулировки яркости
 
Всё остальное — вычисления, управление включением и диммированием — система выполняет самостоятельно.
 
== Что настраивает интегратор ==
 
=== 💡 Датчики освещённости ===
 
Добавьте один или несколько датчиков в блок '''Датчики освещённости'''. 
Логика будет использовать среднее значение от всех устройств.
 
=== 💡 Светильники ===
 
* '''Группа 1''' — первый набор светильников
* '''Группа 2''' — второй набор светильников (необязательно)
 
Логика регулирует яркость и включение каждой группы в зависимости от настроек.


=== 🔢 Основные параметры ===
== Что делает сценарий ==


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


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


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


* '''Желаемая освещённость в %''' — целевое значение, к которому стремится система
{| class="wikitable"
! Блок
! Что подключается
|-
| Датчики освещенности
| датчик освещённости
|}


=== 💡 Яркость светильников ===
=== Управляемые устройства и действия ===


* '''Ограничение максимальной яркости 1 группы''' — максимум в %
{| class="wikitable"
* '''Ограничение максимальной яркости 2 группы''' — аналогично
! Блок
! Что подключается
|-
| Светильники 1 группы
| светильник
|-
| Светильники 2 группы
| светильник
|}


=== ⚙️ Режим управления группами ===
== Характеристики сценария ==


* '''вместе''' — яркость обоих групп регулируется одновременно
{| class="wikitable"
* '''поочерёдно''' — сначала используется группа 1, затем подключается 2-я при необходимости
! Характеристика
! Назначение
|-
| включение сценария
| включает или выключает работу сценария
|-
| Освещённость (люксы)
| используется для расчёта и отображения управления светом
|-
| Текущая освещенность пересчитанная в %
| используется для расчёта и отображения управления светом
|-
| желаемая яркость
| используется для расчёта и отображения управления светом
|}


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


* Если освещённость ниже желаемой — свет включается
{| class="wikitable"
* Если выше — яркость уменьшается вплоть до выключения
! Параметр
! По умолчанию
! Варианты / единицы
|-
| Название сценария
| Поддержание яркости по датчику освещенности
|
|-
| Максимальная освещенность искусственным светом
| 200
| lux
|-
| Минимальная освещенность искусственным светом
| 0
| lux
|-
| Ограничение максимальной яркости светильников 1 группы
| 100
| %
|-
| Ограничение максимальной яркости светильников 2 группы
| 100
| %
|-
| Вариант управления группами
| 1
| вместе, по очереди
|-
| Управление включением
| 1
| не управлять, управлять
|}


== Что увидит пользователь ==
== Логика работы ==


=== 📱 В интерфейсе ===
* Каждое новое значение датчика участвует в среднем значении освещённости.
* Основной расчёт дополнительно запускается каждые 30 секунд.
* Если текущая освещённость выше желаемой, целевая яркость уменьшается; если ниже — увеличивается.
* Изменение целевой яркости ограничено шагом, чтобы не было резких скачков.
* Фактическая яркость групп доводится до цели плавными шагами по одному проценту.
* Если управление включением выключено, сценарий не повышает яркость выше текущей цели и не включает светильники сам.


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


== Примечания ==
* В режиме «по очереди» сначала используется первая группа, а вторая начинает расти только после достижения лимита первой.
* Минимальная и максимальная освещённость должны быть настроены по реальным замерам помещения.


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


== 📌 Рекомендации ==
* Проверьте усреднение нескольких датчиков освещённости.
* Сымитируйте падение освещённости и проверьте рост яркости.
* Сымитируйте рост освещённости и проверьте снижение яркости.
* Проверьте режим двух групп «вместе» и «по очереди».


* Устанавливайте минимум и максимум освещённости по реальным замерам в комнате
[[Категория:Сценарии XIOT]]
* Для жилых помещений выбирайте желаемую яркость 60–80%
[[Категория:Документация XIOT]]
* Добавьте несколько датчиков освещённости для стабильной работы
{{DEFAULTSORT:Сценарий "Поддержание яркости по датчику освещенности"}}

Текущая версия от 22:30, 2 октября 2026


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

Назначение

Поддержание яркости по датчику освещенности — сценарий XIOT, который поддерживает заданную освещённость, регулируя яркость одной или двух групп светильников.

Что делает сценарий

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

Устройства и действия

Входные блоки

Блок Что подключается
Датчики освещенности датчик освещённости

Управляемые устройства и действия

Блок Что подключается
Светильники 1 группы светильник
Светильники 2 группы светильник

Характеристики сценария

Характеристика Назначение
включение сценария включает или выключает работу сценария
Освещённость (люксы) используется для расчёта и отображения управления светом
Текущая освещенность пересчитанная в % используется для расчёта и отображения управления светом
желаемая яркость используется для расчёта и отображения управления светом

Параметры

Параметр По умолчанию Варианты / единицы
Название сценария Поддержание яркости по датчику освещенности
Максимальная освещенность искусственным светом 200 lux
Минимальная освещенность искусственным светом 0 lux
Ограничение максимальной яркости светильников 1 группы 100 %
Ограничение максимальной яркости светильников 2 группы 100 %
Вариант управления группами 1 вместе, по очереди
Управление включением 1 не управлять, управлять

Логика работы

  • Каждое новое значение датчика участвует в среднем значении освещённости.
  • Основной расчёт дополнительно запускается каждые 30 секунд.
  • Если текущая освещённость выше желаемой, целевая яркость уменьшается; если ниже — увеличивается.
  • Изменение целевой яркости ограничено шагом, чтобы не было резких скачков.
  • Фактическая яркость групп доводится до цели плавными шагами по одному проценту.
  • Если управление включением выключено, сценарий не повышает яркость выше текущей цели и не включает светильники сам.

Особенности

  • В режиме «по очереди» сначала используется первая группа, а вторая начинает расти только после достижения лимита первой.
  • Минимальная и максимальная освещённость должны быть настроены по реальным замерам помещения.

Проверка настройки

  • Проверьте усреднение нескольких датчиков освещённости.
  • Сымитируйте падение освещённости и проверьте рост яркости.
  • Сымитируйте рост освещённости и проверьте снижение яркости.
  • Проверьте режим двух групп «вместе» и «по очереди».
Источник — https://wiki.xiot.ru/index.php?title=Constant-illuminance-scenario&oldid=5830