Xiot-device-characteristics: различия между версиями

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

Характеристика — отдельная команда, состояние, измерение или настройка виртуального устройства. Например, у светильника On отвечает за включение, а Brightness — за яркость. Название помогает найти поле в интерфейсе, технический код — однозначно отличить его от похожих полей.

Эта статья описывает общие правила и состав характеристик семи основных типов: дома, части дома, комнаты, света, выключателя, розетки и штор. Перечни сверены по актуальной схеме XIOT-EDITOR 16 сентября 2026 года. Это не список характеристик всех 48 типов; остальные устройства собраны в каталоге.

Как читать характеристики

Обязательная — входит в базовый набор типа. Это не означает, что ей обязательно нужен физический адрес или что её можно изменять вручную.
Дополнительная — расширяет возможности устройства. Проверьте её активность в конкретном проекте; название группы не означает, что все её поля всегда выключены по умолчанию.
Связанная — указана в схеме вместе с другой характеристикой. Например, у яркости есть диммирование, у RGB — отдельные цветовые составляющие. Такая связь внутри схемы не назначает адреса оборудования автоматически.
Пользовательская — добавляется интегратором для задачи проекта. Имя, тип значения и назначение определяет интегратор; это не новый стандартный тип устройства.

Команда, состояние и настройка — разные вещи. Включить свет отправляет действие, свет включен отражает состояние, а Пробуждение в будний день задаёт время. Не определяйте назначение только по похожей подписи.

Где настраивать

В разделе Устройства и сценарии выберите объект. В варианте окна Новый (бета) откройте вкладку Характеристики. Состав групп и связанные поля зависят от выбранного типа и его параметров.

У характеристики могут быть отдельные кнопки Привязка тегов, Преобразование значений, Настройки характеристики и Дополнительная логика. Не все кнопки доступны у каждого поля. Для пользовательской характеристики в настройках можно выбрать управление и состояние или только состояние.

Адрес управления отправляет команду в физический канал; адрес состояния принимает значение или обратную связь. Для системных и логических полей адрес может не требоваться. Правила назначения и смысл флажка Связать управление с состоянием описаны в Привязка реальных устройств к виртуальным и Механизм работы тегов в XIOT.

Изменения состава характеристик, их адресов и параметров применяют через Загрузить конфигурацию на контроллер: сначала успешное локальное сохранение, затем отправка сохранённого снимка. Облако и публикация приложения проверяются отдельно: Сохранение резервной копии проекта. При этом изменение текущего значения через элемент управления может отправить команду уже работающему оборудованию — это не безвредное редактирование подписи.

Дом

Дом хранит общие состояния и настройки проекта. Характеристики присутствия согласованы между собой; это не шесть независимых переключателей. HomeStatus: 0 — «я ушёл», 1 — «я дома», 2 — «отпуск», 3 — «в пути домой», 4 — «уборка».

Группа	Название в редакторе	Код
Обязательная	я дома	`InHome`
Обязательная	я ушел	`OutHome`
Обязательная	отпуск	`Vacation`
Обязательная	в пути домой	`Way_home`
Обязательная	уборка	`Cleaning`
Обязательная	состояние присутствия в доме	`HomeStatus`
Обязательная	включить свет	`LightOn`
Обязательная	выключить свет	`LightOff`
Обязательная	включить/выключить свет	`LightOnOff`
Обязательная	время рассвета	`SunriseTime`
Обязательная	время заката	`SunsetTime`
Обязательная	солнечный день	`SunnyDay`
Обязательная	ночь по закату	`Dark`
Обязательная	отопительный сезон	`ModeSeason`
Обязательная	температура на улице	`OutTemp`
Обязательная	обнаружено движение	`MotionDetected`
Обязательная	свет в доме включен	`LightOnStatus`
Обязательная	теплый пол греет	`FloorHeatHeatingState`
Обязательная	время на контроллере	`ServerTime`
Обязательная	дата на контроллере	`ServerDate`
Обязательная	дата и время на контроллере	`ServerDateTime`
Обязательная	день недели	`DayWeek`
Обязательная	Выходной или рабочий день сегодня	`WorkDay`
Обязательная	Выходной или рабочий день завтра	`WorkDayTomorrow`
Обязательная	Пробуждение в будний день	`MorningTimeWeekday`
Обязательная	Пробуждение в выходной день	`MorningTimeWeekend`
Обязательная	Уход ко сну перед рабочим днем	`DarkTimeWeekday`
Обязательная	Уход ко сну перед выходным днем	`DarkTimeWeekend`
Обязательная	ночь по времени	`DarkTime`
Обязательная	наличие электричества	`Electricity`
Обязательная	cостояние электричества	`ElectroAlarm`
Обязательная	Флаг протечки	`WaterAlarm`
Обязательная	Состояние ОПС	`SecurityFireAlarm`
Дополнительная	Целевая позиция (0–100%) всех штор	`CurtainTargetPosition`
Дополнительная	управление всеми шторами	`CurtainPositionSet`
Дополнительная	Кнопка открыть/закрыть все шторы	`CurtainOpenClose`

Важные различия:

MorningTimeWeekday, MorningTimeWeekend, DarkTimeWeekday и DarkTimeWeekend — настройки времени в формате ЧЧ:ММ, а не сигналы «событие наступило». По ним контроллер рассчитывает DarkTime.
WorkDay и WorkDayTomorrow: 0 — рабочий день, 1 — выходной. В текущей реализации выходными считаются суббота и воскресенье; это не производственный календарь праздников и переносов.
SunnyDay — признак солнечной погоды; не путайте его с временем рассвета или признаком ночи. Само наличие этой характеристики не подключает источник погоды.
Electricity показывает наличие питания, а ElectroAlarm — аварийное состояние. У них разный смысл и противоположные подписи нормы: 1 — «есть питание», но 1 у аварии — «ошибка».
ModeSeason — отопительный сезон: 0 — лето, 1 — зима. Это не календарное название времени года.

Подробнее: Виртуальное устройство "Дом".

Этаж (часть дома)

Часть дома объединяет комнаты. Общие команды и агрегированные состояния относятся к этой части проекта; они не означают, что каждый вложенный объект реагирует на любую команду.

Группа	Название в редакторе	Код
Обязательная	включить свет	`LightOn`
Обязательная	выключить свет	`LightOff`
Обязательная	включить/выключить свет	`LightOnOff`
Обязательная	обнаружено движение	`MotionDetected`
Обязательная	свет на этаже включен	`LightOnStatus`
Обязательная	теплый пол греет	`FloorHeatHeatingState`
Дополнительная	Целевая позиция (0–100%) всех штор	`CurtainTargetPosition`
Дополнительная	управление всеми шторами	`CurtainPositionSet`
Дополнительная	Кнопка открыть/закрыть все шторы	`CurtainOpenClose`

Подробнее: Виртуальное устройство "Часть дома".

Комната

Комната объединяет управление и состояния своих устройств. Состав данных зависит от активных характеристик, подключённых устройств и их логики. Значение комнаты не заменяет показания конкретного физического датчика.

Группа	Название в редакторе	Код
Обязательная	включить свет	`LightOn`
Обязательная	выключить свет	`LightOff`
Обязательная	переключить свет	`LightToggle`
Обязательная	включить/выключить свет	`LightOnOff`
Обязательная	включить свет включенный до выключения	`LightOnOld`
Обязательная	выключить/включить свет включенный до выключения	`LightOffOnOld`
Обязательная	свет в комнате включен	`LightOnStatus`
Дополнительная	активировать/сохранить световую сцену по номеру	`LightScene`
Дополнительная	активировать следующую сцену	`LightSceneNext`
Дополнительная	активировать предыдущую сцену	`LightScenePrev`
Дополнительная	яркость	`Brightness`
Дополнительная	температура цвета	`ColorTemperature`
Дополнительная	оттенок	`Hue`
Дополнительная	Целевая позиция (0–100%) всех штор	`CurtainTargetPosition`
Дополнительная	Фактическое положение (0–100%) всех штор	`CurtainCurrentPosition`
Дополнительная	управление всеми шторами	`CurtainPositionSet`
Дополнительная	Кнопка открыть/закрыть все шторы	`CurtainOpenClose`
Дополнительная	обнаружено движение	`MotionDetected`
Дополнительная	дверь открыта	`DoorOpen`
Дополнительная	окно открыто	`WindowOpen`
Дополнительная	обнаружена протечка	`LeakDetected`
Дополнительная	теплый пол включен	`FloorHeatOn`
Связанная с `FloorHeatOn`	теплый пол греет	`FloorHeatHeatingState`
Дополнительная	статус работы кондиционера комнаты	`ConditionerOn`
Дополнительная	статус режима кондиционера в комнате	`ConditionerModeHvac`
Дополнительная	радиатор включен	`RadiatorOn`
Связанная с `RadiatorOn`	состояние нагревателя	`RadiatorHeatingState`
Дополнительная	конвектор включен	`ConvectorOn`
Дополнительная	приточная вентиляция включена	`BreezerOn`
Дополнительная	текущая влажность	`CurrentRelativeHumidity`
Дополнительная	Освещённость (люксы)	`CurrentAmbientLightLevel`
Дополнительная	Освещённость (%)	`LightLevelPercentage`
Дополнительная	чистота воздуха	`AirQuality`
Дополнительная	плотность VOC	`VOCDensity`
Дополнительная	обнаружено высокое содержание углекислого газа	`CarbonDioxideDetected`
Дополнительная	уровень углекислого газа	`CarbonDioxideLevel`
Дополнительная	сильный шум	`NoiseDetected`
Дополнительная	уровень шума	`NoiseLevel`
Дополнительная	текущая температура	`CurrentTemperature`
Дополнительная	целевая температура	`TargetTemperature`
Дополнительная	состояние батареек в датчиках	`BatteryDead`
Дополнительная	ИИ аналитика	`AIAnalytics`
Связанная с `AIAnalytics`	обновление аналитики	`AIAnalyticsUpdate`

Что учитывать: TargetTemperature — уставка, а CurrentTemperature — текущее значение. Комната передаёт уставку соответствующим климатическим устройствам; для тёплого пола учитывается режим управления. FloorHeatOn не равнозначен FloorHeatHeatingState: включённое устройство не обязано нагревать прямо сейчас. Наличие AIAnalytics не подтверждает, что источник аналитики настроен и доступен.

Подробнее: Виртуальное устройство "Комната".

Свет

Тип Lightbulb в меню редактора называется «свет», а в каталоге вики — «Светильник». Базовое включение и дополнительные каналы настраиваются отдельно.

Группа	Название в редакторе	Код
Обязательная	включение	`On`
Дополнительная	яркость	`Brightness`
Связанная с `Brightness`	диммирование	`Dimming`
Дополнительная	температура цвета	`ColorTemperature`
Дополнительная	цвет	`RGB`
Связанная с `RGB`	оттенок	`Hue`
Связанная с `RGB`	насыщенность	`Saturation`
Связанная с `RGB`	красный	`ColorRed`
Связанная с `RGB`	зеленый	`ColorGreen`
Связанная с `RGB`	синий	`ColorBlue`

Единицы и формат:

Brightness — 0–100 %. Dimming задаёт действие плавного изменения яркости, а не ещё одно абсолютное значение.
ColorTemperature в XIOT использует шкалу 0–100: 0 — тёплый, 100 — холодный цвет. Не вводите сюда кельвины напрямую; соответствие шкале оборудования задаётся преобразованием значений и драйвером.
RGB — строка компонентов 0–255, например 255,0,0. Отдельные ColorRed, ColorGreen, ColorBlue используют проценты 0–100; Hue — угол 0–360, Saturation — 0–100 %.

Подробнее: Виртуальное устройство "Светильник".

Выключатель

Тип Switch — логический выключатель. Его характеристика On может быть связана с физическим каналом или использоваться в логике проекта; само создание объекта не подключает оборудование.

Группа	Название в редакторе	Код
Обязательная	включение	`On`

Подробнее: Виртуальное устройство "Переключатель".

Розетка

Тип Outlet управляет включением розетки через настроенный канал. Таймер автоматического выключения относится к параметрам устройства, а не к дополнительной характеристике On.

Группа	Название в редакторе	Код
Обязательная	включение	`On`

Подробнее: Виртуальное устройство "Розетка".

Карниз

Тип WindowCovering в редакторе называется «шторы». В актуальной схеме обязательны отдельно команда Close и состояние CloseState — не только прежнее «Закрытие».

Группа	Название в редакторе	Код
Обязательная	Управление	`Close`
Обязательная	Состояние	`CloseState`
Дополнительная	Целевая позиция (0–100%)	`TargetPosition`
Связанная с `TargetPosition`	Фактическое положение (0–100%)	`CurrentPosition`
Связанная с `TargetPosition`	Управление: открыть/закрыть/остановить	`PositionSet`
Связанная с `TargetPosition`	Состояние: открывается/закрывается/стоп	`PositionState`
Связанная с `TargetPosition`	Состояние: последнее направление движения	`DirectionMove`
Связанная с `TargetPosition`	Кнопка открыть/закрыть	`OpenClose`
Связанная с `TargetPosition`	Кнопка открыть	`ButOpen`
Связанная с `TargetPosition`	Кнопка стоп	`ButStop`
Связанная с `TargetPosition`	Кнопка закрыть	`ButClose`
Дополнительная	автоматическое открытие	`AutoOpenSchedule`
Дополнительная	автоматическое закрытие	`AutoCloseSchedule`

Не перепутайте направление шкалы: в логике XIOT 0 % — открыто, 100 % — закрыто. Для Close команда 0 означает открыть, 1 — закрыть; для CloseState 1 означает полностью закрыто. Целевая позиция не является подтверждением достижения положения. Текущая позиция может поступать от оборудования или рассчитываться логикой движения — проверьте способ её получения на объекте.

AutoOpenSchedule и AutoCloseSchedule настраиваются как расписания, а не как проценты положения. Подписи и значения готовых позиций относятся к параметрам устройства.

Подробнее: Виртуальное устройство "Карниз".

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

Убедитесь, что выбраны правильный тип устройства, характеристика и формат значения.
Для физических каналов проверьте активность характеристики, адреса, направление и преобразование значений.
Загрузите конфигурацию, проверьте связь с контроллером и фактическую реакцию оборудования.
Раздельно проверьте команду и обратную связь. Изменение цифры или индикатора в интерфейсе не доказывает исполнение.
Проверьте нужные владельцу интерфейсы отдельно: наличие характеристики в редакторе не гарантирует её отображение в приложении, панели или голосовой интеграции.

@@ Строка 2: / Строка 2: @@
 '''Характеристика''' — отдельная команда, состояние, измерение или настройка виртуального устройства. Например, у светильника <code>On</code> отвечает за включение, а <code>Brightness</code> — за яркость. Название помогает найти поле в интерфейсе, технический код — однозначно отличить его от похожих полей.
-Эта статья описывает общие правила и состав характеристик '''семи основных типов''': дома, части дома, комнаты, света, выключателя, розетки и штор. Перечни сверены по актуальной схеме XIOT-EDITOR 16 сентября 2026 года. Это не список характеристик всех 48 типов; остальные устройства собраны в [[Виртуальные устройства XIOT|каталоге]].
+Эта статья описывает общие правила и состав характеристик '''семи основных типов''': дома, части дома, комнаты, света, выключателя, розетки и штор. Перечни сверены по актуальной схеме XIOT-EDITOR 16 сентября 2026 года. Это не список характеристик всех 48 типов; остальные устройства собраны в [[Xiot-devices|каталоге]].
 == Как читать характеристики ==
@@ Строка 19: / Строка 19: @@
 У характеристики могут быть отдельные кнопки '''Привязка тегов''', '''Преобразование значений''', '''Настройки характеристики''' и '''Дополнительная логика'''. Не все кнопки доступны у каждого поля. Для пользовательской характеристики в настройках можно выбрать '''управление и состояние''' или '''только состояние'''.
-'''Адрес управления''' отправляет команду в физический канал; '''адрес состояния''' принимает значение или обратную связь. Для системных и логических полей адрес может не требоваться. Правила назначения и смысл флажка '''Связать управление с состоянием''' описаны в [[Привязка реальных устройств к виртуальным]] и [[Механизм работы тегов в XIOT]].
+'''Адрес управления''' отправляет команду в физический канал; '''адрес состояния''' принимает значение или обратную связь. Для системных и логических полей адрес может не требоваться. Правила назначения и смысл флажка '''Связать управление с состоянием''' описаны в [[Device-bindings|Привязка реальных устройств к виртуальным]] и [[Xiot-tags|Механизм работы тегов в XIOT]].
-Изменения состава характеристик, их адресов и параметров применяют через '''Загрузить конфигурацию на контроллер''': сначала успешное локальное сохранение, затем отправка сохранённого снимка. Облако и публикация приложения проверяются отдельно: [[Сохранение резервной копии проекта]]. При этом изменение '''текущего значения''' через элемент управления может отправить команду уже работающему оборудованию — это не безвредное редактирование подписи.
+Изменения состава характеристик, их адресов и параметров применяют через '''Загрузить конфигурацию на контроллер''': сначала успешное локальное сохранение, затем отправка сохранённого снимка. Облако и публикация приложения проверяются отдельно: [[Project-backup|Сохранение резервной копии проекта]]. При этом изменение '''текущего значения''' через элемент управления может отправить команду уже работающему оборудованию — это не безвредное редактирование подписи.
 == Дом ==
@@ Строка 110: / Строка 110: @@
 * <code>ModeSeason</code> — отопительный сезон: 0 — лето, 1 — зима. Это не календарное название времени года.
-Подробнее: [[Виртуальное устройство "Дом"]].
+Подробнее: [[Home|Виртуальное устройство "Дом"]].
 <span id="Этаж_(часть_дома)_="></span>
@@ Строка 139: / Строка 139: @@
 |}
-Подробнее: [[Виртуальное устройство "Часть дома"]].
+Подробнее: [[Home-area|Виртуальное устройство "Часть дома"]].
 == Комната ==
@@ Строка 237: / Строка 237: @@
 '''Что учитывать:''' <code>TargetTemperature</code> — уставка, а <code>CurrentTemperature</code> — текущее значение. Комната передаёт уставку соответствующим климатическим устройствам; для тёплого пола учитывается режим управления. <code>FloorHeatOn</code> не равнозначен <code>FloorHeatHeatingState</code>: включённое устройство не обязано нагревать прямо сейчас. Наличие <code>AIAnalytics</code> не подтверждает, что источник аналитики настроен и доступен.
-Подробнее: [[Виртуальное устройство "Комната"]].
+Подробнее: [[Room|Виртуальное устройство "Комната"]].
 == Свет ==
@@ Строка 272: / Строка 272: @@
 * <code>RGB</code> — строка компонентов 0–255, например <code>255,0,0</code>. Отдельные <code>ColorRed</code>, <code>ColorGreen</code>, <code>ColorBlue</code> используют проценты 0–100; <code>Hue</code> — угол 0–360, <code>Saturation</code> — 0–100 %.
-Подробнее: [[Виртуальное устройство "Светильник"]].
+Подробнее: [[Light-fixture|Виртуальное устройство "Светильник"]].
 == Выключатель ==
@@ Строка 284: / Строка 284: @@
 |}
-Подробнее: [[Виртуальное устройство "Переключатель"]].
+Подробнее: [[Switch|Виртуальное устройство "Переключатель"]].
 == Розетка ==
@@ Строка 296: / Строка 296: @@
 |}
-Подробнее: [[Виртуальное устройство "Розетка"]].
+Подробнее: [[Power-socket|Виртуальное устройство "Розетка"]].
 == Карниз ==
@@ Строка 336: / Строка 336: @@
 <code>AutoOpenSchedule</code> и <code>AutoCloseSchedule</code> настраиваются как расписания, а не как проценты положения. Подписи и значения готовых позиций относятся к параметрам устройства.
-Подробнее: [[Виртуальное устройство "Карниз"]].
+Подробнее: [[Curtain-track|Виртуальное устройство "Карниз"]].
 == Проверка после настройки ==
@@ Строка 347: / Строка 347: @@
 [[Категория:Документация XIOT]]
+{{DEFAULTSORT:Характеристики устройств в XIOT}}

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