Kurz – Definování nového typu zařízení brány IoT v aplikaci Azure IoT Central

V tomto kurzu se dozvíte, jak pomocí šablony zařízení brány definovat zařízení brány v aplikaci IoT Central. Pak nakonfigurujete několik podřízených zařízení, která se připojují k aplikaci IoT Central prostřednictvím zařízení brány.

V tomto kurzu vytvoříte šablonu zařízení brány Smart Building . Zařízení brány inteligentní budovy má vztahy s jinými podřízenými zařízeními.

Diagram of relationship between gateway device and downstream devices

Zařízení brány může také umožňovat komunikaci podřízených zařízení s vaší aplikací IoT Central:

  • Odešlete vlastní telemetrii, například teplotu.
  • Reagujte na aktualizace zapisovatelných vlastností provedených operátorem. Operátor může například změnit interval odesílání telemetrie.
  • Odpovězte na příkazy, jako je restartování zařízení.

V tomto kurzu se naučíte:

  • Vytváření podřízených šablon zařízení
  • Vytvoření šablony zařízení brány
  • Publikování šablony zařízení
  • Vytvoření simulovaných zařízení

Požadavky

K dokončení kroků v tomto kurzu potřebujete:

Vytváření podřízených šablon zařízení

V tomto kurzu se používají šablony zařízení pro zařízení se senzorem S1 a zařízením senzoru obsazenosti RS40 k vygenerování simulovaných podřízených zařízení.

Vytvoření šablony zařízení pro zařízení se senzorem S1 :

  1. V levém podokně vyberte Šablony zařízení. Pak vyberte + Nový a začněte přidávat šablonu.

  2. Posuňte se dolů, dokud neuvidíte dlaždici pro zařízení Minew S1 . Vyberte dlaždici a pak vyberte Další: Zkontrolovat.

  3. Na stránce Revize vyberte Vytvořit a přidejte šablonu zařízení do aplikace.

Vytvoření šablony zařízení pro zařízení senzoru obsazenosti RS40 :

  1. V levém podokně vyberte Šablony zařízení. Pak vyberte + Nový a začněte přidávat šablonu.

  2. Posuňte se dolů, dokud neuvidíte dlaždici pro zařízení Senzor obsazenosti Rigado RS40 . Vyberte dlaždici a pak vyberte Další: Zkontrolovat.

  3. Na stránce Revize vyberte Vytvořit a přidejte šablonu zařízení do aplikace.

Teď máte šablony zařízení pro dva podřízené typy zařízení:

Device templates for downstream devices

Vytvoření šablony zařízení brány

V tomto kurzu vytvoříte šablonu zařízení pro zařízení brány úplně od začátku. Tuto šablonu použijete později k vytvoření simulovaného zařízení brány ve vaší aplikaci.

Přidání nové šablony zařízení brány do aplikace:

  1. V levém podokně vyberte Šablony zařízení. Pak vyberte + Nový a začněte přidávat šablonu.

  2. Na stránce Vybrat typ šablony vyberte dlaždici Zařízení IoT a pak vyberte Další: Přizpůsobit.

  3. Na stránce Přizpůsobit zařízení zaškrtněte políčko Toto je zařízení brány .

  4. Jako název šablony zadejte zařízení brány Smart Building a pak vyberte Další: Zkontrolovat.

  5. Na stránce Revize vyberte Vytvořit.

  6. Na stránce Vytvořit model vyberte dlaždici Vlastní model .

  7. Pokud chcete přidat funkci, vyberte + Přidat funkci.

  8. Jako zobrazovaný název zadejte Odeslat data a jako typ schopnosti vyberte Vlastnost .

  9. Jako typ schématu vyberte logickou hodnotu a pak vyberte Uložit.

Přidání relací

Dále přidáte relace do šablon pro podřízené šablony zařízení:

  1. V šabloně zařízení brány Smart Building vyberte Relace.

  2. Vyberte + Přidat relaci. Jako zobrazovaný název zadejte senzor prostředí a jako cíl vyberte senzor S1 .

  3. Znovu vyberte + Přidat relaci . Jako zobrazované jméno zadejte senzor obsazenosti a jako cíl vyberte senzor obsazenosti RS40 .

  4. Vyberte Uložit.

Smart Building gateway device template, showing relationships

Přidání vlastností cloudu

Šablona zařízení brány může obsahovat vlastnosti cloudu. Vlastnosti cloudu existují pouze v aplikaci IoT Central a nikdy se neodesílají do zařízení nebo z ho přijímají.

Přidání vlastností cloudu do šablony zařízení brány Smart Building

  1. V šabloně zařízení inteligentní budovy vyberte Vlastnosti cloudu.

  2. Informace v následující tabulce slouží k přidání dvou vlastností cloudu do šablony zařízení brány.

    Zobrazované jméno Sémantický typ Schéma
    Last Service Date (Datum poslední údržby) Žádné Datum
    Název zákazníka Žádné Řetězec
  3. Vyberte Uložit.

Vytváření zobrazení

Jako tvůrce můžete aplikaci přizpůsobit tak, aby zobrazovala relevantní informace o zařízení senzoru prostředí operátorovi. Vaše přizpůsobení umožňuje operátorovi spravovat zařízení senzoru prostředí připojená k aplikaci. Můžete vytvořit dva typy zobrazení, které operátor použije k interakci se zařízeními:

  • Formuláře pro zobrazení a úpravu vlastností zařízení a cloudu
  • Zobrazení pro vizualizaci zařízení

Pokud chcete vygenerovat výchozí zobrazení pro šablonu zařízení brány Smart Building Gateway :

  1. V šabloně zařízení inteligentní budovy vyberte Zobrazení.

  2. Vyberte Dlaždici Generovat výchozí zobrazení a ujistěte se, že jsou vybrané všechny možnosti.

  3. Vyberte Generovat výchozí zobrazení řídicího panelu.

Publikování šablony zařízení

Než budete moct vytvořit simulované zařízení brány nebo připojit skutečné zařízení brány, musíte šablonu zařízení publikovat.

Publikování šablony zařízení brány:

  1. Na stránce Šablony zařízení vyberte šablonu zařízení Brány inteligentní budovy.

  2. Vyberte Publikovat.

  3. V dialogovém okně Publikovat šablonu zařízení zvolte Publikovat.

Po publikování šablony zařízení se zobrazí na stránce Zařízení a operátorovi. Operátor může šablonu použít k vytvoření instancí zařízení nebo vytvoření pravidel a monitorování. Úprava publikované šablony může ovlivnit chování v celé aplikaci.

Další informace o úpravě šablony zařízení po publikování najdete v tématu Úprava existující šablony zařízení.

Vytvoření simulovaných zařízení

Tento kurz používá simulovaná podřízená zařízení a simulované zařízení brány.

Vytvoření simulovaného zařízení brány:

  1. Na stránce Zařízení vyberte v seznamu šablon zařízení zařízení možnost Inteligentní sestavení .

  2. Pokud chcete začít přidávat nové zařízení, vyberte + Nový .

  3. Ponechte vygenerované ID zařízení a název zařízení. Ujistěte se, že je simulovaný přepínač zapnutý. Vyberte Vytvořit.

Vytvoření simulovaných podřízených zařízení:

  1. Na stránce Zařízení vyberte senzor obsazenosti RS40 v seznamu šablon zařízení.

  2. Pokud chcete začít přidávat nové zařízení, vyberte + Nový .

  3. Ponechte vygenerované ID zařízení a název zařízení. Ujistěte se, že je simulovaný přepínač zapnutý. Vyberte Vytvořit.

  4. Na stránce Zařízení vyberte v seznamu šablon zařízení senzor S1 .

  5. Pokud chcete začít přidávat nové zařízení, vyberte + Nový .

  6. Ponechte vygenerované ID zařízení a název zařízení. Ujistěte se, že je simulovaný přepínač zapnutý. Vyberte Vytvořit.

Simulated devices in your application

Přidání vztahů podřízených zařízení do zařízení brány

Teď, když máte v aplikaci simulovaná zařízení, můžete vytvořit vztahy mezi podřízenými zařízeními a zařízením brány:

  1. Na stránce Zařízení vyberte v seznamu šablon zařízení senzor S1 a pak vyberte simulované zařízení se senzorem S1 .

  2. Vyberte Připojit k bráně.

  3. V dialogovém okně Připojit k bráně vyberte šablonu zařízení inteligentní budovy a pak vyberte simulovanou instanci, kterou jste vytvořili dříve.

  4. Vyberte Připojit.

  5. Na stránce Zařízení vyberte senzor obsazenosti RS40 v seznamu šablon zařízení a pak vyberte simulované zařízení RS40 Occupancy Sensor .

  6. Vyberte Připojit k bráně.

  7. V dialogovém okně Připojit k bráně vyberte šablonu zařízení inteligentní budovy a pak vyberte simulovanou instanci, kterou jste vytvořili dříve.

  8. Vyberte Připojit.

Simulovaná podřízená zařízení jsou teď připojená k simulovanému zařízení brány. Pokud přejdete do zobrazení Podřízená zařízení pro vaše zařízení brány, zobrazí se související podřízená zařízení:

Downstream devices view

Připojení skutečných podřízených zařízení

V kurzu Vytvoření a připojení klientské aplikace k vaší aplikaci Azure IoT Central ukázkový kód ukazuje, jak do datové části zřizování, která zařízení odesílá, zahrnout ID modelu ze šablony zařízení.

Když připojíte podřízené zařízení, můžete upravit datovou část zřizování tak, aby zahrnovala ID zařízení brány. ID modelu umožňuje Službě IoT Central přiřadit zařízení ke správné šabloně podřízeného zařízení. ID brány umožňuje IoT Central navázat vztah mezi podřízeným zařízením a jeho bránou. V takovém případě datová část zřizování, která zařízení odesílá, vypadá takto:

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

Brána může zaregistrovat a zřídit podřízené zařízení a přidružit podřízené zařízení k bráně následujícím způsobem:

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)
   }
});

Vyčištění prostředků

Pokud nechcete dokončit žádné další rychlé starty nebo kurzy IoT Central, můžete odstranit aplikaci IoT Central:

  1. V aplikaci IoT Central přejděte do správy aplikací>.
  2. Vyberte Odstranit a potvrďte akci.

Další kroky

V tomto kurzu jste se naučili:

  • Vytvořte novou bránu IoT jako šablonu zařízení.
  • Vytvořte vlastnosti cloudu.
  • Vytvořte vlastní nastavení.
  • Definujte vizualizaci telemetrie zařízení.
  • Přidejte relace.
  • Publikujte šablonu zařízení.

V dalším kroku se dozvíte, jak: