File konfigurasi Device Update for IoT Hub

Agen Pembaruan Perangkat mendapatkan informasi konfigurasinya dari file du-config.json pada perangkat. Agen membaca nilai-nilai ini dan melaporkannya ke layanan Pembaruan Perangkat:

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

Lokasi file

Saat menginstal agen Debian pada Perangkat IoT dengan OS Linux, ubah file /etc/adu/du-config.json untuk memperbarui nilai. Untuk sistem pembangunan Yocto, di partisi atau disk bernama adu, buat file json bernama /adu/du-config.json.

Daftar bidang

Nama	Deskripsi
SchemaVersion	Versi skema yang memetakan versi format file konfigurasi saat ini.
aduShellTrustedUsers	Daftar pengguna yang dapat meluncurkan program adu-shell. Catatan, adu-shell adalah program broker yang melakukan berbagai tindakan pembaruan sebagai 'root'. Penangan pembaruan konten default Pembaruan Perangkat memanggil adu-shell untuk melakukan tugas yang memerlukan hak istimewa pengguna super. Contoh tugas yang memerlukan hak istimewa ini adalah apt-get install atau menjalankan skrip istimewa.
aduc_manufacturer	Dilansir oleh antarmuka AzureDeviceUpdateCore:4.ClientMetadata:4 untuk mengklasifikasikan perangkat guna menargetkan penyebaran pembaruan.
aduc_model	Dilansir oleh antarmuka AzureDeviceUpdateCore:4.ClientMetadata:4 untuk mengklasifikasikan perangkat guna menargetkan penyebaran pembaruan.
iotHubProtocol	Nilai yang diterima adalah mqtt atau mqtt/ws untuk mengubah protokol yang digunakan untuk menyambungkan dengan hub IoT. Nilai defaultnya adalah 'mqtt'
compatPropertyNames	Properti ini digunakan untuk memeriksa kompatibilitas perangkat untuk menargetkan penyebaran pembaruan. Agar semua properti yang ditentukan digunakan untuk kopatabiitas, nilai harus dalam huruf kecil saja
additionalProperties	Bidang opsional. Properti perangkat tambahan yang dilaporkan dapat diatur dan digunakan untuk pemeriksaan kompaptibilitas . Terbatas pada lima properti perangkat. Properti ini harus dalam huruf kecil saja.
connectionType	Nilai yang diterima adalah string atau AIS. Gunakan string saat menghubungkan perangkat ke IoT Hub secara manual untuk tujuan pengujian. Untuk skenario produksi, gunakan AIS saat menggunakan Layanan Identitas IoT untuk menghubungkan perangkat ke IoT Hub. Untuk informasi selengkapnya, lihat memahami konfigurasi Layanan Identitas IoT.
connectionData	Jika connectionType = "string", tambahkan perangkat IoT Anda atau modul koneksi string di sini. Jika connectionType = "AIS", atur connectionData ke string kosong ("connectionData": "").
produsen	Dilansir oleh agen Pembaruan Perangkat sebagai bagian dari antarmuka DeviceInformation.
model	Dilansir oleh agen Pembaruan Perangkat sebagai bagian dari antarmuka DeviceInformation.

Contoh konten file "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"
      }
    }
  ]
}