Udostępnij za pośrednictwem

Device Update for IoT Hub configuration file (Aktualizacja urządzenia dla pliku konfiguracji IoT Hub)

  • Artykuł

Agent usługi Device Update pobiera informacje o konfiguracji z du-config.json pliku na urządzeniu. Agent odczytuje te wartości i zgłasza je do usługi Device Update:

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

Lokalizacja pliku

Podczas instalowania agenta Debian na urządzeniu IoT z systemem operacyjnym Linux zmodyfikuj plik w /etc/adu/du-config.json celu zaktualizowania wartości. W przypadku systemu kompilacji Yocto w partycji lub dysku o nazwie aduutwórz plik JSON o nazwie /adu/du-config.json.

Lista pól

Nazwa Opis
SchemaVersion Wersja schematu, która mapuje bieżącą wersję formatu pliku konfiguracji.
aduShellTrustedUsers Lista użytkowników, którzy mogą uruchomić program adu-shell . Uwaga: adu-shell to program brokera, który wykonuje różne akcje aktualizacji jako "root". Domyślne procedury obsługi aktualizacji zawartości usługi Device Update wywołują adu-shell w celu wykonywania zadań wymagających uprawnień administratora. Przykłady zadań, które wymagają tego uprawnienia, to apt-get install lub wykonywanie skryptu uprzywilejowanego.
aduc_manufacturer Zgłoszone przez interfejs AzureDeviceUpdateCore:4.ClientMetadata:4 w celu sklasyfikowania urządzenia pod kątem wdrożenia aktualizacji.
aduc_model Zgłoszone przez interfejs AzureDeviceUpdateCore:4.ClientMetadata:4 w celu sklasyfikowania urządzenia pod kątem wdrożenia aktualizacji.
Connectiontype Akceptowane wartości to string lub AIS. Użyj string polecenia podczas łączenia urządzenia, aby IoT Hub ręcznie na potrzeby testowania. W przypadku scenariuszy produkcyjnych użyj AIS polecenia w przypadku używania usługi tożsamości IoT, aby połączyć urządzenie z IoT Hub. Aby uzyskać więcej informacji, zobacz Understand IoT Identity Service configurations (Omówienie konfiguracji usługi tożsamości IoT).
connectionData Jeśli parametr connectionType = "string", dodaj tutaj parametry połączenia urządzenia lub modułu urządzenia IoT. Jeśli connectionType = "AIS", ustaw parametr connectionData na puste parametry ("connectionData": "").
manufacturer Zgłoszone przez agenta usługi Device Update w ramach interfejsu DeviceInformation .
model Zgłoszone przez agenta usługi Device Update w ramach interfejsu DeviceInformation .

Przykład zawartości pliku "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>
    }
  ]
}