이 방법 가이드에서는 Azure IoT Central 애플리케이션의 디바이스 템플릿에 정의된 디바이스 속성을 사용하는 방법을 보여 줍니다.
속성은 지정 시간 값을 나타냅니다. 예를 들어 디바이스는 속성을 사용하여 도달하려는 대상 온도를 보고할 수 있습니다. 기본적으로 디바이스 속성은 IoT Central에서 읽기 전용입니다. 쓰기 가능한 속성을 사용하면 디바이스와 Azure IoT Central 애플리케이션 간의 상태를 동기화할 수 있습니다.
Azure IoT Central 애플리케이션에서 클라우드 속성을 정의할 수도 있습니다. 클라우드 속성 값은 디바이스와 교환되지 않으며 이 문서의 범위를 벗어납니다.
IoT Pug 및 Play 속성 규칙에 대한 자세한 내용은 IoT 플러그 앤 플레이 규칙을 참조하세요.
디바이스가 IoT Central과 교환하는 속성 데이터에 대한 자세한 내용은 원격 분석, 속성 및 명령 페이로드를 참조하세요.
IoT Central REST API를 사용하여 속성을 관리하는 방법을 알아보려면 IoT Central REST API를 사용하여 디바이스를 제어하는 방법을 참조하세요.
디바이스 SDK를 사용하지 않고 디바이스에서 속성을 구현하는 방법을 알아보려면 MQTT 프로토콜을 사용하여 IoT Hub와 통신을 참조하세요.
속성 정의
속성은 디바이스의 상태를 나타내는 데이터 필드입니다. 속성을 사용하여 디바이스의 켜기/끄기 상태와 같은 디바이스의 지속성 상태를 나타냅니다. 속성은 디바이스의 소프트웨어 버전과 같은 기본 디바이스 속성을 나타낼 수도 있습니다. 속성을 읽기 전용 또는 쓰기 가능으로 선언합니다.
다음 스크린샷은 Azure IoT Central 애플리케이션의 속성 정의를 보여줍니다.
다음 표에서는 속성 기능에 대한 구성 설정을 보여줍니다.
| 분야 | Description |
|---|---|
| 표시 이름 | 대시보드 타일 및 디바이스 양식에 사용되는 속성 값의 표시 이름입니다. |
| 이름 | 속성의 이름입니다. Azure IoT Central은 표시 이름에서 이 필드에 대한 값을 생성하지만 필요한 경우 고유한 값을 선택할 수 있습니다. 이 필드는 영숫자여야 합니다. 디바이스 코드는 이 이름 값을 사용합니다. |
| 기능 유형 | 재산. |
| 의미 체계 형식 | 온도, 상태 또는 이벤트와 같은 속성의 의미 체계 형식입니다. 의미 체계 형식을 선택하면 다음 필드 중 사용할 수 있는 필드가 결정됩니다. |
| Schema | 속성 데이터 형식(예: 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 애플리케이션 간에 속성 값을 동기화합니다. 디바이스 속성 값은 디바이스 트윈의 보고된 속성을 사용합니다. 자세한 내용은 자습서: 백 엔드 서비스에서 디바이스 구성을 참조하세요.
디바이스는 속성 업데이트를 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에서 쓰기 가능한 속성을 설정하면, 애플리케이션은 디바이스 트윈의 원하는 속성을 사용하여 디바이스에 그 값을 전송합니다. 그런 다음 디바이스 트윈의 보고된 속성을 사용하여 응답합니다. Azure IoT Central이 reported 속성 값을 받으면 속성 뷰를 수락됨 상태로 업데이트합니다.
값을 입력하고 저장을 선택하면 초기 상태가 보류 중입니다. 디바이스에서 변경 내용을 수락하면 상태가 수락됨으로 변경됩니다.
할당되지 않은 디바이스에서 속성 사용
디바이스 템플릿에 할당되지 않은 디바이스에서 쓰기 가능 속성을 보고 업데이트할 수 있습니다.
할당되지 않은 디바이스에서 기존 속성을 보려면 디바이스 섹션에서 디바이스로 이동하고 디바이스 관리를 선택한 다음 디바이스 속성을 선택합니다.
이 보기에서 쓰기 가능한 속성을 업데이트할 수 있습니다.
다음 단계
Azure IoT Central 애플리케이션에서 속성을 사용하는 방법을 알아보려면 다음을 참조하세요.