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
• 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.
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"
  ],
  "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>
    }
  ]
}