Używanie właściwości w rozwiązaniu Azure IoT Central

Artykuł
02/27/2024

W tym przewodniku z instrukcjami pokazano, jak używać właściwości urządzenia zdefiniowanych w szablonie urządzenia w aplikacji usługi Azure IoT Central.

Właściwości reprezentują wartości punktu w czasie. Na przykład urządzenie może użyć właściwości , aby zgłosić temperaturę docelową, z którą próbuje nawiązać połączenie. Domyślnie właściwości urządzenia są tylko do odczytu w usłudze IoT Central. Właściwości zapisywalne umożliwiają synchronizowanie stanu między urządzeniem a aplikacją usługi Azure IoT Central.

Właściwości chmury można również zdefiniować w aplikacji usługi Azure IoT Central. Wartości właściwości w chmurze nigdy nie są wymieniane z urządzeniem i nie należą do zakresu tego artykułu.

Aby dowiedzieć się więcej na temat konwencji właściwości IoT Pug i Play, zobacz Konwencje IoT Plug and Play.

Aby dowiedzieć się więcej na temat danych właściwości wymienianych przez urządzenie w usłudze IoT Central, zobacz Telemetria, właściwość i ładunki poleceń.

Aby dowiedzieć się, jak zarządzać właściwościami przy użyciu interfejsu API REST usługi IoT Central, zobacz Jak używać interfejsu API REST usługi IoT Central do sterowania urządzeniami.

Aby dowiedzieć się, jak zaimplementować właściwości na urządzeniu bez korzystania z zestawów SDK urządzeń, zobacz Komunikacja z centrum IoT przy użyciu protokołu MQTT.

Definiowanie właściwości

Właściwości to pola danych reprezentujące stan urządzenia. Użyj właściwości, aby reprezentować trwały stan urządzenia, taki jak stan włączania/wyłączania urządzenia. Właściwości mogą również reprezentować podstawowe właściwości urządzenia, takie jak wersja oprogramowania urządzenia. Właściwości można zadeklarować jako tylko do odczytu lub zapisywalne.

Poniższy zrzut ekranu przedstawia definicję właściwości w aplikacji usługi Azure IoT Central.

W poniższej tabeli przedstawiono ustawienia konfiguracji dla możliwości właściwości.

Pole	opis
Display name	Nazwa wyświetlana wartości właściwości używanej na kafelkach pulpitu nawigacyjnego i formularzach urządzeń.
Nazwisko	Nazwa właściwości. Usługa Azure IoT Central generuje wartość dla tego pola z nazwy wyświetlanej, ale w razie potrzeby możesz wybrać własną wartość. To pole musi być alfanumeryczne. Kod urządzenia używa tej wartości Nazwa .
Typ możliwości	Właściwość.
Typ semantyczny	Semantyczny typ właściwości, taki jak temperatura, stan lub zdarzenie. Wybór typu semantycznego określa, które z następujących pól są dostępne.
Schemat	Typ danych właściwości, taki jak podwójne, ciąg lub wektor. Typ semantyczny określa dostępne opcje. Schemat nie jest dostępny dla typów semantycznych zdarzeń i stanów.
Zapisywalne	Jeśli właściwość nie jest zapisywalna, urządzenie może zgłosić wartości właściwości do usługi Azure IoT Central. Jeśli właściwość jest zapisywalna, urządzenie może zgłaszać wartości właściwości do usługi Azure IoT Central. Następnie usługa Azure IoT Central może wysyłać aktualizacje właściwości do urządzenia.
Ważność	Dostępne tylko dla typu semantycznego zdarzenia. Ważność to Błąd, Informacje lub Ostrzeżenie.
Wartości stanów	Dostępne tylko dla typu semantycznego stanu. Zdefiniuj możliwe wartości stanu, z których każda ma nazwę wyświetlaną, nazwę, typ wyliczenia i wartość.
Jednostka	Jednostka wartości właściwości, taka jak mph, %lub °C.
Jednostka wyświetlania	Jednostka wyświetlania do użycia na kafelkach pulpitów nawigacyjnych i formularzach urządzeń.
Komentarz	Wszelkie komentarze dotyczące możliwości właściwości.
opis	Opis możliwości właściwości.

Aby dowiedzieć się więcej o języku DTDL (Digital Twin Definition Language), którego usługa Azure IoT Central używa do definiowania właściwości w szablonie urządzenia, zobacz Konwencje > IoT Plug and Play właściwości tylko do odczytu.

Opcjonalne pola, takie jak nazwa wyświetlana i opis, umożliwiają dodanie dodatkowych szczegółów do interfejsu i możliwości.

Podczas tworzenia właściwości można określić złożone typy schematów, takie jak Object i Enum.

Po wybraniu złożonego schematu, takiego jak Obiekt, należy zdefiniować schemat obiektu.

Implementowanie właściwości tylko do odczytu

Domyślnie właściwości są tylko do odczytu. Właściwości tylko do odczytu umożliwiają aktualizacji wartości właściwości raportu urządzenia do aplikacji usługi Azure IoT Central. Aplikacja usługi Azure IoT Central nie może ustawić wartości właściwości tylko do odczytu.

Usługa Azure IoT Central używa bliźniaczych reprezentacji urządzeń do synchronizowania wartości właściwości między urządzeniem a aplikacją usługi Azure IoT Central. Wartości właściwości urządzenia używają zgłoszonych właściwości bliźniaczej reprezentacji urządzenia. Aby uzyskać więcej informacji, zobacz bliźniacze reprezentacje urządzeń.

Urządzenie wysyła aktualizacje właściwości jako ładunek JSON. Aby uzyskać więcej informacji, zobacz Telemetria, właściwość i ładunki poleceń.

Zestaw SDK urządzenia Azure IoT umożliwia wysyłanie aktualizacji właściwości do aplikacji usługi Azure IoT Central.

Na przykład implementacje w wielu językach można znaleźć w temacie Create and connect a client application to your Azure IoT Central application (Tworzenie i łączenie aplikacji klienckiej z aplikacją usługi Azure IoT Central).

W poniższym widoku w aplikacji usługi Azure IoT Central są wyświetlane właściwości tylko do odczytu urządzenia:

Implementowanie właściwości zapisywalnych

Operator usługi IoT Central ustawia właściwości zapisywalne w formularzu. Usługa Azure IoT Central wysyła właściwość do urządzenia. Usługa Azure IoT Central oczekuje potwierdzenia z urządzenia.

Komunikat odpowiedzi powinien zawierać ac pola i av . Pole ad jest opcjonalne. Aby dowiedzieć się więcej, zobacz IoT Plug and Play conventions > Właściwości zapisywalne.

Gdy operator ustawia właściwość zapisywalną w interfejsie użytkownika usługi Azure IoT Central, aplikacja używa żądanej właściwości bliźniaczej reprezentacji urządzenia, aby wysłać wartość do urządzenia. Następnie urządzenie odpowiada za pomocą zgłaszanej właściwości bliźniaczej reprezentacji urządzenia. Gdy usługa Azure IoT Central odbiera zgłoszoną wartość właściwości, aktualizuje widok właściwości o stanie Zaakceptowane.

Po wprowadzeniu wartości i wybraniu pozycji Zapisz początkowy stan to Oczekiwanie. Gdy urządzenie zaakceptuje zmianę, stan zmieni się na Zaakceptowane.

Używanie właściwości na nieprzypisanych urządzeniach

Właściwości zapisywalne można wyświetlać i aktualizować na urządzeniu, które nie jest przypisane do szablonu urządzenia.

Aby wyświetlić istniejące właściwości na nieprzypisanym urządzeniu, przejdź do urządzenia w sekcji Urządzenia, wybierz pozycję Zarządzaj urządzeniem, a następnie pozycję Właściwości urządzenia:

Właściwości z możliwością zapisu można zaktualizować w tym widoku:

Następne kroki

Teraz, gdy już wiesz, jak używać właściwości w aplikacji usługi Azure IoT Central, zobacz:

Udostępnij za pośrednictwem