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

Button: различия между версиями

Материал из XIOT Wiki
Новая страница: «__NOTOC__ = 🟢 Виртуальное устройство "Кнопка" = '''Кнопка''' — это виртуальное устройство, предназначенное для обработки различных типов нажатия (короткое, длинное, удержание) и запуска соответствующих действий. Кнопка может управлять светильниками, шторам...»
 
Строка 1: Строка 1:
__NOTOC__
__NOTOC__
= 🟢 Виртуальное устройство "Кнопка" =
__NOTOC__


'''Кнопка''' — это виртуальное устройство, предназначенное для обработки различных типов нажатия (короткое, длинное, удержание) и запуска соответствующих действий. Кнопка может управлять светильниками, шторами, устройствами, а также запускать сценарии.
'''Кнопка''' — это виртуальное устройство, предназначенное для обработки различных типов нажатия (короткое, длинное, удержание) и запуска соответствующих действий. Кнопка может управлять светильниками, шторами, устройствами, а также запускать сценарии.
Строка 6: Строка 6:
== ⚙️ Назначение ==
== ⚙️ Назначение ==
Кнопка реагирует на бинарный вход (0/1), получаемый из KNX, Wiren Board или любого другого источника, и определяет тип нажатия:
Кнопка реагирует на бинарный вход (0/1), получаемый из KNX, Wiren Board или любого другого источника, и определяет тип нажатия:
* короткое — включение/выключение   
* короткое — включение/выключение   
* удержание — диммирование или движение   
* удержание — диммирование или движение   
* длинное — отдельная команда (например, запуск сценария)
* длинное — отдельная команда (например, запуск сценария)


== 🔗 Работа характеристик ==
== 🧩 Работа характеристик ==
Устройство содержит две характеристики:
Устройство содержит две характеристики:
 
* '''Состояние кнопки''' — принимает значения 1 (нажато) и 0 (отжато). Обновляется напрямую от физического входа.
* '''Состояние кнопки''' — принимает значения 1 (нажато) и 0 (отжато). Обновляется напрямую от физического входа.
* '''Действие кнопки''' — логическая характеристика, определяемая автоматически на основе времени между нажатием и отпусканием.
* '''Действие кнопки''' — логическая характеристика, определяемая автоматически на основе времени между нажатием и отпусканием.


При изменении характеристики '''Состояние кнопки''', устройство запускает внутреннюю логику и определяет тип нажатия по таймингам. Результат записывается в характеристику '''Действие кнопки'''.
При изменении характеристики '''Состояние кнопки''' устройство запускает внутреннюю логику и определяет тип нажатия по таймингам. Результат записывается в характеристику '''Действие кнопки'''.


== 🔌 Интеграция с оборудованием ==
== 🔌 Интеграция с оборудованием ==
Для корректной работы необходимо связать '''Состояние кнопки''' с тегом статуса входа:
Для корректной работы необходимо связать характеристику '''Состояние кнопки''' с тегом статуса входа.


Поддерживаются:
Поддерживаются:
Строка 26: Строка 24:
* '''Выключатели KNX''' — через привязку к соответствующему групповому адресу (GA)
* '''Выключатели KNX''' — через привязку к соответствующему групповому адресу (GA)


Тег должен присылать значение '''1''' при замыкании (нажатии), и '''0''' — при размыкании (отпускании).
Тег должен присылать значение '''1''' при замыкании (нажатии) и '''0''' при размыкании (отпускании).


== 🛠 Настройка действий ==
== ⚙️ Настройка действий ==
Можно назначить действия для разных типов нажатий:
Можно назначить действия для разных типов нажатий:
* Управление светильниками — короткое нажатие включает/выключает, удержание диммирует
* Управление светильниками — короткое нажатие включает/выключает, удержание диммирует
* Управление устройствами — включение/выключение
* Управление устройствами — включение/выключение
* Управление шторами — короткое нажатие открывает/закрывает, удержание останавливает
* Управление шторами — короткое нажатие открывает/закрывает, удержание останавливает
* Запуск сценариев — привязка любых действий
* Запуск сценариев — любое действие может вызывать запуск


== ⏱ Параметры ==
== ⏱ Параметры ==
* '''Время длинного нажатия''' — длительность удержания, по истечении которой оно считается «длинным» (по умолчанию: 6 × 0.1 = 0.6 сек)
* '''Время длинного нажатия''' — длительность удержания, по истечении которой оно считается «длинным» (по умолчанию: 6 × 0.1 = 0.6 сек)


== 👁 Интерфейс ==
== 🧾 Возможные значения «Действие кнопки» ==
Кнопка — это '''системное устройство'''. Она не отображается в пользовательском интерфейсе и служит для построения логики управления.
Характеристика '''Действие кнопки''' принимает одно из следующих значений:
 
* '''отпустили''' — завершение любого нажатия 
* '''коснулись''' — моментальное касание кнопки (устанавливается мгновенно при изменении '''Состояния кнопки''' на "нажата") 
* '''одиночное нажатие''' — короткое нажатие 
* '''двойное нажатие''' — два коротких нажатия подряд 
* '''длинное нажатие''' — удержание дольше заданного времени


== 📎 Пример использования ==
'''Коснулись''' — это событие, которое фиксируется сразу при замыкании входа (нажатии). Оно позволяет максимально быстро запускать действия (например, свет по касанию), не дожидаясь завершения нажатия и определения его типа. Это особенно полезно для сценариев, требующих минимальной задержки.
На примере ниже:
* вход с модуля '''WB-MDM3''' (вход 3)
* при коротком нажатии управляется два светильника (треки в гостиной)
* удержание — диммирование


[[Файл:610a99fe-f567-43cd-a7e3-c398de6ee892.png|800px]] 
== 👁 Интерфейс ==
[[Файл:5aac0126-377b-457d-8f13-97bd1ed50774.png|800px]]
Кнопка — это '''системное устройство'''. Она не отображается в пользовательском интерфейсе и служит для построения логики.


== 🔍 См. также ==
== 🔍 См. также ==

Версия от 20:24, 12 мая 2025


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

⚙️ Назначение

Кнопка реагирует на бинарный вход (0/1), получаемый из KNX, Wiren Board или любого другого источника, и определяет тип нажатия:

  • короткое — включение/выключение
  • удержание — диммирование или движение
  • длинное — отдельная команда (например, запуск сценария)

🧩 Работа характеристик

Устройство содержит две характеристики:

  • Состояние кнопки — принимает значения 1 (нажато) и 0 (отжато). Обновляется напрямую от физического входа.
  • Действие кнопки — логическая характеристика, определяемая автоматически на основе времени между нажатием и отпусканием.

При изменении характеристики Состояние кнопки устройство запускает внутреннюю логику и определяет тип нажатия по таймингам. Результат записывается в характеристику Действие кнопки.

🔌 Интеграция с оборудованием

Для корректной работы необходимо связать характеристику Состояние кнопки с тегом статуса входа.

Поддерживаются:

  • Входы контроллера или модулей Wiren Board — WBDI-14, WB-MCM8 (в режиме быстрого Modbus), входы реле и диммеров
  • Выключатели KNX — через привязку к соответствующему групповому адресу (GA)

Тег должен присылать значение 1 при замыкании (нажатии) и 0 при размыкании (отпускании).

⚙️ Настройка действий

Можно назначить действия для разных типов нажатий:

  • Управление светильниками — короткое нажатие включает/выключает, удержание диммирует
  • Управление устройствами — включение/выключение
  • Управление шторами — короткое нажатие открывает/закрывает, удержание останавливает
  • Запуск сценариев — любое действие может вызывать запуск

⏱ Параметры

  • Время длинного нажатия — длительность удержания, по истечении которой оно считается «длинным» (по умолчанию: 6 × 0.1 = 0.6 сек)

🧾 Возможные значения «Действие кнопки»

Характеристика Действие кнопки принимает одно из следующих значений:

  • отпустили — завершение любого нажатия
  • коснулись — моментальное касание кнопки (устанавливается мгновенно при изменении Состояния кнопки на "нажата")
  • одиночное нажатие — короткое нажатие
  • двойное нажатие — два коротких нажатия подряд
  • длинное нажатие — удержание дольше заданного времени

Коснулись — это событие, которое фиксируется сразу при замыкании входа (нажатии). Оно позволяет максимально быстро запускать действия (например, свет по касанию), не дожидаясь завершения нажатия и определения его типа. Это особенно полезно для сценариев, требующих минимальной задержки.

👁 Интерфейс

Кнопка — это системное устройство. Она не отображается в пользовательском интерфейсе и служит для построения логики.

🔍 См. также