IoT Hub yapılandırma dosyası için Cihaz Güncelleştirmesi

  • Makale

Cihaz Güncelleştirme aracısı yapılandırma bilgilerini cihazdaki du-config.json dosyadan alır. Aracı bu değerleri okur ve Cihaz Güncelleştirme hizmetine bildirir:

  • AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["manufacturer"]
  • AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["model"]
  • DeviceInformation.manufacturer
  • DeviceInformation.model
  • additionalProperties
  • Connectiondata
  • Connectiontype

Dosya konumu

Linux işletim sistemi olan bir IoT Cihazına Debian aracısını yüklerken, değerleri güncelleştirmek için dosyayı değiştirin /etc/adu/du-config.json . Yocto derleme sistemi için adlı adubölümde veya diskte adlı /adu/du-config.jsonbir json dosyası oluşturun.

Alan listesi

Ad Tanım
SchemaVersion Geçerli yapılandırma dosyası biçimi sürümüyle eşleşen şema sürümü.
aduShellTrustedUsers adu-shell programını başlatabilen kullanıcıların listesi. Adu-shell'in çeşitli güncelleştirme eylemlerini 'root' olarak yerine getiren bir aracı programı olduğunu unutmayın. Cihaz Güncelleştirmesi varsayılan içerik güncelleştirme işleyicileri süper kullanıcı ayrıcalığı gerektiren görevleri gerçekleştirmek için adu-shell çağırır. Bu ayrıcalığı apt-get install gerektiren görevlere örnek olarak ayrıcalıklı bir betik yürütme verilebilir.
aduc_manufacturer Cihazı güncelleştirme dağıtımını hedeflemek üzere sınıflandırmak için AzureDeviceUpdateCore:4.ClientMetadata:4 arabirimi tarafından raporlandı.
aduc_model Cihazı güncelleştirme dağıtımını hedeflemek üzere sınıflandırmak için AzureDeviceUpdateCore:4.ClientMetadata:4 arabirimi tarafından raporlandı.
iotHubProtocol Kabul edilen değerler, IoT hub'ına bağlanmak için kullanılan protokolü değiştirmek için veya'dır mqttmqtt/ws . Varsayılan değer 'mqtt'
compatPropertyNames Bu özellikler, güncelleştirme dağıtımını hedeflemek için cihazın uyumluluğunu denetlemek için kullanılır. Uyumluluk için kullanılacak belirtilen tüm özellikler için değerler yalnızca küçük harfle yazılmalıdır
additionalProperties İsteğe bağlı alan. Cihaz tarafından bildirilen ek özellikler ayarlanabilir ve comaptibility denetimi için kullanılabilir. Beş cihaz özelliğiyle sınırlıdır. Bu özellikler yalnızca küçük harfle yazılmalıdır.
Connectiontype Kabul edilen değerler veya AISşeklindedirstring. Test amacıyla cihazı IoT Hub'a el ile bağlarken kullanın string . Üretim senaryolarında, cihazı IoT Hub'a bağlamak için IoT Kimlik Hizmeti'ni kullanırken kullanın AIS . Daha fazla bilgi için bkz . IoT Kimlik Hizmeti yapılandırmalarını anlama.
Connectiondata connectionType = "string" ise IoT cihazınızın cihazını veya modülünü buraya bağlantı dizesi ekleyin. connectionType = "AIS" ise connectionData değerini boş dize ()"connectionData": "" olarak ayarlayın.
üretici DeviceInformation arabiriminin bir parçası olarak Cihaz Güncelleştirmesi aracısı tarafından bildirilir .
model DeviceInformation arabiriminin bir parçası olarak Cihaz Güncelleştirmesi aracısı tarafından bildirilir .

Örnek "du-config.json" dosya içeriği


{
  "schemaVersion": "1.1",
  "aduShellTrustedUsers": [
    "adu",
    "do"
  ],
  "iotHubProtocol": "mqtt",
  "compatPropertyNames":"manufacturer,model,location,language" <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"
      }
    }
  ]
}