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

Light-fixture: различия между версиями

Материал из XIOT Wiki
Строка 95: Строка 95:
* При сохранении сцены фиксируются текущие значения яркости, температуры и цвета;
* При сохранении сцены фиксируются текущие значения яркости, температуры и цвета;
* При вызове сцены — они применяются ко всем светильникам в группе.
* При вызове сцены — они применяются ко всем светильникам в группе.
== Примеры использования ==
* Люстра, управляемая через DALI-драйвер — используется «включение через яркость»;
* Светодиодная лента с RGB — добавляется характеристика цвета;
* Настенные бра без диммирования — только включение и выключение;
* Биодинамический сценарий — изменяет цветовую температуру в течение дня, но только если свет включён.


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

Версия от 13:44, 10 июня 2025


Светильник

Виртуальное устройство Светильник используется для управления различными источниками света: люстрами, бра, потолочными панелями и т.п. Оно не связано жёстко с конкретным физическим устройством — интегратор сам выбирает иконку, название и настраивает связи с физическими тэгами.

Основные возможности

  • Включение / выключение
  • Управление яркостью
  • Управление цветовой температурой
  • Управление RGB-цветом
  • Работа с пользовательскими сценами
  • Поддержка логики диммирования
  • Настраиваемое поведение при выключении

Интерфейс настройки

Название и иконка

Интегратор может:

  • Указать произвольное название (например, Люстра в спальне, Бра у кровати)
  • Выбрать подходящую иконку из встроенной базы
  • Назначить комнату
  • Скрыть устройство из пользовательского приложения
  • Клонировать устройство с выбором количества копий и комнат

Характеристики

Обязательная:

  • Включение — основная характеристика для управления состоянием (вкл/выкл)

Дополнительные (добавляются по мере необходимости):

  • Яркость
  • Цветовая температура
  • Цвет (RGB)

При добавлении этих характеристик визуальное представление лампочки в приложении будет меняться — от простой иконки включения до полноцветной лампы с управлением спектром.

Параметры

Включение через изменение яркости

Этот параметр используется в ситуациях, когда у физического устройства (например, DALI через шлюз Arlight) **отсутствует тэг включения**. В таком случае:

  • при выключении яркость запоминается и сбрасывается в 0%;
  • при включении — вместо команды «включить» отправляется последняя сохранённая яркость (если она была > 0%).

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

Управление яркостью, температурой и цветом в выключенном состоянии

По умолчанию разрешено. Однако:

  • Некоторые драйверы и лампы **реагируют на изменение яркости как на включение**, даже если были выключены.
  • Если сценарий меняет цветовую температуру или яркость — устройство может включиться само, хотя включение явно не задавалось.

Параметр позволяет это предотвратить:

  • Если отключено — в выключенном состоянии значения не отправляются, а только сохраняются;
  • При включении — светильник приводит себя к сохранённым значениям.

Рекомендуется отключать этот параметр, если свет неожиданно загорается от сценариев.

Минимальный уровень яркости при включении

Определяет, какая минимальная яркость будет установлена при включении (если предыдущая была ниже).

Например:

  • сохранённая яркость — 1%
  • заданный минимум — 10%
  • при включении будет отправлено 10%

Шаг диммирования и Задержка между шагами

Используются при плавном изменении яркости:

  • Шаг — на сколько процентов изменяется яркость за один шаг;
  • Задержка — интервал между шагами (в 0.1 секундах).

Пример: если шаг = 5%, задержка = 5 (0.5 сек), то от 0 до 100% пройдёт 10 секунд.

Дополнительная логика

Позволяет задать собственные правила поведения устройства — сценарии, реакции на события, связи с другими элементами системы.

Поведение в пользовательском приложении

  • Управление происходит через интерактивную иконку светильника;
  • Если добавлена яркость — появляется ползунок;
  • Если добавлена температура и цвет — доступны дополнительные параметры;
  • При ручной регулировке яркости/цвета светильник автоматически включается.

Работа со сценами

Светильник может быть частью световой сцены в комнате или на этаже:

  • При сохранении сцены фиксируются текущие значения яркости, температуры и цвета;
  • При вызове сцены — они применяются ко всем светильникам в группе.

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

  • При работе с нестандартными драйверами всегда проверяйте реакцию на команды яркости;
  • Отключайте управление параметрами в выключенном состоянии, если устройство включает свет от изменения яркости;
  • Для плавного управления используйте шаг и задержку диммирования.