Share via


Enhetsuppdatering för IoT Hub-konfigurationsfil

Enhetsuppdateringsagenten hämtar sin konfigurationsinformation från du-config.json filen på enheten. Agenten läser dessa värden och rapporterar dem till enhetsuppdateringstjänsten:

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

Sökväg

När du installerar Debian-agenten på en IoT-enhet med ett Linux-operativsystem ändrar du /etc/adu/du-config.json filen för att uppdatera värden. För ett Yocto-byggsystem i partitionen eller disken med namnet aduskapar du en json-fil med namnet /adu/du-config.json.

Lista över fält

Namn Beskrivning
SchemaVersion Schemaversionen som mappar den aktuella versionen av konfigurationsfilformatet.
aduShellTrustedUsers Listan över användare som kan starta adu-shell-programmet . Observera att adu-shell är ett koordinatorprogram som utför olika uppdateringsåtgärder som "root". Enhetsuppdateringens standardhanterare för innehållsuppdateringar anropar adu-shell för att utföra uppgifter som kräver superanvändarbehörighet. Exempel på uppgifter som kräver den här behörigheten är apt-get install eller kör ett privilegierat skript.
aduc_manufacturer Rapporteras av gränssnittet AzureDeviceUpdateCore:4.ClientMetadata:4 för att klassificera enheten för att rikta in sig på uppdateringsdistributionen.
aduc_model Rapporteras av gränssnittet AzureDeviceUpdateCore:4.ClientMetadata:4 för att klassificera enheten för att rikta in sig på uppdateringsdistributionen.
iotHubProtocol Godkända värden är mqtt eller mqtt/ws för att ändra det protokoll som används för att ansluta till IoT Hub. Standardvärdet är "mqtt"
compatPropertyNames Dessa egenskaper används för att kontrollera enhetens kompatibilitet för att rikta in sig på uppdateringsdistributionen. För alla egenskaper som har angetts för att användas för kompatibilitet måste värdena endast vara gemener
additionalProperties Valfritt fält. Ytterligare enhetsrapporterade egenskaper kan anges och användas för kompatibilitetskontroll. Begränsad till fem enhetsegenskaper. Dessa egenskaper bör endast vara gemener.
connectionType Godkända värden är string eller AIS. Använd string när du ansluter enheten till IoT Hub manuellt i testsyfte. I produktionsscenarier använder du AIS när du använder IoT Identity Service för att ansluta enheten till IoT Hub. Mer information finns i förstå IoT Identity Service-konfigurationer.
connectionData Om connectionType = "string" lägger du till din IoT-enhets enhet eller modul anslutningssträng här. Om connectionType = "AIS" anger du connectionData till tom sträng ("connectionData": "").
manufacturer Rapporteras av enhetsuppdateringsagenten som en del av DeviceInformation-gränssnittet .
modell Rapporteras av enhetsuppdateringsagenten som en del av DeviceInformation-gränssnittet .

Exempel på filinnehållet "du-config.json"


{
  "schemaVersion": "1.1",
  "aduShellTrustedUsers": [
    "adu",
    "do"
  ],
  "iotHubProtocol": "mqtt",
  "compatPropertyNames":"manufacturer,model,location,language" <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"
      }
    }
  ]
}