IoT 中樞裝置更新的組態檔
裝置更新代理程式會從裝置上的 du-config.json
檔案取得其設定資訊。 代理程式會讀取這些值,並將其報告給裝置更新服務:
- AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["manufacturer"]
- AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["model"]
- DeviceInformation.manufacturer
- DeviceInformation.model
- additionalProperties
- connectionData
- connectionType
檔案位置
在使用 Linux OS 的 IoT 裝置上安裝 Debian 代理程式時,請修改 /etc/adu/du-config.json
檔案以更新值。 對於 Yocto 建置系統,請在名為 adu
的分割區或磁碟中,建立名為 /adu/du-config.json
的 json 檔案。
欄位清單
名稱 | 描述 |
---|---|
schemaVersion | 對應目前組態檔格式版本的結構描述版本。 |
aduShellTrustedUsers | 可啟動 adu-shell 程式的使用者清單。 請注意,du-shell 是一種訊息代理程式,會以 'root' 身分執行多種更新動作。 裝置更新預設內容更新處理常式會叫用 du-shell,以執行需要進階使用者權限的工作。 舉例來說,apt-get install 或執行特殊權限指令碼都屬於需要此權限的工作。 |
aduc_manufacturer | 由 AzureDeviceUpdateCore:4.ClientMetadata:4 介面回報,用來分類裝置以決定更新部署的目標。 |
aduc_model | 由 AzureDeviceUpdateCore:4.ClientMetadata:4 介面回報,用來分類裝置以決定更新部署的目標。 |
iotHubProtocol | 接受的值是 mqtt 或 mqtt/ws ,可變更用來與 IoT 中樞連線的通訊協定。 預設值是 'mqtt' |
compatPropertyNames | 這些屬性可用來檢查裝置的相容性,以將目標設定為更新部署。 針對指定用於相容性的所有屬性,值必須只以小寫為單位 |
additionalProperties | 選擇性欄位。 您可以設定其他裝置報告的屬性,並用於相容性檢查。 限制為五個裝置屬性。 這些屬性應該只有小寫。 |
connectionType | 接受的值為 string 或 AIS 。 將裝置手動連線至 IoT 中樞以供測試之用時,請使用 string 。 在生產案例中,使用 IoT 識別服務將裝置連線至 IoT 中樞時,請使用 AIS 。 如需詳細資訊,請參閱了解 IoT 識別服務設定。 |
connectionData | 如果 connectionType = "string",請在此處新增 IoT 裝置的裝置或模組連接字串。 如果 connectionType = "AIS",請將 connectionData 設定為空字串 ("connectionData": "" )。 |
製造商 | 由裝置更新代理程式回報為 DeviceInformation 介面的一部分。 |
機型 | 由裝置更新代理程式回報為 DeviceInformation 介面的一部分。 |
範例 "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"
}
}
]
}