Konfigurationsdatei von Device Update for IoT Hub

Der Device Update-Agent ruft seine Konfigurationsinformationen aus der Datei du-config.json auf dem Gerät ab. Der Agent liest diese Werte und meldet sie dem Device Update-Dienst:

• AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["manufacturer"]
• AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["model"]
• DeviceInformation.manufacturer
• DeviceInformation.model
• additionalProperties
• connectionData
• connectionType

Dateispeicherort

Wenn Sie den Debian-Agent auf einem IoT-Gerät mit einem Linux-Betriebssystem installieren, ändern Sie die Datei /etc/adu/du-config.json zum Aktualisieren von Werten. Erstellen Sie für ein Yocto-Buildsystem in der Partition oder auf dem Datenträger mit dem Namen adu eine JSON-Datei mit dem Namen /adu/du-config.json.

Liste der Felder

Name	Beschreibung
SchemaVersion	Die Schemaversion, mit der die aktuelle Formatversion der Konfigurationsdatei zugeordnet wird.
aduShellTrustedUsers	Die Liste der Benutzer, die das Programm adu-shell starten können. Beachten Sie, dass adu-shell ein Brokerprogramm ist, das verschiedene Updateaktionen als „root“ ausführt. Die Device Update-Standardhandler für Inhaltsupdates rufen adu-shell auf, um Aufgaben auszuführen, für die die Superuser-Berechtigung erforderlich ist. Beispiele für Aufgaben, die diese Berechtigung erfordern, sind apt-get install oder das Ausführen privilegierter Skripts.
aduc_manufacturer	Wird von der Schnittstelle AzureDeviceUpdateCore:4.ClientMetadata:4 gemeldet, um das Gerät für die Updatebereitstellung zu klassifizieren.
aduc_model	Wird von der Schnittstelle AzureDeviceUpdateCore:4.ClientMetadata:4 gemeldet, um das Gerät für die Updatebereitstellung zu klassifizieren.
iotHubProtocol	Zum Ändern des Protokolls, das zum Herstellen einer Verbindung mit dem IoT-Hub verwendet wird, wird der Wert mqtt oder mqtt/ws akzeptiert. Der Standardwert ist „mqtt“.
compatPropertyNames	Diese Eigenschaften werden verwendet, um die Kompatibilität des Geräts für die Updatebereitstellung zu überprüfen. Damit alle für die Kompatibilität angegebenen Eigenschaften verwendet werden, müssen die Werte nur in Kleinbuchstaben angegeben werden
additionalProperties	Optionales Feld. Zusätzliche vom Gerät gemeldete Eigenschaften können festgelegt und für die Kompatibilitätsprüfung verwendet werden. Auf fünf Geräteeigenschaften beschränkt. Diese Eigenschaften sollten nur in Kleinbuchstaben vorliegen.
connectionType	Zulässige Werte sind string und AIS. Verwenden Sie string, wenn Sie das Gerät zu Testzwecken manuell mit IoT Hub verbinden. Verwenden Sie für Produktionsszenarien AIS, wenn Sie den IoT-Identitätsdienst zum Verbinden des Geräts mit IoT Hub verwenden. Weitere Informationen finden Sie unter Grundlegendes zu Konfigurationen des IoT-Identitätsdiensts.
connectionData	Fügen Sie bei „connectionType = "string"“ hier die Verbindungszeichenfolge Ihres IoT-Geräts, Geräts oder Moduls hinzu. Wenn „connectionType = "AIS"“, legen Sie connectionData auf eine leere Zeichenfolge fest("connectionData": "").
Hersteller	Wird vom Device Update-Agent als Teil der Schnittstelle DeviceInformation gemeldet.
model	Wird vom Device Update-Agent als Teil der Schnittstelle DeviceInformation gemeldet.

Beispielinhalt der Datei „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"
      }
    }
  ]
}