Sdílet prostřednictvím

Aktualizace zařízení pro konfigurační soubor IoT Hub

  • Článek

Agent aktualizace zařízení získá informace o konfiguraci ze du-config.json souboru v zařízení. Agent přečte tyto hodnoty a nahlásí je službě Device Update:

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

Umístění souboru

Při instalaci agenta Debianu na zařízení IoT s operačním systémem Linux upravte /etc/adu/du-config.json soubor tak, aby aktualizoval hodnoty. Pro systém sestavení Yocto vytvořte v oddílu nebo disku s názvem adusoubor JSON s názvem /adu/du-config.json.

Seznam polí

Název Description
SchemaVersion Verze schématu, která mapuje aktuální verzi formátu konfiguračního souboru.
aduShellTrustedUsers Seznam uživatelů, kteří můžou spustit program adu-shell . Všimněte si, že adu-shell je zprostředkovaný program, který provádí různé akce aktualizace jako root. Výchozí obslužné rutiny aktualizace obsahu služby Device Update vyvolají adu-shell k úkolům, které vyžadují oprávnění superuživatele. Příklady úloh, které toto oprávnění vyžadují, jsou apt-get install nebo spuštění privilegovaného skriptu.
aduc_manufacturer Nahlášené rozhraním AzureDeviceUpdateCore:4.ClientMetadata:4 klasifikuje zařízení pro cílení na nasazení aktualizace.
aduc_model Nahlášené rozhraním AzureDeviceUpdateCore:4.ClientMetadata:4 klasifikuje zařízení pro cílení na nasazení aktualizace.
connectionType Akceptované hodnoty jsou string nebo AIS. Použijte string při ručním připojení zařízení k IoT Hub pro účely testování. V produkčních scénářích použijte AIS při použití služby IoT Identity Service připojení zařízení k IoT Hub. Další informace najdete v tématu Principy konfigurací služby IoT Identity Service.
connectionData Pokud connectionType = "string", přidejte sem připojovací řetězec zařízení nebo modulu vašeho zařízení IoT. Pokud connectionType = "AIS", nastavte connectionData na prázdný řetězec ("connectionData": "").
manufacturer Nahlášeno agentem Aktualizace zařízení jako součást rozhraní DeviceInformation .
model Nahlášeno agentem Aktualizace zařízení jako součást rozhraní DeviceInformation .

Příklad obsahu souboru 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>
    }
  ]
}