Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этом руководстве показано, как использовать свойства устройства, определенные в шаблоне устройства в приложении Azure IoT Central.
Свойства представляют значения на определенный момент времени. Например, устройство может использовать свойство, чтобы сообщить о целевой температуре, которую он пытается достичь. По умолчанию свойства устройства доступны только для чтения в IoT Central. Свойства, доступные для записи, позволяют синхронизировать состояние между устройством и приложением Azure IoT Central.
Вы также можете определить облачные свойства в приложении Azure IoT Central. Значения облачных свойств никогда не обмениваются с устройством и не находятся в рамках этой статьи.
Дополнительные сведения о стандартах свойств IoT Plug and Play см. в соглашениях об использовании IoT Plug and Play.
Дополнительные сведения о данных свойств, которыми устройство обменивается с IoT Central, см. в статье Телеметрия, свойства и полезные данные команд.
Сведения об управлении свойствами с помощью REST API IoT Central см. в статье "Как использовать REST API IoT Central для управления устройствами".
Сведения о том, как реализовать свойства на устройстве без использования пакетов SDK для устройств, см. в статье "Обмен данными с центром Интернета вещей" с помощью протокола MQTT.
Определение свойств
Свойства — это поля данных, представляющие состояние устройства. Используйте свойства для представления устойчивого состояния устройства, например состояния включено или выключение устройства. Свойства также могут представлять основные свойства устройства, например версию программного обеспечения устройства. Свойства объявляются как доступные только для чтения или разрешающие запись.
На следующем снимке экрана показано определение свойства в приложении Azure IoT Central.
В следующей таблице показаны параметры конфигурации для возможности свойства.
| Поле | Description |
|---|---|
| Показать имя | Отображаемое имя значения свойства, используемого на плитках панели мониторинга и формах устройств. |
| Имя | Имя свойства. Azure IoT Central создает значение для этого поля из отображаемого имени, но при необходимости можно выбрать собственное значение. Это поле должно быть буквенно-цифровым. Код устройства использует это значение Name . |
| Тип возможности | Свойство. |
| Семантический тип | Семантический тип свойства, например температура, состояние или событие. Выбор семантического типа определяет, какие из следующих полей доступны. |
| Schema | Тип данных свойства, например double, string или vector. Семантический тип определяет доступные варианты. Схема недоступна для семантических типов событий и состояний. |
| Записываемый | Если свойство недоступно для записи, устройство может сообщать значения свойств в Azure IoT Central. Если свойство доступно для записи, устройство может сообщать значения свойств в Azure IoT Central. Затем Azure IoT Central может отправлять обновления свойств на устройство. |
| Severity | Доступно только для семантического типа события. Серьезность — "Ошибка", "Сведения" или "Предупреждение". |
| Значения состояния | Доступно только для семантического типа состояния. Определите возможные значения состояния, для каждого из которых указаны отображаемое имя, имя, тип перечисления и значение. |
| Единица | Единица для значения свойства, например mph, %или °C. |
| Блок индикации | Модуль отображения для использования на плитках информационных панелей и формах устройств. |
| Комментарий | Комментарии относительно функциональности свойства. |
| Description | Описание возможности свойства. |
Дополнительные сведения о языке определения цифровых двойников (DTDL), который Azure IoT Central использует для определения свойств в шаблоне устройства, см. в соглашениях IoT Plug and Play > о свойствах только для чтения.
Необязательные поля, такие как отображаемое имя и описание, позволяют добавлять дополнительные сведения в интерфейс и возможности.
При создании свойства можно указать сложные типы схем, такие как Object и Enum.
При выборе сложной схемы, например object, необходимо определить схему объекта.
Внедрение свойств только для чтения
По умолчанию свойства доступны только для чтения. Свойства только для чтения позволяют устройству сообщать об обновлении значений своих свойств в приложение Azure IoT Central. Приложение Azure IoT Central не может задать значение свойства только для чтения.
Azure IoT Central использует двойники устройств для синхронизации значений свойств между устройством и приложением Azure IoT Central. Значения свойств устройства зависят от сообщаемых свойств двойника устройства. Для получения дополнительной информации см. Учебное пособие: Настройка устройств из серверной службы.
Устройство отправляет обновления свойств в виде полезных данных JSON. Для получения дополнительной информации см. раздел телеметрии, свойств и полезных данных команд.
Пакет SDK для устройств Интернета вещей Azure можно использовать для отправки обновления свойств в приложение Azure IoT Central.
Примеры реализации на нескольких языках см. в руководстве. Создание и подключение клиентского приложения к приложению Azure IoT Central.
В следующем представлении в приложении Azure IoT Central отображаются свойства, доступные только для чтения устройства:
Реализация доступных для записи свойств
Оператор IoT Central задает доступные для записи свойства в форме. Azure IoT Central отправляет свойство на устройство. Azure IoT Central ожидает подтверждение от устройства.
Примеры реализации на нескольких языках см. в статье "Создание и подключение клиентского приложения к приложению Azure IoT Central".
Ответное сообщение должно содержать ac поля и av поля. Поле ad является необязательным. Дополнительные сведения см. в разделе соглашений IoT Plug and Play о свойствах с возможностью записи.
Когда оператор задает записываемое свойство в пользовательском интерфейсе Azure IoT Central, приложение использует нужное свойство двойника устройства для отправки значения на устройство. Затем устройство отвечает, используя сообщаемое свойство двойника устройства. Когда Azure IoT Central получает указанное значение свойства, оно обновляет представление свойств с состоянием Accepted.
После ввода значения и выбора кнопки "Сохранить" начальное состояние — На рассмотрении. Когда устройство принимает изменение, состояние изменяется на Accepted.
Использование свойств на неназначенных устройствах
Вы можете просматривать и обновлять доступные для записи свойства на устройстве, которое не назначено шаблону устройства.
Чтобы просмотреть существующие свойства на неназначаемом устройстве, перейдите к устройству в разделе "Устройства ", выберите "Управление устройством" и " Свойства устройства".
В этом представлении можно обновить доступные для записи свойства:
Дальнейшие шаги
Теперь, когда вы знаете, как использовать свойства в приложении Azure IoT Central, см. следующие сведения: