Aggiornamento del dispositivo per hub IoT file di configurazione

  • Articolo

L'agente di Aggiornamento dispositivi ottiene le informazioni di configurazione dal du-config.json file nel 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
  • additionalProperties
  • connectionData
  • connectionType

Percorso del file

Quando si installa l'agente Debian in un dispositivo IoT con un sistema operativo Linux, modificare il file per aggiornare i /etc/adu/du-config.json 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 esegue il mapping della 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 di Aggiornamento dispositivi richiamano adu-shell per eseguire attività che richiedono privilegi utente con privilegi 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.
iotHubProtocol I valori accettati sono mqtt o mqtt/ws per modificare il protocollo usato per connettersi all'hub IoT. Il valore predefinito è 'mqtt'
compatPropertyNames Queste proprietà vengono usate per verificare la compatibilità del dispositivo per la distribuzione degli aggiornamenti. Per tutte le proprietà specificate per la compatabiity, i valori devono essere solo minuscoli
additionalProperties Campo facoltativo. È possibile impostare e usare proprietà aggiuntive segnalate del dispositivo per il controllo della comaptibilità. Limitato a cinque proprietà del dispositivo. Queste proprietà devono essere solo minuscole.
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 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.
connectionData Se connectionType = "string", aggiungere il dispositivo o il modulo del dispositivo IoT stringa di connessione qui. Se connectionType = "AIS", impostare connectionData su stringa vuota ("connectionData": "").
manufacturer Segnalato dall'agente di Aggiornamento dispositivi 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"
  ],
  "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"
      }
    }
  ]
}