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

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

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

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

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


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


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


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


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


== Комната ==
== Где настраивать ==


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


'''Дополнительные характеристики'''
У характеристики могут быть отдельные кнопки '''Привязка тегов''', '''Преобразование значений''', '''Настройки характеристики''' и '''Дополнительная логика'''. Не все кнопки доступны у каждого поля. Для пользовательской характеристики в настройках можно выбрать '''управление и состояние''' или '''только состояние'''.
* '''Активировать/сохранить световую сцену по номеру''' — управление предустановленными световыми сценами
* '''Активировать следующую сцену''' — переход к следующей сцене
* '''Активировать предыдущую сцену''' — возврат к предыдущей сцене
* '''Яркость''' — установка уровня яркости света
* '''Температура цвета''' — настройка тёплого или холодного оттенка белого
* '''Оттенок (RGB)''' — изменение цвета света по цветовому кругу
* '''Целевая позиция штор''' — задание положения для всех штор
* '''Текущая позиция всех штор''' — отображает положение штор
* '''Управление всеми шторами''' — централизованное управление шторами
* '''Открыть/закрыть все шторы''' — быстрое открытие или закрытие
* '''Обнаружено движение''' — датчик движения в комнате активирован
* '''Дверь открыта''' — состояние дверного сенсора
* '''Окно открыто''' — состояние оконного сенсора
* '''Обнаружена протечка''' — сигнал от датчика протечки
* '''Тёплый пол включен''' — отображает, включено ли отопление пола
* '''Кондиционер включен''' — отображает, работает ли кондиционер
* '''Радиатор включен''' — состояние радиатора отопления
* '''Конвектор включен''' — состояние конвектора
* '''Приточная вентиляция включена''' — активность бризера
* '''Текущая влажность''' — данные от датчика влажности
* '''Уровень освещённости''' — измеренный уровень света
* '''Уровень освещённости в %''' — освещённость в относительных процентах
* '''Качество воздуха''' — обобщённая оценка VOC
* '''Концентрация VOC''' — уровень летучих органических соединений
* '''Высокая концентрация углекислого газа''' — предупреждение по CO₂
* '''Уровень углекислого газа''' — измеренное значение CO₂
* '''Сильный шум''' — шум выше порогового значения
* '''Уровень шума''' — текущий уровень децибел
* '''Текущая температура''' — измеренная температура в комнате
* '''Целевая температура''' — установленное желаемое значение


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


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


'''Дополнительные характеристики'''
== Дом ==
* '''Яркость''' — установка уровня яркости от 0 до 100%
* '''Температура цвета''' — настройка теплоты света (от холодного до тёплого белого)
* '''Цвет (RGB)''' — установка цвета освещения (красный, зелёный, синий)


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


'''Обязательные характеристики'''
{| class="wikitable"
* '''Включение''' — включает или выключает устройство, привязанное к выключателю
! Группа !! Название в редакторе !! Код
|-
| Обязательная || я дома || <code>InHome</code>
|-
| Обязательная || я ушел || <code>OutHome</code>
|-
| Обязательная || отпуск || <code>Vacation</code>
|-
| Обязательная || в пути домой || <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|Виртуальное устройство "Дом"]].
'''Обязательные характеристики'''
* '''закрытие'''
'''Дополнительные характеристики'''
* '''TargetPosition'''


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


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


== кран ==
{| class="wikitable"
'''Обязательные характеристики'''
! Группа !! Название в редакторе !! Код
* '''включение'''
|-
'''Дополнительные характеристики'''
| Обязательная || включить свет || <code>LightOn</code>
* '''управление'''
|-
* '''текущая позиция'''
| Обязательная || выключить свет || <code>LightOff</code>
* '''TargetPosition'''
|-
* '''текущее состояние'''
| Обязательная || включить/выключить свет || <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|Виртуальное устройство "Часть дома"]].
'''Обязательные характеристики'''
* '''включение'''
* '''ErrorFloorHeat'''
'''Дополнительные характеристики'''
* '''текущая температура'''
* '''TargetTemperature'''
* '''HeatingState'''
* '''ErrorTemperatureSensor'''


== Климат контроль ==
== Комната ==


'''Обязательные характеристики'''
Комната объединяет управление и состояния своих устройств. Состав данных зависит от активных характеристик, подключённых устройств и их логики. Значение комнаты не заменяет показания конкретного физического датчика.
* '''Включение''' — устройство включено или выключено
* '''Текущая температура''' — текущая температура в помещении
* '''Целевая температура''' — желаемая температура, установленная пользователем
* '''Режим работы''' — текущий режим: обогрев, охлаждение, авто и др.
* '''Сезонный режим''' — лето/зима, влияет на режимы работы устройства


'''Дополнительные характеристики'''
{| 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> не подтверждает, что источник аналитики настроен и доступен.
'''Обязательные характеристики'''
* '''включение'''
'''Дополнительные характеристики'''
* '''текущая температура'''
* '''TargetTemperature'''
* '''HeatingState'''
* '''ErrorTemperatureSensor'''


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


== Увлажнитель ==
== Свет ==
'''Обязательные характеристики'''
* '''включение'''
'''Дополнительные характеристики'''
* '''текущая влажность'''
* '''TargetRelativeHumidity'''
* '''HumidificationState'''
* '''ErrorHumiditySensor'''


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


== сирена ==
{| 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|Виртуальное устройство "Светильник"]].
'''Обязательные характеристики'''
* '''включение'''
* '''TargetPosition'''


== видеокамера ==
== Выключатель ==
'''Обязательные характеристики'''
* '''ImageBase64'''
 
== зуммер ==
'''Обязательные характеристики'''
* '''включение'''
'''Дополнительные характеристики'''
* '''Volume'''
* '''Frequency'''
* '''ModeBuzzer'''
 
== кнопка ==
'''Обязательные характеристики'''
* '''действие кнопки'''
* '''состояние кнопки'''
 
== пульт ==
'''Обязательные характеристики'''
* '''команды включения'''
'''Дополнительные характеристики'''
* '''команды выбора входа'''
* '''команды курсора'''
* '''команды цифр'''
* '''команды плеера'''
* '''команды громкости'''
 
== датчик температуры ==
'''Обязательные характеристики'''
* '''текущая температура'''
* '''ErrorTemperatureSensor'''
 
== датчик движения ==
'''Обязательные характеристики'''
* '''обнаружено движение'''
'''Дополнительные характеристики'''
* '''уровень движения'''
 
== датчик шума ==
'''Обязательные характеристики'''
* '''сильный шум'''
'''Дополнительные характеристики'''
* '''уровень шума'''


== датчик углекислого газа ==
Тип <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