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

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

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

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

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


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


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


'''Поддержание яркости''' — это автоматическая логика регулировки освещения по значениям с одного или нескольких '''датчиков освещённости'''.
'''Поддержание яркости по датчику освещенности''' — сценарий XIOT, который поддерживает заданную освещённость, регулируя яркость одной или двух групп светильников.
 
Позволяет:
* поддерживать заданный уровень освещённости в помещении
* управлять двумя группами светильников
* адаптировать яркость на основе внешнего освещения
 
== Как это работает ==
 
Каждые 30 секунд логика:
* получает усреднённую '''текущую освещённость''' в люксах от всех подключённых датчиков
* рассчитывает относительную освещённость в процентах по заданному диапазону
* сравнивает с желаемым значением и корректирует яркость светильников
 
Дополнительно:
* каждые 5 секунд проверяется включение/выключение света
* яркость меняется пошагово, с задержкой
 
== Что настраивает интегратор ==
 
=== 💡 Датчики освещённости ===
 
Добавьте один или несколько датчиков в блок '''Датчики освещённости'''. 
Логика будет использовать среднее значение от всех устройств.
 
=== 💡 Светильники ===
 
* '''Группа 1''' — первый набор светильников
* '''Группа 2''' — второй набор светильников (необязательно)
 
Логика регулирует яркость и включение каждой группы в зависимости от настроек.
 
=== 🔢 Основные параметры ===


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


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


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


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


=== 💡 Яркость светильников ===
{| class="wikitable"
! Блок
! Что подключается
|-
| Датчики освещенности
| датчик освещённости
|}


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


=== ⚙️ Режим управления группами ===
{| class="wikitable"
! Блок
! Что подключается
|-
| Светильники 1 группы
| светильник
|-
| Светильники 2 группы
| светильник
|}


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


=== ⬆️ Управление включением ===
{| class="wikitable"
! Характеристика
! Назначение
|-
| включение сценария
| включает или выключает работу сценария
|-
| Освещённость (люксы)
| используется для расчёта и отображения управления светом
|-
| Текущая освещенность пересчитанная в %
| используется для расчёта и отображения управления светом
|-
| желаемая яркость
| используется для расчёта и отображения управления светом
|}


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


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


=== 📱 В интерфейсе ===
== Логика работы ==


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


[[Файл:f5161d3e-6cb3-4ab5-851c-01499bd764c7.png|без|мини|Параметры логики освещённости]]
== Особенности ==
[[Файл:b20d17fb-0f7f-4700-bae3-badcfdb8ab4d.png|без|мини|Настройки групп светильников]]
[[Файл:01280f1a-fd4f-44dc-a87e-cb6bbd782045.png|без|мини|Подключение устройств]]


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


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


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


* Устанавливайте минимум и максимум освещённости по реальным замерам в комнате
[[Категория:Сценарии 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