Condividi tramite


Aggiornamento del file di configurazione del dispositivo per l'hub IoT

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

  • AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["produttore"]
  • AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["model"]
  • DeviceInformation.manufacturer (fabbricante)
  • InformazioneDispositivo.modello
  • datiDiConnessione
  • tipo di connessione

Percorso del file

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

Elenco di campi

Nome Descrizione
SchemaVersion Versione dello schema che mappa la versione corrente del formato del file di configurazione.
aduShellTrustedUsers Elenco di utenti che possono avviare il programma adu-shell . Si noti che adu-shell è un programma broker che esegue varie azioni di aggiornamento come "root". I gestori di aggiornamento del contenuto predefiniti dell'update del dispositivo richiamano adu-shell per eseguire attività che richiedono privilegi di superutente. 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.
tipo di connessione 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 AIS quando si usa il servizio di gestione delle identità IoT per connettere il dispositivo a hub IoT. Per altre informazioni, vedere Informazioni sulle configurazioni del servizio di gestione delle identità IoT.
dati di connessione Se il connectionType = "string", aggiungi qui la stringa di connessione del dispositivo o del modulo IoT. Se connectionType = "AIS", impostare connectionData su stringa vuota ("connectionData": "").
produttore Segnalato dall'agente di aggiornamento del dispositivo come parte dell'interfaccia DeviceInformation.
modello 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>
    }
  ]
}