Aggiornamento del dispositivo per hub IoT file di configurazione

  • Articolo

L'agente Di aggiornamento del dispositivo ottiene le informazioni di configurazione dal file nel du-config.json dispositivo. L'agente legge questi valori e li segnala al servizio Aggiornamento dispositivi:

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

Percorso del file

Quando si installa l'agente Debian in un dispositivo IoT con un sistema operativo Linux, modificare il /etc/adu/du-config.json file per aggiornare i valori. Per un sistema di compilazione Yocto, nella partizione o nel disco denominato adu, creare un file json denominato /adu/du-config.json.

Elenco di campi

Nome Descrizione
schemaVersion Versione dello schema che esegue il mapping della versione corrente del formato file di configurazione.
aduShellTrustedUsers Elenco di utenti che possono avviare il programma adu-shell . Nota, adu-shell è un programma broker che esegue varie azioni di aggiornamento come "radice". I gestori di aggiornamento del contenuto predefiniti per l'aggiornamento del dispositivo richiamano adu-shell per eseguire attività che richiedono privilegi utente avanzati. Esempi di attività che richiedono questo privilegio sono apt-get install o eseguono uno script con privilegi.
aduc_manufacturer Segnalato dall'interfaccia AzureDeviceUpdateCore:4.ClientMetadata:4 per classificare il dispositivo per la distribuzione degli aggiornamenti.
aduc_model Segnalato dall'interfaccia AzureDeviceUpdateCore:4.ClientMetadata:4 per classificare il dispositivo per la distribuzione degli aggiornamenti.
connectionType I valori accettati sono string o AIS. Usare string quando si connette il dispositivo a hub IoT manualmente a scopo di test. Per gli scenari di produzione, usare quando si usa AIS il servizio identità IoT per connettere il dispositivo a hub IoT. Per altre informazioni, vedere Informazioni sulle configurazioni del servizio identità IoT.
connectionData Se connectionType = "string", aggiungere qui la stringa di connessione del dispositivo o del modulo IoT. Se connectionType = "AIS", impostare connectionData su stringa vuota ("connectionData": "").
manufacturer Segnalato dall'agente Di aggiornamento dispositivi come parte dell'interfaccia DeviceInformation .
model Segnalato dall'agente Di aggiornamento dispositivi come parte dell'interfaccia DeviceInformation .

Contenuto del file "du-config.json" di esempio


{
  "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>
    }
  ]
}