Oktatóanyag: Új IoT-átjáróeszköz-típus definiálása az Azure IoT Central-alkalmazásban

Ebben az oktatóanyagban egy Smart Building Gateway-eszközsablont hoz létre. Az intelligens épület átjáróeszközei kapcsolatban vannak más alsóbb rétegbeli eszközökkel.

Az átjáróeszköz a következőket is megteheti:

• Küldje el a saját telemetriáját, például a hőmérsékletet.
• Válaszoljon egy operátor írható tulajdonságfrissítéseire. Egy operátor például módosíthatja a telemetriai küldési időközt.
• Válaszoljon a parancsokra, például az eszköz újraindítására.

Ebben az oktatóanyagban a következőket sajátíthatja el:

• Alsóbb rétegbeli eszközsablonok létrehozása
• Átjáróeszköz-sablon létrehozása
• Az eszközsablon közzététele
• A szimulált eszközök létrehozása

Előfeltételek

Az oktatóanyag lépéseinek elvégzéséhez a következőkre van szüksége:

• Aktív Azure-előfizetés. Ha nincs Azure-előfizetésed, hozz létre egy ingyenes fiókot mielőtt elkezdenéd.

• Az egyéni alkalmazássablon alapján készült IoT Central-alkalmazás . További információ: IoT Central-alkalmazás létrehozása és Hogyan kaphatok információt az alkalmazásomról?

Alsóbb rétegbeli eszközsablonok létrehozása

Ez az oktatóanyag eszközsablonokat használ egy Onset Hobo MX-100 Temp Sensor-eszközhöz és egy RS40-bérlőérzékelő eszközhöz szimulált alsóbb rétegbeli eszközök létrehozásához.

Eszközsablon létrehozása egy Onset Hobo MX-100 Temp Sensor-eszközhöz :

1. A bal oldali panelen válassza az Eszközsablonok lehetőséget. Ezután válassza az + Új lehetőséget a sablon hozzáadásának megkezdéséhez.

2. Görgessen lefelé, amíg meg nem jelenik az Onset Hobo MX-100 Temp Sensor eszköz csempéje. Jelölje ki a csempét, majd válassza a Tovább: Véleményezés lehetőséget.

3. A Véleményezés lapon válassza a Létrehozás lehetőséget az eszközsablon alkalmazáshoz való hozzáadásához.

Eszközsablon létrehozása RS40 kihasználatlansági érzékelő eszközhöz:

1. A bal oldali panelen válassza az Eszközsablonok lehetőséget. Ezután válassza az + Új lehetőséget a sablon hozzáadásának megkezdéséhez.

2. Görgessen lefelé, amíg meg nem jelenik a Rigado RS40 foglaltsági érzékelő eszköz csempéje. Jelölje ki a csempét, majd válassza a Tovább: Véleményezés lehetőséget.

3. A Véleményezés lapon válassza a Létrehozás lehetőséget az eszközsablon alkalmazáshoz való hozzáadásához.

Most már rendelkezik eszközsablonokkal a két alsóbb rétegbeli eszköztípushoz:

Átjáróeszköz-sablon létrehozása

Ebben az oktatóanyagban teljesen új eszközsablont hoz létre egy átjáróeszközhöz. Ezt a sablont később egy szimulált átjáróeszköz létrehozásához használhatja az alkalmazásban.

Új átjáróeszköz-sablon hozzáadása az alkalmazáshoz:

1. A bal oldali panelen válassza az Eszközsablonok lehetőséget. Ezután válassza az + Új lehetőséget a sablon hozzáadásának megkezdéséhez.

2. A Sablontípus kiválasztása lapon válassza az IoT-eszköz csempét, majd válassza a Tovább: Testreszabás lehetőséget.

3. Az Eszköz testreszabása lapon jelölje be az Átjáróeszköz jelölőnégyzetet.

4. Írja be a Smart Building Gateway-eszközt sablonnévként, majd válassza a Tovább: Áttekintés lehetőséget.

5. A Véleményezés lapon válassza a Létrehozás lehetőséget.

6. A Modell létrehozása lapon válassza az Egyéni modell csempét.

7. Válassza a +Képesség hozzáadása lehetőséget a képesség hozzáadásához.

8. Adja meg az Adatok küldése nevet a megjelenítési névként, majd válassza a Tulajdonság lehetőséget képességtípusként.

9. Sématípusként válassza a Boolean típust, állítsa be a Írható beállítást, majd kattintson a Mentés gombra.

Kapcsolatok hozzáadása

Ezután kapcsolatokat ad hozzá az alsóbb rétegbeli eszközsablonok sablonjaihoz:

1. Az Intelligens épület átjáró eszközsablonjában válassza a Kapcsolatok lehetőséget.

2. Válassza a + Kapcsolat hozzáadása lehetőséget. Megjelenítendő névként adja meg a Környezeti érzékelőt , és válassza a Hobo MX-100-ast célként.

3. Válassza ismét a + Kapcsolat hozzáadása lehetőséget. A megjelenítendő névként adja meg a kihasználtsági érzékelőt , és válassza az RS40 Kihasználtsági érzékelőt célként.

4. Válassza az Mentésgombot.

Felhőtulajdonságok hozzáadása

Az átjáróeszköz-sablon tartalmazhat felhőtulajdonságokat. A felhőtulajdonságok csak az IoT Central alkalmazásban léteznek, és soha nem lesznek elküldve vagy fogadva egy eszközre.

Felhőtulajdonságok hozzáadása az Intelligens épület átjáró eszközsablonhoz .

1. Az Intelligens épület átjáró eszközsablonban válassza az Intelligens épület átjáró eszközmodellt .

2. Az alábbi táblázatban található információk segítségével két felhőtulajdonság adható hozzá az átjáróeszköz-sablonhoz.

   Megjelenítendő név	Képesség típusa	Szemantikai típus	Schema
   Utolsó szolgáltatásdátum	Felhőtulajdonság	None	Date
   Ügyfél neve	Felhőtulajdonság	None	Lánc

3. Válassza az Mentésgombot.

Nézetek létrehozása

Szerkesztőként testre szabhatja az alkalmazást, hogy releváns információkat jelenítsen meg a környezeti érzékelő eszközéről egy operátor számára. A testreszabások lehetővé teszik az operátor számára az alkalmazáshoz csatlakoztatott környezeti érzékelő eszközök kezelését. Az operátorok kétféle nézetet hozhatnak létre az eszközökkel való interakcióhoz:

• Űrlapok az eszköz- és felhőtulajdonságok megtekintéséhez és szerkesztéséhez.
• Az eszközök vizualizációs nézetei.

Az Intelligens épület átjáró eszközsablon alapértelmezett nézeteinek létrehozása:

1. Az Intelligens épület átjáró eszközsablonban válassza a Nézetek lehetőséget.

2. Válassza az Alapértelmezett nézetek létrehozása csempét, és győződjön meg arról, hogy az összes beállítás be van jelölve.

3. Válassza az Alapértelmezett irányítópult nézet(ek) létrehozása lehetőséget.

Az eszközsablon közzététele

Ahhoz, hogy szimulált átjáróeszközt hozhasson létre, vagy valós átjáróeszközt csatlakoztathasson, közzé kell tennie az eszközsablont.

Az átjáró eszközsablonjának közzététele:

1. Válassza ki az Intelligens épület átjáró eszközsablont az Eszközsablonok lapon.

2. Válassza a Közzététel lehetőséget.

3. Az Eszközsablon közzététele párbeszédpanelen válassza a Közzététel lehetőséget.

Az eszközsablon közzététele után megjelenik az Eszközök lapon és az operátor számára. Az operátor a sablonnal eszközpéldányokat hozhat létre, vagy szabályokat és figyelést hozhat létre. A közzétett sablon szerkesztése hatással lehet az alkalmazás viselkedésére.

Ha többet szeretne tudni az eszközsablonok közzétételét követően történő módosításáról, olvassa el az Eszközsablon szerkesztése című témakört.

A szimulált eszközök létrehozása

Ez az oktatóanyag szimulált alsóbb rétegbeli eszközöket és szimulált átjáróeszközt használ.

Szimulált átjáróeszköz létrehozása:

1. Az Eszközök lapon válassza az Intelligens épület átjáró eszköz lehetőséget az eszközsablonok listájában.

2. Új eszköz hozzáadásának megkezdéséhez válassza az + Új lehetőséget.

3. Tartsa meg a létrehozott eszközazonosítót és eszköznevet. Győződjön meg arról, hogy a szimulált kapcsoló igen. Válassza a Create gombot.

Szimulált alsóbb rétegbeli eszközök létrehozása:

1. Az Eszközök lapon válassza az RS40 Kihasználtsági érzékelő lehetőséget az eszközsablonok listájában.

2. Új eszköz hozzáadásának megkezdéséhez válassza az + Új lehetőséget.

3. Tartsa meg a létrehozott eszközazonosítót és eszköznevet. Győződjön meg arról, hogy a szimulált kapcsoló igen. Válassza a Create gombot.

4. Az Eszközök lapon válassza a Hobo MX-100 elemet az eszközsablonok listájában.

5. Új eszköz hozzáadásának megkezdéséhez válassza az + Új lehetőséget.

6. Tartsa meg a létrehozott eszközazonosítót és eszköznevet. Győződjön meg arról, hogy a szimulált kapcsoló igen. Válassza a Create gombot.

Alsóbb rétegbeli eszközkapcsolatok hozzáadása átjáróeszközhöz

Most, hogy már rendelkezik a szimulált eszközökkel az alkalmazásban, létrehozhatja az alsóbb rétegbeli eszközök és az átjáróeszköz közötti kapcsolatokat:

1. Az Eszközök lapon válassza a Hobo MX-100 elemet az eszközsablonok listájában, majd válassza ki a szimulált Hobo MX-100-eszközt .

2. Válassza a Csatolás az átjáróhoz lehetőséget.

3. Az Átjáró csatolása párbeszédpanelen válassza ki a Smart Building-átjáró eszközsablont , majd válassza ki a korábban létrehozott szimulált példányt.

4. Válassza a(z) lehetőséget, majd csatolja a(z)-et.

5. Az Eszközök lapon válassza az RS40 Kihasználtsági érzékelőt az eszközsablonok listájában, majd válassza ki a szimulált RS40 foglaltsági érzékelő eszközt.

6. Válassza a Csatolás az átjáróhoz lehetőséget.

7. Az Átjáró csatolása párbeszédpanelen válassza ki a Smart Building-átjáró eszközsablont , majd válassza ki a korábban létrehozott szimulált példányt.

8. Válassza a(z) lehetőséget, majd csatolja a(z)-et.

A szimulált alsóbb rétegbeli eszközök most már csatlakoznak a szimulált átjáróeszközhöz. Ha az átjáróeszköz Alsóbb rétegbeli eszközök nézetére lép, láthatja a kapcsolódó alsóbb rétegbeli eszközöket:

Valós alsóbb rétegbeli eszközök csatlakoztatása

Az ügyfélalkalmazás létrehozása és csatlakoztatása az Azure IoT Central-alkalmazáshoz oktatóanyagban a mintakód bemutatja, hogyan lehet az eszközsablonból származó modellazonosítót belefoglalni az eszköz által küldött kiépítési adatcsomagba.

Amikor csatlakoztat egy alárendelt eszközt, módosíthatja a provisionáló adatcsomagot úgy, hogy beleértse az átjáró eszköz azonosítóját. A modellazonosító lehetővé teszi, hogy az IoT Central hozzárendelje az eszközt a megfelelő alsóbb rétegbeli eszközsablonhoz. Az átjáróazonosító lehetővé teszi, hogy az IoT Central létrehozza a kapcsolatot az alsóbb rétegbeli eszköz és az átjáró között. Ebben az esetben az eszköz által küldött kiépítési csomag a következő JSON formátumot veszi fel:

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

Az átjáró regisztrálhat és építhet ki egy alsóbb rétegbeli eszközt, és a következő módon társíthatja az alsóbb rétegbeli eszközt az átjáróval:

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)

Erőforrások tisztítása

Ha nem tervezi további IoT Central-rövid útmutatók vagy oktatóanyagok elvégzését, törölheti az IoT Central-alkalmazást:

1. Az IoT Central-alkalmazásban lépjen az Alkalmazáskezelés elemre>.
2. Válassza a Törlés lehetőséget, majd erősítse meg a műveletet.

Következő lépés

A következő lépésben megtanulhatja, hogyan:

Szabály létrehozása és értesítések beállítása az Azure IoT Central-alkalmazásban