Device Update for IoT Hub 구성 파일

디바이스 업데이트 에이전트는 디바이스의 du-config.json 파일에서 구성 정보를 가져옵니다. 에이전트는 이러한 값을 읽고 디바이스 업데이트 서비스에 보고합니다.

• AzureDeviceUpdateCore: 4. ClientMetadata: 4 deviceProperties ["manufacturer"]
• AzureDeviceUpdateCore: 4. ClientMetadata: 4 deviceProperties ["manufacturer"]
• DeviceInformation. 제조업체
• DeviceInformation. 모델
• additionalProperties
• connectionData
• connectionType

파일 위치

Linux OS를 사용하는 IoT 디바이스에 Debian 에이전트를 설치하는 경우 /etc/adu/du-config.json 파일을 수정하여 값을 업데이트합니다. Yocto 빌드 시스템의 경우 adu라는 파티션 또는 디스크에서 /adu/du-config.json이라는 json 파일을 만듭니다.

필드 목록

이름	설명
SchemaVersion	현재 구성 파일 형식 버전을 매핑하는 스키마 버전입니다.
aduShellTrustedUsers	adu-shell 프로그램을 시작할 수 있는 사용자 목록입니다. adu-shell은 다양한 업데이트 작업을 ‘루트’로 수행하는 broker 프로그램입니다. 디바이스 업데이트 기본 콘텐츠 업데이트 처리기는 adu-shell을 호출하여 슈퍼 사용자 권한이 필요한 작업을 수행합니다. 이 권한이 필요한 작업의 예제로는 apt-get install 또는 권한 있는 스크립트 실행이 있습니다.
제조업체	업데이트 배포를 대상으로 하는 디바이스를 분류하기 위해 AzureDeviceUpdateCore:4.ClientMetadata:4 인터페이스에서 보고됩니다.
model	업데이트 배포를 대상으로 하는 디바이스를 분류하기 위해 AzureDeviceUpdateCore:4.ClientMetadata:4 인터페이스에서 보고됩니다.
iotHubProtocol	허용되는 값은 IoT Hub에 연결하는 데 사용되는 프로토콜을 변경하는 mqtt 또는 mqtt/ws입니다. 기본값은 'mqtt'입니다.
compatPropertyNames	이러한 속성을 사용하여 디바이스가 업데이트 배포를 대상으로 하는 디바이스의 호환성을 확인합니다. 호환성을 위해 사용하도록 지정된 모든 속성의 경우 값은 소문자여야 합니다.
additionalProperties	선택적 필드입니다. 추가 디바이스 reported 속성을 설정하고 호환성 검사에 사용할 수 있습니다. 5개 디바이스 속성으로 제한됩니다. 이러한 속성은 소문자여야 합니다.
connectionType	허용되는 값은 string 또는 AIS입니다. 테스트를 위해 디바이스를 IoT Hub에 수동으로 연결할 때 string을 사용합니다. 프로덕션 시나리오의 경우 IoT ID 서비스를 사용하여 디바이스를 IoT Hub에 연결할 때 AIS를 사용합니다. 자세한 내용은 IoT ID 서비스 구성 이해를 참조하세요.
connectionData	connectionType = "string"이면 여기에 IoT 디바이스의 디바이스 또는 모듈 연결 문자열을 추가합니다. connectionType = "AIS"이면 connectionData를 빈 문자열("connectionData": "")로 설정합니다.
제조업체	디바이스 업데이트 에이전트를 DeviceInformation 인터페이스의 일부로 보고합니다.
model	디바이스 업데이트 에이전트를 DeviceInformation 인터페이스의 일부로 보고합니다.

예제 “du-config.json” 파일 콘텐츠

{
  "schemaVersion": "1.1",
  "aduShellTrustedUsers": [
    "adu",
    "do"
  ],
  "iotHubProtocol": "mqtt",
  "compatPropertyNames":"manufacturer,model,location,environment" <The property values must be in lower case only>,
  "manufacturer": <Place your device info manufacturer here>,
  "model": <Place your device info model here>,
  "agents": [
    {
      "name": <Place your agent name here>,
      "runas": "adu",
      "connectionSource": {
        "connectionType": "string", //or “AIS”
        "connectionData": <Place your Azure IoT device connection string here>
      },
      "manufacturer": <Place your device property manufacturer here>,
      "model": <Place your device property model here>,
      "additionalDeviceProperties": {
        "location": "usa",
        "environment": "development"
      }
    }
  ]
}