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