Hızlı Başlangıç: Bir IoT Tak Çalıştır cihazından Azure IoT Hub

Uygulama: Cihaz uygulaması geliştiricileri

Koda göz atın

Bu hızlı başlangıçta temel bir Azure IoT uygulama geliştirme iş akışı öğrenirsiniz. Azure CLI ve IoT Explorer'ı kullanarak bir Azure IoT hub'ı ve cihaz oluşturabilirsiniz. Ardından bir Azure IoT cihaz SDK'sı örneği kullanarak bir sıcaklık denetleyicisi simülasyonu çalıştıracak, hub'a güvenli bir şekilde bağacak ve telemetri göndereceksiniz.

Önkoşullar

Bu hızlı başlangıç Windows, Linux ve Raspberry Pi üzerinde çalışır. Aşağıdaki işletim sistemi ve cihaz sürümlerinde test edilmiştir:

  • Windows 10
  • Linux için Windows Alt Sistemi (WSL) üzerinde çalışan Ubuntu 20.04 LTS
  • Raspberry Pi 3 Model B+ üzerinde çalışan Raspberry Pi OS sürüm 10 (Raspian)

Raspberry Pi için not edildi dışındaki geliştirme makinenize aşağıdaki önkoşulları yükleyin:

  • Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir abonelik oluşturun.
  • Git .
  • Azure IoT Explorer:Azure IoT'yu izlemek ve yönetmek için platformlar arası, GUI tabanlı yardımcı program. Geliştirme platformumuz olarak Raspberry Pi kullanıyorsanız IoT Explorer'ı başka bir bilgisayara yüklemenizi öneririz. IoT Explorer'ı yüklemek istemiyorsanız, aynı adımları gerçekleştirmek için Azure CLI'ı kullanabilirsiniz.
  • Azure CLI. Bu hızlı başlangıçta Azure CLI komutlarını çalıştırmaya iki seçeneğiniz vardır:
    • Tarayıcınızda CLI Azure Cloud Shell çalışan etkileşimli bir kabuk olan Azure Cloud Shell'i kullanın. Herhangi bir şey yüklemeniz gerekmay olduğundan bu seçenek önerilir. İlk kez Cloud Shell kullanıyorsanız Azure portal. Başlangıç hızlı Cloud Shell Başlangıç ve Cloud Shell Bash ortamını seçme adımlarını izleyin.
    • İsteğe bağlı olarak, yerel makineniz üzerinde Azure CLI'sini çalıştırın. Azure CLI zaten yüklüyse, CLI ve az upgrade uzantıları geçerli sürüme yükseltmek için çalıştırın. Azure CLI'sini yüklemek için bkz. Azure CLI'sini yükleme. Geliştirme platformumuz olarak Raspberry Pi kullanıyorsanız, Azure CLI'yi başka bir Azure Cloud Shell veya yüklemenizi öneririz.

İşletim sisteminiz için kalan önkoşulları yükleyin.

Linux veya Raspberry Pi OS

Linux veya Raspberry Pi OS'de bu hızlı başlangıç işlemini tamamlamak için aşağıdaki yazılımı yükleyin:

komutunu GCC, Git, cmake ve gerekli bağımlılıkları apt-get yükleyin:

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

sürümünün cmake 2.8.12'nin üzerinde olduğunu ve GCC 4.4.7'nin üzerinde olduğunu doğrulayın.

cmake --version
gcc --version

Windows

Bu hızlı başlangıç Windows için Visual Studio 2019'a yükleyin ve C ve C++ geliştirmesi için gerekli bileşenleri ekleyin.

  1. Yeni kullanıcılar için 2019 Visual Studio (Community, Professional veya Enterprise) yükleyin. Yüklemek istediğiniz sürümü indirin ve yükleyiciyi çalıştırın.

    Not

    Mevcut 2019 Visual Studio için Başlat'ı Windows seçin, Visual Studio Yükleyicisi yazın ve yükleyiciyi çalıştırın.

  2. Yükleyici İş Yükleri sekmesinde C++ ile Masaüstü Geliştirme iş yükünü seçin.
  3. Yüklemeyi çalıştırın.

IoT hub oluşturma

Bu bölümde, bir IoT Hub 'ı ve bir kaynak grubu oluşturmak için Azure CLı 'yi kullanırsınız. Azure kaynak grubu, Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. IoT Hub 'ı, IoT uygulamanız ve cihazlarınız arasında çift yönlü iletişim için bir merkezi ileti hub 'ı görevi görür.

Bir IoT Hub 'ı ve bir kaynak grubu oluşturmak için:

  1. Azure CLı 'yı başlatın:

    • Cloud Shell kullanıyorsanız, bir bölünmüş tarayıcı penceresinde Cloud Shell başlatmak için CLı komutlarında deneyin düğmesini seçin. Ya da Cloud Shell ayrı bir tarayıcı sekmesinde açabilirsiniz.
    • azure clı 'yi yerel olarak kullanıyorsanız, Windows CMD, PowerShell veya bash gibi bir konsolu açın ve azure clı 'da oturum açın.

    Bu hızlı başlangıçtaki geri kalanında CLı komutlarını çalıştırmak için: komut sözdizimini kopyalayın, Cloud Shell pencere veya CLı konsoluna yapıştırın, değişken değerlerini düzenleyin ve ENTER tuşuna basın.

  2. Azure-IoT uzantısını yüklemek veya güncel sürüme yükseltmek için az Extension Add ' i çalıştırın.

    az extension add --upgrade --name azure-iot
    
  3. Bir kaynak grubu oluşturmak için az Group Create komutunu çalıştırın. Aşağıdaki komut eastus konumunda myresourcegroup adlı bir kaynak grubu oluşturur.

    Not

    İsteğe bağlı olarak alternatif bir konum ayarlayabilirsiniz. Kullanılabilir konumları görmek için öğesini çalıştırın az account list-locations . Bu öğretici, örnek komutta gösterildiği gibi eastus kullanır.

    az group create --name MyResourceGroup --location eastus
    
  4. IoT Hub 'ı oluşturmak için az IoT Hub Create komutunu çalıştırın. IoT Hub 'ı oluşturmak birkaç dakika sürebilir.

    Youriothubname. IoT Hub 'ınız için seçtiğiniz adı kullanarak aşağıdaki komutta yer tutucuyu ve çevreleyen ayraçları değiştirin. IoT Hub 'ı adı Azure 'da genel olarak benzersiz olmalıdır. Yer tutucusunu gördüğünüz her yerde, bu hızlı başlangıçta IoT Hub 'ınızın adını kullanın.

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

    İpucu

    IoT Hub 'ı oluşturduktan sonra, bu hızlı başlangıçtaki geri kalanında IoT Hub 'ınız ile etkileşim kurmak için Azure IoT Explorer 'ı kullanacaksınız. IoT Explorer, mevcut bir IoT Hub bağlanmanıza ve cihazları eklemenize, yönetmenize ve izlemenize olanak tanıyan bir GUI uygulamasıdır. Daha fazla bilgi için bkz. Azure IoT Explorer 'ı yüklemek ve kullanmak. İsteğe bağlı olarak, CLı komutlarını kullanmaya devam edebilirsiniz.

IoT Gezginini yapılandırma

Bu hızlı başlangıçta, IoT Hub 'ınıza bir cihaz kaydetmek ve cihaz telemetrisini görüntülemek için IoT Gezginini kullanacaksınız. Bu bölümde, IoT Gezginini yeni oluşturduğunuz IoT Hub 'ına bağlanacak ve ortak model deposundan Tak ve kullan modellerini okuyabileceğiniz şekilde yapılandırırsınız.

Not

Ayrıca, bir cihazı kaydetmek için Azure CLı 'yi de kullanabilirsiniz. Cihaza yönelik birincil bağlantı dizesini almak için yeni bir cihaz ve az IoT Hub cihazı-kimliği bağlantı- kimliği -adı {youriothubname} komutunu kaydetmek üzere az IoT Hub cihazı-kimlik Create --Device-ID cihazım--hub-Name {youriothubname} komutunu kullanın. Cihaz bağlantı dizesi ' ni ayarladıktan sonra, sanal cihazı çalıştırmayıileri atlayabilirsiniz.

IoT Hub 'ınıza bir bağlantı eklemek için:

  1. IoT Hub 'ınız için bağlantı dizesini almak için az IoT Hub Connection-String Show komutunu çalıştırın.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Bağlantı dizesini çevreleyen tırnak karakterleri olmadan kopyalayın.

  3. Azure IoT Explorer 'da, sol taraftaki menüde IoT Hub 'ları ' nı seçin ve + bağlantı ekle' yi seçin.

  4. Bağlantı dizesini bağlantı dizesi kutusuna yapıştırın.

  5. Kaydet’i seçin.

    IoT Gezgininde bağlantı ekleme ekran görüntüsü

  6. Bağlantı başarılı olursa IoT Gezgini cihazlar görünümüne geçer.

Ortak model deposunu eklemek için:

  1. IoT Gezgini ' nde giriş görünümüne geri dönmek için giriş ' i seçin.

  2. sol taraftaki menüde ıot Tak ve Kullan Ayarlar' nı seçin, ardından + ekle ' yi seçin ve açılan menüden ortak depoyu seçin.

  3. Konumundaki ortak model deposu için bir giriş görüntülenir https://devicemodels.azure.com .

    IoT Gezgini 'ne ortak model deposu ekleme ekran görüntüsü

  4. Kaydet’i seçin.

Cihaz kaydetme

Bu bölümde, yeni bir cihaz örneği oluşturup oluşturduğunuz IoT Hub 'ına kaydedersiniz. Yeni kaydedilen cihazın bağlantı bilgilerini, sanal cihazınızı daha sonraki bir bölümde güvenli bir şekilde bağlamak için kullanacaksınız.

Bir cihazı kaydetmek için:

  1. IoT Explorer 'daki giriş görünümünden IoT Hub 'ları' nı seçin.

  2. Daha önce eklediğiniz bağlantı görünmelidir. Bağlantı özelliklerinin altında Bu hub 'da cihazları görüntüle ' yi seçin.

  3. + Yeni ' yi seçin ve cihazınız için BIR cihaz kimliği girin; Örneğin, cihazmakinedir. Diğer tüm özellikleri aynı şekilde bırakın.

  4. Oluştur’u seçin.

    Azure IoT gezgin cihaz kimliğinin ekran görüntüsü

  5. Birincil bağlantı dizesi alanını kopyalamak ve bir yere dönmek için kopyalama düğmelerini kullanın. Bu bağlantı dizesine daha sonra ihtiyacınız olacak.

Simülasyon cihazı çalıştırma

Bu bölümde, sanal bir cihazdan IoT hub'ınıza ileti göndermek için C SDK'sı kullanırsınız. İki termostat algılayıcısı olan bir sıcaklık denetleyicisi uygulayan bir örnek çalıştıracak.

Örneği oluşturma

  1. Azure IoT C cihaz SDK'sı yüklemek ve kod örneğini çalıştırmak için yeni bir konsol açın. Daha Windows'yi seçin, VS 2019 için Geliştirici Komut İstemi yazın ve konsolunu açın. Linux ve Raspberry Pi OS için Bash komutları için bir terminal açın.

    Not

    Yerel bir Azure CLI yüklemesi kullanıyorsanız, artık iki konsol pencereniz açık olabilir. Cli için kullanmakta olduğunu değil, yeni açtığın konsolda bu bölümdeki komutları girmeyin.

  2. Örnek bir klasörü klonlamak istediğiniz yerel klasöre gidin.

  3. Azure IoT C cihaz SDK'sı'nızı yerel makinenize kopyalama:

    git clone https://github.com/Azure/azure-iot-sdk-c.git
    
  4. SDK'nın kök klasörüne gidin ve bağımlılıkları güncelleştirmek için aşağıdaki komutu çalıştırın:

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

    Bu işlem birkaç dakika sürer.

  5. SDK ve örnekleri oluşturmak için aşağıdaki komutları çalıştırın:

    cmake -Bcmake -Duse_prov_client=ON -Dhsm_type_symm_key=ON -Drun_e2e_tests=OFF
    cmake --build cmake
    
  6. Sanal cihazınızın Azure IoT'ye bağlanmasına olanak sağlamak için aşağıdaki ortam değişkenlerini ayarlayın.

    • adlı bir ortam değişkeni IOTHUB_DEVICE_CONNECTION_STRING ayarlayın. Değişken değeri için, önceki bölümde kaydedilen cihaz bağlantı dizesini kullanın.
    • adlı bir ortam değişkeni IOTHUB_DEVICE_SECURITY_TYPE ayarlayın. değişkeni için değişmez dize değerini connectionString kullanın.

    CMD

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

    Not

    Bu Windows CMD'de her değişkenin dize değerlerini çevreleyen tırnak işaretleri yoktur.

    Bash

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

Kodu çalıştırma

  1. Konsolunuzun uygun komutunu kullanarak örnek kodu çalıştırın.

    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
    

    Not

    Bu kod örneği, akıllı IoT Tak Çalıştır el ile yapılandırmaya gerek kalmadan çözümlerinize tümleştiren Azure IoT Tak Çalıştır'i kullanır. Varsayılan olarak, bu belgelerde yer alan örneklerin çoğu IoT Tak Çalıştır. IoT PnP'nin avantajları ve kullanmama örnekleri hakkında daha fazla bilgi edinmek için bkz. IoT PnP'nin avantajları IoT Tak Çalıştır..

Örnek, kayıtlı cihaz olarak IoT hub'ınıza güvenli bir şekilde bağlanır ve telemetri iletileri göndermeye başlar. Örnek çıkış konsolunuzun içinde görünür.

Telemetri görüntüleme

IoT Explorer ile cihaz telemetrisini görüntüebilirsiniz. İsteğe bağlı olarak, Azure CLI kullanarak telemetri görüntüabilirsiniz.

Azure IoT Explorer'da telemetri görüntülemek için:

  1. IoT Explorer'daki IoT hub'ınıza bakarak Cihazları bu hub'da görüntüle'yi ve ardından listeden cihazınızı seçin.

  2. Cihazınızın sol menüsünde Telemetri'yi seçin.

  3. Yerleşik olay hub'larını kullan seçeneğinin Evet olarak ayar olduğunu onaylayın ve Başlat'ı seçin.

  4. Cihaz buluta ileti gönderirken telemetriyi görüntüleme.

    IoT Explorer'da cihaz telemetrisini ekran görüntüsü

  5. Alma olaylarını durdurmak için Durdur'a seçin.

Tek tek cihaz bileşenleri tarafından gönderilen telemetri verileri okumak için IoT Explorer'daki tak çalıştır özelliklerini kullanabilirsiniz. Örneğin, bu hızlı başlangıçtaki sıcaklık denetleyicisinde iki termostat vardır: termostat1 ve termostat2. Termostat1 tarafından bildirilen sıcaklığı görmek için:

  1. IoT Explorer'daki cihazınızın sol IoT Tak Çalıştır bileşenleri seçin. Ardından bileşen listesinden thermostat1'i seçin.

  2. Termostat1 bileşen bölmesinde üst menüden Telemetri'yi seçin.

  3. Telemetri bölmesinde, daha önce attığımız adımların aynısını izleyin. Yerleşik olay hub'larını kullan seçeneğinin Evet olarak ayarlanmış olduğundan emin olun ve başlat'ı seçin.

Azure CLI ile cihaz telemetrisini görüntülemek için:

  1. Simülasyon cihazından IoT hub'ınıza gönderilen olayları izlemek için az iot hub monitor-events komutunu çalıştırın. Cihazınız ve IoT hub'nız için daha önce Azure IoT'de oluşturduğunuz adları kullanın.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Konsolda bağlantı ayrıntılarını ve telemetri çıktısını görüntüleme.

    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}'
    

Koda göz atın

Bu hızlı başlangıçta, temel bir Azure IoT uygulama geliştirme iş akışı öğrenirsiniz. Bir Azure IoT Hub 'ı ve bir cihaz oluşturmak için Azure CLı ve IoT gezginini kullanın. Ardından sanal bir sıcaklık denetleyicisi çalıştırmak, hub 'a güvenli bir şekilde bağlamak ve telemetri göndermek için bir Azure IoT cihaz SDK 'Sı örneği kullanırsınız.

Önkoşullar

bu hızlı başlangıç Windows, Linux ve Raspberry Pi üzerinde çalışır. Aşağıdaki işletim sistemi ve cihaz sürümleri üzerinde test edilmiştir:

  • Windows 10
  • ubuntu 20,04 lts Linux için Windows Alt Sistemi (wsl) üzerinde çalışıyor
  • Raspberry Pi 3 modelinde çalışan Raspberry PI OS sürüm 10 (Raspian) B +

Aşağıdaki önkoşulları, Raspberry PI için belirtilenler dışında geliştirme makinenize yüklersiniz:

  • Azure aboneliğiniz yoksa başlamadan önce ücretsiz olarak bir tane oluşturun .

  • Git.

  • .NET Core SDK 3,1. Yalnızca çalışma zamanını değil, .NET SDK 'yi yüklediğinizden emin olun. Makinenizde yüklü .NET SDK ve çalışma zamanının sürümünü denetlemek için öğesini çalıştırın dotnet --info .

    • Windows ve Linux için (Raspberry pı hariç), platformunuza 3,1 .NET Core SDK yüklemek için yönergeleri izleyin.
    • Raspberry PI için, SDK 'yı el ile yüklemekiçin yönergeleri izlemeniz gerekir. Bunun nedeni, .NET SDK 'nın Paket Yöneticisi yüklemelerinin yalnızca x64 mimarisi için desteklenidir.
  • Azure IoT Gezgini: Azure IoT 'yi izlemeye ve yönetmeye yönelik platformlar arası, GUI tabanlı yardımcı program. Geliştirme platformunuz olarak Raspberry PI kullanıyorsanız, IoT Explorer 'ı başka bir bilgisayara yüklemenizi öneririz. IoT Gezginini yüklemek istemiyorsanız, aynı adımları gerçekleştirmek için Azure CLı kullanabilirsiniz.

  • Azure CLI. Bu hızlı başlangıçta Azure CLı komutlarını çalıştırmak için iki seçeneğiniz vardır:

    • Tarayıcınızda CLı komutlarını çalıştıran etkileşimli bir kabuk olan Azure Cloud Shell kullanın. Her şeyi yüklemeniz gerekmiyorsa bu seçenek önerilir. Cloud Shell ilk kez kullanıyorsanız, Azure Portaloturum açın. Cloud Shell başlamak için Cloud Shell hızlı başlangıç ' daki adımları izleyin ve Bash ortamını seçin.
    • İsteğe bağlı olarak, yerel makinenizde Azure CLı 'yi çalıştırın. Azure CLı zaten yüklüyse, az upgrade CLI ve uzantıları güncel sürüme yükseltmek için ' i çalıştırın. Azure CLı 'yı yüklemek için bkz. Azure CLI 'Yi yüklemek. Geliştirme platformunuz olarak Raspberry PI kullanıyorsanız, Azure Cloud Shell kullanmanızı veya Azure CLı 'yi başka bir bilgisayara yüklemenizi öneririz.

IoT hub oluşturma

Bu bölümde, bir IoT Hub 'ı ve bir kaynak grubu oluşturmak için Azure CLı 'yi kullanırsınız. Azure kaynak grubu, Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. IoT Hub 'ı, IoT uygulamanız ve cihazlarınız arasında çift yönlü iletişim için bir merkezi ileti hub 'ı görevi görür.

Bir IoT Hub 'ı ve bir kaynak grubu oluşturmak için:

  1. Azure CLı 'yı başlatın:

    • Cloud Shell kullanıyorsanız, bir bölünmüş tarayıcı penceresinde Cloud Shell başlatmak için CLı komutlarında deneyin düğmesini seçin. Ya da Cloud Shell ayrı bir tarayıcı sekmesinde açabilirsiniz.
    • azure clı 'yi yerel olarak kullanıyorsanız, Windows CMD, PowerShell veya bash gibi bir konsolu açın ve azure clı 'da oturum açın.

    Bu hızlı başlangıçtaki geri kalanında CLı komutlarını çalıştırmak için: komut sözdizimini kopyalayın, Cloud Shell pencere veya CLı konsoluna yapıştırın, değişken değerlerini düzenleyin ve ENTER tuşuna basın.

  2. Azure-IoT uzantısını yüklemek veya güncel sürüme yükseltmek için az Extension Add ' i çalıştırın.

    az extension add --upgrade --name azure-iot
    
  3. Bir kaynak grubu oluşturmak için az Group Create komutunu çalıştırın. Aşağıdaki komut eastus konumunda myresourcegroup adlı bir kaynak grubu oluşturur.

    Not

    İsteğe bağlı olarak alternatif bir konum ayarlayabilirsiniz. Kullanılabilir konumları görmek için öğesini çalıştırın az account list-locations . Bu öğretici, örnek komutta gösterildiği gibi eastus kullanır.

    az group create --name MyResourceGroup --location eastus
    
  4. IoT Hub 'ı oluşturmak için az IoT Hub Create komutunu çalıştırın. IoT Hub 'ı oluşturmak birkaç dakika sürebilir.

    Youriothubname. IoT Hub 'ınız için seçtiğiniz adı kullanarak aşağıdaki komutta yer tutucuyu ve çevreleyen ayraçları değiştirin. IoT Hub 'ı adı Azure 'da genel olarak benzersiz olmalıdır. Yer tutucusunu gördüğünüz her yerde, bu hızlı başlangıçta IoT Hub 'ınızın adını kullanın.

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

    İpucu

    IoT Hub 'ı oluşturduktan sonra, bu hızlı başlangıçtaki geri kalanında IoT Hub 'ınız ile etkileşim kurmak için Azure IoT Explorer 'ı kullanacaksınız. IoT Explorer, mevcut bir IoT Hub bağlanmanıza ve cihazları eklemenize, yönetmenize ve izlemenize olanak tanıyan bir GUI uygulamasıdır. Daha fazla bilgi için bkz. Azure IoT Explorer 'ı yüklemek ve kullanmak. İsteğe bağlı olarak, CLı komutlarını kullanmaya devam edebilirsiniz.

IoT Gezginini yapılandırma

Bu hızlı başlangıçta, IoT Hub 'ınıza bir cihaz kaydetmek ve cihaz telemetrisini görüntülemek için IoT Gezginini kullanacaksınız. Bu bölümde, IoT Gezginini yeni oluşturduğunuz IoT Hub 'ına bağlanacak ve ortak model deposundan Tak ve kullan modellerini okuyabileceğiniz şekilde yapılandırırsınız.

Not

Ayrıca, bir cihazı kaydetmek için Azure CLı 'yi de kullanabilirsiniz. Cihaza yönelik birincil bağlantı dizesini almak için yeni bir cihaz ve az IoT Hub cihazı-kimliği bağlantı- kimliği -adı {youriothubname} komutunu kaydetmek üzere az IoT Hub cihazı-kimlik Create --Device-ID cihazım--hub-Name {youriothubname} komutunu kullanın. Cihaz bağlantı dizesi ' ni ayarladıktan sonra, sanal cihazı çalıştırmayıileri atlayabilirsiniz.

IoT Hub 'ınıza bir bağlantı eklemek için:

  1. IoT Hub 'ınız için bağlantı dizesini almak için az IoT Hub Connection-String Show komutunu çalıştırın.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Bağlantı dizesini çevreleyen tırnak karakterleri olmadan kopyalayın.

  3. Azure IoT Explorer 'da, sol taraftaki menüde IoT Hub 'ları ' nı seçin ve + bağlantı ekle' yi seçin.

  4. Bağlantı dizesini bağlantı dizesi kutusuna yapıştırın.

  5. Kaydet’i seçin.

    IoT Gezgininde bağlantı ekleme ekran görüntüsü

  6. Bağlantı başarılı olursa IoT Gezgini cihazlar görünümüne geçer.

Ortak model deposunu eklemek için:

  1. IoT Gezgini ' nde giriş görünümüne geri dönmek için giriş ' i seçin.

  2. sol taraftaki menüde ıot Tak ve Kullan Ayarlar' nı seçin, ardından + ekle ' yi seçin ve açılan menüden ortak depoyu seçin.

  3. Konumundaki ortak model deposu için bir giriş görüntülenir https://devicemodels.azure.com .

    IoT Gezgini 'ne ortak model deposu ekleme ekran görüntüsü

  4. Kaydet’i seçin.

Cihaz kaydetme

Bu bölümde, yeni bir cihaz örneği oluşturup oluşturduğunuz IoT Hub 'ına kaydedersiniz. Yeni kaydedilen cihazın bağlantı bilgilerini, sanal cihazınızı daha sonraki bir bölümde güvenli bir şekilde bağlamak için kullanacaksınız.

Bir cihazı kaydetmek için:

  1. IoT Explorer 'daki giriş görünümünden IoT Hub 'ları' nı seçin.

  2. Daha önce eklediğiniz bağlantı görünmelidir. Bağlantı özelliklerinin altında Bu hub 'da cihazları görüntüle ' yi seçin.

  3. + Yeni ' yi seçin ve cihazınız için BIR cihaz kimliği girin; Örneğin, cihazmakinedir. Diğer tüm özellikleri aynı şekilde bırakın.

  4. Oluştur’u seçin.

    Azure IoT gezgin cihaz kimliğinin ekran görüntüsü

  5. Birincil bağlantı dizesi alanını kopyalamak ve bir yere dönmek için kopyalama düğmelerini kullanın. Bu bağlantı dizesine daha sonra ihtiyacınız olacak.

Sanal cihazı Çalıştır

Bu bölümde, sanal bir cihazdan IoT Hub 'ınıza ileti göndermek için C# SDK 'SıNı kullanacaksınız. İki termostat sensörle bir sıcaklık denetleyicisi uygulayan bir örnek çalıştırırsınız.

  1. Windows CMD, PowerShell veya bash gibi yeni bir konsol açın. Aşağıdaki adımlarda, bu konsolu Node.js SDK 'Yı yüklemek ve Node.js örnek kodla çalışmak üzere kullanacaksınız.

    Not

    Yerel bir Azure CLı yüklemesi kullanıyorsanız, artık iki konsol penceresi açık olabilir. Bu bölümdeki komutları, CLı için kullanmakta olduğunuz konsolun değil, yeni açtığınız konsolda girdiğinizden emin olun.

  2. C# (.net) için Microsoft Azure ıot örneklerini yerel makinenize kopyalayın:

    git clone https://github.com/Azure-Samples/azure-iot-samples-csharp.git
    
  3. Örnek dizinine gidin:

    Windows

    cd azure-iot-samples-csharp\iot-hub\Samples\device\PnpDeviceSamples\TemperatureController
    

    Linux veya Raspberry PI OS

    cd azure-iot-samples-csharp/iot-hub/Samples/device/PnpDeviceSamples/TemperatureController
    
  4. Azure IoT C# SDK 'SıNı ve gerekli bağımlılıkları yükler:

    dotnet restore
    

    Bu komut, TemperatureController. csproj dosyasında belirtilen şekilde doğru bağımlılıkları kurar.

  5. Sanal cihazınızın Azure IoT 'ye bağlanmasını sağlamak için aşağıdaki ortam değişkenlerinin her ikisini de ayarlayın.

    • Adlı bir ortam değişkeni ayarlayın IOTHUB_DEVICE_CONNECTION_STRING . Değişken değeri için, önceki bölümde kaydettiğiniz cihaz bağlantı dizesini kullanın.
    • Adlı bir ortam değişkeni ayarlayın IOTHUB_DEVICE_SECURITY_TYPE . Değişkeni için, sabit dize değerini kullanın connectionString .

    CMD (Windows)

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

    Not

    Windows CMD için her değişken için dize değerlerini çevreleyen tırnak işareti yoktur.

    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. Kod örneğini çalıştırın:

    dotnet run
    

    Not

    Bu kod örneği, Azure IoT Tak ve Kullan kullanır ve bu, akıllı cihazları el ile herhangi bir yapılandırma olmadan çözümlerinizle tümleştirmenize imkan tanır. Varsayılan olarak, bu belgelerde birçok örnek IoT Tak ve Kullan kullanır. IoT PnP 'nin avantajları ve kullanma ya da kullanmayan durumlar hakkında daha fazla bilgi edinmek için bkz. ıot Tak ve Kullan nedir?.

Örnek, kaydettiğiniz cihaz olarak IoT Hub 'ınıza güvenli bir şekilde bağlanır ve telemetri iletileri göndermeye başlar. Örnek çıktı konsolunuzun içinde görüntülenir.

Telemetri görüntüleme

IoT Explorer ile cihaz telemetrisini görüntüleyebilirsiniz. İsteğe bağlı olarak, Azure CLı kullanarak Telemetriyi görüntüleyebilirsiniz.

Azure IoT Explorer 'da Telemetriyi görüntülemek için:

  1. IoT Hub 'ınızdaki IoT Hub 'ından Bu hub 'da cihazları görüntüle' yi seçin ve ardından listeden cihazınızı seçin.

  2. Cihazınızın sol menüsünde Telemetriyi seçin.

  3. Yerleşik Olay Hub 'ı kullan ' ın Evet olarak ayarlandığını onaylayın ve Başlat' ı seçin.

  4. Cihaz buluta ileti gönderdiğinden Telemetriyi görüntüleyin.

    IoT Gezgininde cihaz telemetrinin ekran görüntüsü

  5. Olayları almayı sonlandırmak için Durdur ' u seçin.

Tek Cihaz bileşenleri tarafından gönderilen Telemetriyi okumak için IoT Explorer 'daki Tak ve Kullan özelliklerini kullanabilirsiniz. Örneğin, bu hızlı başlangıçta bulunan sıcaklık denetleyicisinde iki termostats vardır: thermostat1 ve thermostat2. Thermostat1 tarafından raporlanan sıcaklığın görmek için:

  1. IoT Explorer 'daki cihazınızda, sol taraftaki menüden ıot Tak ve kullan bileşenleri ' ni seçin. Ardından bileşenler listesinden thermostat1 öğesini seçin.

  2. Thermostat1 bileşeni bölmesinde, üst menüden telemetri ' i seçin.

  3. Telemetri bölmesinde, daha önce yaptığınız adımların aynısını izleyin. Yerleşik Olay Hub 'ı kullan ' ın Evet olarak ayarlandığından emin olun ve ardından Başlat' ı seçin.

Azure CLı ile cihaz telemetrisini görüntülemek için:

  1. Sanal cihazdan IoT Hub 'ınıza gönderilen olayları izlemek için az IoT Hub Monitor-Events komutunu çalıştırın. Cihazınız ve IoT Hub 'ınız için daha önce Azure IoT 'de oluşturduğunuz adları kullanın.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Konsolunda bağlantı ayrıntılarını ve telemetri çıkışını görüntüleyin.

    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. İzlemeyi bitirmek için CTRL + C 'yi seçin.

Koda göz atın

Bu hızlı başlangıçta, temel bir Azure IoT uygulama geliştirme iş akışı öğrenirsiniz. Bir Azure IoT Hub 'ı ve bir cihaz oluşturmak için Azure CLı ve IoT gezginini kullanın. Ardından sanal bir sıcaklık denetleyicisi çalıştırmak, hub 'a güvenli bir şekilde bağlamak ve telemetri göndermek için bir Azure IoT cihaz SDK 'Sı örneği kullanırsınız.

Önkoşullar

  • Azure aboneliğiniz yoksa başlamadan önce ücretsiz olarak bir tane oluşturun .
  • Git.
  • Java SE Development Kit 8 veya üzeri bir geliştirme makinesi. Birden çok platform için Java 8 (LTS) JDK 'yi indirin, OpenJDK 'Nin Zulu sürümlerini indirin. Yükleyicide yola Ekle seçeneğini belirleyin.
  • Apache Maven 3. indirmeyi yerel bir klasöre ayıkladıktan sonra, maven /bin klasörünün tam yolunu Windows yol değişkenine ekleyin.
  • Azure IoT Gezgini: Azure IoT 'yi izlemeye ve yönetmeye yönelik platformlar arası, GUI tabanlı yardımcı program.
  • Azure CLI. Bu hızlı başlangıçta Azure CLı komutlarını çalıştırmak için iki seçeneğiniz vardır:
    • Tarayıcınızda CLı komutlarını çalıştıran etkileşimli bir kabuk olan Azure Cloud Shell kullanın. Her şeyi yüklemeniz gerekmiyorsa bu seçenek önerilir. Cloud Shell ilk kez kullanıyorsanız, Azure Portaloturum açın. Cloud Shell başlamak için Cloud Shell hızlı başlangıç ' daki adımları izleyin ve Bash ortamını seçin.
    • İsteğe bağlı olarak, yerel makinenizde Azure CLı 'yi çalıştırın. Azure CLı zaten yüklüyse, az upgrade CLI ve uzantıları güncel sürüme yükseltmek için ' i çalıştırın. Azure CLı 'yı yüklemek için bkz. Azure CLI 'Yi yüklemek.

IoT hub oluşturma

Bu bölümde, bir IoT Hub 'ı ve bir kaynak grubu oluşturmak için Azure CLı 'yi kullanırsınız. Azure kaynak grubu, Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. IoT Hub 'ı, IoT uygulamanız ve cihazlarınız arasında çift yönlü iletişim için bir merkezi ileti hub 'ı görevi görür.

Bir IoT Hub 'ı ve bir kaynak grubu oluşturmak için:

  1. Azure CLı 'yı başlatın:

    • Cloud Shell kullanıyorsanız, bir bölünmüş tarayıcı penceresinde Cloud Shell başlatmak için CLı komutlarında deneyin düğmesini seçin. Ya da Cloud Shell ayrı bir tarayıcı sekmesinde açabilirsiniz.
    • azure clı 'yi yerel olarak kullanıyorsanız, Windows CMD, PowerShell veya bash gibi bir konsolu açın ve azure clı 'da oturum açın.

    Bu hızlı başlangıçtaki geri kalanında CLı komutlarını çalıştırmak için: komut sözdizimini kopyalayın, Cloud Shell pencere veya CLı konsoluna yapıştırın, değişken değerlerini düzenleyin ve ENTER tuşuna basın.

  2. Azure-IoT uzantısını yüklemek veya güncel sürüme yükseltmek için az Extension Add ' i çalıştırın.

    az extension add --upgrade --name azure-iot
    
  3. Bir kaynak grubu oluşturmak için az Group Create komutunu çalıştırın. Aşağıdaki komut eastus konumunda myresourcegroup adlı bir kaynak grubu oluşturur.

    Not

    İsteğe bağlı olarak alternatif bir konum ayarlayabilirsiniz. Kullanılabilir konumları görmek için öğesini çalıştırın az account list-locations . Bu öğretici, örnek komutta gösterildiği gibi eastus kullanır.

    az group create --name MyResourceGroup --location eastus
    
  4. IoT Hub 'ı oluşturmak için az IoT Hub Create komutunu çalıştırın. IoT Hub 'ı oluşturmak birkaç dakika sürebilir.

    Youriothubname. IoT Hub 'ınız için seçtiğiniz adı kullanarak aşağıdaki komutta yer tutucuyu ve çevreleyen ayraçları değiştirin. IoT Hub 'ı adı Azure 'da genel olarak benzersiz olmalıdır. Yer tutucusunu gördüğünüz her yerde, bu hızlı başlangıçta IoT Hub 'ınızın adını kullanın.

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

    İpucu

    IoT Hub 'ı oluşturduktan sonra, bu hızlı başlangıçtaki geri kalanında IoT Hub 'ınız ile etkileşim kurmak için Azure IoT Explorer 'ı kullanacaksınız. IoT Explorer, mevcut bir IoT Hub bağlanmanıza ve cihazları eklemenize, yönetmenize ve izlemenize olanak tanıyan bir GUI uygulamasıdır. Daha fazla bilgi için bkz. Azure IoT Explorer 'ı yüklemek ve kullanmak. İsteğe bağlı olarak, CLı komutlarını kullanmaya devam edebilirsiniz.

IoT Gezginini yapılandırma

Bu hızlı başlangıçta, IoT Hub 'ınıza bir cihaz kaydetmek ve cihaz telemetrisini görüntülemek için IoT Gezginini kullanacaksınız. Bu bölümde, IoT Gezginini yeni oluşturduğunuz IoT Hub 'ına bağlanacak ve ortak model deposundan Tak ve kullan modellerini okuyabileceğiniz şekilde yapılandırırsınız.

Not

Ayrıca, bir cihazı kaydetmek için Azure CLı 'yi de kullanabilirsiniz. Cihaza yönelik birincil bağlantı dizesini almak için yeni bir cihaz ve az IoT Hub cihazı-kimliği bağlantı- kimliği -adı {youriothubname} komutunu kaydetmek üzere az IoT Hub cihazı-kimlik Create --Device-ID cihazım--hub-Name {youriothubname} komutunu kullanın. Cihaz bağlantı dizesi ' ni ayarladıktan sonra, sanal cihazı çalıştırmayıileri atlayabilirsiniz.

IoT Hub 'ınıza bir bağlantı eklemek için:

  1. IoT Hub 'ınız için bağlantı dizesini almak için az IoT Hub Connection-String Show komutunu çalıştırın.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Bağlantı dizesini çevreleyen tırnak karakterleri olmadan kopyalayın.

  3. Azure IoT Explorer 'da, sol taraftaki menüde IoT Hub 'ları ' nı seçin ve + bağlantı ekle' yi seçin.

  4. Bağlantı dizesini bağlantı dizesi kutusuna yapıştırın.

  5. Kaydet’i seçin.

    IoT Gezgininde bağlantı ekleme ekran görüntüsü

  6. Bağlantı başarılı olursa IoT Gezgini cihazlar görünümüne geçer.

Ortak model deposunu eklemek için:

  1. IoT Gezgini ' nde giriş görünümüne geri dönmek için giriş ' i seçin.

  2. sol taraftaki menüde ıot Tak ve Kullan Ayarlar' nı seçin, ardından + ekle ' yi seçin ve açılan menüden ortak depoyu seçin.

  3. Konumundaki ortak model deposu için bir giriş görüntülenir https://devicemodels.azure.com .

    IoT Gezgini 'ne ortak model deposu ekleme ekran görüntüsü

  4. Kaydet’i seçin.

Cihaz kaydetme

Bu bölümde, yeni bir cihaz örneği oluşturup oluşturduğunuz IoT Hub 'ına kaydedersiniz. Yeni kaydedilen cihazın bağlantı bilgilerini, sanal cihazınızı daha sonraki bir bölümde güvenli bir şekilde bağlamak için kullanacaksınız.

Bir cihazı kaydetmek için:

  1. IoT Explorer 'daki giriş görünümünden IoT Hub 'ları' nı seçin.

  2. Daha önce eklediğiniz bağlantı görünmelidir. Bağlantı özelliklerinin altında Bu hub 'da cihazları görüntüle ' yi seçin.

  3. + Yeni ' yi seçin ve cihazınız için BIR cihaz kimliği girin; Örneğin, cihazmakinedir. Diğer tüm özellikleri aynı şekilde bırakın.

  4. Oluştur’u seçin.

    Azure IoT gezgin cihaz kimliğinin ekran görüntüsü

  5. Birincil bağlantı dizesi alanını kopyalamak ve bir yere dönmek için kopyalama düğmelerini kullanın. Bu bağlantı dizesine daha sonra ihtiyacınız olacak.

Sanal cihazı Çalıştır

Bu bölümde, sanal bir cihazdan IoT Hub 'ınıza ileti göndermek için Java SDK 'sını kullanırsınız. İki termostat sensörle bir sıcaklık denetleyicisi uygulayan bir örnek çalıştırırsınız.

Ortamınızı yapılandırma

  1. Azure IoT Java cihaz SDK 'sını yüklemek, derlemek ve kod örneğini çalıştırmak için bir konsol açın. Bu konsolu aşağıdaki adımlarda kullanacaksınız.

    Not

    Yerel bir Azure CLı yüklemesi kullanıyorsanız, artık iki konsol penceresi açık olabilir. Bu bölümdeki komutları, CLı için kullanmakta olduğunuz konsolun değil, yeni açtığınız konsolda girdiğinizden emin olun.

  2. Sanal cihazınızın Azure IoT 'ye bağlanmasını sağlamak için aşağıdaki ortam değişkenlerini ayarlayın.

    • Adlı bir ortam değişkeni ayarlayın IOTHUB_DEVICE_CONNECTION_STRING . Değişken değeri için, önceki bölümde kaydettiğiniz cihaz bağlantı dizesini kullanın.
    • Adlı bir ortam değişkeni ayarlayın IOTHUB_DEVICE_SECURITY_TYPE . Değişkeni için, sabit dize değerini kullanın connectionString .

    CMD

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

    Not

    Windows CMD için her değişken için dize değerlerini çevreleyen tırnak işareti yoktur.

    Bash

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

Örneği oluşturma

  1. Azure IoT Java cihaz SDK 'sını yerel makinenize kopyalayın:
    git clone https://github.com/Azure/azure-iot-sdk-java.git
    
  2. SDK 'nın kök klasörüne gidin ve SDK 'Yı derlemek ve örnekleri güncelleştirmek için aşağıdaki komutu çalıştırın.
    cd azure-iot-sdk-java
    mvn install -T 2C -DskipTests
    
    Bu işlem birkaç dakika sürer.

Kodu çalıştırma

  1. Örnekler dizinine gidin.

    cd device/iot-device-samples/pnp-device-sample/temperature-controller-device-sample
    
  2. Aşağıdaki kod örneğini çalıştırın.

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

    Not

    Bu kod örneği, Azure IoT Tak ve Kullan kullanır ve bu, akıllı cihazları el ile herhangi bir yapılandırma olmadan çözümlerinizle tümleştirmenize imkan tanır. Varsayılan olarak, bu belgelerde birçok örnek IoT Tak ve Kullan kullanır. IoT PnP 'nin avantajları ve kullanma ya da kullanmayan durumlar hakkında daha fazla bilgi edinmek için bkz. ıot Tak ve Kullan nedir?.

Örnek, kaydettiğiniz cihaz olarak IoT Hub 'ınıza güvenli bir şekilde bağlanır ve telemetri iletileri göndermeye başlar. Örnek çıktı konsolunuzun içinde görüntülenir.

Telemetri görüntüleme

IoT Explorer ile cihaz telemetrisini görüntüleyebilirsiniz. İsteğe bağlı olarak, Azure CLı kullanarak Telemetriyi görüntüleyebilirsiniz.

Azure IoT Explorer 'da Telemetriyi görüntülemek için:

  1. IoT Hub 'ınızdaki IoT Hub 'ından Bu hub 'da cihazları görüntüle' yi seçin ve ardından listeden cihazınızı seçin.

  2. Cihazınızın sol menüsünde Telemetriyi seçin.

  3. Yerleşik Olay Hub 'ı kullan ' ın Evet olarak ayarlandığını onaylayın ve Başlat' ı seçin.

  4. Cihaz buluta ileti gönderdiğinden Telemetriyi görüntüleyin.

    IoT Gezgininde cihaz telemetrinin ekran görüntüsü

  5. Olayları almayı sonlandırmak için Durdur ' u seçin.

Tek Cihaz bileşenleri tarafından gönderilen Telemetriyi okumak için IoT Explorer 'daki Tak ve Kullan özelliklerini kullanabilirsiniz. Örneğin, bu hızlı başlangıçta bulunan sıcaklık denetleyicisinde iki termostats vardır: thermostat1 ve thermostat2. Thermostat1 tarafından raporlanan sıcaklığın görmek için:

  1. IoT Explorer 'daki cihazınızda, sol taraftaki menüden ıot Tak ve kullan bileşenleri ' ni seçin. Ardından bileşenler listesinden thermostat1 öğesini seçin.

  2. Thermostat1 bileşeni bölmesinde, üst menüden telemetri ' i seçin.

  3. Telemetri bölmesinde, daha önce yaptığınız adımların aynısını izleyin. Yerleşik Olay Hub 'ı kullan ' ın Evet olarak ayarlandığından emin olun ve ardından Başlat' ı seçin.

Azure CLı ile cihaz telemetrisini görüntülemek için:

  1. Sanal cihazdan IoT Hub 'ınıza gönderilen olayları izlemek için az IoT Hub Monitor-Events komutunu çalıştırın. Cihazınız ve IoT Hub 'ınız için daha önce Azure IoT 'de oluşturduğunuz adları kullanın.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Konsolunda bağlantı ayrıntılarını ve telemetri çıkışını görüntüleyin.

    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
    

Koda göz atın

Bu hızlı başlangıçta, temel bir Azure IoT uygulama geliştirme iş akışı öğrenirsiniz. Bir Azure IoT Hub 'ı ve bir cihaz oluşturmak için Azure CLı ve IoT gezginini kullanın. Ardından sanal bir sıcaklık denetleyicisi çalıştırmak, hub 'a güvenli bir şekilde bağlamak ve telemetri göndermek için bir Azure IoT cihaz SDK 'Sı örneği kullanırsınız.

Önkoşullar

bu hızlı başlangıç Windows, Linux ve Raspberry Pi üzerinde çalışır. Aşağıdaki işletim sistemi ve cihaz sürümleri üzerinde test edilmiştir:

  • Windows 10
  • ubuntu 20,04 lts Linux için Windows Alt Sistemi (wsl) üzerinde çalışıyor
  • Raspberry Pi 3 modelinde çalışan Raspberry PI OS sürüm 10 (Raspian) B +

Aşağıdaki önkoşulları, Raspberry PI için belirtilenler dışında geliştirme makinenize yüklersiniz:

  • Azure aboneliğiniz yoksa başlamadan önce ücretsiz olarak bir tane oluşturun .
  • Git.
  • Sürüm 10 veya üzeri Node.js . Node sürümünüzün çalışmasını denetlemek için node --version .
  • Azure IoT Gezgini: Azure IoT 'yi izlemeye ve yönetmeye yönelik platformlar arası, GUI tabanlı yardımcı program. Geliştirme platformunuz olarak Raspberry PI kullanıyorsanız, IoT Explorer 'ı başka bir bilgisayara yüklemenizi öneririz. IoT Gezginini yüklemek istemiyorsanız, aynı adımları gerçekleştirmek için Azure CLı kullanabilirsiniz.
  • Azure CLI. Bu hızlı başlangıçta Azure CLı komutlarını çalıştırmak için iki seçeneğiniz vardır:
    • Tarayıcınızda CLı komutlarını çalıştıran etkileşimli bir kabuk olan Azure Cloud Shell kullanın. Her şeyi yüklemeniz gerekmiyorsa bu seçenek önerilir. Cloud Shell ilk kez kullanıyorsanız, Azure Portaloturum açın. Cloud Shell başlamak için Cloud Shell hızlı başlangıç ' daki adımları izleyin ve Bash ortamını seçin.
    • İsteğe bağlı olarak, yerel makinenizde Azure CLı 'yi çalıştırın. Azure CLı zaten yüklüyse, az upgrade CLI ve uzantıları güncel sürüme yükseltmek için ' i çalıştırın. Azure CLı 'yı yüklemek için bkz. Azure CLI 'Yi yüklemek. Geliştirme platformunuz olarak Raspberry PI kullanıyorsanız, Azure Cloud Shell kullanmanızı veya Azure CLı 'yi başka bir bilgisayara yüklemenizi öneririz.

IoT hub oluşturma

Bu bölümde, bir IoT Hub 'ı ve bir kaynak grubu oluşturmak için Azure CLı 'yi kullanırsınız. Azure kaynak grubu, Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. IoT Hub 'ı, IoT uygulamanız ve cihazlarınız arasında çift yönlü iletişim için bir merkezi ileti hub 'ı görevi görür.

Bir IoT Hub 'ı ve bir kaynak grubu oluşturmak için:

  1. Azure CLı 'yı başlatın:

    • Cloud Shell kullanıyorsanız, bir bölünmüş tarayıcı penceresinde Cloud Shell başlatmak için CLı komutlarında deneyin düğmesini seçin. Ya da Cloud Shell ayrı bir tarayıcı sekmesinde açabilirsiniz.
    • azure clı 'yi yerel olarak kullanıyorsanız, Windows CMD, PowerShell veya bash gibi bir konsolu açın ve azure clı 'da oturum açın.

    Bu hızlı başlangıçtaki geri kalanında CLı komutlarını çalıştırmak için: komut sözdizimini kopyalayın, Cloud Shell pencere veya CLı konsoluna yapıştırın, değişken değerlerini düzenleyin ve ENTER tuşuna basın.

  2. Azure-IoT uzantısını yüklemek veya güncel sürüme yükseltmek için az Extension Add ' i çalıştırın.

    az extension add --upgrade --name azure-iot
    
  3. Bir kaynak grubu oluşturmak için az Group Create komutunu çalıştırın. Aşağıdaki komut eastus konumunda myresourcegroup adlı bir kaynak grubu oluşturur.

    Not

    İsteğe bağlı olarak alternatif bir konum ayarlayabilirsiniz. Kullanılabilir konumları görmek için öğesini çalıştırın az account list-locations . Bu öğretici, örnek komutta gösterildiği gibi eastus kullanır.

    az group create --name MyResourceGroup --location eastus
    
  4. IoT Hub 'ı oluşturmak için az IoT Hub Create komutunu çalıştırın. IoT Hub 'ı oluşturmak birkaç dakika sürebilir.

    Youriothubname. IoT Hub 'ınız için seçtiğiniz adı kullanarak aşağıdaki komutta yer tutucuyu ve çevreleyen ayraçları değiştirin. IoT Hub 'ı adı Azure 'da genel olarak benzersiz olmalıdır. Yer tutucusunu gördüğünüz her yerde, bu hızlı başlangıçta IoT Hub 'ınızın adını kullanın.

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

    İpucu

    IoT Hub 'ı oluşturduktan sonra, bu hızlı başlangıçtaki geri kalanında IoT Hub 'ınız ile etkileşim kurmak için Azure IoT Explorer 'ı kullanacaksınız. IoT Explorer, mevcut bir IoT Hub bağlanmanıza ve cihazları eklemenize, yönetmenize ve izlemenize olanak tanıyan bir GUI uygulamasıdır. Daha fazla bilgi için bkz. Azure IoT Explorer 'ı yüklemek ve kullanmak. İsteğe bağlı olarak, CLı komutlarını kullanmaya devam edebilirsiniz.

IoT Gezginini yapılandırma

Bu hızlı başlangıçta, IoT Hub 'ınıza bir cihaz kaydetmek ve cihaz telemetrisini görüntülemek için IoT Gezginini kullanacaksınız. Bu bölümde, IoT Gezginini yeni oluşturduğunuz IoT Hub 'ına bağlanacak ve ortak model deposundan Tak ve kullan modellerini okuyabileceğiniz şekilde yapılandırırsınız.

Not

Ayrıca, bir cihazı kaydetmek için Azure CLı 'yi de kullanabilirsiniz. Cihaza yönelik birincil bağlantı dizesini almak için yeni bir cihaz ve az IoT Hub cihazı-kimliği bağlantı- kimliği -adı {youriothubname} komutunu kaydetmek üzere az IoT Hub cihazı-kimlik Create --Device-ID cihazım--hub-Name {youriothubname} komutunu kullanın. Cihaz bağlantı dizesi ' ni ayarladıktan sonra, sanal cihazı çalıştırmayıileri atlayabilirsiniz.

IoT Hub 'ınıza bir bağlantı eklemek için:

  1. IoT Hub 'ınız için bağlantı dizesini almak için az IoT Hub Connection-String Show komutunu çalıştırın.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Bağlantı dizesini çevreleyen tırnak karakterleri olmadan kopyalayın.

  3. Azure IoT Explorer 'da, sol taraftaki menüde IoT Hub 'ları ' nı seçin ve + bağlantı ekle' yi seçin.

  4. Bağlantı dizesini bağlantı dizesi kutusuna yapıştırın.

  5. Kaydet’i seçin.

    IoT Gezgininde bağlantı ekleme ekran görüntüsü

  6. Bağlantı başarılı olursa IoT Gezgini cihazlar görünümüne geçer.

Ortak model deposunu eklemek için:

  1. IoT Gezgini ' nde giriş görünümüne geri dönmek için giriş ' i seçin.

  2. sol taraftaki menüde ıot Tak ve Kullan Ayarlar' nı seçin, ardından + ekle ' yi seçin ve açılan menüden ortak depoyu seçin.

  3. Konumundaki ortak model deposu için bir giriş görüntülenir https://devicemodels.azure.com .

    IoT Gezgini 'ne ortak model deposu ekleme ekran görüntüsü

  4. Kaydet’i seçin.

Cihaz kaydetme

Bu bölümde, yeni bir cihaz örneği oluşturup oluşturduğunuz IoT Hub 'ına kaydedersiniz. Yeni kaydedilen cihazın bağlantı bilgilerini, sanal cihazınızı daha sonraki bir bölümde güvenli bir şekilde bağlamak için kullanacaksınız.

Bir cihazı kaydetmek için:

  1. IoT Explorer 'daki giriş görünümünden IoT Hub 'ları' nı seçin.

  2. Daha önce eklediğiniz bağlantı görünmelidir. Bağlantı özelliklerinin altında Bu hub 'da cihazları görüntüle ' yi seçin.

  3. + Yeni ' yi seçin ve cihazınız için BIR cihaz kimliği girin; Örneğin, cihazmakinedir. Diğer tüm özellikleri aynı şekilde bırakın.

  4. Oluştur’u seçin.

    Azure IoT gezgin cihaz kimliğinin ekran görüntüsü

  5. Birincil bağlantı dizesi alanını kopyalamak ve bir yere dönmek için kopyalama düğmelerini kullanın. Bu bağlantı dizesine daha sonra ihtiyacınız olacak.

Sanal cihazı Çalıştır

Bu bölümde, sanal bir cihazdan IoT Hub 'ınıza ileti göndermek için Node.js SDK 'sını kullanacaksınız. İki termostat sensörle bir sıcaklık denetleyicisi uygulayan bir örnek çalıştırırsınız.

  1. Windows CMD, PowerShell veya bash gibi yeni bir konsol açın. Aşağıdaki adımlarda, bu konsolu Node.js SDK 'Yı yüklemek ve Node.js örnek kodla çalışmak üzere kullanacaksınız.

    Not

    Yerel bir Azure CLı yüklemesi kullanıyorsanız, artık iki konsol penceresi açık olabilir. Bu bölümdeki komutları, CLı için kullanmakta olduğunuz konsolun değil, yeni açtığınız konsolda girdiğinizden emin olun.

  2. Azure ıot Node.js SDK cihaz örneklerini yerel makinenize kopyalayın:

    git clone https://github.com/Azure/azure-iot-sdk-node
    
  3. Örnek dizinine gidin:

    Windows

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

    Linux veya Raspberry PI OS

    cd azure-iot-sdk-node/device/samples/javascript/pnp
    
  4. Azure IoT Node.js SDK 'sını ve gerekli bağımlılıkları yükler:

    npm install
    

    Bu komut, aygıt örnekleri dizinindeki Package. JSON dosyasında belirtilen şekilde doğru bağımlılıkları kurar.

  5. Sanal cihazınızın Azure IoT 'ye bağlanmasını sağlamak için aşağıdaki ortam değişkenlerinin her ikisini de ayarlayın.

    • Adlı bir ortam değişkeni ayarlayın IOTHUB_DEVICE_CONNECTION_STRING . Değişken değeri için, önceki bölümde kaydettiğiniz cihaz bağlantı dizesini kullanın.
    • Adlı bir ortam değişkeni ayarlayın IOTHUB_DEVICE_SECURITY_TYPE . Değişkeni için, sabit dize değerini kullanın connectionString .

    CMD (Windows)

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

    Not

    Windows CMD için her değişken için dize değerlerini çevreleyen tırnak işareti yoktur.

    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. Aşağıdaki kod örneğini çalıştırın:

    node pnpTemperatureController.js
    

    Not

    Bu kod örneği, Azure IoT Tak ve Kullan kullanır ve bu, akıllı cihazları el ile herhangi bir yapılandırma olmadan çözümlerinizle tümleştirmenize imkan tanır. Varsayılan olarak, bu belgelerde birçok örnek IoT Tak ve Kullan kullanır. IoT PnP 'nin avantajları ve kullanma ya da kullanmayan durumlar hakkında daha fazla bilgi edinmek için bkz. ıot Tak ve Kullan nedir?.

Örnek, kaydettiğiniz cihaz olarak IoT Hub 'ınıza güvenli bir şekilde bağlanır ve telemetri iletileri göndermeye başlar. Örnek çıktı konsolunuzun içinde görüntülenir.

Telemetri görüntüleme

IoT Explorer ile cihaz telemetrisini görüntüleyebilirsiniz. İsteğe bağlı olarak, Azure CLı kullanarak Telemetriyi görüntüleyebilirsiniz.

Azure IoT Explorer 'da Telemetriyi görüntülemek için:

  1. IoT Hub 'ınızdaki IoT Hub 'ından Bu hub 'da cihazları görüntüle' yi seçin ve ardından listeden cihazınızı seçin.

  2. Cihazınızın sol menüsünde Telemetriyi seçin.

  3. Yerleşik Olay Hub 'ı kullan ' ın Evet olarak ayarlandığını onaylayın ve Başlat' ı seçin.

  4. Cihaz buluta ileti gönderdiğinden Telemetriyi görüntüleyin.

    IoT Gezgininde cihaz telemetrinin ekran görüntüsü

  5. Olayları almayı sonlandırmak için Durdur ' u seçin.

Tek Cihaz bileşenleri tarafından gönderilen Telemetriyi okumak için IoT Explorer 'daki Tak ve Kullan özelliklerini kullanabilirsiniz. Örneğin, bu hızlı başlangıçta bulunan sıcaklık denetleyicisinde iki termostats vardır: thermostat1 ve thermostat2. Thermostat1 tarafından raporlanan sıcaklığın görmek için:

  1. IoT Explorer 'daki cihazınızda, sol taraftaki menüden ıot Tak ve kullan bileşenleri ' ni seçin. Ardından bileşenler listesinden thermostat1 öğesini seçin.

  2. Thermostat1 bileşeni bölmesinde, üst menüden telemetri ' i seçin.

  3. Telemetri bölmesinde, daha önce yaptığınız adımların aynısını izleyin. Yerleşik Olay Hub 'ı kullan ' ın Evet olarak ayarlandığından emin olun ve ardından Başlat' ı seçin.

Azure CLı ile cihaz telemetrisini görüntülemek için:

  1. Sanal cihazdan IoT Hub 'ınıza gönderilen olayları izlemek için az IoT Hub Monitor-Events komutunu çalıştırın. Cihazınız ve IoT Hub 'ınız için daha önce Azure IoT 'de oluşturduğunuz adları kullanın.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Konsolunda bağlantı ayrıntılarını ve telemetri çıkışını görüntüleyin.

    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
    

Koda göz atın

Bu hızlı başlangıçta temel bir Azure IoT uygulama geliştirme iş akışı öğrenirsiniz. Azure CLI ve IoT Explorer'ı kullanarak bir Azure IoT hub'ı ve cihaz oluşturabilirsiniz. Ardından bir Azure IoT cihaz SDK'sı örneği kullanarak bir sıcaklık denetleyicisi simülasyonu çalıştıracak, hub'a güvenli bir şekilde bağacak ve telemetri göndereceksiniz.

Önkoşullar

Bu hızlı başlangıç Windows, Linux ve Raspberry Pi üzerinde çalışır. Aşağıdaki işletim sistemi ve cihaz sürümlerinde test edilmiştir:

  • Windows 10
  • Linux için Windows Alt Sistemi (WSL) üzerinde çalışan Ubuntu 20.04 LTS
  • Raspberry Pi 3 Model B+ üzerinde çalışan Raspberry Pi OS sürüm 10 (Raspian)

Raspberry Pi için not edildi dışındaki geliştirme makinenize aşağıdaki önkoşulları yükleyin:

  • Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir abonelik oluşturun.
  • Git .
  • Python sürüm 3.7 veya sonrası. Python sürümünü kontrol etmek için python3 --version çalıştırın.
  • Azure IoT Explorer:Azure IoT'yu izlemek ve yönetmek için platformlar arası, GUI tabanlı yardımcı program. Geliştirme platformumuz olarak Raspberry Pi kullanıyorsanız IoT Explorer'ı başka bir bilgisayara yüklemenizi öneririz. IoT Explorer'ı yüklemek istemiyorsanız, aynı adımları gerçekleştirmek için Azure CLI'ı kullanabilirsiniz.
  • Azure CLI. Bu hızlı başlangıçta Azure CLI komutlarını çalıştırmaya iki seçeneğiniz vardır:
    • Tarayıcınızda CLI Azure Cloud Shell çalışan etkileşimli bir kabuk olan Azure Cloud Shell'i kullanın. Herhangi bir şey yüklemeniz gerekmay olduğundan bu seçenek önerilir. İlk kez Cloud Shell kullanıyorsanız Azure portal. Başlangıç hızlı Cloud Shell Başlangıç ve Cloud Shell Bash ortamını seçme adımlarını izleyin.
    • İsteğe bağlı olarak, yerel makineniz üzerinde Azure CLI'sini çalıştırın. Azure CLI zaten yüklüyse, CLI ve az upgrade uzantıları geçerli sürüme yükseltmek için çalıştırın. Azure CLI'sini yüklemek için bkz. Azure CLI'sini yükleme. Geliştirme platformumuz olarak Raspberry Pi kullanıyorsanız, Azure CLI'yi başka bir Azure Cloud Shell veya yüklemenizi öneririz.

IoT hub oluşturma

Bu bölümde, bir IoT Hub 'ı ve bir kaynak grubu oluşturmak için Azure CLı 'yi kullanırsınız. Azure kaynak grubu, Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. IoT Hub 'ı, IoT uygulamanız ve cihazlarınız arasında çift yönlü iletişim için bir merkezi ileti hub 'ı görevi görür.

Bir IoT Hub 'ı ve bir kaynak grubu oluşturmak için:

  1. Azure CLı 'yı başlatın:

    • Cloud Shell kullanıyorsanız, bir bölünmüş tarayıcı penceresinde Cloud Shell başlatmak için CLı komutlarında deneyin düğmesini seçin. Ya da Cloud Shell ayrı bir tarayıcı sekmesinde açabilirsiniz.
    • azure clı 'yi yerel olarak kullanıyorsanız, Windows CMD, PowerShell veya bash gibi bir konsolu açın ve azure clı 'da oturum açın.

    Bu hızlı başlangıçtaki geri kalanında CLı komutlarını çalıştırmak için: komut sözdizimini kopyalayın, Cloud Shell pencere veya CLı konsoluna yapıştırın, değişken değerlerini düzenleyin ve ENTER tuşuna basın.

  2. Azure-IoT uzantısını yüklemek veya güncel sürüme yükseltmek için az Extension Add ' i çalıştırın.

    az extension add --upgrade --name azure-iot
    
  3. Bir kaynak grubu oluşturmak için az Group Create komutunu çalıştırın. Aşağıdaki komut eastus konumunda myresourcegroup adlı bir kaynak grubu oluşturur.

    Not

    İsteğe bağlı olarak alternatif bir konum ayarlayabilirsiniz. Kullanılabilir konumları görmek için öğesini çalıştırın az account list-locations . Bu öğretici, örnek komutta gösterildiği gibi eastus kullanır.

    az group create --name MyResourceGroup --location eastus
    
  4. IoT Hub 'ı oluşturmak için az IoT Hub Create komutunu çalıştırın. IoT Hub 'ı oluşturmak birkaç dakika sürebilir.

    Youriothubname. IoT Hub 'ınız için seçtiğiniz adı kullanarak aşağıdaki komutta yer tutucuyu ve çevreleyen ayraçları değiştirin. IoT Hub 'ı adı Azure 'da genel olarak benzersiz olmalıdır. Yer tutucusunu gördüğünüz her yerde, bu hızlı başlangıçta IoT Hub 'ınızın adını kullanın.

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

    İpucu

    IoT Hub 'ı oluşturduktan sonra, bu hızlı başlangıçtaki geri kalanında IoT Hub 'ınız ile etkileşim kurmak için Azure IoT Explorer 'ı kullanacaksınız. IoT Explorer, mevcut bir IoT Hub bağlanmanıza ve cihazları eklemenize, yönetmenize ve izlemenize olanak tanıyan bir GUI uygulamasıdır. Daha fazla bilgi için bkz. Azure IoT Explorer 'ı yüklemek ve kullanmak. İsteğe bağlı olarak, CLı komutlarını kullanmaya devam edebilirsiniz.

IoT Gezginini yapılandırma

Bu hızlı başlangıçta, IoT Hub 'ınıza bir cihaz kaydetmek ve cihaz telemetrisini görüntülemek için IoT Gezginini kullanacaksınız. Bu bölümde, IoT Gezginini yeni oluşturduğunuz IoT Hub 'ına bağlanacak ve ortak model deposundan Tak ve kullan modellerini okuyabileceğiniz şekilde yapılandırırsınız.

Not

Ayrıca, bir cihazı kaydetmek için Azure CLı 'yi de kullanabilirsiniz. Cihaza yönelik birincil bağlantı dizesini almak için yeni bir cihaz ve az IoT Hub cihazı-kimliği bağlantı- kimliği -adı {youriothubname} komutunu kaydetmek üzere az IoT Hub cihazı-kimlik Create --Device-ID cihazım--hub-Name {youriothubname} komutunu kullanın. Cihaz bağlantı dizesi ' ni ayarladıktan sonra, sanal cihazı çalıştırmayıileri atlayabilirsiniz.

IoT Hub 'ınıza bir bağlantı eklemek için:

  1. IoT Hub 'ınız için bağlantı dizesini almak için az IoT Hub Connection-String Show komutunu çalıştırın.

    az iot hub connection-string  show --hub-name {YourIoTHubName}
    
  2. Bağlantı dizesini çevreleyen tırnak karakterleri olmadan kopyalayın.

  3. Azure IoT Explorer 'da, sol taraftaki menüde IoT Hub 'ları ' nı seçin ve + bağlantı ekle' yi seçin.

  4. Bağlantı dizesini bağlantı dizesi kutusuna yapıştırın.

  5. Kaydet’i seçin.

    IoT Gezgininde bağlantı ekleme ekran görüntüsü

  6. Bağlantı başarılı olursa IoT Gezgini cihazlar görünümüne geçer.

Ortak model deposunu eklemek için:

  1. IoT Gezgini ' nde giriş görünümüne geri dönmek için giriş ' i seçin.

  2. sol taraftaki menüde ıot Tak ve Kullan Ayarlar' nı seçin, ardından + ekle ' yi seçin ve açılan menüden ortak depoyu seçin.

  3. Konumundaki ortak model deposu için bir giriş görüntülenir https://devicemodels.azure.com .

    IoT Gezgini 'ne ortak model deposu ekleme ekran görüntüsü

  4. Kaydet’i seçin.

Cihaz kaydetme

Bu bölümde, yeni bir cihaz örneği oluşturup oluşturduğunuz IoT Hub 'ına kaydedersiniz. Yeni kaydedilen cihazın bağlantı bilgilerini, sanal cihazınızı daha sonraki bir bölümde güvenli bir şekilde bağlamak için kullanacaksınız.

Bir cihazı kaydetmek için:

  1. IoT Explorer 'daki giriş görünümünden IoT Hub 'ları' nı seçin.

  2. Daha önce eklediğiniz bağlantı görünmelidir. Bağlantı özelliklerinin altında Bu hub 'da cihazları görüntüle ' yi seçin.

  3. + Yeni ' yi seçin ve cihazınız için BIR cihaz kimliği girin; Örneğin, cihazmakinedir. Diğer tüm özellikleri aynı şekilde bırakın.

  4. Oluştur’u seçin.

    Azure IoT gezgin cihaz kimliğinin ekran görüntüsü

  5. Birincil bağlantı dizesi alanını kopyalamak ve bir yere dönmek için kopyalama düğmelerini kullanın. Bu bağlantı dizesine daha sonra ihtiyacınız olacak.

Simülasyon cihazı çalıştırma

Bu bölümde Python SDK'sı kullanarak sanal bir cihazdan IoT hub'ınıza ileti göndereceksiniz. İki termostat algılayıcısı olan bir sıcaklık denetleyicisi uygulayan bir örnek çalıştıracak.

  1. Windows CMD, PowerShell veya Bash gibi yeni bir konsol açın. Aşağıdaki adımlarda, Python SDK'sı yüklemek ve Python örnek koduyla çalışmak için bu konsolu kullanacağız.

    Not

    Yerel bir Azure CLI yüklemesi kullanıyorsanız, artık iki konsol pencereniz açık olabilir. Cli için kullanmakta olduğunu değil, yeni açtığın konsolda bu bölümdeki komutları girmeyin.

  2. Azure IoT Python SDK'sı cihaz örneklerini yerel makinenize kopyalama:

    git clone https://github.com/Azure/azure-iot-sdk-python
    
  3. Örnek dizine gidin:

    Windows

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

    Linux veya Raspberry Pi OS

    cd azure-iot-sdk-python/azure-iot-device/samples/pnp
    
  4. Azure IoT Python SDK'sı yükleyin:

    pip3 install azure-iot-device
    
  5. Sanal cihazınızın Azure IoT'ye bağlanmasına olanak sağlamak için aşağıdaki ortam değişkenlerini ayarlayın.

    • adlı bir ortam değişkeni IOTHUB_DEVICE_CONNECTION_STRING ayarlayın. Değişken değeri için, önceki bölümde kaydedilen cihaz bağlantı dizesini kullanın.
    • adlı bir ortam değişkeni IOTHUB_DEVICE_SECURITY_TYPE ayarlayın. değişkeni için değişmez dize değerini connectionString kullanın.

    CMD (Windows)

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

    Not

    Bu Windows CMD'de her değişkenin dize değerlerini çevreleyen tırnak işaretleri yoktur.

    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. Aşağıdaki örnek dosyanın kodunu çalıştırın.

    python3 temp_controller_with_thermostats.py
    

    Not

    Bu kod örneği, akıllı IoT Tak Çalıştır el ile yapılandırmaya gerek kalmadan çözümlerinize tümleştiren Azure IoT Tak Çalıştır'i kullanır. Varsayılan olarak, bu belgelerde yer alan örneklerin çoğu IoT Tak Çalıştır. Uygulamanın avantajları ve IoT Tak Çalıştır kullanmama örnekleri hakkında daha fazla bilgi edinmek için bkz. Uygulamanın IoT Tak Çalıştır..

Örnek, kayıtlı cihaz olarak IoT hub'ınıza güvenli bir şekilde bağlanır ve telemetri iletileri göndermeye başlar. Örnek çıkış konsolunuzun içinde görünür.

Telemetri görüntüleme

IoT Explorer ile cihaz telemetrisini görüntüebilirsiniz. İsteğe bağlı olarak, Azure CLI kullanarak telemetri görüntüabilirsiniz.

Azure IoT Explorer'da telemetri görüntülemek için:

  1. IoT Explorer'daki IoT hub'ınıza bakarak Cihazları bu hub'da görüntüle'yi ve ardından listeden cihazınızı seçin.

  2. Cihazınızın sol menüsünde Telemetri'yi seçin.

  3. Yerleşik olay hub'larını kullan seçeneğinin Evet olarak ayar olduğunu onaylayın ve Başlat'ı seçin.

  4. Cihaz buluta ileti gönderirken telemetriyi görüntüleme.

    IoT Explorer'da cihaz telemetrisini ekran görüntüsü

  5. Alma olaylarını durdurmak için Durdur'a seçin.

Tek tek cihaz bileşenleri tarafından gönderilen telemetri verileri okumak için IoT Explorer'daki tak çalıştır özelliklerini kullanabilirsiniz. Örneğin, bu hızlı başlangıçtaki sıcaklık denetleyicisinde iki termostat vardır: termostat1 ve termostat2. Termostat1 tarafından bildirilen sıcaklığı görmek için:

  1. IoT Explorer'daki cihazınızın sol IoT Tak Çalıştır bileşenleri seçin. Ardından bileşen listesinden thermostat1'i seçin.

  2. Termostat1 bileşen bölmesinde üst menüden Telemetri'yi seçin.

  3. Telemetri bölmesinde, daha önce attığımız adımların aynısını izleyin. Yerleşik olay hub'larını kullan seçeneğinin Evet olarak ayarlanmış olduğundan emin olun ve başlat'ı seçin.

Azure CLI ile cihaz telemetrisini görüntülemek için:

  1. Simülasyon cihazından IoT hub'ınıza gönderilen olayları izlemek için az iot hub monitor-events komutunu çalıştırın. Cihazınız ve IoT hub'nız için daha önce Azure IoT'de oluşturduğunuz adları kullanın.

    az iot hub monitor-events --output table --device-id mydevice --hub-name {YourIoTHubName}
    
  2. Konsolda bağlantı ayrıntılarını ve telemetri çıktısını görüntüleme.

    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
    

Kaynakları temizleme

Bu hızlı başlangıçta oluşturulan Azure kaynaklarına artık ihtiyacınız yoksa, bunları silmek için Azure CLI'sini kullanabilirsiniz.

Önemli

Silinen kaynak grupları geri alınamaz. Kaynak grubu ve içindeki tüm kaynaklar kalıcı olarak silinir. Yanlış kaynak grubunu veya kaynakları yanlışlıkla silmediğinizden emin olun.

Bir kaynak grubunu adıyla silmek için:

  1. az group delete komutunu çalıştırın. Bu komut kaynak grubunu, IoT Hub ve oluşturduğunuz cihaz kaydını kaldırır.

    az group delete --name MyResourceGroup
    
  2. Kaynak grubunun silindikten sonra az group list komutunu çalıştırın.

    az group list
    

Sonraki adımlar

Bu hızlı başlangıçta, bir cihazı buluta güvenli bir şekilde bağlamak ve cihazdan buluta telemetri göndermek için temel bir Azure IoT uygulama iş akışı öğrendiniz. Azure IoT hub'ı ve cihaz örneği oluşturmak için Azure CLI'sini kullandınız. Ardından bir Azure IoT cihaz SDK'sı kullanarak simülasyon cihazı oluştur, hub'a bağla ve telemetri gönder. Telemetri verileri Azure portal için de bu verileri kullandın.

Sonraki adım olarak, Azure IoT ile cihaz çözümleri hakkında daha fazla bilgi edinmek için aşağıdaki makaleleri keşfedin.