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

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

Материал из XIOT Wiki
← Предыдущая правка

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

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


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


'''Обязательные характеристики'''
== Как читать характеристики ==
* '''Я дома''' — активен режим присутствия в доме
* '''Я ушёл''' — активен режим отсутствия
* '''Отпуск''' — активен длительный режим отсутствия (например, при поездке)
* '''Включить свет''' — команда на включение всего света в доме
* '''Выключить свет''' — команда на выключение всего света в доме
* '''Включить/выключить свет''' — переключение общего освещения
* '''Время рассвета''' — локальное время восхода солнца
* '''Время заката''' — локальное время захода солнца
* '''Солнечный день''' — индикатор солнечной погоды (например, для сценариев)
* '''Ночь по закату''' — наступление тёмного времени по природному циклу
* '''Сезонный режим''' — текущее время года: лето/зима
* '''Обнаружено движение''' — есть движение в любом помещении дома
* '''Свет в комнате включен''' — в какой-либо комнате свет включён
* '''Статус работы тёплого пола''' — пол нагревается или нет
* '''Время на сервере''' — текущее время, полученное от контроллера
* '''Дата на сервере''' — текущая дата, полученная от контроллера
* '''День недели''' — текущий день недели
* '''Рабочий день (сегодня)''' — индикатор, рабочий ли сегодня день
* '''Рабочий день (завтра)''' — индикатор, рабочий ли завтра день
* '''Пробуждение в будний день''' — наступило ли утреннее время в будни
* '''Пробуждение в выходной день''' — наступило ли утро в выходной
* '''Уход ко сну перед рабочим днём''' — настало ли вечернее время в будний день
* '''Уход ко сну перед выходным днём''' — настало ли вечернее время в выходной день
* '''Ночь по времени''' — ночь наступила по заданному времени
* '''Ошибка электричества''' — сработала сигнализация электропитания
* '''Состояние водоснабжения''' — авария по воде (например, протечка)
* '''Состояние ОПС''' — пожарная или охранная сигнализация в тревоге


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


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


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


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


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


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


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


== кондиционер ==
== Дом ==
'''Обязательные характеристики'''
* '''включение'''
'''Дополнительные характеристики'''
* '''текущая температура'''
* '''TargetTemperature'''
* '''ModeHvac'''
* '''FanSpeed'''
* '''FanSpeedStep'''
* '''HorizontalVanes'''
* '''VerticalVanes'''
* '''HeatingState'''
* '''CoolingState'''


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


== теплый пол ==
{| class="wikitable"
'''Обязательные характеристики'''
! Группа !! Название в редакторе !! Код
* '''включение'''
|-
* '''ErrorFloorHeat'''
| Обязательная || я дома || <code>InHome</code>
'''Дополнительные характеристики'''
|-
* '''текущая температура'''
| Обязательная || я ушел || <code>OutHome</code>
* '''TargetTemperature'''
|-
* '''HeatingState'''
| Обязательная || отпуск || <code>Vacation</code>
* '''ErrorTemperatureSensor'''
|-
| Обязательная || в пути домой || <code>Way_home</code>
|-
| Обязательная || уборка || <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 у аварии — «ошибка».
* <code>ModeSeason</code> — отопительный сезон: 0 — лето, 1 — зима. Это не календарное название времени года.


'''Обязательные характеристики'''
Подробнее: [[Home|Виртуальное устройство "Дом"]].
* '''Включение''' — устройство включено или выключено
* '''Текущая температура''' — текущая температура в помещении
* '''Целевая температура''' — желаемая температура, установленная пользователем
* '''Режим работы''' — текущий режим: обогрев, охлаждение, авто и др.
* '''Сезонный режим''' — лето/зима, влияет на режимы работы устройства


'''Дополнительные характеристики'''
<span id="Этаж_(часть_дома)_="></span>
* '''Состояние нагрева''' — устройство активно греет помещение
== Этаж (часть дома) ==
* '''Состояние охлаждения''' — устройство активно охлаждает помещение
* '''Ошибка температурного датчика''' — датчик температуры не работает или даёт ошибку


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


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


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


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


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


== реле ==
{| class="wikitable"
'''Обязательные характеристики'''
! Группа !! Название в редакторе !! Код
* '''включение'''
|-
| Обязательная || включить свет || <code>LightOn</code>
|-
| Обязательная || выключить свет || <code>LightOff</code>
|-
| Обязательная || переключить свет || <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> не подтверждает, что источник аналитики настроен и доступен.
'''Обязательные характеристики'''
* '''включение'''
* '''TargetPosition'''


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


== зуммер ==
== Свет ==
'''Обязательные характеристики'''
* '''включение'''
'''Дополнительные характеристики'''
* '''Volume'''
* '''Frequency'''
* '''ModeBuzzer'''


== кнопка ==
Тип <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 — холодный цвет. Не вводите сюда кельвины напрямую; соответствие шкале оборудования задаётся преобразованием значений и драйвером.
* '''ErrorTemperatureSensor'''
* <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>
* '''скорость ветра'''
|}


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


== датчик освещенности ==
== Карниз ==
'''Обязательные характеристики'''
* '''уровень освещенности'''
'''Дополнительные характеристики'''
* '''уровень освещенности в %'''


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


== датчик качества воздуха ==
{| class="wikitable"
'''Обязательные характеристики'''
! Группа !! Название в редакторе !! Код
* '''AirQuality'''
|-
'''Дополнительные характеристики'''
| Обязательная || Управление || <code>Close</code>
* '''VOCDensity'''
|-
| Обязательная || Состояние || <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 означает полностью закрыто. Целевая позиция не является подтверждением достижения положения. Текущая позиция может поступать от оборудования или рассчитываться логикой движения — проверьте способ её получения на объекте.
'''Обязательные характеристики'''
* '''SmokeDetected'''


== счетчик воды ==
<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