Rövid útmutató: IoT Hubhoz csatlakozó eszköz vezérlése

Ebben a rövid útmutatóban egy közvetlen metódussal fogja vezérelni az IoT Hubhoz csatlakoztatott szimulált eszközt. IoT Hub egy Azure-szolgáltatás, amellyel az IoT-eszközöket a felhőből kezelheti, és nagy mennyiségű eszköztelemetria betölthető a felhőbe tárolás vagy feldolgozás céljából. Közvetlen módszerekkel távolról módosíthatja az IoT Hubhoz csatlakoztatott eszközök viselkedését.

Ez a rövid útmutató két előre megírt .NET-alkalmazást használ:

  • Egy szimulált eszközalkalmazás, amely válaszol a szolgáltatásalkalmazásból meghívott közvetlen metódusokra. A közvetlen metódusok meghívásának fogadásához ez az alkalmazás az IoT Hubon található eszközspecifikus végponthoz csatlakozik.

  • Egy szolgáltatásalkalmazás, amely meghívja a közvetlen metódusokat a szimulált eszközön. A közvetlen metódus egy eszközre való meghívásához ez az alkalmazás az IoT Hubon található szolgáltatásoldali végponthoz csatlakozik.

Előfeltételek

  • Egy Azure-fiók, aktív előfizetéssel. Hozzon létre egyet ingyen.

  • A rövid útmutatóban futtatott két mintaalkalmazás a C# használatával készült. A fejlesztői gépen szüksége lesz a .NET SDK 6.0-s vagy újabb verziójára.

    A .NET Core SDK-t többféle platformra a .NET oldaláról töltheti le.

    A C# aktuális verzióját a következő paranccsal ellenőrizheti a fejlesztői gépen:

    dotnet --version
    
  • Klónozza vagy töltse le az Azure IoT C# SDK-t a GitHubról.

  • Győződjön meg arról, hogy a 8883-as port nyitva van a tűzfalon. Az ebben a rövid útmutatóban szereplő eszközminta MQTT protokollt használ, amely a 8883-es porton keresztül kommunikál. Ez a port bizonyos vállalati és oktatási hálózati környezetekben blokkolható. További információkért és a probléma megoldásának módjaiért lásd: Csatlakozás IoT Hub (MQTT)-hez.

Megjegyzés

Ez a cikk az Azure IoT-bővítmény legújabb, nevű azure-iotverzióját használja. Az örökölt verzió neve azure-cli-iot-ext. Egyszerre csak egy verziót kell telepítenie. Az paranccsal az extension list ellenőrizheti a jelenleg telepített bővítményeket.

A használatával az extension remove --name azure-cli-iot-ext eltávolíthatja a bővítmény régi verzióját.

A bővítmény új verziójának hozzáadásához használja az extension add --name azure-iot a parancsot.

A telepített bővítmények megtekintéséhez használja a következőt az extension list: .

Ebben a szakaszban az Azure CLI használatával hoz létre egy IoT Hubot és egy erőforráscsoportot. Az Azure-erőforráscsoport olyan logikai tároló, amelybe a rendszer üzembe helyezi és kezeli az Azure-erőforrásokat. Az IoT Hub központi üzenetközpontként szolgál az IoT-alkalmazás és az eszközök közötti kétirányú kommunikációhoz.

Ha már rendelkezik IoT Hubbal az Azure-előfizetésében, kihagyhatja ezt a szakaszt.

IoT Hub és erőforráscsoport létrehozása:

  1. Indítsa el a CLI-alkalmazást. A cli-parancsok a cikk további részében való futtatásához másolja ki a parancs szintaxisát, illessze be a PARANCSSOR-alkalmazásba, szerkessze a változóértékeket, és nyomja le a billentyűt Enter.

    • Ha Cloud Shell használ, válassza a CLI-parancsok Kipróbálás gombját Cloud Shell megnyitásához egy osztott böngészőablakban. Vagy megnyithatja a Cloud Shell egy külön böngészőlapon.
    • Ha helyileg használja az Azure CLI-t, indítsa el a CLI-konzolalkalmazást, és jelentkezzen be az Azure CLI-be.
  2. Az az extension add parancs futtatásával telepítheti vagy frissítheti az azure-iot bővítményt az aktuális verzióra.

    az extension add --upgrade --name azure-iot
    
  3. A CLI-alkalmazásban futtassa az az group create parancsot egy erőforráscsoport létrehozásához. A következő parancs létrehoz egy MyResourceGroup nevű erőforráscsoportot az eastus helyen.

    Megjegyzés

    Igény szerint másik helyet is beállíthat. Az elérhető helyek megtekintéséhez futtassa a parancsot az account list-locations. Ez a rövid útmutató az eastus függvényt használja a példaparancsban látható módon.

    az group create --name MyResourceGroup --location eastus
    
  4. Futtassa az az iot hub create parancsot egy IoT Hub létrehozásához. Az IoT Hub létrehozása eltarthat néhány percig.

    YourIotHubName. Cserélje le ezt a helyőrzőt és a környező kapcsos zárójeleket a következő parancsban az IoT Hubhoz választott névvel. Az IoT Hub nevének globálisan egyedinek kell lennie az Azure-ban. Használja az IoT Hub nevét a rövid útmutató többi részében, ahol a helyőrzőt látja.

    az iot hub create --resource-group MyResourceGroup --name {your_iot_hub_name}
    

A szolgáltatás kapcsolati sztringjének lekérése

Szüksége lesz az IoT Hub szolgáltatás kapcsolati sztring is, hogy a szolgáltatásalkalmazás kapcsolódhasson a központhoz, és lekérhesse az üzeneteket. A szolgáltatás kapcsolati sztring az IoT Hub egészére érvényes, és különbözik az előző szakaszban lekért eszköztől kapcsolati sztring.

Az alábbi parancs lekéri az IoT Hub szolgáltatáskapcsolati sztringjét:

az iot hub connection-string show --policy-name service --hub-name {YourIoTHubName} --output table

Jegyezze fel a szolgáltatáskapcsolati sztringet, amely a következőképpen néz ki:

HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

Ezt az értéket használni fogja a rövid útmutató későbbi részében.

Eszköz szimulálása

A szimulálteszköz-alkalmazás az IoT Hubon található eszközspecifikus végponthoz csatlakozik, szimulált telemetriát küld, és figyeli a hubról érkező közvetlenmetódus-hívásokat. Ebben a rövid útmutatóban a hubról érkező közvetlenmetódus-hívás arra utasítja az eszközt, hogy módosítsa a telemetriaküldések közötti időintervallumot. A szimulált eszköz a közvetlen metódus végrehajtása után nyugtázást küld a központnak.

  1. Egy helyi terminálablakban keresse meg a C#-mintaprojekt gyökérmappáját. Ezután keresse meg az iothub\device\samples\getting started\SimulatedDeviceWithCommand mappát.

  2. Futtassa a következő parancsot a szimulált eszközalkalmazáshoz szükséges csomagok telepítéséhez:

    dotnet restore
    
  3. Futtassa a következő parancsot a szimulált eszközalkalmazás létrehozásához és futtatásához.

    {DeviceConnectionString}: Cserélje le ezt a helyőrzőt a korábban feljegyzett eszközre kapcsolati sztring.

    dotnet run -- -c "{DeviceConnectionString}"
    

    A következő képernyőképen az a kimenet látható, amikor a szimulálteszköz-alkalmazás telemetriát küld az IoT Hubnak:

    A szimulált eszköz futtatása

A közvetlen metódus meghívása

A szolgáltatásalkalmazás egy szolgáltatásoldali végponthoz csatlakozik a IoT Hub. Az alkalmazás közvetlen metódushívásokat indít egy eszközre az IoT Hubon keresztül, és figyeli a nyugtázásokat. A IoT Hub szolgáltatásalkalmazások általában a felhőben futnak.

  1. Egy másik helyi terminálablakban keresse meg a C#-mintaprojekt gyökérmappáját. Ezután lépjen az iothub\service\samples\getting started\InvokeDeviceMethod mappába.

  2. A helyi terminálablakban futtassa a következő parancsokat a szolgáltatásalkalmazáshoz szükséges kódtárak telepítéséhez:

    dotnet build
    
  3. A helyi terminálablakban futtassa az alábbi parancsokat a szolgáltatásalkalmazás létrehozásához és futtatásához.

    {ServiceConnectionString}: Cserélje le ezt a helyőrzőt a korábban feljegyzett IoT Hub szolgáltatásra kapcsolati sztring.

    {DeviceName}: Cserélje le ezt a helyőrzőt a regisztrált eszköz nevére.

    dotnet run -- -c "{ServiceConnectionString}" -d {DeviceName}
    

    Az alábbi képernyőképen a kimenet látható, amikor az alkalmazás közvetlen metódushívást kezdeményez az eszközre, és nyugtázást kap:

    A szolgáltatásalkalmazás futtatása

    A szolgáltatásalkalmazás futtatása után megjelenik egy üzenet a szimulált eszközt futtató konzolablakban, és az üzenetek küldésének sebessége megváltozik:

    Változás a szimulált ügyfélben

Ez a rövid útmutató két Java-alkalmazást használ:

  • Egy szimulálteszköz-alkalmazás, amely válaszol a háttéralkalmazásokból meghívott közvetlen metódusokra.
  • Egy szolgáltatásalkalmazás, amely meghívja a közvetlen metódust a szimulált eszközön.

Előfeltételek

  • Egy Azure-fiók, aktív előfizetéssel. Hozzon létre egyet ingyen.

  • Java SE Development Kit 8. Az Azure-hoz és az Azure Stackhez készült Java hosszú távú támogatásában a Hosszú távú támogatás területen válassza a Java 8 lehetőséget.

    A Java aktuális verzióját a következő paranccsal ellenőrizheti a fejlesztői gépen:

    java -version
    
  • Apache Maven 3.

    A Maven aktuális verzióját a következő paranccsal ellenőrizheti a fejlesztői gépen:

    mvn --version
    
  • Klónozza vagy töltse le az Azure IoT Java-mintákat a GitHubról.

  • Győződjön meg arról, hogy a 8883-os port meg van nyitva a tűzfalon. A rövid útmutatóban szereplő eszközminta az MQTT protokollt használja, amely a 8883-es porton keresztül kommunikál. Ez a port bizonyos vállalati és oktatási hálózati környezetben blokkolva lehet. További információkért és a probléma megkerülésének módjaiért lásd: Csatlakozás IoT Hub -hez (MQTT).

Megjegyzés

Ez a cikk az Azure IoT-bővítmény legújabb, úgynevezett azure-iotverzióját használja. Az örökölt verzió neve azure-cli-iot-ext. Egyszerre csak egy verziót kell telepítenie. Az paranccsal az extension list ellenőrizheti a jelenleg telepített bővítményeket.

A bővítmény régi verziójának eltávolítására használható az extension remove --name azure-cli-iot-ext .

A bővítmény új verziójának hozzáadására használható az extension add --name azure-iot .

A telepített bővítmények megtekintéséhez használja a következőt az extension list: .

IoT Hub létrehozása

Ebben a szakaszban az Azure CLI használatával hozhat létre egy IoT Hubot és egy erőforráscsoportot. Az Azure-erőforráscsoport olyan logikai tároló, amelybe a rendszer üzembe helyezi és kezeli az Azure-erőforrásokat. Az IoT Hub központi üzenetközpontként szolgál az IoT-alkalmazás és az eszközök közötti kétirányú kommunikációhoz.

Ha már rendelkezik IoT Hubbal az Azure-előfizetésében, kihagyhatja ezt a szakaszt.

IoT Hub és erőforráscsoport létrehozása:

  1. Indítsa el a CLI-alkalmazást. A parancssori felületi parancsok a cikk további részében való futtatásához másolja ki a parancs szintaxisát, illessze be a PARANCSSOR-alkalmazásba, szerkessze a változóértékeket, és nyomja le a billentyűt Enter.

    • Ha Cloud Shell használ, a parancssori felület parancsainak Kipróbálása gombjára kattintva elindíthatja Cloud Shell egy osztott böngészőablakban. Vagy megnyithatja a Cloud Shell egy külön böngészőlapon.
    • Ha helyileg használja az Azure CLI-t, indítsa el a CLI-konzolalkalmazást, és jelentkezzen be az Azure CLI-be.
  2. Futtassa az az extension add parancsot az azure-iot bővítmény telepítéséhez vagy frissítéséhez az aktuális verzióra.

    az extension add --upgrade --name azure-iot
    
  3. A CLI-alkalmazásban futtassa az az group create parancsot egy erőforráscsoport létrehozásához. A következő parancs létrehoz egy MyResourceGroup nevű erőforráscsoportot az eastus helyen.

    Megjegyzés

    Igény szerint másik helyet is beállíthat. Az elérhető helyek megtekintéséhez futtassa a parancsot az account list-locations. Ez a rövid útmutató az eastus függvényt használja a példaparancsban látható módon.

    az group create --name MyResourceGroup --location eastus
    
  4. Futtassa az az iot hub create parancsot egy IoT Hub létrehozásához. Az IoT Hub létrehozása eltarthat néhány percig.

    YourIotHubName. Cserélje le ezt a helyőrzőt és a környező kapcsos zárójeleket az alábbi parancsban az IoT Hubhoz választott névvel. Az IoT Hub nevének globálisan egyedinek kell lennie az Azure-ban. Használja az IoT Hub nevét a rövid útmutató többi részében, bárhol is láthatja a helyőrzőt.

    az iot hub create --resource-group MyResourceGroup --name {your_iot_hub_name}
    

Eszköz regisztrálása

Az eszköznek regisztrálva kell lennie az IoT Hubbal, hogy csatlakozhasson hozzá. Ebben a szakaszban az Azure CLI használatával hozhat létre eszközidentitást.

Ha már regisztrált egy eszközt az IoT Hubon, kihagyhatja ezt a szakaszt.

Eszközidentitás létrehozása:

  1. Futtassa az az iot hub device-identity create parancsot a CLI-rendszerhéjban. Ez a parancs létrehozza az eszközidentitást.

    your_iot_hub_name. Cserélje le az alábbi helyőrzőt az IoT Hubhoz választott névre.

    myDevice. Ezt a nevet használhatja az eszközazonosítóhoz ebben a cikkben, vagy megadhat egy másik eszköznevet.

    az iot hub device-identity create --device-id myDevice --hub-name {your_iot_hub_name}
    
  2. Futtassa az az iot hub device-identity connection-string show parancsot.

    az iot hub device-identity connection-string show --device-id myDevice --hub-name {your_iot_hub_name}
    

    A kapcsolati sztring kimenete a következő formátumban van:

    HostName=<your IoT Hub name>.azure-devices.net;DeviceId=<your device id>;SharedAccessKey=<some value>
    
  3. Mentse a kapcsolati sztring biztonságos helyre.

Megjegyzés

Hagyja nyitva a CLI-alkalmazást. A későbbi lépésekben szükség lesz rá.

A szolgáltatás kapcsolati sztringjének lekérése

Szüksége van egy szolgáltatáskapcsolati sztringre is azért, hogy a háttéralkalmazás csatlakozhasson az IoT Hubhoz, és üzeneteket kérhessen le. Az alábbi parancs lekéri az IoT Hub szolgáltatáskapcsolati sztringjét:

YourIoTHubName: Cserélje le az alábbi helyőrzőt az IoT Hubhoz választott névre.

az iot hub connection-string show --policy-name service --hub-name {YourIoTHubName} --output table

Jegyezze fel a szolgáltatáskapcsolati sztringet, amely a következőképpen néz ki:

HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

Ezt az értéket használni fogja a rövid útmutató későbbi részében. Ez a szolgáltatás kapcsolati sztring eltér az előző lépésben feljegyzett eszköztől kapcsolati sztring.

Eszköz szimulálása

A szimulálteszköz-alkalmazás az IoT Hubon található eszközspecifikus végponthoz csatlakozik, szimulált telemetriát küld, és figyeli a hubról érkező közvetlenmetódus-hívásokat. Ebben a rövid útmutatóban a hubról érkező közvetlenmetódus-hívás arra utasítja az eszközt, hogy módosítsa a telemetriaküldések közötti időintervallumot. A szimulált eszköz nyugtázást küld a központnak a közvetlen metódus végrehajtása után.

  1. Egy helyi terminálablakban keresse meg a Java-mintaprojekt gyökérmappáját. Ezután lépjen az iot-hub\Quickstarts\simulated-device-2 mappába.

  2. Nyissa meg az src/main/java/com/microsoft/docs/iothub/samples/SimulatedDevice.java fájlt egy tetszőleges szövegszerkesztőben.

    Cserélje le a connString változó értékét arra az eszközre, kapcsolati sztring korábban megjegyzést tett. Ezután mentse a módosításokat a SimulatedDevice.java fájlba.

  3. Futtassa az alábbi parancsokat a helyi terminálablakban a szükséges kódtárak telepítéséhez és a szimulálteszköz-alkalmazás létrehozásához:

    mvn clean package
    
  4. Futtassa az alábbi parancsokat a helyi terminálablakban a szimulálteszköz-alkalmazás futtatásához:

    java -jar target/simulated-device-2-1.0.0-with-deps.jar
    

    A következő képernyőképen az a kimenet látható, amikor a szimulálteszköz-alkalmazás telemetriát küld az IoT Hubnak:

    Kimenet az eszköz által az IoT Hubnak küldött telemetriából

A közvetlen metódus meghívása

A háttéralkalmazás az IoT Hubon található szolgáltatásoldali végponthoz csatlakozik. Az alkalmazás közvetlen metódushívásokat indít egy eszközre az IoT Hubon keresztül, és figyeli a nyugtázásokat. Az IoT Hub-háttéralkalmazások általában a felhőben futnak.

  1. Egy másik helyi terminálablakban keresse meg a Java-mintaprojekt gyökérmappáját. Ezután lépjen az iot-hub\Quickstarts\back-end-application mappába.

  2. Nyissa meg az src/main/java/com/microsoft/docs/iothub/samples/BackEndApplication.java fájlt egy Ön által választott szövegszerkesztőben.

    Cserélje le a iotHubConnectionString változó értékét a szolgáltatásra, kapcsolati sztring korábban már jegyezte fel. Ezután mentse a módosításokat a BackEndApplication.java fájlba.

  3. Futtassa az alábbi parancsokat a helyi terminálablakban a szükséges kódtárak telepítéséhez és a háttéralkalmazás létrehozásához:

    mvn clean package
    
  4. Futtassa az alábbi parancsokat a helyi terminálablakban a háttéralkalmazás futtatásához:

    java -jar target/back-end-application-1.0.0-with-deps.jar
    

    Az alábbi képernyőképen a kimenet látható, amikor az alkalmazás közvetlen metódushívást kezdeményez az eszközre, és nyugtázást kap:

    Kimenet, amikor az alkalmazás közvetlen metódushívást kezdeményez az IoT Hubon keresztül

    A háttéralkalmazás futtatása után megjelenik egy üzenet a szimulált eszközt futtató konzolablakban, és megváltozik az üzenetküldések gyakorisága:

    Az eszköz konzolüzenete azt mutatja, hogy milyen sebességgel változik

Ez a rövid útmutató két Node.js alkalmazást használ:

  • Egy szimulálteszköz-alkalmazás, amely válaszol a háttéralkalmazásokból meghívott közvetlen metódusokra. A közvetlen metódusok meghívásának fogadásához ez az alkalmazás az IoT Hubon található eszközspecifikus végponthoz csatlakozik.
  • Egy háttéralkalmazás, amely meghívja a közvetlen metódusokat a szimulált eszközre. Ha közvetlen metódust szeretne meghívni egy eszközön, ez az alkalmazás egy szolgáltatásspecifikus végponthoz csatlakozik az IoT Hubon.

Előfeltételek

  • Egy Azure-fiók, aktív előfizetéssel. Hozzon létre egyet ingyen.

  • Node.js 12+.

    A Node.js aktuális verzióját a következő paranccsal ellenőrizheti a fejlesztői gépen:

    node --version
    
  • Klónozza vagy töltse le az Azure IoT-Node.js mintákat a GitHubról.

  • Győződjön meg arról, hogy a 8883-as port nyitva van a tűzfalon. Az ebben a rövid útmutatóban szereplő eszközminta MQTT protokollt használ, amely a 8883-es porton keresztül kommunikál. Ez a port bizonyos vállalati és oktatási hálózati környezetekben blokkolható. További információkért és a probléma megoldásának módjaiért lásd: Csatlakozás IoT Hub (MQTT)-hez.

Megjegyzés

Ez a cikk az Azure IoT-bővítmény legújabb, nevű azure-iotverzióját használja. Az örökölt verzió neve azure-cli-iot-ext. Egyszerre csak egy verziót kell telepítenie. Az paranccsal az extension list ellenőrizheti a jelenleg telepített bővítményeket.

A használatával az extension remove --name azure-cli-iot-ext eltávolíthatja a bővítmény régi verzióját.

A bővítmény új verziójának hozzáadásához használja az extension add --name azure-iot a parancsot.

A telepített bővítmények megtekintéséhez használja a következőt az extension list: .

IoT Hub létrehozása

Ebben a szakaszban az Azure CLI használatával hoz létre egy IoT Hubot és egy erőforráscsoportot. Az Azure-erőforráscsoport olyan logikai tároló, amelybe a rendszer üzembe helyezi és kezeli az Azure-erőforrásokat. Az IoT Hub központi üzenetközpontként szolgál az IoT-alkalmazás és az eszközök közötti kétirányú kommunikációhoz.

Ha már rendelkezik IoT Hubbal az Azure-előfizetésében, kihagyhatja ezt a szakaszt.

IoT Hub és erőforráscsoport létrehozása:

  1. Indítsa el a CLI-alkalmazást. A cli-parancsok a cikk további részében való futtatásához másolja ki a parancs szintaxisát, illessze be a PARANCSSOR-alkalmazásba, szerkessze a változóértékeket, és nyomja le a billentyűt Enter.

    • Ha Cloud Shell használ, válassza a CLI-parancsok Kipróbálás gombját Cloud Shell megnyitásához egy osztott böngészőablakban. Vagy megnyithatja a Cloud Shell egy külön böngészőlapon.
    • Ha helyileg használja az Azure CLI-t, indítsa el a CLI-konzolalkalmazást, és jelentkezzen be az Azure CLI-be.
  2. Az az extension add parancs futtatásával telepítheti vagy frissítheti az azure-iot bővítményt az aktuális verzióra.

    az extension add --upgrade --name azure-iot
    
  3. A CLI-alkalmazásban futtassa az az group create parancsot egy erőforráscsoport létrehozásához. A következő parancs létrehoz egy MyResourceGroup nevű erőforráscsoportot az eastus helyen.

    Megjegyzés

    Igény szerint másik helyet is beállíthat. Az elérhető helyek megtekintéséhez futtassa a parancsot az account list-locations. Ez a rövid útmutató az eastus függvényt használja a példaparancsban látható módon.

    az group create --name MyResourceGroup --location eastus
    
  4. Futtassa az az iot hub create parancsot egy IoT Hub létrehozásához. Az IoT Hub létrehozása eltarthat néhány percig.

    YourIotHubName. Cserélje le ezt a helyőrzőt és a környező kapcsos zárójeleket a következő parancsban az IoT Hubhoz választott névvel. Az IoT Hub nevének globálisan egyedinek kell lennie az Azure-ban. Használja az IoT Hub nevét a rövid útmutató többi részében, ahol a helyőrzőt látja.

    az iot hub create --resource-group MyResourceGroup --name {your_iot_hub_name}
    

Eszköz regisztrálása

Az eszköznek regisztrálva kell lennie az IoT Hubbal, hogy csatlakozhasson hozzá. Ebben a szakaszban az Azure CLI használatával hozhat létre eszközidentitást.

Ha már regisztrált egy eszközt az IoT Hubon, kihagyhatja ezt a szakaszt.

Eszközidentitás létrehozása:

  1. Futtassa az az iot hub device-identity create parancsot a CLI-rendszerhéjban. Ez a parancs létrehozza az eszközidentitást.

    your_iot_hub_name. Cserélje le az alábbi helyőrzőt az IoT Hubhoz választott névre.

    myDevice. Ezt a nevet használhatja az eszközazonosítóhoz ebben a cikkben, vagy megadhat egy másik eszköznevet.

    az iot hub device-identity create --device-id myDevice --hub-name {your_iot_hub_name}
    
  2. Futtassa az az iot hub device-identity connection-string show parancsot.

    az iot hub device-identity connection-string show --device-id myDevice --hub-name {your_iot_hub_name}
    

    A kapcsolati sztring kimenete a következő formátumban van:

    HostName=<your IoT Hub name>.azure-devices.net;DeviceId=<your device id>;SharedAccessKey=<some value>
    
  3. Mentse a kapcsolati sztring biztonságos helyre.

Megjegyzés

Hagyja megnyitva a CLI-alkalmazást. A későbbi lépésekben szükség lesz rá.

A szolgáltatás kapcsolati sztringjének lekérése

Az IoT Hub szolgáltatási kapcsolati sztring is szüksége lesz arra, hogy a háttéralkalmazás csatlakozzon az IoT Hubhoz, és lekérje az üzeneteket. Az alábbi parancs lekéri az IoT Hub szolgáltatáskapcsolati sztringjét:

YourIoTHubName: Cserélje le az alábbi helyőrzőt az IoT Hubhoz választott névre.

az iot hub connection-string show \
  --policy-name service --hub-name {YourIoTHubName} --output table

Jegyezze fel a szolgáltatáskapcsolati sztringet, amely a következőképpen néz ki:

HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

Ezt az értéket használni fogja a rövid útmutató későbbi részében. Ez a szolgáltatás kapcsolati sztring eltér az előző lépésben feljegyzett eszköztől kapcsolati sztring.

Eszköz szimulálása

A szimulálteszköz-alkalmazás az IoT Hubon található eszközspecifikus végponthoz csatlakozik, szimulált telemetriát küld, és figyeli a hubról érkező közvetlenmetódus-hívásokat. Ebben a rövid útmutatóban a hubról érkező közvetlenmetódus-hívás arra utasítja az eszközt, hogy módosítsa a telemetriaküldések közötti időintervallumot. A szimulált eszköz a közvetlen metódus végrehajtása után nyugtázást küld a központnak.

  1. Egy helyi terminálablakban keresse meg a Node.js-mintaprojekt gyökérmappáját. Ezután lépjen az iot-hub\Quickstarts\simulated-device-2 mappába.

  2. Nyissa meg a SimulatedDevice.js fájlt egy Ön által választott szövegszerkesztőben.

    Cserélje le a connectionString változó értékét arra az eszközre, kapcsolati sztring korábban már jegyezte fel. Ezután mentse a módosításokat SimulatedDevice.js.

  3. Futtassa az alábbi parancsokat a helyi terminálablakban a szükséges kódtárak telepítéséhez és a szimulálteszköz-alkalmazás futtatásához:

    npm install
    node SimulatedDevice.js
    

    A következő képernyőképen az a kimenet látható, amikor a szimulálteszköz-alkalmazás telemetriát küld az IoT Hubnak:

    A szimulált eszköz futtatása

A közvetlen metódus meghívása

A háttéralkalmazás egy szolgáltatásoldali végponthoz csatlakozik az IoT Hubon. Az alkalmazás közvetlen metódushívásokat indít egy eszközre az IoT Hubon keresztül, és figyeli a nyugtázásokat. Az IoT Hub-háttéralkalmazások általában a felhőben futnak.

  1. Egy másik helyi terminálablakban keresse meg a Node.js-mintaprojekt gyökérmappáját. Ezután lépjen az iot-hub\Quickstarts\back-end-application mappába.

  2. Nyissa meg a BackEndApplication.js fájlt egy Ön által választott szövegszerkesztőben.

    Cserélje le a connectionString változó értékét arra a szolgáltatásra, kapcsolati sztring korábban megjegyzést tett. Ezután mentse a módosításokat a következőre:BackEndApplication.js.

  3. Futtassa az alábbi parancsokat a helyi terminálablakban a szükséges kódtárak telepítéséhez és a háttéralkalmazás futtatásához:

    npm install
    node BackEndApplication.js
    

    Az alábbi képernyőképen a kimenet látható, amikor az alkalmazás közvetlen metódushívást kezdeményez az eszközhöz, és nyugtát kap:

    Kimenet, amikor az alkalmazás közvetlen metódushívást kezdeményez az eszközhöz

    A háttéralkalmazás futtatása után megjelenik egy üzenet a szimulált eszközt futtató konzolablakban, és megváltozik az üzenetküldések gyakorisága:

    Kimenet, ha változás történik a szimulált ügyfélben

Ez a rövid útmutató két Python-alkalmazást használ:

  • Egy szimulálteszköz-alkalmazás, amely válaszol a háttéralkalmazásokból meghívott közvetlen metódusokra.
  • Egy háttéralkalmazás, amely meghívja a közvetlen metódusokat a szimulált eszközre.

Előfeltételek

  • Egy Azure-fiók, aktív előfizetéssel. Hozzon létre egyet ingyen.

  • Python 3.7+. A Python egyéb támogatott verzióiért lásd: Azure IoT-eszközfunkciók.

  • Klónozza vagy töltse le az Azure IoT Python-mintákat a GitHubról.

  • Győződjön meg arról, hogy a 8883-as port nyitva van a tűzfalon. A rövid útmutatóban szereplő eszközminta az MQTT protokollt használja, amely a 8883-es porton keresztül kommunikál. Ez a port bizonyos vállalati és oktatási hálózati környezetben blokkolva lehet. További információkért és a probléma megkerülésének módjaiért lásd: Csatlakozás IoT Hub -hez (MQTT).

Megjegyzés

Ez a cikk az Azure IoT-bővítmény legújabb, úgynevezett azure-iotverzióját használja. Az örökölt verzió neve azure-cli-iot-ext. Egyszerre csak egy verziót kell telepítenie. Az paranccsal az extension list ellenőrizheti a jelenleg telepített bővítményeket.

A bővítmény régi verziójának eltávolítására használható az extension remove --name azure-cli-iot-ext .

A bővítmény új verziójának hozzáadására használható az extension add --name azure-iot .

A telepített bővítmények megtekintéséhez használja a következőt az extension list: .

IoT Hub létrehozása

Ebben a szakaszban az Azure CLI használatával hozhat létre egy IoT Hubot és egy erőforráscsoportot. Az Azure-erőforráscsoport olyan logikai tároló, amelybe a rendszer üzembe helyezi és kezeli az Azure-erőforrásokat. Az IoT Hub központi üzenetközpontként szolgál az IoT-alkalmazás és az eszközök közötti kétirányú kommunikációhoz.

Ha már rendelkezik IoT Hubbal az Azure-előfizetésében, kihagyhatja ezt a szakaszt.

IoT Hub és erőforráscsoport létrehozása:

  1. Indítsa el a CLI-alkalmazást. A parancssori felületi parancsok a cikk további részében való futtatásához másolja ki a parancs szintaxisát, illessze be a PARANCSSOR-alkalmazásba, szerkessze a változóértékeket, és nyomja le a billentyűt Enter.

    • Ha Cloud Shell használ, a parancssori felület parancsainak Kipróbálása gombjára kattintva elindíthatja Cloud Shell egy osztott böngészőablakban. Vagy megnyithatja a Cloud Shell egy külön böngészőlapon.
    • Ha helyileg használja az Azure CLI-t, indítsa el a CLI-konzolalkalmazást, és jelentkezzen be az Azure CLI-be.
  2. Futtassa az az extension add parancsot az azure-iot bővítmény telepítéséhez vagy frissítéséhez az aktuális verzióra.

    az extension add --upgrade --name azure-iot
    
  3. A CLI-alkalmazásban futtassa az az group create parancsot egy erőforráscsoport létrehozásához. A következő parancs létrehoz egy MyResourceGroup nevű erőforráscsoportot az eastus helyen.

    Megjegyzés

    Igény szerint másik helyet is beállíthat. Az elérhető helyek megtekintéséhez futtassa a parancsot az account list-locations. Ez a rövid útmutató az eastus függvényt használja a példaparancsban látható módon.

    az group create --name MyResourceGroup --location eastus
    
  4. Futtassa az az iot hub create parancsot egy IoT Hub létrehozásához. Az IoT Hub létrehozása eltarthat néhány percig.

    YourIotHubName. Cserélje le ezt a helyőrzőt és a környező kapcsos zárójeleket az alábbi parancsban az IoT Hubhoz választott névvel. Az IoT Hub nevének globálisan egyedinek kell lennie az Azure-ban. Használja az IoT Hub nevét a rövid útmutató többi részében, bárhol is láthatja a helyőrzőt.

    az iot hub create --resource-group MyResourceGroup --name {your_iot_hub_name}
    

Eszköz regisztrálása

Az eszköznek regisztrálva kell lennie az IoT Hubbal, hogy csatlakozhasson hozzá. Ebben a szakaszban az Azure CLI használatával hozhat létre eszközidentitást.

Ha már regisztrált egy eszközt az IoT Hubon, kihagyhatja ezt a szakaszt.

Eszközidentitás létrehozása:

  1. Futtassa az az iot hub device-identity create parancsot a CLI-rendszerhéjban. Ez a parancs létrehozza az eszközidentitást.

    your_iot_hub_name. Cserélje le az alábbi helyőrzőt az IoT Hubhoz választott névre.

    myDevice. Ezt a nevet használhatja az eszközazonosítóhoz ebben a cikkben, vagy megadhat egy másik eszköznevet.

    az iot hub device-identity create --device-id myDevice --hub-name {your_iot_hub_name}
    
  2. Futtassa az az iot hub device-identity connection-string show parancsot.

    az iot hub device-identity connection-string show --device-id myDevice --hub-name {your_iot_hub_name}
    

    A kapcsolati sztring kimenete a következő formátumban van:

    HostName=<your IoT Hub name>.azure-devices.net;DeviceId=<your device id>;SharedAccessKey=<some value>
    
  3. Mentse a kapcsolati sztring biztonságos helyre.

Megjegyzés

Hagyja nyitva a CLI-alkalmazást. A későbbi lépésekben szükség lesz rá.

A szolgáltatás kapcsolati sztringjének lekérése

Szüksége van egy szolgáltatáskapcsolati sztringre is azért, hogy a háttéralkalmazás csatlakozhasson az IoT Hubhoz, és üzeneteket kérhessen le. Az alábbi parancs lekéri az IoT Hub szolgáltatáskapcsolati sztringjét:

YourIoTHubName: Cserélje le az alábbi helyőrzőt az IoT Hubhoz választott névre.

az iot hub connection-string show \
  --policy-name service \
  --hub-name {YourIoTHubName} \
  --output table

Jegyezze fel a szolgáltatáskapcsolati sztringet, amely a következőképpen néz ki:

HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

Ezt az értéket használni fogja a rövid útmutató későbbi részében. Ez a szolgáltatás kapcsolati sztring eltér az előző lépésben feljegyzett eszköztől kapcsolati sztring.

Eszköz szimulálása

A szimulálteszköz-alkalmazás az IoT Hubon található eszközspecifikus végponthoz csatlakozik, szimulált telemetriát küld, és figyeli a hubról érkező közvetlenmetódus-hívásokat. Ebben a rövid útmutatóban a hubról érkező közvetlenmetódus-hívás arra utasítja az eszközt, hogy módosítsa a telemetriaküldések közötti időintervallumot. A szimulált eszköz a közvetlen metódus végrehajtása után nyugtázást küld a központnak.

  1. Egy helyi terminálablakban keresse meg a Python-mintaprojekt gyökérmappáját. Ezután lépjen az iot-hub\Quickstarts\simulated-device-2 mappába.

  2. Nyissa meg a SimulatedDeviceSync.py fájlt egy tetszőleges szövegszerkesztőben.

    Cserélje le a CONNECTION_STRING változó értékét arra az eszközre, kapcsolati sztring korábban már jegyezte fel. Ezután mentse a módosításokat a SimulatedDeviceSync.py.

  3. Futtassa az alábbi parancsokat a helyi terminálablakban a szimulálteszköz-alkalmazáshoz szükséges kódtárak telepítéséhez:

    pip install azure-iot-device
    
  4. Futtassa az alábbi parancsokat a helyi terminálablakban a szimulálteszköz-alkalmazás futtatásához:

    python SimulatedDeviceSync.py
    

    A következő képernyőképen az a kimenet látható, amikor a szimulálteszköz-alkalmazás telemetriát küld az IoT Hubnak:

    A szimulált eszköz futtatása

A közvetlen metódus meghívása

A háttéralkalmazás az IoT Hubon található szolgáltatásoldali végponthoz csatlakozik. Az alkalmazás közvetlen metódushívásokat indít egy eszközre az IoT Hubon keresztül, és figyeli a nyugtázásokat. Az IoT Hub-háttéralkalmazások általában a felhőben futnak.

  1. Egy másik helyi terminálablakban keresse meg a Python-mintaprojekt gyökérmappáját. Ezután lépjen az iot-hub\Quickstarts\back-end-application mappába.

  2. Nyissa meg a BackEndApplication.py fájlt egy Ön által választott szövegszerkesztőben.

    Cserélje le a CONNECTION_STRING változó értékét a szolgáltatásra, kapcsolati sztring korábban már jegyezte fel. Ezután mentse a módosításokat a BackEndApplication.py.

  3. Futtassa az alábbi parancsokat a helyi terminálablakban a szimulálteszköz-alkalmazáshoz szükséges kódtárak telepítéséhez:

    pip install azure-iot-hub
    
  4. Futtassa az alábbi parancsokat a helyi terminálablakban a háttéralkalmazás futtatásához:

    python BackEndApplication.py
    

    Az alábbi képernyőképen a kimenet látható, amikor az alkalmazás közvetlen metódushívást kezdeményez az eszközre, és nyugtázást kap:

    A háttéralkalmazás futtatása

    A háttéralkalmazás futtatása után megjelenik egy üzenet a szimulált eszközt futtató konzolablakban, és megváltozik az üzenetküldések gyakorisága:

    Változás a szimulált ügyfélben

Az erőforrások eltávolítása

Ha azt tervezi, hogy a következő ajánlott cikkel folytatja, megtarthatja és újból felhasználhatja a már létrehozott erőforrásokat.

Ellenkező esetben, a díjak elkerülése érdekében törölheti a jelen cikkben létrehozott Azure-erőforrásokat.

Fontos

Az erőforráscsoport törlése nem vonható vissza. Az erőforráscsoport és a benne foglalt erőforrások véglegesen törlődnek. Figyeljen arra, hogy ne töröljön véletlenül erőforráscsoportot vagy erőforrásokat. Ha az IoT Hubot egy meglévő, megtartani kívánt erőforrásokat tartalmazó erőforráscsoportban hozta létre, az erőforráscsoport törlése helyett törölheti csak magát az IoT Hub-erőforrást.

Erőforráscsoport törlése név alapján:

  1. Jelentkezzen be az Azure Portalra, és válassza az Erőforráscsoportok elemet.

  2. A Szűrés név alapján szövegmezőbe írja be a IoT Hub tartalmazó erőforráscsoport nevét.

  3. Az eredménylistában az erőforráscsoporttól jobbra válassza a ... lehetőséget, majd az Erőforráscsoport törlése lehetőséget.

    Törlés

  4. A rendszer az erőforráscsoport törlésének megerősítését fogja kérni. Írja be ismét az erőforráscsoport nevét a megerősítéshez, majd válassza a Törlés lehetőséget. A rendszer néhány pillanaton belül törli az erőforráscsoportot és a benne foglalt erőforrásokat.

Következő lépések

Ebben a rövid útmutatóban egy közvetlen metódust hívott meg egy eszközről egy szolgáltatásalkalmazásból, és válaszolt egy szimulált eszközalkalmazás közvetlen metódushívására.

Ha szeretné megtudni, hogy hogyan irányíthatók az eszközről felhőbe irányuló üzenetek különböző felhőbeli célokhoz, folytassa a következő oktatóanyaggal.