Rövid útmutató: Telemetria küldése IoT-Plug and Play eszközről Azure IoT Hub

A következőkre vonatkozik: Eszközalkalmazás-fejlesztők

Kód tallózása

Ebben a rövid útmutatóban egy alapszintű Azure IoT-alkalmazásfejlesztési munkafolyamatot ismerhet meg. Az Azure CLI-vel és az IoT Explorerrel létrehozhat egy Azure IoT Hubot és egy eszközt. Ezután egy Azure IoT-eszköz SDK-mintáját használva futtat egy hőmérséklet-vezérlőt, biztonságosan csatlakoztatja azt a központhoz, és telemetriát küld. A hőmérséklet-vezérlő mintaalkalmazás a helyi gépen fut, és szimulált érzékelőadatokat hoz létre, hogy elküldje IoT Hub.

Előfeltételek

Ez a rövid útmutató Windows, Linux és Raspberry Pi rendszeren fut. Az alábbi operációs rendszer- és eszközverziókon teszteltük:

  • Windows 10
  • Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) 10-es verzió, Raspberry Pi 3 B+ modellen fut

Telepítse a következő előfeltételeket a fejlesztői gépen, kivéve, ha a Raspberry Pi esetében fel van jegyezve:

  • Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egyet ingyen .
  • Git.
  • Azure IoT Explorer: Platformfüggetlen, GUI-alapú segédprogram az Azure IoT monitorozásához és kezeléséhez. Ha a Raspberry Pi-t használja fejlesztési platformként, javasoljuk, hogy telepítse az IoT Explorert egy másik számítógépre. Ha nem szeretné telepíteni az IoT Explorert, az Azure CLI-vel is elvégezheti ugyanazokat a lépéseket.
  • Azure CLI. Ebben a rövid útmutatóban két lehetősége van az Azure CLI-parancsok futtatására:
    • Használja az Azure Cloud Shell interaktív felületet, amely parancssori felületi parancsokat futtat a böngészőben. Ez a beállítás azért ajánlott, mert nem kell semmit telepítenie. Ha először használ Cloud Shell, jelentkezzen be a Azure Portal. Kövesse Cloud Shell gyorsútmutató lépéseit a Start Cloud Shell és a Bash-környezet kiválasztása területen.
    • Igény szerint futtassa az Azure CLI-t a helyi gépen. Ha az Azure CLI már telepítve van, futtassa a parancsot az upgrade a parancssori felület és a bővítmények aktuális verzióra való frissítéséhez. Az Azure CLI telepítéséhez lásd: Az Azure CLI telepítése. Ha a Raspberry Pi-t használja fejlesztési platformként, javasoljuk, hogy használja az Azure Cloud Shell vagy telepítse az Azure CLI-t egy másik számítógépre.

Telepítse az operációs rendszer fennmaradó előfeltételeit.

Linux vagy Raspberry Pi OS

A rövid útmutató linuxos vagy Raspberry Pi OS rendszeren való végrehajtásához telepítse a következő szoftvert:

Telepítse a GCC-t, a Gitet, a cmake-t és a szükséges függőségeket a apt-get következő paranccsal:

sudo apt-get update
sudo apt-get install -y git cmake build-essential curl libcurl4-openssl-dev libssl-dev uuid-dev

Ellenőrizze, hogy a verzió cmake a 2.8.12-es verziónál magasabb-e, és hogy a GCC verziója 4.4.7-esnél magasabb-e.

cmake --version
gcc --version

Windows

A rövid útmutató Windows rendszeren való elvégzéséhez telepítse a Visual Studio 2019-et, és adja hozzá a C és C++ fejlesztéshez szükséges összetevőket.

  1. Új felhasználók számára telepítse a Visual Studio (Community, Professional vagy Enterprise) 2019-et. Töltse le a telepíteni kívánt kiadást, és indítsa el a telepítőt.

    Megjegyzés

    Meglévő Visual Studio 2019-felhasználók esetén válassza a Windows Start lehetőséget, írja be a Visual Studio Installer kifejezést, és indítsa el a telepítőt.

  2. A telepítő Számítási feladatok lapján válassza az Asztali fejlesztés C++ számítási feladattal lehetőséget.
  3. Futtassa a telepítést.

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.

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

  1. Indítsa el az Azure CLI-t:

    • 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, nyisson meg egy konzolt, például a Windows CMD-t, a PowerShellt vagy a Basht, és jelentkezzen be az Azure CLI-be.

    A parancssori felület parancsainak futtatásához a rövid útmutató hátralévő részében: másolja ki a parancs szintaxisát, illessze be a Cloud Shell ablakba vagy a CLI-konzolba, szerkessze a változóértékeket, és nyomja le az Enter billentyűt.

  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. 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 az oktatóanyag 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, ahol a helyőrzőt látja.

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

    Tipp

    Az IoT Hub létrehozása után az Azure IoT Explorer használatával kommunikálhat az IoT Hubbal a rövid útmutató további részében. Az IoT Explorer egy grafikus felhasználói felületi alkalmazás, amellyel csatlakozhat egy meglévő IoT Hub, és eszközöket vehet fel, kezelhet és figyelhet. További információ: Az Azure IoT Explorer telepítése és használata. A parancssori felület parancsai továbbra is használhatók.

Az IoT Explorer konfigurálása

A rövid útmutató további részében az IoT Explorerrel regisztrálhat egy eszközt az IoT Hubra, és megtekintheti az eszköz telemetriáját. Ebben a szakaszban úgy konfigurálja az IoT Explorert, hogy csatlakozzon az imént létrehozott IoT Hubhoz, és olvassa el a plug and play modelleket a nyilvános modell adattárából.

Megjegyzés

Az Azure CLI-vel is regisztrálhat egy eszközt. Az az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} paranccsal regisztráljon egy új eszközt, és az az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} paranccsal kérje le az eszköz elsődleges kapcsolati sztring. Miután feljegyezte az eszköz kapcsolati sztring, továbbléphet az Eszközminta futtatása elemre.

Kapcsolat hozzáadása az IoT Hubhoz:

  1. Futtassa az az iot hub connection-string show parancsot az IoT Hub kapcsolati sztring lekéréséhez.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Másolja a kapcsolati sztring a környező idézőjelek nélkül.

  3. Az Azure IoT Explorerben válassza az IoT Hubs lehetőséget a bal oldali menüben, majd válassza a + Kapcsolat hozzáadása lehetőséget.

  4. Illessze be a kapcsolati sztring a Kapcsolati sztring mezőbe.

  5. Kattintson a Mentés gombra.

    Képernyőkép kapcsolat hozzáadásáról az IoT Explorerben

  6. Ha a kapcsolat sikeres, az IoT Explorer átvált az Eszközök nézetre.

A nyilvános modell adattárának hozzáadása:

  1. Az IoT Explorerben válassza a Kezdőlap lehetőséget a kezdőlap nézethez való visszatéréshez.

  2. A bal oldali menüben válassza az IoT Plug and Play Beállítások, majd a +Hozzáadás lehetőséget, majd a legördülő menüBen válassza a Nyilvános adattár lehetőséget.

  3. Megjelenik egy bejegyzés a nyilvános modell adattárához a következő helyen: https://devicemodels.azure.com.

    Képernyőkép a nyilvános modelladattár hozzáadásáról az IoT Explorerben

  4. Kattintson a Mentés gombra.

Eszköz regisztrálása

Ebben a szakaszban létrehoz egy új eszközpéldányt, és regisztrálja azt a létrehozott IoT Hubon. Az újonnan regisztrált eszköz kapcsolati adataival biztonságosan csatlakoztathatja az eszközt egy későbbi szakaszban.

Eszköz regisztrálása:

  1. Az IoT Explorer kezdőlap nézetében válassza az IoT Hubs lehetőséget.

  2. A korábban hozzáadott kapcsolatnak meg kell jelennie. Válassza az Eszközök megtekintése ebben a központban lehetőséget a kapcsolat tulajdonságai alatt.

  3. Válassza az + Új lehetőséget, és adja meg az eszköz eszközazonosítóját; például mydevice. Az összes többi tulajdonságot hagyja változatlanul.

  4. Válassza a Létrehozás lehetőséget.

    Képernyőkép az Azure IoT Explorer eszközidentitásáról

  5. A másolási gombokkal másolja és jegyezze fel az Elsődleges kapcsolati sztring mezőt. Erre a kapcsolati sztring később lesz szüksége.

Az eszközminta futtatása

Ebben a szakaszban a C SDK használatával küld üzeneteket egy eszközről az IoT Hubra. Egy olyan mintát fog futtatni, amely egy hőmérséklet-vezérlőt implementál két termosztát-érzékelővel.

A minta létrehozása

  1. Nyisson meg egy új konzolt az Azure IoT C-eszköz SDK telepítéséhez és a kódminta futtatásához. Windows esetén válassza a Start gombot, írja be a VS 2019 fejlesztői parancssorát, és nyissa meg a konzolt. Linux és Raspberry Pi OS esetén nyisson meg egy terminált a Bash-parancsokhoz.

    Megjegyzés

    Ha az Azure CLI helyi telepítését használja, előfordulhat, hogy két konzolablak van megnyitva. Ügyeljen arra, hogy az imént megnyitott konzolon adja meg az ebben a szakaszban található parancsokat, ne azt, amelyet a parancssori felülethez használt.

  2. Lépjen egy helyi mappába, ahol klónozni szeretné a mintaadattárat.

  3. Klónozza az Azure IoT C eszköz SDK-t a helyi gépre:

    git clone https://github.com/Azure/azure-iot-sdk-c.git
    
  4. Keresse meg az SDK gyökérmappáját, és futtassa a következő parancsot a függőségek frissítéséhez:

    cd azure-iot-sdk-c
    git submodule update --init
    

    A művelet pár percet vesz igénybe.

  5. Az SDK és a minták létrehozásához futtassa a következő parancsokat:

    cmake -Bcmake -Duse_prov_client=ON -Dhsm_type_symm_key=ON -Drun_e2e_tests=OFF
    cmake --build cmake
    
  6. Állítsa be a következő környezeti változókat, hogy az eszköz kapcsolódhasson az Azure IoT-hez.

    • Állítson be egy nevű környezeti változót IOTHUB_DEVICE_CONNECTION_STRING. A változó értékeként használja az előző szakaszban mentett eszköz kapcsolati sztring.
    • Állítson be egy nevű környezeti változót IOTHUB_DEVICE_SECURITY_TYPE. A változóhoz használja a literális sztringértéket connectionString.

    Cmd

    set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
    set IOTHUB_DEVICE_SECURITY_TYPE=connectionString
    

    Megjegyzés

    A Windows CMD esetében nincsenek idézőjelek az egyes változók sztringértékei körül.

    Bash

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
    export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"
    

A kód futtatása

  1. Futtassa a mintakódot a konzol megfelelő parancsával.

    Cmd

    cmake\iothub_client\samples\pnp\pnp_temperature_controller\Debug\pnp_temperature_controller.exe
    

    Bash

    cmake/iothub_client/samples/pnp/pnp_temperature_controller/pnp_temperature_controller
    

    Megjegyzés

    Ez a kódminta azure IoT-Plug and Play használ, amely lehetővé teszi az intelligens eszközök manuális konfigurálás nélküli integrálását a megoldásokba. Alapértelmezés szerint a dokumentációban szereplő legtöbb minta IoT-Plug and Play használ. Az IoT PnP előnyeiről és a használatukra vonatkozó esetekről a Mi az IoT Plug and Play?.

A minta biztonságosan csatlakozik az IoT Hubhoz a regisztrált eszközként, és elkezd telemetriai üzeneteket küldeni. A mintakimenet megjelenik a konzolon.

Telemetria megtekintése

Az eszköz telemetriáját az IoT Explorerrel tekintheti meg. A telemetriai adatokat az Azure CLI használatával is megtekintheti.

Telemetria megtekintése az Azure IoT Explorerben:

  1. Az IoT Explorer Iot Hubjában válassza az Eszközök megtekintése ebben a központban lehetőséget, majd válassza ki az eszközt a listából.

  2. Az eszköz bal oldali menüjében válassza a Telemetria lehetőséget.

  3. Győződjön meg arról, hogy a Beépített eseményközpont használatabeállítás igen értékre van állítva, majd válassza a Start lehetőséget.

  4. Tekintse meg a telemetriát, amikor az eszköz üzeneteket küld a felhőbe.

    Az IoT Explorer eszköztelemetria képernyőképe

  5. Válassza a Leállítás lehetőséget az események fogadásának befejezéséhez.

Az egyes eszközösszetevők által küldött telemetriai adatok olvasásához használhatja az IoT Explorer beépülő és lejátszási funkcióit. Ebben a rövid útmutatóban például a hőmérséklet-vezérlő két termosztáttal rendelkezik: termosztát1 és termosztát2. A termosztát által jelentett hőmérséklet megtekintése1:

  1. Az IoT Explorer eszközén válassza az IoT Plug and Play összetevők lehetőséget a bal oldali menüben. Ezután válassza a termosztát1 elemet az összetevők listájából.

  2. A termosztát1 összetevő paneljén válassza a Telemetria lehetőséget a felső menüben.

  3. A Telemetriai panelen kövesse a korábban végrehajtott lépéseket. Győződjön meg arról, hogy a Beépített eseményközpont használatabeállítás Igen értékre van állítva, majd válassza a Start lehetőséget.

Eszköztelemetria megtekintése az Azure CLI-vel:

  1. Futtassa az az iot hub monitor-events parancsot az eszközről az IoT Hubra küldött események monitorozásához. Használja az eszközhöz és az IoT Hubhoz korábban létrehozott neveket az Azure IoT-ben.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Tekintse meg a kapcsolat részleteit és a telemetriai kimenetet a konzolon.

    Starting event monitor, filtering on device: mydevice, use ctrl-c to stop...
    event:
      component: ''
      interface: dtmi:com:example:TemperatureController;1
      module: ''
      origin: mydevice
      payload: '{"workingSet":1251}'
    
    event:
      component: thermostat1
      interface: dtmi:com:example:TemperatureController;1
      module: ''
      origin: mydevice
      payload: '{"temperature":22.00}'
    

Kód tallózása

Ebben a rövid útmutatóban egy alapszintű Azure IoT-alkalmazásfejlesztési munkafolyamatot ismerhet meg. Az Azure CLI-vel és az IoT Explorerrel létrehozhat egy Azure IoT Hubot és egy eszközt. Ezután egy Azure IoT-eszköz SDK-mintáját használva futtat egy hőmérséklet-vezérlőt, biztonságosan csatlakoztatja azt a központhoz, és telemetriát küld. A hőmérséklet-vezérlő mintaalkalmazás a helyi gépen fut, és szimulált érzékelőadatokat hoz létre, hogy elküldje IoT Hub.

Előfeltételek

Ez a rövid útmutató Windows, Linux és Raspberry Pi rendszeren fut. Az alábbi operációs rendszer- és eszközverziókon teszteltük:

  • Windows 10
  • Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) 10-es verzió, Raspberry Pi 3 B+ modellen fut

Telepítse a következő előfeltételeket a fejlesztői gépen, kivéve, ha a Raspberry Pi esetében fel van jegyezve:

  • Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egyet ingyen .

  • Git.

  • .NET Core SDK 3.1. Ne csak a futtatókörnyezetet, hanem a .NET SDK-t is telepítse. A számítógépen telepített .NET SDK és futtatókörnyezet verziójának ellenőrzéséhez futtassa a következőt dotnet --info: .

  • Azure IoT Explorer: Platformfüggetlen, GUI-alapú segédprogram az Azure IoT monitorozásához és kezeléséhez. Ha a Raspberry Pi-t használja fejlesztési platformként, javasoljuk, hogy telepítse az IoT Explorert egy másik számítógépre. Ha nem szeretné telepíteni az IoT Explorert, az Azure CLI-vel is elvégezheti ugyanazokat a lépéseket.

  • Azure CLI. Ebben a rövid útmutatóban két lehetősége van az Azure CLI-parancsok futtatására:

    • Használja az Azure Cloud Shell interaktív felületet, amely parancssori felületi parancsokat futtat a böngészőben. Ez a beállítás azért ajánlott, mert nem kell semmit telepítenie. Ha először használ Cloud Shell, jelentkezzen be a Azure Portal. Kövesse Cloud Shell gyorsútmutató lépéseit a Start Cloud Shell és a Bash-környezet kiválasztása területen.
    • Igény szerint futtassa az Azure CLI-t a helyi gépen. Ha az Azure CLI már telepítve van, futtassa a parancsot az upgrade a parancssori felület és a bővítmények aktuális verzióra való frissítéséhez. Az Azure CLI telepítéséhez lásd: Az Azure CLI telepítése. Ha a Raspberry Pi-t használja fejlesztési platformként, javasoljuk, hogy használja az Azure Cloud Shell vagy telepítse az Azure CLI-t egy másik számítógépre.

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.

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

  1. Indítsa el az Azure CLI-t:

    • 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, nyisson meg egy konzolt, például a Windows CMD-t, a PowerShellt vagy a Basht, és jelentkezzen be az Azure CLI-be.

    A parancssori felület parancsainak futtatásához a rövid útmutató hátralévő részében: másolja ki a parancs szintaxisát, illessze be a Cloud Shell ablakba vagy a CLI-konzolba, szerkessze a változóértékeket, és nyomja le az Enter billentyűt.

  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. 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 az oktatóanyag 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, ahol a helyőrzőt látja.

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

    Tipp

    Az IoT Hub létrehozása után az Azure IoT Explorer használatával kommunikálhat az IoT Hubbal a rövid útmutató további részében. Az IoT Explorer egy grafikus felhasználói felületi alkalmazás, amellyel csatlakozhat egy meglévő IoT Hub, és eszközöket vehet fel, kezelhet és figyelhet. További információ: Az Azure IoT Explorer telepítése és használata. A parancssori felület parancsai továbbra is használhatók.

Az IoT Explorer konfigurálása

A rövid útmutató további részében az IoT Explorerrel regisztrálhat egy eszközt az IoT Hubra, és megtekintheti az eszköz telemetriáját. Ebben a szakaszban úgy konfigurálja az IoT Explorert, hogy csatlakozzon az imént létrehozott IoT Hubhoz, és olvassa el a plug and play modelleket a nyilvános modell adattárából.

Megjegyzés

Az Azure CLI-vel is regisztrálhat egy eszközt. Az az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} paranccsal regisztráljon egy új eszközt, és az az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} paranccsal kérje le az eszköz elsődleges kapcsolati sztring. Miután feljegyezte az eszköz kapcsolati sztring, továbbléphet az Eszközminta futtatása elemre.

Kapcsolat hozzáadása az IoT Hubhoz:

  1. Futtassa az az iot hub connection-string show parancsot az IoT Hub kapcsolati sztring lekéréséhez.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Másolja a kapcsolati sztring a környező idézőjelek nélkül.

  3. Az Azure IoT Explorerben válassza az IoT Hubs lehetőséget a bal oldali menüben, majd válassza a + Kapcsolat hozzáadása lehetőséget.

  4. Illessze be a kapcsolati sztring a Kapcsolati sztring mezőbe.

  5. Kattintson a Mentés gombra.

    Képernyőkép kapcsolat hozzáadásáról az IoT Explorerben

  6. Ha a kapcsolat sikeres, az IoT Explorer átvált az Eszközök nézetre.

A nyilvános modell adattárának hozzáadása:

  1. Az IoT Explorerben válassza a Kezdőlap lehetőséget a kezdőlap nézethez való visszatéréshez.

  2. A bal oldali menüben válassza az IoT Plug and Play Beállítások, majd a +Hozzáadás lehetőséget, majd a legördülő menüBen válassza a Nyilvános adattár lehetőséget.

  3. Megjelenik egy bejegyzés a nyilvános modell adattárához a következő helyen: https://devicemodels.azure.com.

    Képernyőkép a nyilvános modelladattár hozzáadásáról az IoT Explorerben

  4. Kattintson a Mentés gombra.

Eszköz regisztrálása

Ebben a szakaszban létrehoz egy új eszközpéldányt, és regisztrálja azt a létrehozott IoT Hubon. Az újonnan regisztrált eszköz kapcsolati adataival biztonságosan csatlakoztathatja az eszközt egy későbbi szakaszban.

Eszköz regisztrálása:

  1. Az IoT Explorer kezdőlap nézetében válassza az IoT Hubs lehetőséget.

  2. A korábban hozzáadott kapcsolatnak meg kell jelennie. Válassza az Eszközök megtekintése ebben a központban lehetőséget a kapcsolat tulajdonságai alatt.

  3. Válassza az + Új lehetőséget, és adja meg az eszköz eszközazonosítóját; például mydevice. Az összes többi tulajdonságot hagyja változatlanul.

  4. Válassza a Létrehozás lehetőséget.

    Képernyőkép az Azure IoT Explorer eszközidentitásáról

  5. A másolási gombokkal másolja és jegyezze fel az Elsődleges kapcsolati sztring mezőt. Erre a kapcsolati sztring később lesz szüksége.

Az eszközminta futtatása

Ebben a szakaszban a C# SDK használatával fog üzeneteket küldeni egy eszközről az IoT Hubra. Egy olyan mintát fog futtatni, amely egy hőmérséklet-vezérlőt implementál két termosztát-érzékelővel.

  1. Nyisson meg egy új konzolt, például a Windows CMD-t, a PowerShellt vagy a Basht. A következő lépésekben ezt a konzolt fogja használni a Node.js SDK telepítéséhez és Node.js mintakód használatához.

    Megjegyzés

    Ha az Azure CLI helyi telepítését használja, előfordulhat, hogy két konzolablak van megnyitva. Ügyeljen arra, hogy az imént megnyitott konzolon adja meg az ebben a szakaszban található parancsokat, ne azt, amelyet a parancssori felülethez használt.

  2. Klónozza a C# (.NET) Microsoft Azure IoT SDK-t a helyi gépre:

    git clone https://github.com/Azure/azure-iot-sdk-csharp.git
    
  3. Navigáljon a mintakönyvtárhoz:

    Windows

    cd azure-iot-sdk-csharp\iothub\device\samples\solutions\PnpDeviceSamples\TemperatureController
    

    Linux vagy Raspberry Pi OS

    cd azure-iot-sdk-csharp/iothub/device/samples/solutions/PnpDeviceSamples/TemperatureController
    
  4. Telepítse az Azure IoT C# SDK-t és a szükséges függőségeket:

    dotnet restore
    

    Ez a parancs telepíti a TemperatureController.csproj fájlban megadott megfelelő függőségeket.

  5. Állítsa be mindkét környezeti változót, hogy az eszköz kapcsolódhasson az Azure IoT-hez.

    • Állítson be egy nevű környezeti változót IOTHUB_DEVICE_CONNECTION_STRING. A változó értékeként használja az előző szakaszban mentett eszköz kapcsolati sztring.
    • Állítson be egy nevű környezeti változót IOTHUB_DEVICE_SECURITY_TYPE. A változóhoz használja a literális sztringértéket connectionString.

    CMD (Windows)

    set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
    set IOTHUB_DEVICE_SECURITY_TYPE=connectionString
    

    Megjegyzés

    A Windows CMD esetében nincsenek idézőjelek az egyes változók sztringértékei körül.

    PowerShell

    $env:IOTHUB_DEVICE_CONNECTION_STRING='<your connection string here>'
    $env:IOTHUB_DEVICE_SECURITY_TYPE='connectionString'
    

    Bash

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
    export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"
    
  6. Futtassa a kódmintát:

    dotnet run
    

    Megjegyzés

    Ez a kódminta azure IoT-Plug and Play használ, amely lehetővé teszi az intelligens eszközök manuális konfigurálás nélküli integrálását a megoldásokba. Alapértelmezés szerint a dokumentációban szereplő legtöbb minta IoT-Plug and Play használ. Az IoT PnP előnyeiről és a használatukra vonatkozó esetekről a Mi az IoT Plug and Play?.

A minta biztonságosan csatlakozik az IoT Hubhoz a regisztrált eszközként, és elkezd telemetriai üzeneteket küldeni. A mintakimenet megjelenik a konzolon.

Telemetria megtekintése

Az eszköz telemetriáját az IoT Explorerrel tekintheti meg. A telemetriai adatokat az Azure CLI használatával is megtekintheti.

Telemetria megtekintése az Azure IoT Explorerben:

  1. Az IoT Explorer Iot Hubjában válassza az Eszközök megtekintése ebben a központban lehetőséget, majd válassza ki az eszközt a listából.

  2. Az eszköz bal oldali menüjében válassza a Telemetria lehetőséget.

  3. Győződjön meg arról, hogy a Beépített eseményközpont használatabeállítás igen értékre van állítva, majd válassza a Start lehetőséget.

  4. Tekintse meg a telemetriát, amikor az eszköz üzeneteket küld a felhőbe.

    Az IoT Explorer eszköztelemetria képernyőképe

  5. Válassza a Leállítás lehetőséget az események fogadásának befejezéséhez.

Az egyes eszközösszetevők által küldött telemetriai adatok olvasásához használhatja az IoT Explorer plug and play funkcióit. Ebben a rövid útmutatóban például a hőmérséklet-vezérlő két termosztáttal rendelkezik: termosztát1 és termosztát2. A termosztát1 által jelentett hőmérséklet megtekintése:

  1. Az IoT Explorer eszközén válassza az IoT Plug and Play összetevők lehetőséget a bal oldali menüben. Ezután válassza ki a termosztát1 elemet az összetevők listájából.

  2. A termosztát1 összetevő paneljén válassza a telemetria lehetőséget a felső menüben.

  3. A Telemetria panelen kövesse a korábban végrehajtott lépéseket. Győződjön meg arról, hogy a Beépített eseményközpont használatabeállítás értéke Igen , majd válassza a Start gombot.

Eszköztelemetria megtekintése az Azure CLI-vel:

  1. Futtassa az az iot hub monitor-events parancsot az eszközről az IoT Hubra küldött események monitorozásához. Használja a korábban az Azure IoT-ben az eszközhöz és az IoT Hubhoz létrehozott neveket.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Tekintse meg a kapcsolat részleteit és a telemetria kimenetét a konzolon.

    Starting event monitor, filtering on device: mydevice, use ctrl-c to stop...
    event:
      component: thermostat1
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 39.8
    
    event:
      component: thermostat2
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 36.7
    
  3. A figyelés befejezéséhez válassza a CTRL+C billentyűkombinációt.

Kód tallózása

Ebben a rövid útmutatóban egy alapszintű Azure IoT-alkalmazásfejlesztési munkafolyamatot ismerhet meg. Az Azure CLI és az IoT Explorer használatával létrehozhat egy Azure IoT Hubot és egy eszközt. Ezután egy Azure IoT-eszköz SDK-mintával futtathat egy hőmérséklet-vezérlőt, biztonságosan csatlakoztathatja a központhoz, és telemetriát küldhet. A hőmérséklet-vezérlő mintaalkalmazás a helyi gépen fut, és szimulált érzékelőadatokat hoz létre, amelyek elküldése IoT Hub.

Előfeltételek

Ez a rövid útmutató Windows, Linux és Raspberry Pi rendszeren fut. A következő operációs rendszer- és eszközverziókon teszteltük:

  • Windows 10
  • Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) 10-es verzió, raspberry Pi 3 B+ modellen fut

Telepítse a következő előfeltételeket a fejlesztői gépen, kivéve, ha a Raspberry Pi esetében fel van jegyezve:

  • Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egyet ingyen .
  • Git.
  • Azure IoT Explorer: Platformfüggetlen, GUI-alapú segédprogram az Azure IoT monitorozásához és kezeléséhez. Ha a Raspberry Pi-t használja fejlesztési platformként, javasoljuk, hogy telepítse az IoT Explorert egy másik számítógépre. Ha nem szeretné telepíteni az IoT Explorert, az Azure CLI-vel is elvégezheti ugyanezeket a lépéseket.
  • Azure CLI. Ebben a rövid útmutatóban két lehetősége van az Azure CLI-parancsok futtatására:
    • Használja az Azure Cloud Shell interaktív felületet, amely parancssori felületi parancsokat futtat a böngészőben. Ez a beállítás azért ajánlott, mert nem kell semmit telepítenie. Ha először használ Cloud Shell, jelentkezzen be a Azure Portal. Kövesse Cloud Shell rövid útmutató lépéseit a Start Cloud Shell és a Bash-környezet kiválasztásához.
    • Igény szerint futtassa az Azure CLI-t a helyi gépen. Ha az Azure CLI már telepítve van, futtassa a parancsot az upgrade a parancssori felület és a bővítmények aktuális verzióra való frissítéséhez. Az Azure CLI telepítéséhez lásd: Az Azure CLI telepítése. Ha a Raspberry Pi-t használja fejlesztési platformként, javasoljuk, hogy használja az Azure Cloud Shell vagy telepítse az Azure CLI-t egy másik számítógépre.

Telepítse az operációs rendszer fennmaradó előfeltételeit.

Windows

A rövid útmutató Windows rendszeren való végrehajtásához telepítse a következő szoftvert:

  • Java SE Development Kit 8 vagy újabb. A Java 8 (LTS) JDK-t több platformhoz is letöltheti az OpenJDK Zulu-buildjeinek letöltésével. A telepítőben válassza a Hozzáadás az elérési úthoz lehetőséget.

  • Apache Maven 3. Miután kinyerte a letöltést egy helyi mappába, adja hozzá a Maven /bin mappa teljes elérési útját a Windows PATH környezeti változóhoz.

Linux vagy Raspberry Pi OS

A rövid útmutató linuxos vagy Raspberry Pi OS rendszeren való végrehajtásához telepítse a következő szoftvert:

Megjegyzés

A szakasz lépései Linux Ubuntu/Debian disztribúciókon alapulnak. (A Raspberry Pi OS Debianon alapul.) Ha másik Linux-disztribúciót használ, ennek megfelelően módosítania kell a lépéseket.

  • OpenJDK (Open Java Development Kit) 8 vagy újabb. Az java -version paranccsal ellenőrizheti a rendszeren telepített Java-verziót. Győződjön meg arról, hogy a JDK telepítve van, nem csak a Java-futtatókörnyezet (JRE).

    1. A rendszer OpenJDK-jának telepítéséhez adja meg a következő parancsokat:

      Az OpenJDK alapértelmezett verziójának telepítése a rendszerhez (OpenJDK 11 for Ubuntu 20.04 és Raspberry Pi OS 10 az íráskor):

      sudo apt update
      sudo apt install default-jdk
      

      Másik lehetőségként megadhatja a telepíteni kívánt JDK-verziót. Például:

      sudo apt update
      sudo apt install openjdk-8-jdk
      
    2. Ha a rendszer több Java-verzióval rendelkezik, az alábbi parancsokkal konfigurálhatja a Java és a Java-fordító alapértelmezett (automatikus) verzióit.

      update-java-alternatives --list          #list the Java versions installed
      sudo update-alternatives --config java   #set the default Java version
      sudo  update-alternatives --config javac #set the default Java compiler version
      
    3. Állítsa a JAVA_HOME környezeti változót a JDK-telepítés útvonalára. (Ez általában egy verziószámozott alkönyvtár a /usr/lib/jvm könyvtárban.)

      export JAVA_HOME=$(readlink -f /usr/bin/java | sed "s:bin/java::")
      

      Fontos

      Ez a parancs beállítja a változót JAVA_HOME az aktuális rendszerhéj-környezetben. Javasoljuk, hogy adja hozzá a parancsot a ~/.bashrc vagy /etc/profile a fájlhoz, hogy elérhetővé tegye, amikor új rendszerhéjat nyit meg.

    4. Ellenőrizze a telepített Java JDK (és JRE) verzióját, hogy a Java-fordító verziója megegyezik-e a JDK-verzióval, és hogy a JAVA_HOME környezeti változó megfelelően van-e beállítva.

      java -version
      javac -version
      echo $JAVA_HOME
      
  • Apache Maven 3. mvn --version Az paranccsal ellenőrizheti a rendszeren telepített Maven verzióját.

    1. A Maven telepítéséhez adja meg a következő parancsokat:

      sudo apt-get update
      sudo apt-get install maven
      
    2. A telepítés ellenőrzéséhez írja be a következő parancsot.

      mvn --version
      

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.

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

  1. Indítsa el az Azure CLI-t:

    • Ha Cloud Shell használ, válassza a CLI-parancsok Kipróbálás gombját Cloud Shell egy osztott böngészőablakban való elindításához. Vagy megnyithatja a Cloud Shell egy külön böngészőlapon.
    • Ha helyileg használja az Azure CLI-t, nyisson meg egy konzolt, például a Windows CMD-t, a PowerShellt vagy a Basht, és jelentkezzen be az Azure CLI-be.

    A parancssori felület parancsainak futtatásához a rövid útmutató további részében: másolja ki a parancs szintaxisát, illessze be a Cloud Shell ablakba vagy a CLI-konzolba, szerkessze a változóértékeket, és nyomja le az Enter billentyűt.

  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. 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 az oktatóanyag 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 {YourIoTHubName}
    

    Tipp

    Az IoT Hub létrehozása után az Azure IoT Explorer használatával kezelheti az IoT Hubot a rövid útmutató további részében. Az IoT Explorer egy grafikus felhasználói felületi alkalmazás, amellyel csatlakozhat egy meglévő IoT Hub és eszközöket vehet fel, kezelhet és figyelhet. További információ: Az Azure IoT Explorer telepítése és használata. Ha szeretné, továbbra is használhatja a CLI-parancsokat.

Az IoT Explorer konfigurálása

A rövid útmutató további részében az IoT Explorerrel regisztrálhat egy eszközt az IoT Hubra, és megtekintheti az eszköz telemetriáját. Ebben a szakaszban úgy konfigurálja az IoT Explorert, hogy csatlakozzon az imént létrehozott IoT Hubhoz, és olvassa el a plug and play modelleket a nyilvános modell adattárából.

Megjegyzés

Az Azure CLI-vel is regisztrálhat egy eszközt. Az az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} paranccsal regisztráljon egy új eszközt, és az az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} paranccsal kérje le az eszköz elsődleges kapcsolati sztring. Miután feljegyezte az eszköz kapcsolati sztring, továbbléphet az Eszközminta futtatása elemre.

Kapcsolat hozzáadása az IoT Hubhoz:

  1. Futtassa az az iot hub connection-string show parancsot az IoT Hub kapcsolati sztring lekéréséhez.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Másolja a kapcsolati sztring a környező idézőjelek nélkül.

  3. Az Azure IoT Explorerben válassza az IoT Hubs lehetőséget a bal oldali menüben, majd válassza a + Kapcsolat hozzáadása lehetőséget.

  4. Illessze be a kapcsolati sztring a Kapcsolati sztring mezőbe.

  5. Kattintson a Mentés gombra.

    Képernyőkép kapcsolat hozzáadásáról az IoT Explorerben

  6. Ha a kapcsolat sikeres, az IoT Explorer átvált az Eszközök nézetre.

A nyilvános modell adattárának hozzáadása:

  1. Az IoT Explorerben válassza a Kezdőlap lehetőséget a kezdőlap nézethez való visszatéréshez.

  2. A bal oldali menüben válassza az IoT Plug and Play Beállítások, majd a +Hozzáadás lehetőséget, majd a legördülő menüBen válassza a Nyilvános adattár lehetőséget.

  3. Megjelenik egy bejegyzés a nyilvános modell adattárához a következő helyen: https://devicemodels.azure.com.

    Képernyőkép a nyilvános modelladattár hozzáadásáról az IoT Explorerben

  4. Kattintson a Mentés gombra.

Eszköz regisztrálása

Ebben a szakaszban létrehoz egy új eszközpéldányt, és regisztrálja azt a létrehozott IoT Hubon. Az újonnan regisztrált eszköz kapcsolati adataival biztonságosan csatlakoztathatja az eszközt egy későbbi szakaszban.

Eszköz regisztrálása:

  1. Az IoT Explorer kezdőlap nézetében válassza az IoT Hubs lehetőséget.

  2. A korábban hozzáadott kapcsolatnak meg kell jelennie. Válassza az Eszközök megtekintése ebben a központban lehetőséget a kapcsolat tulajdonságai alatt.

  3. Válassza az + Új lehetőséget, és adja meg az eszköz eszközazonosítóját; például mydevice. Az összes többi tulajdonságot hagyja változatlanul.

  4. Válassza a Létrehozás lehetőséget.

    Képernyőkép az Azure IoT Explorer eszközidentitásáról

  5. A másolási gombokkal másolja és jegyezze fel az Elsődleges kapcsolati sztring mezőt. Erre a kapcsolati sztring később lesz szüksége.

Az eszközminta futtatása

Ebben a szakaszban a Java SDK-val küldhet üzeneteket egy eszközről az IoT Hubra. Egy olyan mintát fog futtatni, amely egy hőmérséklet-vezérlőt implementál két termosztát-érzékelővel.

  1. Nyisson meg egy konzolt az Azure IoT Java-eszköz SDK telepítéséhez, a kódminta összeállításához és futtatásához. Ezt a konzolt a következő lépésekben fogja használni.

    Megjegyzés

    Ha az Azure CLI helyi telepítését használja, előfordulhat, hogy két konzolablak van megnyitva. Ügyeljen arra, hogy az imént megnyitott konzolon adja meg az ebben a szakaszban található parancsokat, ne azt, amelyet a parancssori felülethez használt.

    Linux és Raspberry Pi OS

    Győződjön meg arról, hogy a JAVA_HOME (echo $JAVA_HOME) környezeti változó be van állítva. További információ a JAVA_HOME beállításáról: Linux/Raspberry Pi előfeltételek.

  2. Klónozza az Azure IoT Java-eszköz SDK-t a helyi gépre:

    git clone https://github.com/Azure/azure-iot-sdk-java.git
    
  3. Lépjen az SDK gyökérmappájába, és futtassa az alábbi parancsot az SDK létrehozásához és a minták frissítéséhez.

    cd azure-iot-sdk-java
    mvn install -T 2C -DskipTests
    

    Ez a művelet több percet vesz igénybe.

  4. Állítsa be a következő környezeti változókat, hogy az eszköz kapcsolódhasson az Azure IoT-hez.

    • Állítson be egy nevű környezeti változót IOTHUB_DEVICE_CONNECTION_STRING. A változó értékeként használja az előző szakaszban mentett eszköz kapcsolati sztring.
    • Állítson be egy nevű környezeti változót IOTHUB_DEVICE_SECURITY_TYPE. A változóhoz használja a literális sztringértéket connectionString.

    Cmd

    set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
    set IOTHUB_DEVICE_SECURITY_TYPE=connectionString
    

    Megjegyzés

    A Windows CMD esetében nincsenek idézőjelek az egyes változók sztringértékei körül.

    Bash

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
    export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"
    
  5. Lépjen a mintakönyvtárra.

    Cmd

    cd device\iot-device-samples\pnp-device-sample\temperature-controller-device-sample
    

    Bash

    cd device/iot-device-samples/pnp-device-sample/temperature-controller-device-sample
    
  6. Futtassa a kódmintát.

    mvn exec:java -Dexec.mainClass="samples.com.microsoft.azure.sdk.iot.device.TemperatureController"
    

    Megjegyzés

    Ez a kódminta azure IoT-Plug and Play használ, amely lehetővé teszi az intelligens eszközök manuális konfigurálás nélküli integrálását a megoldásokba. Alapértelmezés szerint a dokumentációban szereplő legtöbb minta IoT-Plug and Play használ. Az IoT PnP előnyeiről és a használatukra vonatkozó esetekről a Mi az IoT Plug and Play?.

A minta biztonságosan csatlakozik az IoT Hubhoz a regisztrált eszközként, és elkezd telemetriai üzeneteket küldeni. A mintakimenet megjelenik a konzolon.

Telemetria megtekintése

Az eszköz telemetriáját az IoT Explorerrel tekintheti meg. A telemetriai adatokat az Azure CLI használatával is megtekintheti.

Telemetria megtekintése az Azure IoT Explorerben:

  1. Az IoT Explorer Iot Hubjában válassza az Eszközök megtekintése ebben a központban lehetőséget, majd válassza ki az eszközt a listából.

  2. Az eszköz bal oldali menüjében válassza a Telemetria lehetőséget.

  3. Győződjön meg arról, hogy a Beépített eseményközpont használatabeállítás igen értékre van állítva, majd válassza a Start lehetőséget.

  4. Tekintse meg a telemetriát, amikor az eszköz üzeneteket küld a felhőbe.

    Az IoT Explorer eszköztelemetria képernyőképe

  5. Válassza a Leállítás lehetőséget az események fogadásának befejezéséhez.

Az egyes eszközösszetevők által küldött telemetriai adatok olvasásához használhatja az IoT Explorer beépülő és lejátszási funkcióit. Ebben a rövid útmutatóban például a hőmérséklet-vezérlő két termosztáttal rendelkezik: termosztát1 és termosztát2. A termosztát által jelentett hőmérséklet megtekintése1:

  1. Az IoT Explorer eszközén válassza az IoT Plug and Play összetevők lehetőséget a bal oldali menüben. Ezután válassza a termosztát1 elemet az összetevők listájából.

  2. A termosztát1 összetevő paneljén válassza a Telemetria lehetőséget a felső menüben.

  3. A Telemetriai panelen kövesse a korábban végrehajtott lépéseket. Győződjön meg arról, hogy a Beépített eseményközpont használatabeállítás Igen értékre van állítva, majd válassza a Start lehetőséget.

Eszköztelemetria megtekintése az Azure CLI-vel:

  1. Futtassa az az iot hub monitor-events parancsot az eszközről az IoT Hubra küldött események monitorozásához. Használja az eszközhöz és az IoT Hubhoz korábban létrehozott neveket az Azure IoT-ben.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Tekintse meg a kapcsolat részleteit és a telemetriai kimenetet a konzolon.

    Starting event monitor, filtering on device: mydevice, use ctrl-c to stop...
    event:
      component: thermostat1
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 24.1
    
    event:
      component: thermostat2
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 33.3
    

Kód tallózása

Ebben a rövid útmutatóban egy alapszintű Azure IoT-alkalmazásfejlesztési munkafolyamatot ismerhet meg. Az Azure CLI-vel és az IoT Explorerrel létrehozhat egy Azure IoT Hubot és egy eszközt. Ezután egy Azure IoT-eszköz SDK-mintáját használva futtat egy hőmérséklet-vezérlőt, biztonságosan csatlakoztatja azt a központhoz, és telemetriát küld. A hőmérséklet-vezérlő mintaalkalmazás a helyi gépen fut, és szimulált érzékelőadatokat hoz létre, hogy elküldje IoT Hub.

Előfeltételek

Ez a rövid útmutató Windows, Linux és Raspberry Pi rendszeren fut. Az alábbi operációs rendszer- és eszközverziókon teszteltük:

  • Windows 10
  • Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) 10-es verzió, Raspberry Pi 3 B+ modellen fut

Telepítse a következő előfeltételeket a fejlesztői gépen, kivéve, ha a Raspberry Pi esetében fel van jegyezve:

  • Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egyet ingyen .
  • Git.
  • Node.js 12-es vagy újabb verziót. A csomópont verziójának ellenőrzéséhez futtassa a következőt node --version: .
  • Azure IoT Explorer: Platformfüggetlen, GUI-alapú segédprogram az Azure IoT monitorozásához és kezeléséhez. Ha a Raspberry Pi-t használja fejlesztési platformként, javasoljuk, hogy telepítse az IoT Explorert egy másik számítógépre. Ha nem szeretné telepíteni az IoT Explorert, az Azure CLI-vel is elvégezheti ugyanezeket a lépéseket.
  • Azure CLI. Ebben a rövid útmutatóban két lehetősége van az Azure CLI-parancsok futtatására:
    • Használja az Azure Cloud Shell interaktív felületet, amely parancssori felületi parancsokat futtat a böngészőben. Ez a beállítás azért ajánlott, mert nem kell semmit telepítenie. Ha először használ Cloud Shell, jelentkezzen be a Azure Portal. Kövesse Cloud Shell rövid útmutató lépéseit a Start Cloud Shell és a Bash-környezet kiválasztásához.
    • Igény szerint futtassa az Azure CLI-t a helyi gépen. Ha az Azure CLI már telepítve van, futtassa a parancsot az upgrade a parancssori felület és a bővítmények aktuális verzióra való frissítéséhez. Az Azure CLI telepítéséhez lásd: Az Azure CLI telepítése. Ha a Raspberry Pi-t használja fejlesztési platformként, javasoljuk, hogy használja az Azure Cloud Shell vagy telepítse az Azure CLI-t egy másik számítógépre.

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.

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

  1. Indítsa el az Azure CLI-t:

    • Ha Cloud Shell használ, válassza a CLI-parancsok Kipróbálás gombját Cloud Shell egy osztott böngészőablakban való elindításához. Vagy megnyithatja a Cloud Shell egy külön böngészőlapon.
    • Ha helyileg használja az Azure CLI-t, nyisson meg egy konzolt, például a Windows CMD-t, a PowerShellt vagy a Basht, és jelentkezzen be az Azure CLI-be.

    A parancssori felület parancsainak futtatásához a rövid útmutató további részében: másolja ki a parancs szintaxisát, illessze be a Cloud Shell ablakba vagy a CLI-konzolba, szerkessze a változóértékeket, és nyomja le az Enter billentyűt.

  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. 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 az oktatóanyag 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 {YourIoTHubName}
    

    Tipp

    Az IoT Hub létrehozása után az Azure IoT Explorer használatával kezelheti az IoT Hubot a rövid útmutató további részében. Az IoT Explorer egy grafikus felhasználói felületi alkalmazás, amellyel csatlakozhat egy meglévő IoT Hub és eszközöket vehet fel, kezelhet és figyelhet. További információ: Az Azure IoT Explorer telepítése és használata. Ha szeretné, továbbra is használhatja a CLI-parancsokat.

Az IoT Explorer konfigurálása

A rövid útmutató további részében az IoT Explorerrel regisztrálhat egy eszközt az IoT Hubon, és megtekintheti az eszköz telemetriáját. Ebben a szakaszban úgy konfigurálja az IoT Explorert, hogy csatlakozzon az imént létrehozott IoT Hubhoz, és olvassa be a plug and play modelleket a nyilvános modell adattárából.

Megjegyzés

Az Azure CLI-vel is regisztrálhat eszközöket. Az az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} paranccsal regisztráljon egy új eszközt, és az az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} paranccsal kérje le az eszköz elsődleges kapcsolati sztring. Miután feljegyezte az eszköz kapcsolati sztring, továbbléphet az Eszközminta futtatása elemre.

Kapcsolat hozzáadása az IoT Hubhoz:

  1. Futtassa az az iot hub connection-string show parancsot az IoT Hub kapcsolati sztring lekéréséhez.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Másolja a kapcsolati sztring a környező idézőjelek nélkül.

  3. Az Azure IoT Explorerben válassza az IoT Hubs elemet a bal oldali menüben, majd válassza a + Kapcsolat hozzáadása lehetőséget.

  4. Illessze be a kapcsolati sztring a Kapcsolati sztring mezőbe.

  5. Kattintson a Mentés gombra.

    Képernyőkép egy kapcsolat hozzáadásáról az IoT Explorerben

  6. Ha a kapcsolat sikeres, az IoT Explorer átvált az Eszközök nézetre.

A nyilvános modell adattárának hozzáadása:

  1. Az IoT Explorerben válassza a Kezdőlap lehetőséget a kezdőlap nézethez való visszatéréshez.

  2. A bal oldali menüben válassza az IoT Plug and Play Beállítások, majd a +Hozzáadás lehetőséget, majd a legördülő menü Nyilvános adattár elemét.

  3. Megjelenik egy bejegyzés a nyilvános modell adattárához a következő helyen: https://devicemodels.azure.com.

    Képernyőkép a nyilvános modell adattárának az IoT Explorerben való hozzáadásáról

  4. Kattintson a Mentés gombra.

Eszköz regisztrálása

Ebben a szakaszban létrehoz egy új eszközpéldányt, és regisztrálja azt a létrehozott IoT Hubon. Egy későbbi szakaszban az újonnan regisztrált eszköz kapcsolati adatait fogja használni az eszköz biztonságos csatlakoztatásához.

Eszköz regisztrálása:

  1. Az IoT Explorer kezdőlap nézetében válassza az IoT Hubs lehetőséget.

  2. A korábban hozzáadott kapcsolatnak meg kell jelennie. Válassza az Eszközök megtekintése ebben a központban lehetőséget a kapcsolat tulajdonságai alatt.

  3. Válassza az + Új lehetőséget, és adja meg az eszköz azonosítóját; például mydevice. Az összes többi tulajdonságot hagyja változatlanul.

  4. Válassza a Létrehozás lehetőséget.

    Képernyőkép az Azure IoT Explorer eszközidentitásáról

  5. A másolási gombokkal másolja és jegyezze fel az Elsődleges kapcsolati sztring mezőt. Erre a kapcsolati sztring később lesz szüksége.

Az eszközminta futtatása

Ebben a szakaszban a Node.js SDK használatával fog üzeneteket küldeni egy eszközről az IoT Hubra. Egy olyan mintát fog futtatni, amely egy hőmérséklet-vezérlőt implementál két termosztát-érzékelővel.

  1. Nyisson meg egy új konzolt, például a Windows CMD-t, a PowerShellt vagy a Basht. A következő lépésekben ezt a konzolt fogja használni a Node.js SDK telepítéséhez és Node.js mintakód használatához.

    Megjegyzés

    Ha az Azure CLI helyi telepítését használja, előfordulhat, hogy két konzolablak nyílik meg. Ügyeljen arra, hogy az imént megnyitott konzolon adja meg az ebben a szakaszban található parancsokat, ne azt, amelyet a parancssori felülethez használt.

  2. Klónozza az Azure IoT Node.js SDK-eszközmintákat a helyi gépre:

    git clone https://github.com/Azure/azure-iot-sdk-node
    
  3. Lépjen a mintakönyvtárra:

    Windows

    cd azure-iot-sdk-node\device\samples\javascript
    

    Linux vagy Raspberry Pi OS

    cd azure-iot-sdk-node/device/samples/javascript
    
  4. Telepítse az Azure IoT Node.js SDK-t és a szükséges függőségeket:

    npm install
    

    Ez a parancs telepíti a megfelelő függőségeket az eszközminták könyvtárában található package.json fájlban megadottak szerint.

  5. Állítsa be mindkét környezeti változót, hogy az eszköz kapcsolódhasson az Azure IoT-hez.

    • Állítson be egy nevű környezeti változót IOTHUB_DEVICE_CONNECTION_STRING. A változó értékeként használja az előző szakaszban mentett eszköz kapcsolati sztring.
    • Állítson be egy nevű környezeti változót IOTHUB_DEVICE_SECURITY_TYPE. A változóhoz használja a literális sztringértéket connectionString.

    CMD (Windows)

    set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
    set IOTHUB_DEVICE_SECURITY_TYPE=connectionString
    

    Megjegyzés

    Windows CMD esetén nincsenek idézőjelek az egyes változók sztringértékei körül.

    PowerShell

    $env:IOTHUB_DEVICE_CONNECTION_STRING='<your connection string here>'
    $env:IOTHUB_DEVICE_SECURITY_TYPE='connectionString'
    

    Bash

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
    export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"
    
  6. Futtassa a következő kódmintát:

    node pnp_temperature_controller.js
    

    Megjegyzés

    Ez a kódminta az Azure IoT Plug and Play használja, amely lehetővé teszi az intelligens eszközök manuális konfigurálás nélküli integrálását a megoldásokba. Alapértelmezés szerint a dokumentációban szereplő legtöbb minta IoT-Plug and Play használ. Ha többet szeretne megtudni az IoT PnP előnyeiről, valamint a használatuk eseteiről, olvassa el a Mi az az IoT-Plug and Play?.

A minta biztonságosan csatlakozik az IoT Hubhoz a regisztrált eszközként, és elkezd telemetriai üzeneteket küldeni. A mintakimenet megjelenik a konzolon.

Telemetria megtekintése

Az eszköz telemetriáját az IoT Explorerrel tekintheti meg. Igény szerint az Azure CLI-vel is megtekintheti a telemetriát.

Telemetria megtekintése az Azure IoT Explorerben:

  1. Az IoT Explorerben az IoT Hubon válassza az Eszközök megtekintése ebben a központban lehetőséget, majd válassza ki az eszközt a listából.

  2. Az eszköz bal oldali menüjében válassza a Telemetria lehetőséget.

  3. Győződjön meg arról, hogy a Beépített eseményközpont használataigen értékre van állítva, majd válassza a Start gombot.

  4. Tekintse meg a telemetriát, amikor az eszköz üzeneteket küld a felhőbe.

    Eszköztelemetria képernyőképe az IoT Explorerben

  5. Válassza a Leállítás lehetőséget az események fogadásának befejezéséhez.

Az egyes eszközösszetevők által küldött telemetriai adatok olvasásához használhatja az IoT Explorer plug and play funkcióit. Ebben a rövid útmutatóban például a hőmérséklet-vezérlő két termosztáttal rendelkezik: termosztát1 és termosztát2. A termosztát1 által jelentett hőmérséklet megtekintése:

  1. Az IoT Explorer eszközén válassza az IoT Plug and Play összetevők lehetőséget a bal oldali menüben. Ezután válassza ki a termosztát1 elemet az összetevők listájából.

  2. A termosztát1 összetevő paneljén válassza a telemetria lehetőséget a felső menüben.

  3. A Telemetria panelen kövesse a korábban végrehajtott lépéseket. Győződjön meg arról, hogy a Beépített eseményközpont használatabeállítás értéke Igen , majd válassza a Start gombot.

Eszköztelemetria megtekintése az Azure CLI-vel:

  1. Futtassa az az iot hub monitor-events parancsot az eszközről az IoT Hubra küldött események monitorozásához. Használja a korábban az Azure IoT-ben az eszközhöz és az IoT Hubhoz létrehozott neveket.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Tekintse meg a kapcsolat részleteit és a telemetria kimenetét a konzolon.

    Starting event monitor, filtering on device: mydevice, use ctrl-c to stop...
    event:
      component: thermostat1
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 70.5897683228018
    
    event:
      component: thermostat2
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 52.87582619316418
    

Kód tallózása

Ebben a rövid útmutatóban egy alapszintű Azure IoT-alkalmazásfejlesztési munkafolyamatot ismerhet meg. Az Azure CLI és az IoT Explorer használatával létrehozhat egy Azure IoT Hubot és egy eszközt. Ezután egy Azure IoT-eszköz SDK-mintával futtathat egy hőmérséklet-vezérlőt, biztonságosan csatlakoztathatja a központhoz, és telemetriát küldhet. A hőmérséklet-vezérlő mintaalkalmazás a helyi gépen fut, és szimulált érzékelőadatokat hoz létre, amelyek elküldése IoT Hub.

Előfeltételek

Ez a rövid útmutató Windows, Linux és Raspberry Pi rendszeren fut. A következő operációs rendszer- és eszközverziókon teszteltük:

  • Windows 10
  • Ubuntu 20.04 LTS
  • Raspberry Pi OS (Raspbian) 10-es verzió, raspberry Pi 3 B+ modellen fut

Telepítse a következő előfeltételeket a fejlesztői gépen, kivéve, ha a Raspberry Pi esetében fel van jegyezve:

  • Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egyet ingyen .
  • Git.
  • Python 3.7-es vagy újabb verzió. A Python-verzió ellenőrzéséhez futtassa a parancsot python3 --version.
  • Azure IoT Explorer: Platformfüggetlen, GUI-alapú segédprogram az Azure IoT monitorozásához és kezeléséhez. Ha a Raspberry Pi-t használja fejlesztési platformként, javasoljuk, hogy telepítse az IoT Explorert egy másik számítógépre. Ha nem szeretné telepíteni az IoT Explorert, az Azure CLI-vel is elvégezheti ugyanezeket a lépéseket.
  • Azure CLI. Ebben a rövid útmutatóban két lehetősége van az Azure CLI-parancsok futtatására:
    • Használja az Azure Cloud Shell interaktív felületet, amely parancssori felületi parancsokat futtat a böngészőben. Ez a beállítás azért ajánlott, mert nem kell semmit telepítenie. Ha először használ Cloud Shell, jelentkezzen be a Azure Portal. Kövesse Cloud Shell rövid útmutató lépéseit a Start Cloud Shell és a Bash-környezet kiválasztásához.
    • Igény szerint futtassa az Azure CLI-t a helyi gépen. Ha az Azure CLI már telepítve van, futtassa a parancsot az upgrade a parancssori felület és a bővítmények aktuális verzióra való frissítéséhez. Az Azure CLI telepítéséhez lásd: Az Azure CLI telepítése. Ha a Raspberry Pi-t használja fejlesztési platformként, javasoljuk, hogy használja az Azure Cloud Shell vagy telepítse az Azure CLI-t egy másik számítógépre.

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.

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

  1. Indítsa el az Azure CLI-t:

    • Ha Cloud Shell használ, válassza a CLI-parancsok Kipróbálás gombját Cloud Shell egy osztott böngészőablakban való elindításához. Vagy megnyithatja a Cloud Shell egy külön böngészőlapon.
    • Ha helyileg használja az Azure CLI-t, nyisson meg egy konzolt, például a Windows CMD-t, a PowerShellt vagy a Basht, és jelentkezzen be az Azure CLI-be.

    A parancssori felület parancsainak futtatásához a rövid útmutató további részében: másolja ki a parancs szintaxisát, illessze be a Cloud Shell ablakba vagy a CLI-konzolba, szerkessze a változóértékeket, és nyomja le az Enter billentyűt.

  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. 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 az oktatóanyag 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 {YourIoTHubName}
    

    Tipp

    Az IoT Hub létrehozása után az Azure IoT Explorer használatával kezelheti az IoT Hubot a rövid útmutató további részében. Az IoT Explorer egy grafikus felhasználói felületi alkalmazás, amellyel csatlakozhat egy meglévő IoT Hub és eszközöket vehet fel, kezelhet és figyelhet. További információ: Az Azure IoT Explorer telepítése és használata. Ha szeretné, továbbra is használhatja a CLI-parancsokat.

Az IoT Explorer konfigurálása

A rövid útmutató további részében az IoT Explorerrel regisztrálhat egy eszközt az IoT Hubon, és megtekintheti az eszköz telemetriáját. Ebben a szakaszban úgy konfigurálja az IoT Explorert, hogy csatlakozzon az imént létrehozott IoT Hubhoz, és olvassa be a plug and play modelleket a nyilvános modell adattárából.

Megjegyzés

Az Azure CLI-vel is regisztrálhat eszközöket. Az az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} paranccsal regisztráljon egy új eszközt, és az az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} paranccsal kérje le az eszköz elsődleges kapcsolati sztring. Miután feljegyezte az eszköz kapcsolati sztring, továbbléphet az Eszközminta futtatása elemre.

Kapcsolat hozzáadása az IoT Hubhoz:

  1. Futtassa az az iot hub connection-string show parancsot az IoT Hub kapcsolati sztring lekéréséhez.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Másolja a kapcsolati sztring a környező idézőjelek nélkül.

  3. Az Azure IoT Explorerben válassza az IoT Hubs elemet a bal oldali menüben, majd válassza a + Kapcsolat hozzáadása lehetőséget.

  4. Illessze be a kapcsolati sztring a Kapcsolati sztring mezőbe.

  5. Kattintson a Mentés gombra.

    Képernyőkép kapcsolat hozzáadásáról az IoT Explorerben

  6. Ha a kapcsolat sikeres, az IoT Explorer átvált az Eszközök nézetre.

A nyilvános modell adattárának hozzáadása:

  1. Az IoT Explorerben válassza a Kezdőlap lehetőséget a kezdőlap nézethez való visszatéréshez.

  2. A bal oldali menüben válassza az IoT Plug and Play Beállítások, majd a +Hozzáadás lehetőséget, majd a legördülő menüBen válassza a Nyilvános adattár lehetőséget.

  3. Megjelenik egy bejegyzés a nyilvános modell adattárához a következő helyen: https://devicemodels.azure.com.

    Képernyőkép a nyilvános modelladattár hozzáadásáról az IoT Explorerben

  4. Kattintson a Mentés gombra.

Eszköz regisztrálása

Ebben a szakaszban létrehoz egy új eszközpéldányt, és regisztrálja azt a létrehozott IoT Hubon. Az újonnan regisztrált eszköz kapcsolati adataival biztonságosan csatlakoztathatja az eszközt egy későbbi szakaszban.

Eszköz regisztrálása:

  1. Az IoT Explorer kezdőlap nézetében válassza az IoT Hubs lehetőséget.

  2. A korábban hozzáadott kapcsolatnak meg kell jelennie. Válassza az Eszközök megtekintése ebben a központban lehetőséget a kapcsolat tulajdonságai alatt.

  3. Válassza az + Új lehetőséget, és adja meg az eszköz eszközazonosítóját; például mydevice. Az összes többi tulajdonságot hagyja változatlanul.

  4. Válassza a Létrehozás lehetőséget.

    Képernyőkép az Azure IoT Explorer eszközidentitásáról

  5. A másolási gombokkal másolja és jegyezze fel az Elsődleges kapcsolati sztring mezőt. Erre a kapcsolati sztring később lesz szüksége.

Az eszközminta futtatása

Ebben a szakaszban a Python SDK használatával küld üzeneteket egy eszközről az IoT Hubra. Egy olyan mintát fog futtatni, amely egy hőmérséklet-vezérlőt implementál két termosztát-érzékelővel.

  1. Nyisson meg egy új konzolt, például a Windows CMD-t, a PowerShellt vagy a Basht. A következő lépésekben ezt a konzolt fogja használni a Python SDK telepítéséhez és a Python-mintakód használatához.

    Megjegyzés

    Ha az Azure CLI helyi telepítését használja, előfordulhat, hogy két konzolablak van megnyitva. Ügyeljen arra, hogy az imént megnyitott konzolon adja meg az ebben a szakaszban található parancsokat, ne azt, amelyet a parancssori felülethez használt.

  2. Klónozza az Azure IoT Python SDK-eszközmintákat a helyi gépre:

    git clone https://github.com/Azure/azure-iot-sdk-python
    
  3. Navigáljon a mintakönyvtárhoz:

    Windows

    cd azure-iot-sdk-python\azure-iot-device\samples\pnp
    

    Linux vagy Raspberry Pi OS

    cd azure-iot-sdk-python/azure-iot-device/samples/pnp
    
  4. Telepítse az Azure IoT Python SDK-t:

    pip3 install azure-iot-device
    
  5. Állítsa be a következő környezeti változókat, hogy az eszköz kapcsolódhasson az Azure IoT-hez.

    • Állítson be egy nevű környezeti változót IOTHUB_DEVICE_CONNECTION_STRING. A változó értékeként használja az előző szakaszban mentett eszköz kapcsolati sztring.
    • Állítson be egy nevű környezeti változót IOTHUB_DEVICE_SECURITY_TYPE. A változóhoz használja a literális sztringértéket connectionString.

    CMD (Windows)

    set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
    set IOTHUB_DEVICE_SECURITY_TYPE=connectionString
    

    Megjegyzés

    A Windows CMD esetében nincsenek idézőjelek az egyes változók sztringértékei körül.

    PowerShell

    $env:IOTHUB_DEVICE_CONNECTION_STRING='<your connection string here>'
    $env:IOTHUB_DEVICE_SECURITY_TYPE='connectionString'
    

    Bash

    export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
    export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"
    
  6. Futtassa a következő mintafájl kódját.

    python3 temp_controller_with_thermostats.py
    

    Megjegyzés

    Ez a kódminta azure IoT-Plug and Play használ, amely lehetővé teszi az intelligens eszközök manuális konfigurálás nélküli integrálását a megoldásokba. Alapértelmezés szerint a dokumentációban szereplő legtöbb minta IoT-Plug and Play használ. Az IoT-Plug and Play előnyeiről és a használatukra vonatkozó esetekről a Mi az IoT Plug and Play? című témakörben olvashat bővebben.

A minta biztonságosan csatlakozik az IoT Hubhoz a regisztrált eszközként, és elkezd telemetriai üzeneteket küldeni. A mintakimenet megjelenik a konzolon.

Telemetria megtekintése

Az eszköz telemetriáját az IoT Explorerrel tekintheti meg. A telemetriai adatokat az Azure CLI használatával is megtekintheti.

Telemetria megtekintése az Azure IoT Explorerben:

  1. Az IoT Explorer Iot Hubjában válassza az Eszközök megtekintése ebben a központban lehetőséget, majd válassza ki az eszközt a listából.

  2. Az eszköz bal oldali menüjében válassza a Telemetria lehetőséget.

  3. Győződjön meg arról, hogy a Beépített eseményközpont használatabeállítás igen értékre van állítva, majd válassza a Start lehetőséget.

  4. Tekintse meg a telemetriát, amikor az eszköz üzeneteket küld a felhőbe.

    Az IoT Explorer eszköztelemetria képernyőképe

  5. Válassza a Leállítás lehetőséget az események fogadásának befejezéséhez.

Az egyes eszközösszetevők által küldött telemetriai adatok olvasásához használhatja az IoT Explorer beépülő és lejátszási funkcióit. Ebben a rövid útmutatóban például a hőmérséklet-vezérlő két termosztáttal rendelkezik: termosztát1 és termosztát2. A termosztát által jelentett hőmérséklet megtekintése1:

  1. Az IoT Explorer eszközén válassza az IoT Plug and Play összetevők lehetőséget a bal oldali menüben. Ezután válassza a termosztát1 elemet az összetevők listájából.

  2. A termosztát1 összetevő paneljén válassza a Telemetria lehetőséget a felső menüben.

  3. A Telemetriai panelen kövesse a korábban végrehajtott lépéseket. Győződjön meg arról, hogy a Beépített eseményközpont használatabeállítás Igen értékre van állítva, majd válassza a Start lehetőséget.

Eszköztelemetria megtekintése az Azure CLI-vel:

  1. Futtassa az az iot hub monitor-events parancsot az eszközről az IoT Hubra küldött események monitorozásához. Használja az eszközhöz és az IoT Hubhoz korábban létrehozott neveket az Azure IoT-ben.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Tekintse meg a kapcsolat részleteit és a telemetriai kimenetet a konzolon.

    Starting event monitor, filtering on device: mydevice, use ctrl-c to stop...
    event:
      component: thermostat1
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 29
    
    event:
      component: thermostat2
      interface: dtmi:com:example:TemperatureController;2
      module: ''
      origin: mydevice
      payload:
        temperature: 48
    

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

Ha már nincs szüksége az ebben a rövid útmutatóban létrehozott Azure-erőforrásokra, az Azure CLI használatával törölheti őket.

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.

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

  1. Futtassa az az group delete parancsot. Ez a parancs eltávolítja az erőforráscsoportot, a IoT Hub és a létrehozott eszközregisztrációt.

    az group delete --name MyResourceGroup
    
  2. Futtassa az az group list parancsot az erőforráscsoport törlésének megerősítéséhez.

    az group list
    

Következő lépések

Ebben a rövid útmutatóban megismerkedett egy alapszintű Azure IoT-alkalmazás-munkafolyamattal, amellyel biztonságosan csatlakoztathat egy eszközt a felhőhöz, és eszközről felhőbe irányuló telemetriát küldhet. Az Azure CLI-vel létrehozott egy Azure IoT Hubot és egy eszközpéldányt. Ezután egy Azure IoT-eszköz SDK-val létrehozott egy hőmérsékletvezérlőt, csatlakoztatta a központhoz, és telemetriát küldött. Az Azure CLI-t is használta a telemetriai adatok monitorozásához.

Következő lépésként tekintse át az alábbi cikkeket, amelyekből többet is megtudhat az eszközmegoldások Azure IoT-vel történő kiépítéséről.