Azure IoT Central 솔루션에서 속성 사용
이 방법 가이드에서는 Azure IoT Central 애플리케이션의 디바이스 템플릿에 정의된 디바이스 속성을 사용하는 방법을 보여줍니다.
속성은 특정 시간 값을 나타냅니다. 예를 들어 디바이스에서 속성을 사용하여 도달하려는 목표 온도를 보고할 수 있습니다. 기본적으로 디바이스 속성은 IoT Central에서 읽기 전용입니다. 쓰기 가능한 속성을 사용하면 디바이스와 Azure IoT Central 애플리케이션 간의 상태를 동기화할 수 있습니다.
Azure IoT Central 애플리케이션에서 클라우드 속성을 정의할 수도 있습니다. 클라우드 속성 값은 디바이스와 교환되지 않으며 이 문서에서 다루는 주제의 범위를 벗어납니다.
IoT 플러그 앤 플레이 속성 규칙에 대해 알아보려면 IoT 플러그 앤 플레이 규칙을 참조하세요.
디바이스에서 IoT Central과 교환하는 속성 데이터에 대한 자세한 내용은 원격 분석, 속성 및 명령 페이로드를 참조하세요.
IoT Central REST API를 사용하여 속성을 관리하는 방법을 알아보려면 IoT Central REST API를 사용하여 디바이스를 제어하는 방법을 참조하세요.
디바이스 SDK를 사용하지 않고 디바이스에서 속성을 구현하는 방법을 알아보려면 MQTT 프로토콜을 사용하여 IoT Hub와 통신을 참조하세요.
속성 정의
속성은 디바이스의 상태를 나타내는 데이터 필드입니다. 속성을 사용하여 디바이스의 켜기/끄기 상태와 같은 디바이스의 지속형 상태를 나타냅니다. 또한 속성은 디바이스의 소프트웨어 버전 같은 기본 디바이스 속성을 나타낼 수도 있습니다. 속성을 읽기 전용 또는 쓰기 가능으로 선언합니다.
다음 스크린샷은 Azure IoT Central 애플리케이션의 속성 정의를 보여 줍니다.
다음 표에는 속성 기능의 구성 설정이 나와 있습니다.
| 필드 | Description |
|---|---|
| Display name | 대시보드 타일 및 디바이스 양식에 사용되는 속성 값의 표시 이름입니다. |
| 이름 | 속성의 이름입니다. Azure IoT Central은 표시 이름에서 이 필드의 값을 생성하지만, 필요한 경우 사용자 고유의 값을 선택할 수 있습니다. 이 필드는 영숫자여야 합니다. 디바이스 코드는 이 이름 값을 사용합니다. |
| 기능 유형 | 속성입니다. |
| 의미 체계 유형 | 속성의 의미 체계 유형입니다(예: 온도, 상태 또는 이벤트). 의미 체계 유형을 선택하면 다음 필드 중에서 사용 가능한 필드가 결정됩니다. |
| 스키마 | 속성 데이터 형식입니다(예: double, string 또는 vector). 의미 체계 형식에 따라 사용 가능한 선택이 결정됩니다. 이벤트 및 상태 의미 체계 유형에는 스키마를 사용할 수 없습니다. |
| 쓰기 가능 | 속성이 쓰기 가능이 아닌 경우 디바이스에서 속성 값을 Azure IoT Central에 보고할 수 있습니다. 속성이 쓰기 가능인 경우 디바이스에서 속성 값을 Azure IoT Central에 보고할 수 있습니다. 그런 다음, Azure IoT Central에서 디바이스에 속성 업데이트를 보낼 수 있습니다. |
| 심각도 | 이벤트 의미 체계 유형에만 사용할 수 있습니다. 심각도는 오류, 정보 또는 경고입니다. |
| 상태 값 | 상태 의미 체계 유형에만 사용할 수 있습니다. 가능한 상태 값을 정의하며, 각각에는 표시 이름, 이름, 열거형 형식 및 값이 있습니다. |
| 단위 | 속성 값에 대한 단위입니다(예: mph, % 또는 °C). |
| 표시 단위 | 대시보드 타일 및 디바이스 양식에서 사용할 표시 단위입니다. |
| 의견 | 속성 기능에 대한 주석입니다. |
| Description | 속성 기능에 대한 설명입니다. |
Azure IoT Central이 디바이스 템플릿의 속성을 정의하는 데 사용하는 DTDL(디지털 트윈 정의 언어)에 대해 알아보려면 IoT 플러그 앤 플레이 규칙 > 읽기 전용 속성을 참조하세요.
표시 이름, 설명 등의 선택적 필드를 사용하면 인터페이스 및 기능에 더 많은 세부 정보를 추가할 수 있습니다.
속성을 만들 때 개체, 열거형 등의 복합 스키마 형식을 지정할 수 있습니다.
개체 등의 복합 스키마를 선택하는 경우 개체 스키마를 정의해야 합니다.
읽기 전용 속성 구현
기본적으로 속성은 읽기 전용입니다. 읽기 전용 속성을 사용하면 디바이스 보고서 속성 값이 Azure IoT Central 애플리케이션으로 업데이트됩니다. Azure IoT Central 애플리케이션에서는 읽기 전용 속성 값을 설정할 수 없습니다.
Azure IoT Central은 디바이스 쌍을 사용하여 디바이스와 Azure IoT Central 애플리케이션 간에 속성 값을 동기화합니다. 디바이스 속성 값은 디바이스 쌍 reported 속성을 사용합니다. 자세한 내용은 디바이스 쌍을 참조하세요.
디바이스는 속성 업데이트를 JSON 페이로드로 보냅니다. 자세한 내용은 원격 분석, 속성 및 명령 페이로드를 참조하세요.
Azure IoT 디바이스 SDK를 사용하여 Azure IoT Central 애플리케이션에 속성 업데이트를 보낼 수 있습니다.
여러 언어로 구현된 예는 클라이언트 애플리케이션을 만들고 Azure IoT Central 애플리케이션에 연결을 참조하세요.
Azure IoT Central 애플리케이션의 다음 보기는 디바이스 읽기 전용 속성을 보여 줍니다.
쓰기 가능한 속성 구현
IoT Central 운영자는 양식에 쓰기 가능한 속성을 설정합니다. Azure IoT Central은 디바이스에 속성을 보냅니다. Azure IoT Central에는 디바이스의 승인이 필요합니다.
여러 언어로 구현된 예는 클라이언트 애플리케이션을 만들고 Azure IoT Central 애플리케이션에 연결을 참조하세요.
응답 메시지에는 ac 및 av 필드가 포함되어야 합니다. ad 필드는 선택 사항입니다. 자세한 내용은 IoT 플러그 앤 플레이 규칙 > 쓰기 가능 속성을 참조하세요.
운영자가 Azure IoT Central UI에서 쓰기 가능한 속성을 설정하면 애플리케이션에서 디바이스 쌍 desired 속성을 사용하여 디바이스에 값을 보냅니다. 그런 다음, 디바이스가 디바이스 쌍 reported 속성을 사용하여 응답합니다. Azure IoT Central은 reported 속성 값을 받으면 속성 보기를 수락됨 상태로 업데이트합니다.
값을 입력하고 저장을 선택하면 초기 상태는 보류 중입니다. 디바이스가 변경 내용을 수락하면 상태가 수락됨으로 바뀝니다.
할당되지 않은 디바이스에서 속성 사용
디바이스 템플릿에 할당되지 않은 디바이스에서 쓰기 가능한 속성을 보고 업데이트할 수 있습니다.
할당되지 않은 디바이스에서 기존 속성을 보려면 디바이스 섹션에서 디바이스로 이동하고 디바이스 관리를 선택한 다음, 디바이스 속성을 선택합니다.
이 보기에서 쓰기 가능한 속성을 업데이트할 수 있습니다.
다음 단계
Azure IoT Central 애플리케이션에서 속성을 사용하는 방법을 알아보았으니 이제 다음을 참조하세요.