Mulai Cepat: Mengontrol perangkat yang tersambung ke IoT Hub

Dalam mulai cepat ini, Anda menggunakan metode langsung untuk mengontrol perangkat yang disimulasikan yang tersambung ke Azure IoT Hub Anda. IoT Hub adalah layanan Azure yang memungkinkan Anda mengelola perangkat IoT Anda dari cloud dan menyerap telemetri perangkat dalam volume tinggi ke cloud untuk penyimpanan atau pemrosesan. Anda dapat menggunakan metode langsung untuk mengubah perilaku perangkat yang terhubung ke hub IoT Anda dari jarak jauh.

Mulai cepat menggunakan dua aplikasi .NET yang telah ditulis sebelumnya:

  • Aplikasi perangkat yang disimulasikan yang merespons metode langsung yang dipanggil dari aplikasi layanan. Untuk menerima panggilan metode langsung, aplikasi ini tersambung ke titik akhir khusus perangkat pada Azure IoT Hub Anda.

  • Aplikasi layanan yang memanggil metode langsung pada perangkat yang disimulasikan. Untuk memanggil metode langsung pada perangkat, aplikasi ini terhubung ke titik akhir sisi layanan pada Azure IoT Hub Anda.

Prasyarat

  • Akun Azure dengan langganan aktif. Buat akun gratis.

  • Dua aplikasi sampel yang Anda jalankan dalam mulai cepat ini ditulis menggunakan C#. Anda memerlukan .NET SDK 6.0 atau yang lebih baru di komputer pengembangan Anda.

    Anda dapat mengunduh .NET Core SDK untuk beberapa platform dari .NET.

    Anda dapat memverifikasi versi C# saat ini pada komputer pengembangan Anda menggunakan perintah berikut:

    dotnet --version
    
  • Kloning atau unduh sampel Azure IoT C# dari GitHub.

  • Pastikan port 8883 terbuka di firewall Anda. Sampel perangkat dalam mulai cepat ini menggunakan protokol MQTT, yang berkomunikasi melalui port 8883. Port ini mungkin diblokir di beberapa lingkungan jaringan perusahaan dan pendidikan. Untuk informasi selengkapnya dan cara mengatasi masalah ini, lihat Menyambungkan ke Azure IoT Hub (MQTT).

Catatan

Artikel ini menggunakan versi terbaru ekstensi Azure IoT, yang disebut azure-iot. Versi warisan disebut azure-cli-iot-ext. Anda seharusnya hanya memiliki satu versi yang terinstal pada satu waktu. Anda bisa menggunakan perintah az extension list untuk memvalidasi ekstensi yang saat ini terinstal.

Gunakan az extension remove --name azure-cli-iot-ext untuk menghapus versi lama ekstensi.

Gunakan az extension add --name azure-iot untuk menambahkan versi baru ekstensi.

Untuk melihat ekstensi apa yang telah Anda instal, gunakan az extension list.

Membuat hub IoT

Di bagian ini, Anda menggunakan Azure CLI untuk membuat hub IoT dan grup sumber daya. Grup sumber daya Azure adalah kontainer logis yang disebarkan dan dikelola sumber daya Azure. Hub IoT bertindak sebagai hub pesan pusat untuk komunikasi dua arah antara aplikasi IoT Anda dan perangkat.

Jika sudah memiliki IoT hub di langganan Azure, Anda dapat melewati bagian ini.

Untuk membuat hub IoT dan grup sumber daya:

  1. Luncurkan aplikasi CLI Anda. Untuk menjalankan perintah CLI di sisa mulai cepat ini, salin sintaks perintah, tempelkan ke aplikasi CLI Anda, edit nilai variabel, dan tekan Enter.

    • Jika Anda menggunakan Cloud Shell, pilih tombol Cobalah pada perintah CLI untuk meluncurkan Cloud Shell di jendela browser terpisah. Atau Anda dapat membuka Cloud Shell di tab browser terpisah.
    • Jika Anda menggunakan Azure CLI secara lokal, buka aplikasi konsol CLI Anda dan masuk ke Azure CLI.
  2. Jalankan az extension add untuk menginstal atau meningkatkan ekstensi azure-iot ke versi saat ini.

    az extension add --upgrade --name azure-iot
    
  3. Di aplikasi CLI Anda, jalankan perintah az group create untuk membuat grup sumber daya. Perintah berikut membuat grup sumber daya bernama MyResourceGroup di lokasi eastus.

    Catatan

    Secara opsional, Anda dapat mengatur lokasi yang berbeda. Untuk melihat lokasi yang tersedia, jalankan az account list-locations. Mulai cepat ini menggunakan eastus seperti yang ditunjukkan dalam perintah contoh.

    az group create --name MyResourceGroup --location eastus
    
  4. Jalankan perintah az iot hub create untuk membuat IoT hub. Mungkin perlu waktu beberapa menit untuk membuat hub IoT.

    YourIotHubName. Ganti tempat penampung ini dan kurung kurawal di sekitarnya dalam perintah berikut, menggunakan nama yang Anda pilih untuk hub IoT Anda. Nama hub IoT harus unik secara global di Azure. Gunakan nama hub IoT Anda di sisa mulai cepat ini di mana pun Anda melihat tempat penampung.

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

    Tip

    Setelah membuat hub IoT, di sisa mulai cepat ini Anda dapat terus menggunakan perintah CLI untuk berinteraksi dengan hub. Anda juga dapat memilih untuk menggunakan Azure IoT Explorer sebagai pengganti perintah CLI. IoT Explorer adalah aplikasi GUI yang memungkinkan Anda terhubung ke Azure IoT Hub yang ada dan menambahkan, mengelola, dan memantau perangkat. Untuk mempelajari selengkapnya, lihat Menginstal dan menggunakan Azure IoT Explorer.

Mendaftarkan perangkat

Perangkat harus terdaftar di Azure IoT Hub Anda sebelum dapat tersambung. Dalam bagian ini, Anda menggunakan Azure CLI untuk membuat identitas perangkat.

Jika sudah memiliki perangkat yang terdaftar di IoT hub, Anda dapat melewati bagian ini.

Untuk membuat identitas perangkat:

  1. Jalankan perintah az iot hub device-identity create di shell CLI Anda. Ini menciptakan identitas perangkat.

    YourIotHubName. Ganti tempat penampung di bawah ini dengan nama yang Anda pilih untuk hub IoT Anda.

    myDevice. Anda dapat menggunakan nama ini secara langsung untuk ID perangkat di sisa mulai cepat ini. Anda juga dapat menggunakan nama yang berbeda.

    az iot hub device-identity create --device-id myDevice --hub-name {YourIoTHubName} 
    
  2. Jalankan perintah az iot hub device-identity connection-string show.

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

    Output string koneksi menggunakan format berikut:

    HostName=<your IoT Hub name>.azure-devices.net;DeviceId=<your device id>;SharedAccessKey=<some value>
    
  3. Simpan string koneksi di lokasi yang aman.

Catatan

Biarkan aplikasi CLI Anda tetap terbuka. Anda akan menggunakannya di langkah-langkah selanjutnya.

Mengambil string koneksi layanan

Anda juga memerlukan string koneksi layanan IoT Hub Anda untuk mengaktifkan aplikasi layanan agar tersambung ke hub dan mengambil pesan. String koneksi layanan adalah untuk IoT hub Anda secara keseluruhan, dan berbeda dari string koneksi perangkat yang Anda ambil di bagian sebelumnya.

Perintah berikut mengambil string koneksi layanan untuk Azure IoT Hub Anda:

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

Catat string koneksi layanan, yang terlihat seperti:

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

Anda menggunakan nilai ini nanti di mulai cepat.

Menyimulasikan perangkat

Aplikasi perangkat yang disimulasikan tersambung ke titik akhir khusus perangkat di hub IoT Anda, mengirim telemetri yang disimulasikan, dan mendengarkan panggilan metode langsung dari hub Anda. Dalam mulai cepat ini, panggilan metode langsung dari hub memberi tahu perangkat untuk mengubah interval pengiriman telemetri. Perangkat yang disimulasikan mengirim pengakuan kembali ke hub Anda setelah menjalankan metode langsung.

  1. Di jendela terminal lokal, navigasikan ke folder akar dari contoh proyek C#. Kemudian, buka folder iot-hub\Quickstarts\SimulatedDeviceWithCommand.

  2. Jalankan perintah berikut untuk menginstal paket yang diperlukan untuk aplikasi perangkat yang disimulasikan:

    dotnet restore
    
  3. Jalankan perintah berikut untuk membangun dan menjalankan aplikasi perangkat yang disimulasikan.

    {DeviceConnectionString}: Ganti tempat penampung ini dengan string koneksi perangkat yang Anda catat sebelumnya.

    dotnet run -- "{DeviceConnectionString}"
    

    Cuplikan layar berikut menunjukkan output saat aplikasi perangkat simulasi mengirim telemetri ke hub IoT Anda:

    Run the simulated device

Panggil metode langsung

Aplikasi layanan terhubung ke titik akhir sisi layanan di Azure IoT Hub Anda. Aplikasi ini melakukan panggilan metode langsung ke perangkat melalui Azure IoT Hub Anda dan mendengarkan pengakuan. Aplikasi layanan Azure IoT Hub biasanya berjalan di cloud.

  1. Di jendela terminal lokal lain, navigasikan ke folder akar dari contoh proyek C#. Kemudian, buka folder iot-hub\Quickstarts\InvokeDeviceMethod.

  2. Di jendela terminal lokal, jalankan perintah berikut untuk memasang pustaka yang diperlukan untuk aplikasi layanan:

    dotnet build
    
  3. Di jendela terminal lokal, jalankan perintah berikut untuk membangun dan menjalankan aplikasi layanan.

    {ServiceConnectionString}: Ganti tempat penampung ini dengan string koneksi layanan IoT Hub yang Anda catat sebelumnya.

    {DeviceName}: Ganti placeholder ini dengan nama perangkat yang Anda daftarkan.

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

    Cuplikan layar berikut menunjukkan output saat aplikasi melakukan panggilan metode langsung ke perangkat dan menerima pengakuan:

    Run the service application

    Setelah menjalankan aplikasi layanan, Anda akan melihat pesan di jendela konsol yang menjalankan perangkat yang disimulasikan, dan laju perubahan pengiriman pesan:

    Change in simulated client

Mulai cepat ini menggunakan dua aplikasi Java:

  • Aplikasi perangkat yang disimulasikan dan merespons metode langsung yang dipanggil dari aplikasi back-end.
  • Aplikasi layanan yang memanggil metode langsung pada perangkat yang disimulasikan.

Prasyarat

  • Akun Azure dengan langganan aktif. Membuat satu akun gratis.

  • Java SE Development Kit 8. Dalam Dukungan jangka panjang Java untuk Azure dan Azure Stack, pada bagian Dukungan jangka panjang, pilih Java 8.

    Anda dapat memverifikasi versi Java saat ini di komputer pengembangan Anda menggunakan perintah berikut:

    java -version
    
  • Apache Maven 3.

    Anda dapat memverifikasi versi Maven saat ini pada komputer pengembangan Anda menggunakan perintah berikut:

    mvn --version
    
  • Kloning atau unduh sampel Azure IoT Java dari GitHub.

  • Pastikan port 8883 terbuka di firewall Anda. Sampel perangkat dalam mulai cepat ini menggunakan protokol MQTT, yang berkomunikasi melalui port 8883. Port ini mungkin diblokir di beberapa lingkungan jaringan perusahaan dan pendidikan. Untuk informasi selengkapnya dan cara mengatasi masalah ini, lihat Menyambungkan ke Azure IoT Hub (MQTT).

Catatan

Artikel ini menggunakan versi terbaru ekstensi Azure IoT, yang disebut azure-iot. Versi warisan disebut azure-cli-iot-ext. Anda seharusnya hanya memiliki satu versi yang terinstal pada satu waktu. Anda bisa menggunakan perintah az extension list untuk memvalidasi ekstensi yang saat ini terinstal.

Gunakan az extension remove --name azure-cli-iot-ext untuk menghapus versi lama ekstensi.

Gunakan az extension add --name azure-iot untuk menambahkan versi baru ekstensi.

Untuk melihat ekstensi apa yang telah Anda instal, gunakan az extension list.

Membuat hub IoT

Di bagian ini, Anda menggunakan Azure CLI untuk membuat hub IoT dan grup sumber daya. Grup sumber daya Azure adalah kontainer logis yang disebarkan dan dikelola sumber daya Azure. Hub IoT bertindak sebagai hub pesan pusat untuk komunikasi dua arah antara aplikasi IoT Anda dan perangkat.

Jika sudah memiliki IoT hub di langganan Azure, Anda dapat melewati bagian ini.

Untuk membuat hub IoT dan grup sumber daya:

  1. Luncurkan aplikasi CLI Anda. Untuk menjalankan perintah CLI di sisa mulai cepat ini, salin sintaks perintah, tempelkan ke aplikasi CLI Anda, edit nilai variabel, dan tekan Enter.

    • Jika Anda menggunakan Cloud Shell, pilih tombol Cobalah pada perintah CLI untuk meluncurkan Cloud Shell di jendela browser terpisah. Atau Anda dapat membuka Cloud Shell di tab browser terpisah.
    • Jika Anda menggunakan Azure CLI secara lokal, buka aplikasi konsol CLI Anda dan masuk ke Azure CLI.
  2. Jalankan az extension add untuk menginstal atau meningkatkan ekstensi azure-iot ke versi saat ini.

    az extension add --upgrade --name azure-iot
    
  3. Di aplikasi CLI Anda, jalankan perintah az group create untuk membuat grup sumber daya. Perintah berikut membuat grup sumber daya bernama MyResourceGroup di lokasi eastus.

    Catatan

    Secara opsional, Anda dapat mengatur lokasi yang berbeda. Untuk melihat lokasi yang tersedia, jalankan az account list-locations.

    az group create --name MyResourceGroup --location eastus
    
  4. Jalankan perintah az iot hub create untuk membuat IoT hub. Mungkin perlu waktu beberapa menit untuk membuat hub IoT.

    YourIotHubName. Ganti tempat penampung ini dan kurung kurawal di sekitarnya dalam perintah berikut, menggunakan nama yang Anda pilih untuk hub IoT Anda. Nama hub IoT harus unik secara global di Azure. Gunakan nama hub IoT Anda di sisa mulai cepat ini di mana pun Anda melihat tempat penampung.

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

Mendaftarkan perangkat

Perangkat harus terdaftar di Azure IoT Hub Anda sebelum dapat tersambung. Dalam mulai cepat ini, Anda menggunakan Azure Cloud Shell untuk membuat identitas perangkat.

Jika sudah memiliki perangkat yang terdaftar di IoT hub, Anda dapat melewati bagian ini.

  1. Jalankan perintah az iot hub device-identity create di Azure Cloud Shell untuk membuat identitas perangkat.

    YourIoTHubName: Ganti placeholder di bawah dengan nama yang Anda pilih untuk Azure IoT Hub Anda.

    MyJavaDevice: Ini adalah nama perangkat yang Anda daftarkan. Sebaiknya gunakan MyJavaDevice seperti yang ditunjukkan. Jika Anda memilih nama yang berbeda untuk perangkat, Anda juga harus menggunakan nama tersebut di seluruh artikel ini dan memperbarui nama perangkat di aplikasi contoh sebelum menjalankannya.

    az iot hub device-identity create \
      --hub-name {YourIoTHubName} --device-id MyJavaDevice
    
  2. Jalankan perintah az iot hub device-identity connection-string show di Azure Cloud Shell untuk mendapatkan string koneksi perangkat bagi perangkat yang Anda daftarkan:

    YourIoTHubName: Ganti tempat penampung di bawah ini dengan nama yang Anda pilih untuk Azure IoT Hub Anda.

    az iot hub device-identity connection-string show\
      --hub-name {YourIoTHubName} \
      --device-id MyJavaDevice \
      --output table
    

    Catat string koneksi perangkat, yang terlihat seperti:

    HostName={YourIoTHubName}.azure-devices.net;DeviceId=MyNodeDevice;SharedAccessKey={YourSharedAccessKey}

    Anda menggunakan nilai ini nanti di mulai cepat.

Mengambil string koneksi layanan

Anda juga memerlukan string koneksi layanan untuk mengaktifkan aplikasi ujung belakang untuk tersambung ke IoT Hub Anda dan mengambil pesan. Perintah berikut mengambil string koneksi layanan untuk hub IoT Anda:

YourIoTHubName: Ganti placeholder di bawah dengan nama yang Anda pilih untuk Azure IoT Hub Anda.

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

Catat string koneksi layanan, yang terlihat seperti:

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

Anda menggunakan nilai ini nanti di mulai cepat. String koneksi layanan ini berbeda dari string koneksi perangkat yang Anda catat di langkah sebelumnya.

Menyimulasikan perangkat

Aplikasi perangkat yang disimulasikan tersambung ke titik akhir khusus perangkat di hub IoT Anda, mengirim telemetri yang disimulasikan, dan mendengarkan panggilan metode langsung dari hub Anda. Dalam mulai cepat ini, panggilan metode langsung dari hub memberi tahu perangkat untuk mengubah interval pengiriman telemetri. Perangkat yang disimulasikan mengirim pengakuan kembali ke hub Anda setelah menjalankan metode langsung.

  1. Di jendela terminal lokal, buka folder akar dari sampel proyek Java. Kemudian, buka folder iot-hub\Quickstarts\simulated-device-2.

  2. Buka file src/main/java/com/microsoft/docs/iothub/samples/SimulatedDevice.java dalam editor teks pilihan Anda.

    Ganti nilai variabel connString dengan string koneksi perangkat yang Anda catat sebelumnya. Kemudian, simpan perubahan Anda ke SimulatedDevice.java.

  3. Di jendela terminal lokal, jalankan perintah berikut untuk memasang pustaka yang diperlukan dan membangun aplikasi perangkat yang disimulasikan:

    mvn clean package
    
  4. Di jendela terminal lokal, jalankan perintah berikut untuk menjalankan aplikasi perangkat yang disimulasikan:

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

    Cuplikan layar berikut menunjukkan output saat aplikasi perangkat yang disimulasikan mengirimkan telemetri ke IoT hub:

    Output from the telemetry sent by the device to your IoT hub

Memanggil metode langsung

Aplikasi terbelakang tersambung ke titik akhir sisi layanan di IoT Hub Anda. Aplikasi membuat panggilan metode langsung ke perangkat melalui hub IoT Anda dan mendengarkan pengakuan. Aplikasi ujung belakang IoT Hub biasanya berjalan di cloud.

  1. Di jendela terminal lokal, buka folder akar dari sampel proyek Java. Kemudian, buka folder iot-hub\Quickstarts\back-end-application.

  2. Buka file src/main/java/com/microsoft/docs/iothub/samples/BackEndApplication.java dalam editor teks pilihan Anda.

    Ganti nilai variabel iotHubConnectionString dengan string koneksi layanan yang Anda catat sebelumnya. Kemudian, simpan perubahan Anda ke BackEndApplication.java.

  3. Di jendela terminal lokal, jalankan perintah berikut untuk memasang pustaka yang diperlukan dan membangun aplikasi ujung belakang:

    mvn clean package
    
  4. Di jendela terminal lokal, jalankan perintah berikut untuk menjalankan aplikasi ujung belakang:

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

    Cuplikan layar berikut menunjukkan output saat aplikasi melakukan panggilan metode langsung ke perangkat dan menerima pengakuan:

    Output as the application makes a direct method call through your IoT hub

    Setelah Anda menjalankan aplikasi terbelakang, Anda melihat pesan di jendela konsol yang menjalankan perangkat yang disimulasikan, dan kecepatan pengiriman pesan berubah:

    Console message from device shows the rate at which it changes

Mulai cepat ini menggunakan dua aplikasi Node.js:

  • Aplikasi perangkat yang disimulasikan dan merespons metode langsung yang dipanggil dari aplikasi back-end. Untuk menerima panggilan metode langsung, aplikasi ini tersambung ke titik akhir khusus perangkat pada Azure IoT Hub Anda.
  • Aplikasi back-end yang memanggil metode langsung pada perangkat yang disimulasikan. Untuk memanggil metode langsung pada perangkat, aplikasi ini tersambung ke titik akhir tertentu di IoT hub Anda.

Prasyarat

  • Akun Azure dengan langganan aktif. Buat akun gratis.

  • Node.js 12+.

    Anda dapat memverifikasi versi Node.js saat ini di komputer pengembangan Anda menggunakan perintah berikut:

    node --version
    
  • Kloning atau unduh sampel Azure IoT Node.js dari GitHub.

  • Pastikan port 8883 terbuka di firewall Anda. Sampel perangkat dalam mulai cepat ini menggunakan protokol MQTT, yang berkomunikasi melalui port 8883. Port ini mungkin diblokir di beberapa lingkungan jaringan perusahaan dan pendidikan. Untuk informasi selengkapnya dan cara mengatasi masalah ini, lihat Menyambungkan ke Azure IoT Hub (MQTT).

Catatan

Artikel ini menggunakan versi terbaru ekstensi Azure IoT, yang disebut azure-iot. Versi warisan disebut azure-cli-iot-ext. Anda seharusnya hanya memiliki satu versi yang terinstal pada satu waktu. Anda bisa menggunakan perintah az extension list untuk memvalidasi ekstensi yang saat ini terinstal.

Gunakan az extension remove --name azure-cli-iot-ext untuk menghapus versi lama ekstensi.

Gunakan az extension add --name azure-iot untuk menambahkan versi baru ekstensi.

Untuk melihat ekstensi apa yang telah Anda instal, gunakan az extension list.

Membuat hub IoT

Di bagian ini, Anda menggunakan Azure CLI untuk membuat hub IoT dan grup sumber daya. Grup sumber daya Azure adalah kontainer logis yang disebarkan dan dikelola sumber daya Azure. Hub IoT bertindak sebagai hub pesan pusat untuk komunikasi dua arah antara aplikasi IoT Anda dan perangkat.

Jika sudah memiliki IoT hub di langganan Azure, Anda dapat melewati bagian ini.

Untuk membuat hub IoT dan grup sumber daya:

  1. Luncurkan aplikasi CLI Anda. Untuk menjalankan perintah CLI di sisa mulai cepat ini, salin sintaks perintah, tempelkan ke aplikasi CLI Anda, edit nilai variabel, dan tekan Enter.

    • Jika Anda menggunakan Cloud Shell, pilih tombol Cobalah pada perintah CLI untuk meluncurkan Cloud Shell di jendela browser terpisah. Atau Anda dapat membuka Cloud Shell di tab browser terpisah.
    • Jika Anda menggunakan Azure CLI secara lokal, buka aplikasi konsol CLI Anda dan masuk ke Azure CLI.
  2. Jalankan az extension add untuk menginstal atau meningkatkan ekstensi azure-iot ke versi saat ini.

    az extension add --upgrade --name azure-iot
    
  3. Di aplikasi CLI Anda, jalankan perintah az group create untuk membuat grup sumber daya. Perintah berikut membuat grup sumber daya bernama MyResourceGroup di lokasi eastus.

    Catatan

    Secara opsional, Anda dapat mengatur lokasi yang berbeda. Untuk melihat lokasi yang tersedia, jalankan az account list-locations.

    az group create --name MyResourceGroup --location eastus
    
  4. Jalankan perintah az iot hub create untuk membuat IoT hub. Mungkin perlu waktu beberapa menit untuk membuat hub IoT.

    YourIotHubName. Ganti tempat penampung ini dan kurung kurawal di sekitarnya dalam perintah berikut, menggunakan nama yang Anda pilih untuk hub IoT Anda. Nama hub IoT harus unik secara global di Azure. Gunakan nama hub IoT Anda di sisa mulai cepat ini di mana pun Anda melihat tempat penampung.

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

Mendaftarkan perangkat

Perangkat harus terdaftar di Azure IoT Hub Anda sebelum dapat tersambung. Dalam mulai cepat ini, Anda menggunakan Azure CLI untuk membuat identitas perangkat.

Jika sudah memiliki perangkat yang terdaftar di IoT hub, Anda dapat melewati bagian ini.

  1. Jalankan perintah az iot hub device-identity create di Azure Cloud Shell untuk membuat identitas perangkat.

    YourIoTHubName: Ganti tempat penampung di bawah ini dengan nama yang Anda pilih untuk hub IoT Anda.

    MyNodeDevice: Ini adalah nama perangkat yang Anda daftarkan. Disarankan untuk menggunakan MyNodeDevice seperti yang ditunjukkan. Jika Anda memilih nama yang berbeda untuk perangkat, Anda juga harus menggunakan nama tersebut di seluruh artikel ini, dan memperbarui nama perangkat di aplikasi contoh sebelum menjalankannya.

    az iot hub device-identity create \
      --hub-name {YourIoTHubName} --device-id MyNodeDevice
    
  2. Jalankan perintah az iot hub device-identity connection-string show di Azure Cloud Shell untuk mendapatkan string koneksi perangkat bagi perangkat yang Anda daftarkan:

    YourIoTHubName: Ganti tempat penampung di bawah ini dengan nama yang Anda pilih untuk hub IoT Anda.

    az iot hub device-identity connection-string show \
      --hub-name {YourIoTHubName} \
      --device-id MyNodeDevice \
      --output table
    

    Catat string koneksi perangkat, yang terlihat seperti:

    HostName={YourIoTHubName}.azure-devices.net;DeviceId=MyNodeDevice;SharedAccessKey={YourSharedAccessKey}

    Anda menggunakan nilai ini nanti di mulai cepat.

Mengambil string koneksi layanan

Anda juga memerlukan string koneksi layanan IoT hub untuk mengaktifkan aplikasi back-end agar tersambung ke IoT hub dan mengambil pesan. Perintah berikut mengambil string koneksi layanan untuk hub IoT Anda:

YourIoTHubName: Ganti tempat penampung di bawah ini dengan nama yang Anda pilih untuk hub IoT Anda.

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

Catat string koneksi layanan, yang terlihat seperti:

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

Anda menggunakan nilai ini nanti di mulai cepat. String koneksi layanan ini berbeda dari string koneksi perangkat yang Anda catat di langkah sebelumnya.

Menyimulasikan perangkat

Aplikasi perangkat yang disimulasikan tersambung ke titik akhir khusus perangkat di hub IoT Anda, mengirim telemetri yang disimulasikan, dan mendengarkan panggilan metode langsung dari hub Anda. Dalam mulai cepat ini, panggilan metode langsung dari hub memberi tahu perangkat untuk mengubah interval pengiriman telemetri. Perangkat yang disimulasikan mengirimkan pengakuan kembali ke hub Anda setelah menjalankan metode langsung.

  1. Di jendela terminal lokal, navigasikan ke folder akar dari sampel proyek Node.js. Kemudian navigasikan ke folder iot-hub\Quickstarts\simulated-device-2.

  2. Buka file SimulatedDevice.js di editor teks pilihan Anda.

    Ganti nilai variabel connectionString dengan string koneksi perangkat yang Anda catat sebelumnya. Kemudian simpan perubahan Anda ke SimulatedDevice.js.

  3. Di jendela terminal lokal, jalankan perintah berikut untuk menginstal pustaka yang diperlukan dan menjalankan aplikasi perangkat yang disimulasikan:

    npm install
    node SimulatedDevice.js
    

    Cuplikan layar berikut menunjukkan output saat aplikasi perangkat yang disimulasikan mengirimkan telemetri ke hub IoT Anda:

    Run the simulated device

Panggil metode langsung

Aplikasi back-end tersambung ke titik akhir sisi layanan di IoT Hub. Aplikasi membuat panggilan metode langsung ke perangkat melalui hub IoT Anda dan mendengarkan pengakuan. Aplikasi terbelakang IoT Hub biasanya berjalan di cloud.

  1. Di jendela terminal lokal lain, navigasikan ke folder akar dari sampel proyek Node.js. Kemudian buka folder iot-hub\Quickstarts\back-end-application.

  2. Buka file BackEndApplication.js di editor teks pilihan Anda.

    Ganti nilai variabel connectionString dengan string koneksi layanan yang Anda catat sebelumnya. Kemudian simpan perubahan Anda ke BackEndApplication.js.

  3. Di jendela terminal lokal, jalankan perintah berikut untuk menginstal pustaka yang diperlukan dan menjalankan aplikasi terbelakang:

    npm install
    node BackEndApplication.js
    

    Cuplikan layar berikut menunjukkan output saat aplikasi melakukan panggilan metode langsung ke perangkat dan menerima pengakuan:

    Output when the application makes direct method call to the device

    Setelah Anda menjalankan aplikasi terbelakang, Anda melihat pesan di jendela konsol yang menjalankan perangkat yang disimulasikan, dan kecepatan pengiriman pesan berubah:

    Output when there is a change in the simulated client

Mulai cepat ini menggunakan dua aplikasi Python:

  • Aplikasi perangkat yang disimulasikan dan merespons metode langsung yang dipanggil dari aplikasi back-end.
  • Aplikasi back-end yang memanggil metode langsung pada perangkat yang disimulasikan.

Prasyarat

Catatan

Artikel ini menggunakan versi terbaru ekstensi Azure IoT, yang disebut azure-iot. Versi warisan disebut azure-cli-iot-ext. Anda seharusnya hanya memiliki satu versi yang terinstal pada satu waktu. Anda bisa menggunakan perintah az extension list untuk memvalidasi ekstensi yang saat ini terinstal.

Gunakan az extension remove --name azure-cli-iot-ext untuk menghapus versi lama ekstensi.

Gunakan az extension add --name azure-iot untuk menambahkan versi baru ekstensi.

Untuk melihat ekstensi apa yang telah Anda instal, gunakan az extension list.

Membuat hub IoT

Di bagian ini, Anda menggunakan Azure CLI untuk membuat hub IoT dan grup sumber daya. Grup sumber daya Azure adalah kontainer logis yang disebarkan dan dikelola sumber daya Azure. Hub IoT bertindak sebagai hub pesan pusat untuk komunikasi dua arah antara aplikasi IoT Anda dan perangkat.

Jika sudah memiliki IoT hub di langganan Azure, Anda dapat melewati bagian ini.

Untuk membuat hub IoT dan grup sumber daya:

  1. Luncurkan aplikasi CLI Anda. Untuk menjalankan perintah CLI di sisa mulai cepat ini, salin sintaks perintah, tempelkan ke aplikasi CLI Anda, edit nilai variabel, dan tekan Enter.

    • Jika Anda menggunakan Cloud Shell, pilih tombol Cobalah pada perintah CLI untuk meluncurkan Cloud Shell di jendela browser terpisah. Atau Anda dapat membuka Cloud Shell di tab browser terpisah.
    • Jika Anda menggunakan Azure CLI secara lokal, buka aplikasi konsol CLI Anda dan masuk ke Azure CLI.
  2. Jalankan az extension add untuk menginstal atau meningkatkan ekstensi azure-iot ke versi saat ini.

    az extension add --upgrade --name azure-iot
    
  3. Di aplikasi CLI Anda, jalankan perintah az group create untuk membuat grup sumber daya. Perintah berikut membuat grup sumber daya bernama MyResourceGroup di lokasi eastus.

    Catatan

    Secara opsional, Anda dapat mengatur lokasi yang berbeda. Untuk melihat lokasi yang tersedia, jalankan az account list-locations.

    az group create --name MyResourceGroup --location eastus
    
  4. Jalankan perintah az iot hub create untuk membuat IoT hub. Mungkin perlu waktu beberapa menit untuk membuat hub IoT.

    YourIotHubName. Ganti tempat penampung ini dan kurung kurawal di sekitarnya dalam perintah berikut, menggunakan nama yang Anda pilih untuk hub IoT Anda. Nama hub IoT harus unik secara global di Azure. Gunakan nama hub IoT Anda di sisa mulai cepat ini di mana pun Anda melihat tempat penampung.

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

Mendaftarkan perangkat

Perangkat harus terdaftar di Azure IoT Hub Anda sebelum dapat tersambung. Dalam mulai cepat ini, Anda menggunakan Azure Cloud Shell untuk mendaftarkan perangkat yang disimulasikan.

Jika sudah memiliki perangkat yang terdaftar di IoT hub, Anda dapat melewati bagian ini.

  1. Jalankan perintah az iot hub device-identity create di Azure Cloud Shell untuk membuat identitas perangkat.

    YourIoTHubName: Ganti placeholder di bawah ini dengan nama yang Anda pilih untuk Azure IoT Hub Anda.

    MyPythonDevice: Ini adalah nama perangkat yang Anda daftarkan. Disarankan untuk menggunakan MyPythonDevice seperti yang ditunjukkan. Jika Anda memilih nama yang berbeda untuk perangkat, Anda juga harus menggunakan nama tersebut di seluruh artikel ini dan memperbarui nama perangkat di aplikasi sampel sebelum menjalankannya.

    az iot hub device-identity create --hub-name {YourIoTHubName} --device-id MyPythonDevice
    
  2. Jalankan perintah az iot hub device-identity connection-string show di Azure Cloud Shell untuk mendapatkan string koneksi perangkat bagi perangkat yang Anda daftarkan:

    YourIoTHubName: Ganti tempat penampung di bawah ini dengan nama yang Anda pilih untuk hub IoT Anda.

    az iot hub device-identity connection-string show --hub-name {YourIoTHubName} --device-id MyPythonDevice --output table
    

    Catat string koneksi perangkat, yang terlihat seperti:

    HostName={YourIoTHubName}.azure-devices.net;DeviceId=MyNodeDevice;SharedAccessKey={YourSharedAccessKey}

    Anda menggunakan nilai ini nanti di mulai cepat.

Mengambil string koneksi layanan

Anda juga memerlukan string koneksi layanan untuk mengaktifkan aplikasi ujung belakang untuk tersambung ke IoT Hub Anda dan mengambil pesan. Perintah berikut mengambil string koneksi layanan untuk hub IoT:

YourIoTHubName: Ganti placeholder di bawah ini dengan nama yang Anda pilih untuk Azure IoT Hub Anda.

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

Catat string koneksi layanan, yang terlihat seperti:

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

Anda menggunakan nilai ini nanti di mulai cepat. String koneksi layanan ini berbeda dari string koneksi perangkat yang Anda catat di langkah sebelumnya.

Menyimulasikan perangkat

Aplikasi perangkat yang disimulasikan tersambung ke titik akhir khusus perangkat di hub IoT Anda, mengirim telemetri yang disimulasikan, dan mendengarkan panggilan metode langsung dari hub Anda. Dalam mulai cepat ini, panggilan metode langsung dari hub memberi tahu perangkat untuk mengubah interval pengiriman telemetri. Perangkat yang disimulasikan mengirimkan pengakuan kembali ke hub setelah menjalankan metode langsung.

  1. Di jendela terminal lokal, navigasikan ke folder akar dari contoh proyek Python. Kemudian navigasikan ke folder iot-hub\Quickstarts\simulated-device-2.

  2. Buka file SimulatedDevice.js di editor teks pilihan Anda.

    Ganti nilai variabel CONNECTION_STRING dengan string koneksi perangkat yang Anda catat sebelumnya. Kemudian simpan perubahan ke SimulatedDevice.py.

  3. Di jendela terminal lokal, jalankan perintah berikut untuk menginstal pustaka yang diperlukan untuk aplikasi perangkat yang disimulasikan:

    pip install azure-iot-device
    
  4. Di jendela terminal lokal, jalankan perintah berikut untuk menjalankan aplikasi perangkat yang disimulasikan:

    python SimulatedDevice.py
    

    Cuplikan layar berikut menunjukkan output saat aplikasi perangkat yang disimulasikan mengirimkan telemetri ke IoT hub:

    Run the simulated device

Memanggil metode langsung

Aplikasi terbelakang tersambung ke titik akhir sisi layanan di IoT Hub Anda. Aplikasi membuat panggilan metode langsung ke perangkat melalui hub IoT Anda dan mendengarkan pengakuan. Aplikasi ujung belakang IoT Hub biasanya berjalan di cloud.

  1. Di jendela terminal lokal, navigasikan ke folder akar dari contoh proyek Python. Kemudian navigasikan ke folder iot-hub\Quickstarts\back-end-application.

  2. Buka file BackEndApplication.py di editor teks pilihan Anda.

    Ganti nilai variabel CONNECTION_STRING dengan string koneksi layanan yang Anda catat sebelumnya. Kemudian simpan perubahan Anda ke BackEndApplication.py.

  3. Di jendela terminal lokal, jalankan perintah berikut untuk menginstal pustaka yang diperlukan untuk aplikasi perangkat yang disimulasikan:

    pip install azure-iot-hub
    
  4. Di jendela terminal lokal, jalankan perintah berikut untuk menjalankan aplikasi ujung belakang:

    python BackEndApplication.py
    

    Cuplikan layar berikut menunjukkan output saat aplikasi melakukan panggilan metode langsung ke perangkat dan menerima pengakuan:

    Run the back-end application

    Setelah Anda menjalankan aplikasi terbelakang, Anda melihat pesan di jendela konsol yang menjalankan perangkat yang disimulasikan, dan kecepatan pengiriman pesan berubah:

    Change in simulated client

Membersihkan sumber daya

Jika Anda akan melanjutkan ke artikel yang direkomendasikan berikutnya, Anda dapat menyimpan sumber daya yang telah Anda buat dan menggunakannya kembali.

Jika tidak, Anda dapat menghapus sumber daya Azure yang dibuat di artikel ini untuk menghindari biaya.

Penting

Penghapusan grup sumber daya tidak dapat dipulihkan. Grup sumber daya dan semua sumber daya yang tercakup di dalamnya akan dihapus secara permanen. Pastikan Anda tidak menghapus grup sumber daya atau sumber daya yang salah secara tidak sengaja. Jika Anda membuat IoT Hub di dalam grup sumber daya yang ada dan berisi sumber daya yang ingin Anda simpan, hanya hapus sumber daya IoT Hub itu sendiri dan tidak perlu menghapus grup sumber daya.

Untuk menghapus grup sumber daya berdasarkan nama:

  1. Masuk ke portal Azure, lalu pilih Grup sumber daya.

  2. Di kotak teks Filter berdasarkan nama, ketik nama grup sumber daya yang berisi IoT Hub Anda.

  3. Di sebelah kanan grup sumber daya Anda dalam daftar hasil, pilih ... lalu Hapus grup sumber daya.

    Delete

  4. Anda akan diminta untuk mengonfirmasi penghapusan grup sumber daya. Ketik nama grup sumber daya Anda lagi untuk mengonfirmasi, lalu pilih Hapus. Setelah beberapa saat, grup sumber daya dan semua sumber daya di dalamnya akan dihapus.

Langkah berikutnya

Dalam mulai cepat ini, Anda memanggil metode langsung pada perangkat dari aplikasi layanan, dan merespons panggilan metode langsung dalam aplikasi perangkat yang disimulasikan.

Untuk mempelajari cara merutekan pesan perangkat ke cloud ke tujuan yang berbeda di cloud, lanjutkan ke tutorial berikutnya.