Azure IoT Edge untuk Linux di Windows (EFLOW) dengan IoT Central

Azure IoT Edge untuk Linux di Windows (EFLOW) memungkinkan Anda menjalankan Azure IoT Edge dalam kontainer Linux di perangkat Windows Anda. Dalam artikel ini, Anda mempelajari cara memprovisikan perangkat EFLOW dan mengelolanya dari aplikasi IoT Central Anda.

Dalam artikel cara penggunaan ini, Anda mempelajari cara:

• Buat templat perangkat untuk perangkat IoT Edge.
• Buat perangkat IoT Edge di IoT Central.
• Menyambungkan dan memprovisikan perangkat EFLOW.

Prasyarat

Untuk menyelesaikan langkah-langkah dalam artikel ini, Anda perlu:

• Langganan Azure aktif. Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.

• Aplikasi IoT Central yang dibuat dari templat aplikasi Kustom. Untuk mempelajari lebih lanjut, lihat Membuat aplikasi IoT Central.

• Perangkat Windows dengan persyaratan minimum berikut:

  • Windows 10 ¹/11 (Pro, Enterprise, IoT Enterprise) atau Windows Server 2019¹/2022
  • Memori bebas minimum: 1 GB
  • Ruang disk kosong minimum: 10 GB
  • ¹ Windows 10 dan Windows Server 2019 minimum build 17763 dengan semua pembaruan kumulatif saat ini diinstal.

Untuk mengikuti langkah-langkah dalam artikel ini, unduh file EnvironmentalSensorManifest.json ke komputer Anda.

Menambahkan templat perangkat

Di bagian ini, Anda membuat templat perangkat IoT Central untuk perangkat IoT Edge. Anda mengimpor manifes IoT Edge untuk memulai, lalu memodifikasi templat untuk menambahkan definisi dan tampilan telemetri:

Membuat templat perangkat dan mengimpor manifes

1. Buat templat perangkat dan pilih Azure IoT Edge sebagai jenis templat.

2. Pada halaman Kustomisasi wizard, masukkan nama seperti Perangkat Edge Sensor Lingkungan untuk templat perangkat.

3. Pilih Telusuri dan unggah file manifes EnvironmentalSensorManifest.json yang Anda unduh sebelumnya.

4. Pada halaman Tinjau, pilih Buat

5. Pilih antarmuka manajemen dalam modul SimulatedTemperatureSensor untuk melihat dua properti yang ditentukan dalam manifes:

Menambahkan telemetri ke templat perangkat

Manifes IoT Edge tidak menentukan telemetri yang dikirim modul. Anda menambahkan definisi telemetri ke templat perangkat di IoT Central. Modul SimulatedTemperatureSensor mengirim pesan telemetri yang terlihat seperti JSON berikut:

{
  "machine": {
    "temperature": 75.0,
    "pressure": 40.2
  },
  "ambient": {
    "temperature": 23.0,
    "humidity": 30.0
  },
  "timeCreated": ""
}

Untuk menambahkan definisi telemetri ke templat perangkat:

1. Pilih antarmuka manajemen di templat Perangkat Edge Sensor Lingkungan .

2. Pilih + Tambahkan kemampuan. Masukkan komputer sebagai Nama tampilan dan pilih Jenis kemampuan sebagai Telemetri.

3. Pilih Objek sebagai jenis skema, lalu pilih Tentukan. Pada halaman definisi objek, tambahkan suhu dan tekanan sebagai atribut jenis Ganda lalu pilih Terapkan.

4. Pilih + Tambahkan kemampuan. Masukkan sekitar sebagai Nama tampilan dan pilih jenis Kapabilitas sebagai Telemetri.

5. Pilih Objek sebagai jenis skema, lalu pilih Tentukan. Pada halaman definisi objek, tambahkan suhu dan kelembaban sebagai atribut jenis Ganda lalu pilih Terapkan.

6. Pilih + Tambahkan kemampuan. Masukkan timeCreated sebagai Nama tampilan dan pastikan bahwa jenis Kemampuan adalah Telemetri.

7. Pilih DateTime sebagai jenis skema.

8. Pilih Simpan untuk memperbarui templat.

Antarmuka manajemen sekarang mencakup jenis telemetri mesin, sekitar, dan timeCreated :

Menambahkan tampilan ke templat

Untuk mengaktifkan operator untuk melihat telemetri dari perangkat, tentukan tampilan di templat perangkat.

1. Pilih Tampilan di templat Perangkat Edge Sensor Lingkungan .

2. Pada halaman Pilih untuk menambahkan tampilan baru , pilih petak Visualisasi perangkat .

3. Ubah nama tampilan menjadi Tampilkan telemetri perangkat IoT Edge.

4. Di bawah Mulai dengan perangkat, pilih jenis telemetri sekitar/suhu, sekitar/kelembaban, mesin/kelembaban, dan mesin/suhu . Lalu pilih Tambahkan petak peta.

5. Pilih Simpan untuk menyimpan tampilan telemetri perangkat IoT Edge.

Terbitkan templat

Sebelum Anda dapat menambahkan perangkat yang menggunakan templat Perangkat Edge Sensor Lingkungan , Anda harus menerbitkan templat.

Navigasi ke templat Perangkat Edge Sensor Lingkungan dan pilih Terbitkan. Pada templat Terbitkan perangkat ini ke panel aplikasi , pilih Terbitkan untuk menerbitkan templat:

Menambahkan perangkat IoT Edge

Sebelum dapat menyambungkan perangkat ke IoT Central, Anda harus mendaftarkan perangkat di aplikasi Anda:

1. Di aplikasi IoT Central Anda, navigasikan ke halaman Perangkat dan pilih Perangkat Edge Sensor Lingkungan dalam daftar templat yang tersedia.

2. Pilih + Baru untuk menambahkan perangkat baru dari templat. Pada halaman Buat perangkat baru , pilih Buat.

Anda sekarang memiliki perangkat baru dengan status Terdaftar:

Mendapatkan kredensial perangkat

Saat Anda menyebarkan perangkat IoT Edge nanti dalam artikel panduan ini, Anda memerlukan kredensial yang memungkinkan perangkat terhubung ke aplikasi IoT Central Anda. Untuk mendapatkan kredensial perangkat:

1. Pada halaman Perangkat , pilih perangkat yang Anda buat.

2. Pilih Sambungkan.

3. Pada halaman Koneksi perangkat , catat Cakupan ID, ID Perangkat, dan Kunci Primer. Anda menggunakan nilai-nilai tersebut di lain waktu.

4. Pilih Tutup.

Anda sekarang telah selesai mengonfigurasi aplikasi IoT Central Anda untuk mengaktifkan perangkat IoT Edge untuk terhubung.

Menginstal dan memprovisikan perangkat EFLOW

1. Dalam sesi PowerShell yang ditingkatkan, jalankan setiap perintah berikut untuk mengunduh IoT Edge untuk Linux di Windows.

   $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
   $ProgressPreference = 'SilentlyContinue'
   Invoke-WebRequest "https://aka.ms/AzEflowMSI" -OutFile $msiPath
   

2. Instal IoT Edge untuk Linux di Windows di perangkat Anda.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn"
   

   Anda dapat menentukan pemasangan IoT Edge kustom untuk Linux di Windows dan direktori VHDX dengan menambahkan parameter INSTALLDIR="<FULLY_QUALIFIED_PATH>" dan VHDXDIR="<FULLY_QUALIFIED_PATH>" ke perintah instal.

3. Buat IoT Edge untuk Linux pada penyebaran Windows. Penyebaran membuat VM Linux Anda dan menginstal runtime IoT Edge untuk Anda.

   Deploy-Eflow
   

4. Gunakan cakupan ID, ID Perangkat , dan Kunci Primer yang Anda catat sebelumnya.

  Provision-EflowVm -provisioningType DpsSymmetricKey -scopeId <ID_SCOPE_HERE> -registrationId <DEVCIE_ID_HERE> -symmKey <PRIMARY_KEY_HERE>

Untuk mempelajari tentang cara lain Anda dapat menyebarkan dan memprovisikan perangkat EFLOW, lihat Menginstal dan memprovisikan Azure IoT Edge untuk Linux di perangkat Windows.

Buka halaman Detail Perangkat di aplikasi IoT Central Anda dan Anda dapat melihat telemetri yang mengalir dari perangkat EFLOW Anda:

Langkah berikutnya

Sekarang setelah Anda mempelajari cara menyambungkan Azure IoT Edge untuk Linux di Windows (EFLOW) dengan IoT Central, langkah selanjutnya yang disarankan adalah mempelajari cara Menyambungkan perangkat melalui gateway transparan IoT Edge.