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 adu
skapar 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"
}
}
]
}