Tutorial: Menentukan jenis perangkat gateway IoT baru di aplikasi Azure IoT Central Anda

Dalam tutorial ini, Anda membuat templat perangkat gateway Smart Building . Perangkat gateway Smart Building memiliki hubungan dengan perangkat hilir lainnya.

Perangkat gateway juga dapat:

• Mengirimkan telemetri sendiri, seperti data suhu.
• Merespons pembaruan properti bisa-tulis yang dibuat oleh operator. Misalnya, operator dapat mengubah interval pengiriman telemetri.
• Tanggapi perintah, seperti me-reboot perangkat.

Dalam tutorial ini, Anda akan belajar cara:

• Membuat templat perangkat hilir
• Membuat templat perangkat gateway
• Menerbitkan templat perangkat
• Membuat perangkat yang disimulasikan

Prasyarat

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

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

• Aplikasi IoT Central yang dibuat dari templat aplikasi Kustom . Untuk mempelajari selengkapnya, lihat Membuat aplikasi IoT Central dan Bagaimana cara mendapatkan informasi tentang aplikasi saya?

Membuat templat perangkat hilir

Tutorial ini menggunakan templat perangkat untuk perangkat Onset Hobo MX-100 Temp Sensor dan perangkat Sensor Hunian RS40 untuk menghasilkan perangkat hilir yang disimulasikan.

Untuk membuat templat perangkat untuk perangkat Onset Hobo MX-100 Temp Sensor :

1. Di panel kiri, pilih Templat Perangkat. Lalu pilih + Baru untuk mulai menambahkan templat.

2. Gulir ke bawah hingga Anda dapat melihat petak peta untuk perangkat Onset Hobo MX-100 Temp Sensor . Pilih petak peta lalu pilih Berikutnya: Tinjau.

3. Pada halaman Tinjau , pilih Buat untuk menambahkan templat perangkat ke aplikasi Anda.

Untuk membuat templat perangkat untuk perangkat Sensor Hunian RS40 :

1. Di panel kiri, pilih Templat Perangkat. Lalu pilih + Baru untuk mulai menambahkan templat.

2. Gulir ke bawah sampai Anda bisa melihat ubin untuk perangkat Sensor Hunian Rigado RS40. Pilih petak peta lalu pilih Berikutnya: Tinjau.

3. Pada halaman Tinjau , pilih Buat untuk menambahkan templat perangkat ke aplikasi Anda.

Anda sekarang memiliki templat perangkat untuk dua jenis perangkat hilir:

Membuat templat perangkat gateway

Dalam tutorial ini, Anda membuat templat perangkat untuk perangkat gateway dari awal. Anda menggunakan templat ini nanti untuk membuat perangkat gateway yang disimulasikan di aplikasi Anda.

Untuk menambahkan templat perangkat gateway baru ke aplikasi Anda:

1. Di panel kiri, pilih Templat Perangkat. Lalu pilih + Baru untuk mulai menambahkan templat.

2. Pada halaman Pilih jenis templat , pilih petak IoT Device , lalu pilih Berikutnya: Sesuaikan.

3. Pada halaman Kustomisasi perangkat , pilih Kotak centang Ini adalah perangkat gateway .

4. Masukkan perangkat gateway Smart Building sebagai nama templat lalu pilih Berikutnya: Tinjau.

5. Pada halaman Tinjau , pilih Buat.

6. Pada halaman Buat model , pilih petak peta Model kustom .

7. Pilih + Tambahkan kemampuan untuk menambahkan kemampuan.

8. Masukkan Kirim Data sebagai nama tampilan, lalu pilih Properti sebagai jenis kemampuan.

9. Pilih Boolean sebagai jenis skema, atur Writable aktif, lalu pilih Simpan.

Menambahkan hubungan

Selanjutnya Anda menambahkan relasi ke templat untuk perangkat hilir:

1. Di templat perangkat gateway Smart Building , pilih Hubungan.

2. Pilih + Tambahkan hubungan. Masukkan Sensor Lingkungan sebagai nama tampilan, dan pilih Hobo MX-100 sebagai target.

3. Pilih + Tambahkan hubungan lagi. Masukkan Sensor Hunian sebagai nama tampilan, dan pilih Sensor Hunian RS40 sebagai target.

4. Pilih Simpan.

Tambah properti cloud

Templat perangkat gateway dapat menyertakan properti cloud. Properti cloud hanya ada di aplikasi IoT Central, dan tidak pernah dikirim ke, atau diterima dari, perangkat.

Untuk menambahkan properti cloud pada templat perangkat gateway Smart Building.

1. Di templat perangkat gateway Smart Building , pilih Model perangkat gateway Smart Building .

2. Gunakan informasi dalam tabel berikut untuk menambahkan dua properti cloud ke templat perangkat gateway Anda.

   Nama tampilan	Jenis kapabilitas	Jenis semantik	Schema
   Tanggal Layanan Terakhir	Properti awan	None	Tanggal
   Nama Pelanggan	Properti awan	None	String

3. Pilih Simpan.

Membuat pandangan

Sebagai penyusun, Anda dapat menyesuaikan aplikasi untuk menampilkan informasi yang relevan tentang perangkat sensor lingkungan ke operator. Penyesuaian Anda memungkinkan operator mengelola perangkat sensor lingkungan yang terhubung ke aplikasi. Anda dapat membuat dua jenis tampilan yang digunakan operator untuk berinteraksi dengan perangkat:

• Formulir untuk melihat dan mengedit properti perangkat dan cloud.
• Tampilan untuk memvisualisasikan perangkat.

Untuk menghasilkan tampilan bawaan untuk templat perangkat gateway Smart Building:

1. Di template Smart Building gateway device, pilih Tampilan.

2. Pilih Buat petak tampilan default dan pastikan semua opsi dipilih.

3. Pilih Hasilkan tampilan dasbor default.

Menerbitkan templat perangkat

Sebelum Anda dapat membuat perangkat gateway yang disimulasikan, atau menyambungkan perangkat gateway nyata, Anda perlu menerbitkan templat perangkat Anda.

Untuk menerbitkan templat perangkat gateway:

1. Pilih templat perangkat gateway Smart Building dari halaman Templat perangkat .

2. Pilih Terbitkan.

3. Dalam kotak dialog Terbitkan Templat Perangkat , pilih Terbitkan.

Setelah templat perangkat diterbitkan, templat tersebut terlihat di halaman Perangkat dan ke operator. Operator dapat menggunakan templat untuk membuat instans perangkat atau membuat aturan dan pemantauan. Mengedit templat yang diterbitkan dapat memengaruhi perilaku di seluruh aplikasi.

Untuk mempelajari selengkapnya tentang memodifikasi templat perangkat setelah Anda menerbitkannya, lihat Mengedit templat perangkat.

Membuat perangkat yang disimulasikan

Tutorial ini menggunakan perangkat hilir yang disimulasikan dan perangkat gateway yang disimulasikan.

Untuk membuat perangkat gateway yang disimulasikan:

1. Pada halaman Perangkat , pilih Perangkat gateway Smart Building dalam daftar templat perangkat.

2. Pilih + Baru untuk mulai menambahkan perangkat baru.

3. Pertahankan ID Perangkat dan Nama perangkat yang dihasilkan. Pastikan bahwa sakelar Disimulasikan berada dalam posisi Ya. Pilih Buat.

Untuk membuat simulasi perangkat hilir:

1. Pada halaman Perangkat , pilih Sensor Hunian RS40 dalam daftar templat perangkat.

2. Pilih + Baru untuk mulai menambahkan perangkat baru.

3. Pertahankan ID Perangkat dan Nama perangkat yang dihasilkan. Pastikan bahwa sakelar Disimulasikan berada dalam posisi Ya. Pilih Buat.

4. Pada halaman Perangkat , pilih Hobo MX-100 dalam daftar templat perangkat.

5. Pilih + Baru untuk mulai menambahkan perangkat baru.

6. Pertahankan ID Perangkat dan Nama perangkat yang dihasilkan. Pastikan bahwa sakelar Disimulasikan berada dalam posisi Ya. Pilih Buat.

Menambahkan hubungan perangkat hilir ke perangkat gateway

Sekarang setelah Anda memiliki perangkat yang disimulasikan dalam aplikasi, Anda dapat membuat hubungan antara perangkat hilir dan perangkat gateway:

1. Pada halaman Perangkat , pilih Hobo MX-100 dalam daftar templat perangkat, lalu pilih perangkat Hobo MX-100 yang disimulasikan.

2. Pilih Lampirkan ke gateway.

3. Pada dialog Lampirkan ke gateway , pilih templat perangkat gateway Smart Building , lalu pilih instans simulasi yang Anda buat sebelumnya.

4. Pilih Lampirkan.

5. Pada halaman Perangkat , pilih Sensor Hunian RS40 dalam daftar templat perangkat, lalu pilih perangkat Sensor Hunian RS40 yang disimulasikan.

6. Pilih Lampirkan ke gateway.

7. Pada dialog Lampirkan ke gateway , pilih templat perangkat gateway Smart Building , lalu pilih instans simulasi yang Anda buat sebelumnya.

8. Pilih Lampirkan.

Kedua perangkat hilir simulasi Anda sekarang terhubung ke perangkat gateway simulasi Anda. Jika Anda menavigasi ke tampilan Perangkat Hilir untuk perangkat gateway, Anda dapat melihat perangkat hilir terkait:

Menyambungkan perangkat hilir nyata

Dalam tutorial Membuat dan menyambungkan aplikasi klien ke aplikasi Azure IoT Central Anda , kode sampel menunjukkan cara menyertakan ID model dari templat perangkat dalam payload provisi yang dikirim perangkat.

Saat menyambungkan perangkat hilir, Anda dapat memodifikasi payload provisi untuk menyertakan ID perangkat gateway. ID model memungkinkan IoT Central menetapkan perangkat ke templat perangkat hilir yang benar. ID gateway memungkinkan IoT Central membangun hubungan antara perangkat hilir dan gateway-nya. Dalam kasus ini, payload penyediaan yang dikirimkan perangkat terlihat seperti JSON berikut:

{
  "modelId": "dtmi:rigado:HoboMX100;2",
  "iotcGateway":{
    "iotcGatewayId": "gateway-device-001"
  }
}

Gateway dapat mendaftar dan menyediakan perangkat hilir, dan mengaitkan perangkat hilir dengan gateway sebagai berikut:

JavaScript

var crypto = require('crypto');


var ProvisioningTransport = require('azure-iot-provisioning-device-mqtt').Mqtt;
var SymmetricKeySecurityClient = require('azure-iot-security-symmetric-key').SymmetricKeySecurityClient;
var ProvisioningDeviceClient = require('azure-iot-provisioning-device').ProvisioningDeviceClient;

var provisioningHost = "global.azure-devices-provisioning.net";
var idScope = "<The ID scope from your SAS group enrollment in IoT Central>";
var groupSymmetricKey = "<The primary key from the SAS group enrollment>";
var registrationId = "<The device ID for the downstream device you're creating>";
var modelId = "<The model you're downstream device should use>";
var gatewayId = "<The device ID of your gateway device>";

// Calculate the device key from the group enrollment key
function computeDerivedSymmetricKey(deviceId, masterKey) {
    return crypto.createHmac('SHA256', Buffer.from(masterKey, 'base64'))
        .update(deviceId, 'utf8')
        .digest('base64');
}

var symmetricKey = computeDerivedSymmetricKey(registrationId, groupSymmetricKey);

var provisioningSecurityClient = new SymmetricKeySecurityClient(registrationId, symmetricKey);

var provisioningClient = ProvisioningDeviceClient.create(provisioningHost, idScope, new ProvisioningTransport(), provisioningSecurityClient);

// Use the DPS payload to:
// - specify the device capability model to use.
// - associate the device with a gateway.
var provisioningPayload = {modelId: modelId, iotcGateway: { iotcGatewayId: gatewayId}}

provisioningClient.setProvisioningPayload(provisioningPayload);

provisioningClient.register(function(err, result) {
  if (err) {
    console.log("Error registering device: " + err);
  } else {
    console.log('The registration status is: ' + result.status)
   }
});

Python

from azure.iot.device import ProvisioningDeviceClient
import os
import base64
import hmac
import hashlib

provisioning_host = "global.azure-devices-provisioning.net"

id_scope = "<The ID scope from your SAS group enrollment in IoT Central>"
group_symmetric_key = "<The primary key from the SAS group enrollment>"
registration_id = "<The device ID for the downstream device you're creating>"
model_id = "<The model you're downstream device should use>"
gateway_id = "<The device ID of your gateway device>"

# Calculate the device key from the group enrollment key
def compute_device_key (device_id, group_key):
    message = device_id.encode("utf-8")
    signing_key = base64.b64decode(group_key.encode("utf-8"))
    signed_hmac = hmac.HMAC(signing_key, message, hashlib.sha256)
    device_key_encoded = base64.b64encode(signed_hmac.digest())
    return device_key_encoded.decode("utf-8")

provisioning_device_client = ProvisioningDeviceClient.create_from_symmetric_key(
    provisioning_host=provisioning_host,
    registration_id=registration_id,
    id_scope=id_scope,
    symmetric_key=compute_device_key(registration_id, group_symmetric_key)
)

# Use the DPS payload to:
# - specify the device capability model to use.
# - associate the device with a gateway.
provisioning_device_client.provisioning_payload = {"modelId": model_id, "iotcGateway":{"iotcGatewayId": gateway_id}}

registration_result = provisioning_device_client.register()

print("The registration status is:")
print(registration_result.status)

Membersihkan sumber daya

Jika Anda tidak berencana menyelesaikan panduan memulai cepat atau tutorial IoT Central lebih lanjut, Anda dapat menghapus aplikasi Microsoft IoT Central Anda.

1. Di aplikasi IoT Central Anda, navigasikan ke Manajemen Aplikasi>.
2. Pilih Hapus lalu konfirmasi tindakan Anda.

Langkah selanjutnya

Selanjutnya Anda dapat mempelajari cara:

Membuat aturan dan menyiapkan pemberitahuan di aplikasi Azure IoT Central Anda