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

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

Материал из XIOT Wiki
Новая страница: «__NOTOC__ = Светильник = Виртуальное устройство '''Светильник''' используется для управления различными источниками света: люстрами, бра, потолочными панелями и т.п. Оно не связано жёстко с конкретным физическим устройством — интегратор сам выбирает иконку...»
 
Строка 17: Строка 17:
== Интерфейс настройки ==
== Интерфейс настройки ==


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


Интегратор может:
Интегратор может:
Строка 26: Строка 26:
* Клонировать устройство с выбором количества копий и комнат
* Клонировать устройство с выбором количества копий и комнат


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


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


== Параметры
== Параметры ==


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


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


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


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


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


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


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


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


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


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


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


* Управление происходит через интерактивную иконку светильника;
* Управление происходит через интерактивную иконку светильника;
Строка 90: Строка 90:
* При ручной регулировке яркости/цвета светильник автоматически включается.
* При ручной регулировке яркости/цвета светильник автоматически включается.


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


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


== Примеры использования
== Примеры использования ==


* Люстра, управляемая через DALI-драйвер — используется «включение через яркость»;
* Люстра, управляемая через DALI-драйвер — используется «включение через яркость»;
Строка 103: Строка 103:
* Биодинамический сценарий — изменяет цветовую температуру в течение дня, но только если свет включён.
* Биодинамический сценарий — изменяет цветовую температуру в течение дня, но только если свет включён.


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


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

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


Светильник

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

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

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

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

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

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

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

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

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

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

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

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

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

Параметры

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

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

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

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

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

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

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

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

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

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

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

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

Например:

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

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

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

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

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

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

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

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

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

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

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

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

Примеры использования

  • Люстра, управляемая через DALI-драйвер — используется «включение через яркость»;
  • Светодиодная лента с RGB — добавляется характеристика цвета;
  • Настенные бра без диммирования — только включение и выключение;
  • Биодинамический сценарий — изменяет цветовую температуру в течение дня, но только если свет включён.

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

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