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

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

Материал из XIOT Wiki

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

3 группы участника
3501 правка
ВизуальныйВики-текст
Новая страница: «__NOTOC__ = Характеристики устройств XIOT = == дом == '''Обязательные характеристики''' * '''я дома''' * '''я ушел''' * '''отпуск''' * '''включить свет''' * '''выключить свет''' * '''включить/выключить свет''' * '''время рассвета''' * '''время заката''' * '''солнечный день''' * '''ночь по закату''...»
 
Английские адреса Wiki: обновление ссылок с сохранением русских подписей
 
(не показано 16 промежуточных версий этого же участника)
Строка 1: Строка 1:
__NOTOC__
{{DISPLAYTITLE:Характеристики устройств в XIOT}}
= Характеристики устройств XIOT =
'''Характеристика''' — отдельная команда, состояние, измерение или настройка виртуального устройства. Например, у светильника <code>On</code> отвечает за включение, а <code>Brightness</code> — за яркость. Название помогает найти поле в интерфейсе, технический код — однозначно отличить его от похожих полей.


== дом ==
Эта статья описывает общие правила и состав характеристик '''семи основных типов''': дома, части дома, комнаты, света, выключателя, розетки и штор. Перечни сверены по актуальной схеме XIOT-EDITOR 16 сентября 2026 года. Это не список характеристик всех 48 типов; остальные устройства собраны в [[Xiot-devices|каталоге]].
'''Обязательные характеристики'''
* '''я дома'''
* '''я ушел'''
* '''отпуск'''
* '''включить свет'''
* '''выключить свет'''
* '''включить/выключить свет'''
* '''время рассвета'''
* '''время заката'''
* '''солнечный день'''
* '''ночь по закату'''
* '''ModeSeason'''
* '''обнаружено движение'''
* '''свет в комнате включен'''
* '''статус работы теплого пола'''
* '''время на сервере'''
* '''дата на сервере'''
* '''День недели'''
* '''Выходной или рабочий день сегодня'''
* '''Выходной или рабочий день завтра'''
* '''Пробуждение в будний день'''
* '''Пробуждение в выходной день'''
* '''Уход ко сну перед рабочим днем'''
* '''Уход ко сну перед выходным днем'''
* '''ночь по времени'''
* '''Ошибка электричества'''
* '''Состояние водоснабжения'''
* '''Состояние ОПС'''


== часть дома ==
== Как читать характеристики ==
'''Обязательные характеристики'''
* '''включить свет'''
* '''выключить свет'''
* '''включить/выключить свет'''
* '''обнаружено движение'''
* '''свет в комнате включен'''
* '''статус работы теплого пола'''


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


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


== выключатель ==
== Где настраивать ==
'''Обязательные характеристики'''
* '''включение'''


== розетка ==
В разделе '''Устройства и сценарии''' выберите объект. В варианте окна '''Новый (бета)''' откройте вкладку '''Характеристики'''. Состав групп и связанные поля зависят от выбранного типа и его параметров.
'''Обязательные характеристики'''
* '''включение'''


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


== вентилятор ==
'''Адрес управления''' отправляет команду в физический канал; '''адрес состояния''' принимает значение или обратную связь. Для системных и логических полей адрес может не требоваться. Правила назначения и смысл флажка '''Связать управление с состоянием''' описаны в [[Device-bindings|Привязка реальных устройств к виртуальным]] и [[Xiot-tags|Механизм работы тегов в XIOT]].
'''Обязательные характеристики'''
* '''включение'''
'''Дополнительные характеристики'''
* '''направление вращения'''
* '''скорость вращения'''


== кондиционер ==
Изменения состава характеристик, их адресов и параметров применяют через '''Загрузить конфигурацию на контроллер''': сначала успешное локальное сохранение, затем отправка сохранённого снимка. Облако и публикация приложения проверяются отдельно: [[Project-backup|Сохранение резервной копии проекта]]. При этом изменение '''текущего значения''' через элемент управления может отправить команду уже работающему оборудованию — это не безвредное редактирование подписи.
'''Обязательные характеристики'''
* '''включение'''
'''Дополнительные характеристики'''
* '''текущая температура'''
* '''TargetTemperature'''
* '''ModeHvac'''
* '''FanSpeed'''
* '''FanSpeedStep'''
* '''HorizontalVanes'''
* '''VerticalVanes'''
* '''HeatingState'''
* '''CoolingState'''


== кран ==
== Дом ==
'''Обязательные характеристики'''
* '''включение'''
'''Дополнительные характеристики'''
* '''управление'''
* '''текущая позиция'''
* '''TargetPosition'''
* '''текущее состояние'''
* '''направление движения'''
* '''открыть закрыть'''


== теплый пол ==
Дом хранит общие состояния и настройки проекта. Характеристики присутствия согласованы между собой; это не шесть независимых переключателей. <code>HomeStatus</code>: 0 — «я ушёл», 1 — «я дома», 2 — «отпуск», 3 — «в пути домой», 4 — «уборка».
'''Обязательные характеристики'''
* '''включение'''
* '''ErrorFloorHeat'''
'''Дополнительные характеристики'''
* '''текущая температура'''
* '''TargetTemperature'''
* '''HeatingState'''
* '''ErrorTemperatureSensor'''


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


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


== конвектор ==
Подробнее: [[Home|Виртуальное устройство "Дом"]].
'''Обязательные характеристики'''
* '''включение'''
'''Дополнительные характеристики'''
* '''текущая температура'''
* '''TargetTemperature'''
* '''FanSpeed'''
* '''FanSpeedStep'''
* '''ModeConvector'''
* '''HeatingState'''


== Увлажнитель ==
<span id="Этаж_(часть_дома)_="></span>
'''Обязательные характеристики'''
== Этаж (часть дома) ==
* '''включение'''
'''Дополнительные характеристики'''
* '''текущая влажность'''
* '''TargetRelativeHumidity'''
* '''HumidificationState'''
* '''ErrorHumiditySensor'''


== Приточная вентиляция ==
Часть дома объединяет комнаты. Общие команды и агрегированные состояния относятся к этой части проекта; они не означают, что каждый вложенный объект реагирует на любую команду.
'''Обязательные характеристики'''
* '''включение'''
* '''температура приточного воздуха'''
* '''температура выходящего воздуха'''
* '''TargetTemperature'''
'''Дополнительные характеристики'''
* '''FanSpeed'''
* '''FanSpeedStep'''
* '''требуется замена фильтра'''
* '''уровень углекислого газа'''
* '''VOCDensity'''


== сирена ==
{| class="wikitable"
'''Обязательные характеристики'''
! Группа !! Название в редакторе !! Код
* '''включение'''
|-
| Обязательная || включить свет || <code>LightOn</code>
|-
| Обязательная || выключить свет || <code>LightOff</code>
|-
| Обязательная || включить/выключить свет || <code>LightOnOff</code>
|-
| Обязательная || обнаружено движение || <code>MotionDetected</code>
|-
| Обязательная || свет на этаже включен || <code>LightOnStatus</code>
|-
| Обязательная || теплый пол греет || <code>FloorHeatHeatingState</code>
|-
| Дополнительная || Целевая позиция (0–100%) всех штор || <code>CurtainTargetPosition</code>
|-
| Дополнительная || управление всеми шторами || <code>CurtainPositionSet</code>
|-
| Дополнительная || Кнопка открыть/закрыть все шторы || <code>CurtainOpenClose</code>
|}


== реле ==
Подробнее: [[Home-area|Виртуальное устройство "Часть дома"]].
'''Обязательные характеристики'''
* '''включение'''


== сервопривод ==
== Комната ==
'''Обязательные характеристики'''
* '''включение'''
* '''TargetPosition'''


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


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


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


== пульт ==
Подробнее: [[Room|Виртуальное устройство "Комната"]].
'''Обязательные характеристики'''
* '''команды включения'''
'''Дополнительные характеристики'''
* '''команды выбора входа'''
* '''команды курсора'''
* '''команды цифр'''
* '''команды плеера'''
* '''команды громкости'''


== датчик температуры ==
== Свет ==
'''Обязательные характеристики'''
* '''текущая температура'''
* '''ErrorTemperatureSensor'''


== датчик движения ==
Тип <code>Lightbulb</code> в меню редактора называется «свет», а в каталоге вики — «Светильник». Базовое включение и дополнительные каналы настраиваются отдельно.
'''Обязательные характеристики'''
* '''обнаружено движение'''
'''Дополнительные характеристики'''
* '''уровень движения'''


== датчик шума ==
{| class="wikitable"
'''Обязательные характеристики'''
! Группа !! Название в редакторе !! Код
* '''сильный шум'''
|-
'''Дополнительные характеристики'''
| Обязательная || включение || <code>On</code>
* '''уровень шума'''
|-
| Дополнительная || яркость || <code>Brightness</code>
|-
| Связанная с <code>Brightness</code> || диммирование || <code>Dimming</code>
|-
| Дополнительная || температура цвета || <code>ColorTemperature</code>
|-
| Дополнительная || цвет || <code>RGB</code>
|-
| Связанная с <code>RGB</code> || оттенок || <code>Hue</code>
|-
| Связанная с <code>RGB</code> || насыщенность || <code>Saturation</code>
|-
| Связанная с <code>RGB</code> || красный || <code>ColorRed</code>
|-
| Связанная с <code>RGB</code> || зеленый || <code>ColorGreen</code>
|-
| Связанная с <code>RGB</code> || синий || <code>ColorBlue</code>
|}


== датчик углекислого газа ==
'''Единицы и формат:'''
'''Обязательные характеристики'''
* <code>Brightness</code> — 0–100 %. <code>Dimming</code> задаёт действие плавного изменения яркости, а не ещё одно абсолютное значение.
* '''высокая концентрация углекислого газа'''
* <code>ColorTemperature</code> в XIOT использует шкалу 0–100: 0 — тёплый, 100 — холодный цвет. Не вводите сюда кельвины напрямую; соответствие шкале оборудования задаётся преобразованием значений и драйвером.
'''Дополнительные характеристики'''
* <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|Виртуальное устройство "Светильник"]].
'''Обязательные характеристики'''
* '''состояние контактного датчика'''


== датчик давления ==
== Выключатель ==
'''Обязательные характеристики'''
* '''текущее давление в барах'''


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


== датчик дождя ==
{| class="wikitable"
'''Обязательные характеристики'''
! Группа !! Название в редакторе !! Код
* '''идет дождь'''
|-
| Обязательная || включение || <code>On</code>
|}


== датчик ветра ==
Подробнее: [[Switch|Виртуальное устройство "Переключатель"]].
'''Обязательные характеристики'''
* '''сильный ветер'''
'''Дополнительные характеристики'''
* '''скорость ветра'''


== датчик конденсата ==
== Розетка ==
'''Обязательные характеристики'''
* '''обнаружен конденсат'''


== датчик освещенности ==
Тип <code>Outlet</code> управляет включением розетки через настроенный канал. Таймер автоматического выключения относится к параметрам устройства, а не к дополнительной характеристике <code>On</code>.
'''Обязательные характеристики'''
* '''уровень освещенности'''
'''Дополнительные характеристики'''
* '''уровень освещенности в %'''


== датчик влажности ==
{| class="wikitable"
'''Обязательные характеристики'''
! Группа !! Название в редакторе !! Код
* '''текущая влажность'''
|-
'''Дополнительные характеристики'''
| Обязательная || включение || <code>On</code>
* '''ErrorHumiditySensor'''
|}


== датчик качества воздуха ==
Подробнее: [[Power-socket|Виртуальное устройство "Розетка"]].
'''Обязательные характеристики'''
* '''AirQuality'''
'''Дополнительные характеристики'''
* '''VOCDensity'''


== датчик дыма ==
== Карниз ==
'''Обязательные характеристики'''
* '''SmokeDetected'''


== счетчик воды ==
Тип <code>WindowCovering</code> в редакторе называется «шторы». В актуальной схеме обязательны отдельно команда <code>Close</code> и состояние <code>CloseState</code> — не только прежнее «Закрытие».
'''Обязательные характеристики'''
* '''кол-во куб.м.'''


== счетчик  электроэнергии ==
{| class="wikitable"
'''Обязательные характеристики'''
! Группа !! Название в редакторе !! Код
* '''кВтч'''
|-
| Обязательная || Управление || <code>Close</code>
|-
| Обязательная || Состояние || <code>CloseState</code>
|-
| Дополнительная || Целевая позиция (0–100%) || <code>TargetPosition</code>
|-
| Связанная с <code>TargetPosition</code> || Фактическое положение (0–100%) || <code>CurrentPosition</code>
|-
| Связанная с <code>TargetPosition</code> || Управление: открыть/закрыть/остановить || <code>PositionSet</code>
|-
| Связанная с <code>TargetPosition</code> || Состояние: открывается/закрывается/стоп || <code>PositionState</code>
|-
| Связанная с <code>TargetPosition</code> || Состояние: последнее направление движения || <code>DirectionMove</code>
|-
| Связанная с <code>TargetPosition</code> || Кнопка открыть/закрыть || <code>OpenClose</code>
|-
| Связанная с <code>TargetPosition</code> || Кнопка открыть || <code>ButOpen</code>
|-
| Связанная с <code>TargetPosition</code> || Кнопка стоп || <code>ButStop</code>
|-
| Связанная с <code>TargetPosition</code> || Кнопка закрыть || <code>ButClose</code>
|-
| Дополнительная || автоматическое открытие || <code>AutoOpenSchedule</code>
|-
| Дополнительная || автоматическое закрытие || <code>AutoCloseSchedule</code>
|}


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


== амперметр ==
<code>AutoOpenSchedule</code> и <code>AutoCloseSchedule</code> настраиваются как расписания, а не как проценты положения. Подписи и значения готовых позиций относятся к параметрам устройства.
'''Обязательные характеристики'''
* '''Сила тока (А)'''


== ваттметр ==
Подробнее: [[Curtain-track|Виртуальное устройство "Карниз"]].
'''Обязательные характеристики'''
 
* '''Потребление (Ватт)'''
== Проверка после настройки ==
 
# Убедитесь, что выбраны правильный тип устройства, характеристика и формат значения.
# Для физических каналов проверьте активность характеристики, адреса, направление и преобразование значений.
# Загрузите конфигурацию, проверьте связь с контроллером и фактическую реакцию оборудования.
# Раздельно проверьте команду и обратную связь. Изменение цифры или индикатора в интерфейсе не доказывает исполнение.
# Проверьте нужные владельцу интерфейсы отдельно: наличие характеристики в редакторе не гарантирует её отображение в приложении, панели или голосовой интеграции.
 
[[Категория:Документация XIOT]]
{{DEFAULTSORT:Характеристики устройств в XIOT}}

Текущая версия от 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 настраиваются как расписания, а не как проценты положения. Подписи и значения готовых позиций относятся к параметрам устройства.

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

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

  1. Убедитесь, что выбраны правильный тип устройства, характеристика и формат значения.
  2. Для физических каналов проверьте активность характеристики, адреса, направление и преобразование значений.
  3. Загрузите конфигурацию, проверьте связь с контроллером и фактическую реакцию оборудования.
  4. Раздельно проверьте команду и обратную связь. Изменение цифры или индикатора в интерфейсе не доказывает исполнение.
  5. Проверьте нужные владельцу интерфейсы отдельно: наличие характеристики в редакторе не гарантирует её отображение в приложении, панели или голосовой интеграции.
Источник — https://wiki.xiot.ru/index.php?title=Xiot-device-characteristics&oldid=5796