Hızlı Başlangıç: IoT Tak Çalıştır cihazdan Azure IoT Hub'e telemetri gönderme

Şunlar için geçerlidir: Cihaz uygulaması geliştiricileri

Koda göz atın

Bu hızlı başlangıçta, temel bir Azure IoT uygulama geliştirme iş akışını öğreneceksiniz. Bir Azure IoT hub'ı ve cihaz oluşturmak için Azure CLI ve IoT Gezgini'ni kullanırsınız. Ardından 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. Sıcaklık denetleyicisi örnek uygulaması yerel makinenizde çalışır ve IoT Hub göndermek için simülasyon algılayıcı verileri oluşturur.

Ö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
  • Ubuntu 20.04 LTS
  • Raspberry Pi 3 Modeli B+ üzerinde çalışan Raspberry Pi OS (Raspbian) sürüm 10

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

  • Azure aboneliğiniz yoksa başlamadan önce ücretsiz olarak bir abonelik oluşturun .
  • Git'i seçin.
  • Azure IoT Gezgini: Azure IoT'yi izlemek ve yönetmek için 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 Explorer'ı yüklemek istemiyorsanız, aynı adımları gerçekleştirmek için Azure CLI'yı kullanabilirsiniz.
  • Azure CLI. Bu hızlı başlangıçta Azure CLI komutlarını çalıştırmak için iki seçeneğiniz vardır:
    • Tarayıcınızda CLI komutlarını çalıştıran etkileşimli bir kabuk olan Azure Cloud Shell kullanın. Hiçbir şey yüklemeniz gerekmeyen bu seçenek önerilir. Cloud Shell ilk kez kullanıyorsanız Azure portal oturum açın. Cloud Shell'ı başlatmak ve Bash ortamını seçmek için Cloud Shell hızlı başlangıçtaki adımları izleyin.
    • İsteğe bağlı olarak, yerel makinenizde Azure CLI'yı çalıştırın. Azure CLI zaten yüklüyse, CLI'yı ve uzantıları geçerli sürüme yükseltmek için komutunu çalıştırın az upgrade . Azure CLI'yı yüklemek için bkz. Azure CLI'yi yükleme. Geliştirme platformunuz olarak Raspberry Pi kullanıyorsanız Azure Cloud Shell kullanmanızı veya Azure CLI'yı başka bir bilgisayara yüklemenizi öneririz.

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

Linux veya Raspberry Pi işletim sistemi

Linux veya Raspberry Pi işletim sisteminde bu hızlı başlangıcı tamamlamak için aşağıdaki yazılımı yükleyin:

komutunu kullanarak apt-getGCC, Git, cmake ve gerekli bağımlılıkları 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 cmake2.8.12 ve GCC sürümünün 4.4.7'nin üzerinde olduğunu doğrulayın.

cmake --version
gcc --version

Windows

Windows'da bu hızlı başlangıcı tamamlamak için Visual Studio 2019'u yükleyin ve C ve C++ geliştirmesi için gerekli bileşenleri ekleyin.

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

    Not

    Mevcut Visual Studio 2019 kullanıcıları için Windows Başlat'ı seçin, Visual Studio Yükleyicisi yazın ve yükleyiciyi başlatı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, IoT hub'ı ve kaynak grubu oluşturmak için Azure CLI kullanacaksı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ızla cihazlarınız arasında çift yönlü iletişim için merkezi bir ileti hub'ı işlevi görür.

IoT hub'ı ve kaynak grubu oluşturmak için:

  1. Azure CLI'ı başlatın:

    • Cloud Shell kullanıyorsanız, CLI komutlarındaki Dene düğmesini seçerek Cloud Shell bölünmüş bir tarayıcı penceresinde başlatın. İsterseniz Cloud Shell ayrı bir tarayıcı sekmesinde de açabilirsiniz.
    • Azure CLI'yi yerel olarak kullanıyorsanız Windows CMD, PowerShell veya Bash gibi bir konsol açın ve Azure CLI'da oturum açın.

    Bu hızlı başlangıcın geri kalanında CLI komutlarını çalıştırmak için: komut söz dizimini kopyalayın, Cloud Shell pencerenize veya CLI konsolunuza yapıştırın, değişken değerlerini düzenleyin ve Enter tuşuna basın.

  2. azure-iotuzantısını yüklemek veya geçerli sürüme yükseltmek için az extension add komutunu çalıştırın.

    az extension add --upgrade --name azure-iot
    
  3. 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 komutunu çalıştırın az account list-locations. Bu öğreticide örnek komutta gösterildiği gibi eastus kullanılı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. Aşağıdaki komutta, IoT hub'ınız için seçtiğiniz adı kullanarak bu yer tutucuyu ve çevresindeki küme ayraçlarını değiştirin. IoT hub'ı adının Azure'da genel olarak benzersiz olması gerekir. Bu hızlı başlangıcın geri kalanında yer tutucuyu gördüğünüz her yerde IoT hub'ınızın adını kullanın.

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

    İpucu

    Bir IoT hub'ı oluşturduktan sonra, bu hızlı başlangıcın geri kalanında IoT hub'ınızla etkileşime geçmek için Azure IoT Gezgini'ni kullanacaksınız. IoT Explorer, mevcut bir IoT Hub bağlanmanızı ve cihazları eklemenizi, yönetmenizi ve izlemenizi sağlayan bir GUI uygulamasıdır. Daha fazla bilgi edinmek için bkz. Azure IoT gezginini yükleme ve kullanma. İsteğe bağlı olarak, CLI komutlarını kullanmaya devam edebilirsiniz.

IoT Explorer'ı yapılandırma

Bu hızlı başlangıcın geri kalanında IoT Gezgini'ni kullanarak ioT hub'ınıza bir cihaz kaydedecek ve cihaz telemetrisini görüntüleyebileceksiniz. Bu bölümde IoT Explorer'ı yeni oluşturduğunuz IoT hub'ına bağlanacak ve genel model deposundan tak çalıştır modellerini okuyacak şekilde yapılandıracaksınız.

Not

Bir cihazı kaydetmek için Azure CLI'yi de kullanabilirsiniz. Yeni bir cihaz kaydetmek için az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} komutunu ve cihazın birincil bağlantı dizesini almak için az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} komutunu kullanın. Cihaz bağlantı dizesini not aldıktan sonra Cihaz örneğini çalıştırma bölümüne atlayabilirsiniz.

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

  1. IoT hub'ınızın 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 çevresindeki tırnak karakterleri olmadan kopyalayın.

  3. Azure IoT Gezgini'nde soldaki menüden IoT hub'ları'nı ve ardından + Bağlantı ekle'yi seçin.

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

  5. Kaydet’i seçin.

    IoT Explorer'da bağlantı ekleme ekran görüntüsü

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

Genel model deposunu eklemek için:

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

  2. Soldaki menüden Ayarlar'IoT Tak Çalıştır ve ardından +Ekle'yi seçin ve açılan menüden Genel depo'yu seçin.

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

    IoT Gezgini'nde genel model deposunu ekleme ekran görüntüsü

  4. Kaydet’i seçin.

Cihaz kaydetme

Bu bölümde yeni bir cihaz örneği oluşturacak ve oluşturduğunuz IoT hub'ına kaydedacaksınız. Cihazınızı daha sonraki bir bölümde güvenli bir şekilde bağlamak için yeni kaydedilen cihazın bağlantı bilgilerini kullanacaksınız.

Bir cihazı kaydetmek için:

  1. IoT Gezgini'ndeki giriş görünümünde IoT hub'ları'nı seçin.

  2. Daha önce eklediğiniz bağlantı görünmelidir. Bağlantı özelliklerinin altındaki Cihazları bu hub'da 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, mydevice. Diğer tüm özellikleri aynı bırakın.

  4. Oluştur’u seçin.

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

  5. Kopyalama düğmelerini kullanarak Birincil bağlantı dizesi alanını kopyalayıp not edin. Bu bağlantı dizesine daha sonra ihtiyacınız olacak.

Cihaz örneğini çalıştırma

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

Örneği oluşturma

  1. Azure IoT C cihaz SDK'sını yüklemek ve kod örneğini çalıştırmak için yeni bir konsol açın. Windows için Başlat'ı 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

    Azure CLI'nın yerel yüklemesini kullanıyorsanız artık iki konsol penceresi açık olabilir. Bu bölümdeki komutları CLI için kullandığınız konsola değil, yeni açtığınız konsola girdiğinizden emin olun.

  2. Örnek depoyu kopyalamak istediğiniz yerel klasöre gidin.

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

    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'yı 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. Cihazınızın Azure IoT'ye bağlanmasını sağlamak için aşağıdaki ortam değişkenlerini ayarlayın.

    • adlı IOTHUB_DEVICE_CONNECTION_STRINGbir ortam değişkeni ayarlayın. Değişken değeri için önceki bölümde kaydettiğiniz cihaz bağlantı dizesini kullanın.
    • adlı IOTHUB_DEVICE_SECURITY_TYPEbir ortam değişkeni ayarlayın. değişkeni için değişmez dize değerini connectionStringkullanın.

    Cmd

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

    Not

    Windows CMD için her değişkenin 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"
    

Kodu çalıştırma

  1. Konsolunuz için uygun komutu 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, el ile yapılandırma yapmadan akıllı cihazları çözümlerinizle tümleştirmenizi sağlayan Azure IoT Tak Çalıştır kullanır. Varsayılan olarak, bu belgedeki örneklerin çoğu IoT Tak Çalıştır kullanır. IoT PnP'nin avantajları ve kullanma veya kullanmama durumları hakkında daha fazla bilgi edinmek için bkz. IoT Tak Çalıştır 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 çıkış konsolunuzda görünür.

Telemetri görüntüleme

IoT Gezgini ile cihaz telemetrisini görüntüleyebilirsiniz. İsteğe bağlı olarak, Azure CLI kullanarak telemetri verilerini görüntüleyebilirsiniz.

Azure IoT Gezgini'nde telemetri verilerini görüntülemek için:

  1. IoT Gezgini'ndeki IoT hub'ınızdan Bu hub'daki cihazları 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'ı kullan seçeneğinin Evet olarak ayarlandığını onaylayın ve ardından Başlat'ı seçin.

  4. Cihaz buluta ileti gönderirken telemetri verilerini görüntüleyin.

    IoT Gezgini'nde cihaz telemetrisinin ekran görüntüsü

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

Tek tek cihaz bileşenleri tarafından gönderilen telemetri verilerini okumak için IoT Gezgini'ndeki 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 Gezgini'ndeki cihazınızda sol menüden IoT Tak Çalıştır bileşenleri seçin. Ardından bileşenler listesinden termostat1'i seçin.

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

  3. Telemetri bölmesinde, daha önce uyguladığınız adımları izleyin. Yerleşik olay hub'ı kullan seçeneğinin Evet olarak ayarlandığından emin olun ve ardından Başlat'ı seçin.

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

  1. 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 Azure IoT'de daha önce 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 çıkışını görüntüleyin.

    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ışını öğreneceksiniz. Bir Azure IoT hub'ı ve cihaz oluşturmak için Azure CLI ve IoT Gezgini'ni kullanırsınız. Ardından 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. Sıcaklık denetleyicisi örnek uygulaması yerel makinenizde çalışır ve IoT Hub göndermek için simülasyon algılayıcı verileri oluşturur.

Ö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
  • Ubuntu 20.04 LTS
  • Raspberry Pi 3 Model B+ üzerinde çalışan Raspberry Pi OS (Raspbian) sürüm 10

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

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

  • Git'i seçin.

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

    • Windows ve Linux için (Raspberry Pi hariç), . NET Core SDK 3.1'i platformunuza yüklemek için yönergeleri izleyin.
    • Raspberry Pi için SDK'yı el ile yüklemek için yönergeleri izlemeniz gerekir. Bunun nedeni Debian'da .NET SDK'sının paket yöneticisi yüklemelerinin yalnızca x64 mimarisi için desteklenmesidir.
  • Azure IoT Gezgini: Azure IoT'yi izlemek ve yönetmek için 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 Gezgini'ni yüklemek istemiyorsanız, aynı adımları gerçekleştirmek için Azure CLI'yı kullanabilirsiniz.

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

    • Tarayıcınızda CLI komutlarını çalıştıran etkileşimli bir kabuk olan Azure Cloud Shell kullanın. Herhangi bir şey yüklemeniz gerekmeyen bu seçenek önerilir. Cloud Shell ilk kez kullanıyorsanız Azure portal oturum açın. Cloud Shell Başlatma ve Bash ortamını seçme Cloud Shell hızlı başlangıç bölümündeki adımları izleyin.
    • İsteğe bağlı olarak, yerel makinenizde Azure CLI'yı çalıştırın. Azure CLI zaten yüklüyse, CLI'yı ve uzantıları geçerli sürüme yükseltmek için komutunu çalıştırın az upgrade . Azure CLI'yı yüklemek için bkz. Azure CLI'yı yükleme. Geliştirme platformunuz olarak Raspberry Pi kullanıyorsanız Azure Cloud Shell kullanmanızı veya Azure CLI'yi başka bir bilgisayara yüklemenizi öneririz.

IoT hub oluşturma

Bu bölümde, IoT hub'ı ve kaynak grubu oluşturmak için Azure CLI'yi kullanacaksı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ızla cihazlarınız arasında çift yönlü iletişim için merkezi bir ileti hub'ı işlevi görür.

IoT hub'ı ve kaynak grubu oluşturmak için:

  1. Azure CLI'ı başlatın:

    • Cloud Shell kullanıyorsanız, CLI komutlarındaki Dene düğmesini seçerek Cloud Shell bölünmüş bir tarayıcı penceresinde başlatın. İsterseniz Cloud Shell ayrı bir tarayıcı sekmesinde de açabilirsiniz.
    • Azure CLI'yi yerel olarak kullanıyorsanız Windows CMD, PowerShell veya Bash gibi bir konsol açın ve Azure CLI'da oturum açın.

    Bu hızlı başlangıcın geri kalanında CLI komutlarını çalıştırmak için: komut söz dizimini kopyalayın, Cloud Shell pencerenize veya CLI konsolunuza yapıştırın, değişken değerlerini düzenleyin ve Enter tuşuna basın.

  2. azure-iotuzantısını yüklemek veya geçerli sürüme yükseltmek için az extension add komutunu çalıştırın.

    az extension add --upgrade --name azure-iot
    
  3. 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 komutunu çalıştırın az account list-locations. Bu öğreticide örnek komutta gösterildiği gibi eastus kullanılı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. Aşağıdaki komutta, IoT hub'ınız için seçtiğiniz adı kullanarak bu yer tutucuyu ve çevresindeki küme ayraçlarını değiştirin. IoT hub'ı adının Azure'da genel olarak benzersiz olması gerekir. Bu hızlı başlangıcın geri kalanında yer tutucuyu gördüğünüz her yerde IoT hub'ınızın adını kullanın.

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

    İpucu

    Bir IoT hub'ı oluşturduktan sonra, bu hızlı başlangıcın geri kalanında IoT hub'ınızla etkileşime geçmek için Azure IoT Gezgini'ni kullanacaksınız. IoT Explorer, mevcut bir IoT Hub bağlanmanızı ve cihazları eklemenizi, yönetmenizi ve izlemenizi sağlayan bir GUI uygulamasıdır. Daha fazla bilgi edinmek için bkz. Azure IoT gezginini yükleme ve kullanma. İsteğe bağlı olarak, CLI komutlarını kullanmaya devam edebilirsiniz.

IoT Explorer'ı yapılandırma

Bu hızlı başlangıcın geri kalanında IoT Gezgini'ni kullanarak ioT hub'ınıza bir cihaz kaydedecek ve cihaz telemetrisini görüntüleyebileceksiniz. Bu bölümde IoT Explorer'ı yeni oluşturduğunuz IoT hub'ına bağlanacak ve genel model deposundan tak çalıştır modellerini okuyacak şekilde yapılandıracaksınız.

Not

Bir cihazı kaydetmek için Azure CLI'yi de kullanabilirsiniz. Yeni bir cihaz kaydetmek için az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} komutunu ve cihazın birincil bağlantı dizesini almak için az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} komutunu kullanın. Cihaz bağlantı dizesini not aldıktan sonra Cihaz örneğini çalıştırma bölümüne atlayabilirsiniz.

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

  1. IoT hub'ınızın 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 çevresindeki tırnak karakterleri olmadan kopyalayın.

  3. Azure IoT Gezgini'nde soldaki menüden IoT hub'ları'nı ve ardından + Bağlantı ekle'yi seçin.

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

  5. Kaydet’i seçin.

    IoT Explorer'da bağlantı ekleme ekran görüntüsü

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

Genel model deposunu eklemek için:

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

  2. Soldaki menüden Ayarlar'IoT Tak Çalıştır ve ardından +Ekle'yi seçin ve açılan menüden Genel depo'yu seçin.

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

    IoT Gezgini'nde genel model deposunu ekleme ekran görüntüsü

  4. Kaydet’i seçin.

Cihaz kaydetme

Bu bölümde yeni bir cihaz örneği oluşturacak ve oluşturduğunuz IoT hub'ına kaydedacaksınız. Cihazınızı daha sonraki bir bölümde güvenli bir şekilde bağlamak için yeni kaydedilen cihazın bağlantı bilgilerini kullanacaksınız.

Bir cihazı kaydetmek için:

  1. IoT Gezgini'ndeki giriş görünümünde IoT hub'ları'nı seçin.

  2. Daha önce eklediğiniz bağlantı görünmelidir. Bağlantı özelliklerinin altında Cihazları bu hub'da 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, mydevice. Diğer tüm özellikleri aynı bırakın.

  4. Oluştur’u seçin.

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

  5. Kopyalama düğmelerini kullanarak Birincil bağlantı dizesi alanını kopyalayın ve not edin. Bu bağlantı dizesine daha sonra ihtiyacınız olacak.

Cihaz örneğini çalıştırma

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

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

    Not

    Azure CLI'nın yerel yüklemesini kullanıyorsanız artık iki konsol penceresi açık olabilir. Cli için kullandığınız komutları değil, yeni açtığınız konsolda bu bölümdeki komutları girdiğinizden emin olun.

  2. C# için Azure IoT SDK'sını (.NET) Microsoft yerel makinenize kopyalayın:

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

    Windows

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

    Linux veya Raspberry Pi işletim sistemi

    cd azure-iot-sdk-csharp/iothub/device/samples/solutions/PnpDeviceSamples/TemperatureController
    
  4. Azure IoT C# SDK'sını ve gerekli bağımlılıkları yükleyin:

    dotnet restore
    

    Bu komut , TemperatureController.csproj dosyasında belirtilen uygun bağımlılıkları yükler.

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

    • adlı IOTHUB_DEVICE_CONNECTION_STRINGbir ortam değişkeni ayarlayın. Değişken değeri için, önceki bölümde kaydettiğiniz cihaz bağlantı dizesini kullanın.
    • adlı IOTHUB_DEVICE_SECURITY_TYPEbir ortam değişkeni ayarlayın. değişkeni için değişmez dize değerini connectionStringkullanın.

    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şkenin 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, el ile yapılandırma olmadan akıllı cihazları çözümlerinizle tümleştirmenizi sağlayan Azure IoT Tak Çalıştır kullanır. Varsayılan olarak, bu belgedeki örneklerin çoğu IoT Tak Çalıştır kullanır. IoT PnP'nin avantajları ve kullanma veya kullanmama durumları hakkında daha fazla bilgi edinmek için bkz. IoT Tak Çalıştır 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 çıkış konsolunuzda görünür.

Telemetri görüntüleme

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

Azure IoT Gezgini'nde telemetriyi görüntülemek için:

  1. IoT Explorer'daki IoT hub'ınızdan Bu hub'daki cihazları 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'ı kullan seçeneğinin Evet olarak ayarlandığını onaylayın ve ardından Başlat'ı seçin.

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

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

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

Tek tek cihaz bileşenleri tarafından gönderilen telemetriyi 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 Gezgini'ndeki cihazınızda soldaki menüden IoT Tak Çalıştır bileşenleri'ni seçin. Ardından bileşen listesinden termostat1'i seçin.

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

  3. Telemetri bölmesinde, daha önce uyguladığınız adımları izleyin. Yerleşik olay hub'ı kullan seçeneğinin Evet olarak ayarlandığından emin olun ve ardından Başlat'ı seçin.

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

  1. 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 Azure IoT'de daha önce 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 çı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 sonlandırmak için CTRL+C tuşlarını seçin.

Koda göz atın

Bu hızlı başlangıçta, temel bir Azure IoT uygulama geliştirme iş akışını öğreneceksiniz. Bir Azure IoT hub'ı ve cihaz oluşturmak için Azure CLI ve IoT Gezgini'ni kullanırsınız. Ardından 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. Sıcaklık denetleyicisi örnek uygulaması yerel makinenizde çalışır ve IoT Hub göndermek için simülasyon algılayıcı verileri oluşturur.

Ö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
  • Ubuntu 20.04 LTS
  • Raspberry Pi 3 Modeli B+ üzerinde çalışan Raspberry Pi OS (Raspbian) sürüm 10

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

  • Azure aboneliğiniz yoksa başlamadan önce ücretsiz olarak bir abonelik oluşturun .
  • Git'i seçin.
  • Azure IoT Gezgini: Azure IoT'yi izlemek ve yönetmek için 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 Explorer'ı yüklemek istemiyorsanız, aynı adımları gerçekleştirmek için Azure CLI'yı kullanabilirsiniz.
  • Azure CLI. Bu hızlı başlangıçta Azure CLI komutlarını çalıştırmak için iki seçeneğiniz vardır:
    • Tarayıcınızda CLI komutlarını çalıştıran etkileşimli bir kabuk olan Azure Cloud Shell kullanın. Hiçbir şey yüklemeniz gerekmeyen bu seçenek önerilir. Cloud Shell ilk kez kullanıyorsanız Azure portal oturum açın. Cloud Shell'ı başlatmak ve Bash ortamını seçmek için Cloud Shell hızlı başlangıçtaki adımları izleyin.
    • İsteğe bağlı olarak, yerel makinenizde Azure CLI'yı çalıştırın. Azure CLI zaten yüklüyse, CLI'yı ve uzantıları geçerli sürüme yükseltmek için komutunu çalıştırın az upgrade . Azure CLI'yı yüklemek için bkz. Azure CLI'yi yükleme. Geliştirme platformunuz olarak Raspberry Pi kullanıyorsanız Azure Cloud Shell kullanmanızı veya Azure CLI'yı başka bir bilgisayara yüklemenizi öneririz.

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

Windows

Windows'da bu hızlı başlangıcı tamamlamak için aşağıdaki yazılımı yükleyin:

  • Java SE Development Kit 8 veya üzeri. OpenJDK'nin Zulu Derlemelerini İndirme bölümünden birden çok platform için Java 8 (LTS) JDK'yi indirebilirsiniz. Yükleyicide Yola Ekle seçeneğini belirleyin.

  • Apache Maven 3. İndirmeyi yerel bir klasöre ayıkladıktan sonra, Maven /bin klasörünün tam yolunu Windows PATH ortam değişkenine ekleyin.

Linux veya Raspberry Pi işletim sistemi

Linux veya Raspberry Pi işletim sisteminde bu hızlı başlangıcı tamamlamak için aşağıdaki yazılımı yükleyin:

Not

Bu bölümdeki adımlar Linux Ubuntu/Debian dağıtımlarını temel alır. (Raspberry Pi işletim sistemi Debian'ı temel alır.) Farklı bir Linux dağıtımı kullanıyorsanız adımları buna göre değiştirmeniz gerekir.

  • OpenJDK (Open Java Development Kit) 8 veya üzeri. Sisteminizde yüklü Java sürümünü doğrulamak için komutunu kullanabilirsiniz java -version . Yalnızca Java çalışma zamanının (JRE) değil JDK'nin yüklü olduğundan emin olun.

    1. Sisteminiz için OpenJDK'yi yüklemek için aşağıdaki komutları girin:

      Sisteminiz için varsayılan OpenJDK sürümünü yüklemek için (Ubuntu 20.04 için OpenJDK 11 ve yazma sırasında Raspberry Pi OS 10):

      sudo apt update
      sudo apt install default-jdk
      

      Alternatif olarak, yüklenecek JDK sürümünü belirtebilirsiniz. Örnek:

      sudo apt update
      sudo apt install openjdk-8-jdk
      
    2. Sisteminizde Java'nın birden çok sürümü yüklüyse, Java'nın ve Java derleyicisinin varsayılan (otomatik) sürümlerini yapılandırmak için aşağıdaki komutları kullanabilirsiniz.

      update-java-alternatives --list          #list the Java versions installed
      sudo update-alternatives --config java   #set the default Java version
      sudo  update-alternatives --config javac #set the default Java compiler version
      
    3. Ortam değişkenini JAVA_HOME JDK yüklemenizin yoluna ayarlayın. (Bu genellikle /usr/lib/jvm dizininde sürümü oluşturulmuş bir alt dizindir.)

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

      Önemli

      Bu komut değişkeni JAVA_HOME geçerli kabuk ortamınızda ayarlar. Yeni bir kabuk açtığınızda kullanılabilir hale getirmek için veya /etc/profile dosyanıza komutunu eklemenizi ~/.bashrc öneririz.

    4. Java JDK (ve JRE) sürümünün yüklü olduğunu, Java derleyici sürümünüzün JDK sürümüyle eşleşip eşleşmediğini ve ortam değişkeninin JAVA_HOME düzgün ayarlandığını doğrulayın.

      java -version
      javac -version
      echo $JAVA_HOME
      
  • Apache Maven 3. Maven'in sisteminizde yüklü sürümünü doğrulamak için komutunu kullanabilirsiniz mvn --version .

    1. Maven'ı yüklemek için aşağıdaki komutları girin:

      sudo apt-get update
      sudo apt-get install maven
      
    2. Yüklemenizi doğrulamak için aşağıdaki komutu girin.

      mvn --version
      

IoT hub oluşturma

Bu bölümde, IoT hub'ı ve kaynak grubu oluşturmak için Azure CLI kullanacaksı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ızla cihazlarınız arasında çift yönlü iletişim için merkezi bir ileti hub'ı işlevi görür.

IoT hub'ı ve kaynak grubu oluşturmak için:

  1. Azure CLI'ı başlatın:

    • Cloud Shell kullanıyorsanız, CLI komutlarındaki Dene düğmesini seçerek Cloud Shell bölünmüş bir tarayıcı penceresinde başlatın. İsterseniz Cloud Shell ayrı bir tarayıcı sekmesinde de açabilirsiniz.
    • Azure CLI'yi yerel olarak kullanıyorsanız Windows CMD, PowerShell veya Bash gibi bir konsol açın ve Azure CLI'da oturum açın.

    Bu hızlı başlangıcın geri kalanında CLI komutlarını çalıştırmak için: komut söz dizimini kopyalayın, Cloud Shell pencerenize veya CLI konsolunuza yapıştırın, değişken değerlerini düzenleyin ve Enter tuşuna basın.

  2. azure-iotuzantısını yüklemek veya geçerli sürüme yükseltmek için az extension add komutunu çalıştırın.

    az extension add --upgrade --name azure-iot
    
  3. 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 komutunu çalıştırın az account list-locations. Bu öğreticide örnek komutta gösterildiği gibi eastus kullanılı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. Aşağıdaki komutta, IoT hub'ınız için seçtiğiniz adı kullanarak bu yer tutucuyu ve çevresindeki küme ayraçlarını değiştirin. IoT hub'ı adının Azure'da genel olarak benzersiz olması gerekir. Bu hızlı başlangıcın geri kalanında yer tutucuyu gördüğünüz her yerde IoT hub'ınızın adını kullanın.

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

    İpucu

    Bir IoT hub'ı oluşturduktan sonra, bu hızlı başlangıcın geri kalanında IoT hub'ınızla etkileşime geçmek için Azure IoT Gezgini'ni kullanacaksınız. IoT Explorer, mevcut bir IoT Hub bağlanmanızı ve cihazları eklemenizi, yönetmenizi ve izlemenizi sağlayan bir GUI uygulamasıdır. Daha fazla bilgi edinmek için bkz. Azure IoT gezginini yükleme ve kullanma. İsteğe bağlı olarak, CLI komutlarını kullanmaya devam edebilirsiniz.

IoT Explorer'ı yapılandırma

Bu hızlı başlangıcın geri kalanında IoT Gezgini'ni kullanarak ioT hub'ınıza bir cihaz kaydedecek ve cihaz telemetrisini görüntüleyebileceksiniz. Bu bölümde, IoT Gezgini'ni yeni oluşturduğunuz IoT hub'ına bağlanacak ve ortak model deposundaki tak çalıştır modellerini okuyacak şekilde yapılandıracaksınız.

Not

Bir cihazı kaydetmek için Azure CLI'yi de kullanabilirsiniz. Yeni bir cihaz kaydetmek için az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} komutunu ve cihazın birincil bağlantı dizesini almak için az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} komutunu kullanın. Cihaz bağlantı dizesini not aldıktan sonra Cihaz örneğini çalıştırma bölümüne atlayabilirsiniz.

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

  1. IoT hub'ınızın 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 çevresindeki tırnak işaretleri olmadan kopyalayın.

  3. Azure IoT Gezgini'nde soldaki menüden IoT hub'ları'nı ve ardından + Bağlantı ekle'yi seçin.

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

  5. Kaydet’i seçin.

    IoT Gezgini'nde 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.

Genel model deposunu eklemek için:

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

  2. Sol menüde Ayarlar'IoT Tak Çalıştır ve ardından +Ekle'yi seçin ve açılan menüden Genel depo'yu seçin.

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

    IoT Gezgini'nde genel model deposu ekleme işleminin ekran görüntüsü

  4. Kaydet’i seçin.

Cihaz kaydetme

Bu bölümde yeni bir cihaz örneği oluşturacak ve oluşturduğunuz IoT hub'ına kaydedacaksınız. Cihazınızı daha sonraki bir bölümde güvenli bir şekilde bağlamak için yeni kaydedilen cihazın bağlantı bilgilerini kullanacaksınız.

Bir cihazı kaydetmek için:

  1. IoT Gezgini'ndeki 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ındaki Cihazları bu hub'da 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, mydevice. Diğer tüm özellikleri aynı bırakın.

  4. Oluştur’u seçin.

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

  5. Kopyalama düğmelerini kullanarak Birincil bağlantı dizesi alanını kopyalayıp not edin. Bu bağlantı dizesine daha sonra ihtiyacınız olacak.

Cihaz örneğini çalıştırma

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

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

    Not

    Azure CLI'nın yerel yüklemesini kullanıyorsanız artık iki konsol penceresi açık olabilir. Bu bölümdeki komutları CLI için kullandığınız konsola değil, yeni açtığınız konsola girdiğinizden emin olun.

    Linux ve Raspberry Pi İşletim Sistemi

    JAVA_HOME (echo $JAVA_HOME) ortam değişkeninin ayarlandığını onaylayın. JAVA_HOME ayarlama hakkında bilgi için bkz . Linux/Raspberry Pi Önkoşulları.

  2. Azure IoT Java cihaz SDK'sını yerel makinenize kopyalayın:

    git clone https://github.com/Azure/azure-iot-sdk-java.git
    
  3. SDK'nın kök klasörüne gidin ve SDK'yi 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.

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

    • adlı IOTHUB_DEVICE_CONNECTION_STRINGbir ortam değişkeni ayarlayın. Değişken değeri için önceki bölümde kaydettiğiniz cihaz bağlantı dizesini kullanın.
    • adlı IOTHUB_DEVICE_SECURITY_TYPEbir ortam değişkeni ayarlayın. değişkeni için değişmez dize değerini connectionStringkullanın.

    Cmd

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

    Not

    Windows CMD için her değişkenin 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"
    
  5. Örnek dizine gidin.

    Cmd

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

    Bash

    cd device/iot-device-samples/pnp-device-sample/temperature-controller-device-sample
    
  6. 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, el ile yapılandırma yapmadan akıllı cihazları çözümlerinizle tümleştirmenizi sağlayan Azure IoT Tak Çalıştır kullanır. Varsayılan olarak, bu belgedeki örneklerin çoğu IoT Tak Çalıştır kullanır. IoT PnP'nin avantajları ve kullanma veya kullanmama durumları hakkında daha fazla bilgi edinmek için bkz. IoT Tak Çalıştır 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 çıkış konsolunuzda görünür.

Telemetri görüntüleme

IoT Gezgini ile cihaz telemetrisini görüntüleyebilirsiniz. İsteğe bağlı olarak, Azure CLI kullanarak telemetri verilerini görüntüleyebilirsiniz.

Azure IoT Gezgini'nde telemetri verilerini görüntülemek için:

  1. IoT Gezgini'ndeki IoT hub'ınızdan Bu hub'daki cihazları 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'ı kullan seçeneğinin Evet olarak ayarlandığını onaylayın ve ardından Başlat'ı seçin.

  4. Cihaz buluta ileti gönderirken telemetri verilerini görüntüleyin.

    IoT Gezgini'nde cihaz telemetrisinin ekran görüntüsü

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

Tek tek cihaz bileşenleri tarafından gönderilen telemetri verilerini okumak için IoT Gezgini'ndeki 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 Gezgini'ndeki cihazınızda sol menüden IoT Tak Çalıştır bileşenleri seçin. Ardından bileşenler listesinden termostat1'i seçin.

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

  3. Telemetri bölmesinde, daha önce uyguladığınız adımları izleyin. Yerleşik olay hub'ı kullan seçeneğinin Evet olarak ayarlandığından emin olun ve ardından Başlat'ı seçin.

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

  1. 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 Azure IoT'de daha önce 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 çı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ışını öğreneceksiniz. Bir Azure IoT hub'ı ve cihaz oluşturmak için Azure CLI ve IoT Gezgini'ni kullanırsınız. Ardından 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. Sıcaklık denetleyicisi örnek uygulaması yerel makinenizde çalışır ve IoT Hub göndermek için simülasyon algılayıcı verileri oluşturur.

Ö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
  • Ubuntu 20.04 LTS
  • Raspberry Pi 3 Model B+ üzerinde çalışan Raspberry Pi OS (Raspbian) sürüm 10

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

  • Azure aboneliğiniz yoksa başlamadan önce ücretsiz olarak bir abonelik oluşturun .
  • Git'i seçin.
  • Node.js sürüm 12 veya üzeri. Düğüm sürümünüzü denetlemek için komutunu çalıştırın node --version.
  • Azure IoT Gezgini: Azure IoT'yi izlemek ve yönetmek için 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 Gezgini'ni yüklemek istemiyorsanız, aynı adımları gerçekleştirmek için Azure CLI'yı kullanabilirsiniz.
  • Azure CLI. Bu hızlı başlangıçta Azure CLI komutlarını çalıştırmak için iki seçeneğiniz vardır:
    • Tarayıcınızda CLI komutlarını çalıştıran etkileşimli bir kabuk olan Azure Cloud Shell kullanın. Herhangi bir şey yüklemeniz gerekmeyen bu seçenek önerilir. Cloud Shell ilk kez kullanıyorsanız Azure portal oturum açın. Cloud Shell Başlatma ve Bash ortamını seçme Cloud Shell hızlı başlangıç bölümündeki adımları izleyin.
    • İsteğe bağlı olarak, yerel makinenizde Azure CLI'yı çalıştırın. Azure CLI zaten yüklüyse, CLI'yı ve uzantıları geçerli sürüme yükseltmek için komutunu çalıştırın az upgrade . Azure CLI'yı yüklemek için bkz. Azure CLI'yı yükleme. Geliştirme platformunuz olarak Raspberry Pi kullanıyorsanız Azure Cloud Shell kullanmanızı veya Azure CLI'yi başka bir bilgisayara yüklemenizi öneririz.

IoT hub oluşturma

Bu bölümde, IoT hub'ı ve kaynak grubu oluşturmak için Azure CLI'yi kullanacaksı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 merkezi bir ileti hub'ı işlevi görür.

IoT hub'ı ve kaynak grubu oluşturmak için:

  1. Azure CLI'ı başlatın:

    • Cloud Shell kullanıyorsanız, cli komutlarında Deneyin düğmesini seçerek Cloud Shell bölünmüş bir tarayıcı penceresinde başlatın. İsterseniz Cloud Shell ayrı bir tarayıcı sekmesinde de açabilirsiniz.
    • Azure CLI'yı yerel olarak kullanıyorsanız Windows CMD, PowerShell veya Bash gibi bir konsol açın ve Azure CLI'da oturum açın.

    Bu hızlı başlangıcın geri kalanında CLI komutlarını çalıştırmak için: komut söz dizimini kopyalayın, Cloud Shell pencerenize veya CLI konsolunuza 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 geçerli sürüme yükseltmek için az extension add komutunu çalıştırın.

    az extension add --upgrade --name azure-iot
    
  3. 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 komutunu çalıştırın az account list-locations. Bu öğreticide örnek komutta gösterildiği gibi eastus kullanılı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. Aşağıdaki komuttaki bu yer tutucuyu ve çevresindeki küme ayraçlarını, IoT hub'ınız için seçtiğiniz adı kullanarak değiştirin. IoT hub adı Azure'da genel olarak benzersiz olmalıdır. Bu hızlı başlangıcın geri kalanında yer tutucuyu gördüğünüz her yerde IoT hub adınızı kullanın.

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

    İpucu

    IoT hub'ı oluşturduktan sonra, bu hızlı başlangıcın geri kalanında IoT hub'ınız ile etkileşime geçmek için Azure IoT Gezgini'ni kullanacaksınız. IoT Gezgini, mevcut bir IoT Hub bağlanmanızı ve cihazları eklemenizi, yönetmenizi ve izlemenizi sağlayan bir GUI uygulamasıdır. Daha fazla bilgi için bkz. Azure IoT gezginini yükleme ve kullanma. İsteğe bağlı olarak, CLI komutlarını kullanmaya devam edebilirsiniz.

IoT Explorer'ı yapılandırma

Bu hızlı başlangıcın geri kalanında IoT Gezgini'ni kullanarak ioT hub'ınıza bir cihaz kaydedecek ve cihaz telemetrisini görüntüleyebileceksiniz. Bu bölümde, IoT Gezgini'ni yeni oluşturduğunuz IoT hub'ına bağlanacak ve ortak model deposundaki tak çalıştır modellerini okuyacak şekilde yapılandıracaksınız.

Not

Bir cihazı kaydetmek için Azure CLI'yi de kullanabilirsiniz. Yeni bir cihaz kaydetmek için az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} komutunu ve cihazın birincil bağlantı dizesini almak için az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} komutunu kullanın. Cihaz bağlantı dizesini not aldıktan sonra Cihaz örneğini çalıştırma bölümüne atlayabilirsiniz.

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

  1. IoT hub'ınızın 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 çevresindeki tırnak işaretleri olmadan kopyalayın.

  3. Azure IoT Gezgini'nde soldaki menüden IoT hub'ları'nı ve ardından + Bağlantı ekle'yi seçin.

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

  5. Kaydet’i seçin.

    IoT Gezgini'nde 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.

Genel model deposunu eklemek için:

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

  2. Sol menüde Ayarlar'IoT Tak Çalıştır ve ardından +Ekle'yi seçin ve açılan menüden Genel depo'yu seçin.

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

    IoT Gezgini'nde genel model deposu ekleme işleminin ekran görüntüsü

  4. Kaydet’i seçin.

Cihaz kaydetme

Bu bölümde yeni bir cihaz örneği oluşturacak ve oluşturduğunuz IoT hub'ına kaydedacaksınız. Cihazınızı daha sonraki bir bölümde güvenli bir şekilde bağlamak için yeni kaydedilen cihazın bağlantı bilgilerini kullanacaksınız.

Bir cihazı kaydetmek için:

  1. IoT Gezgini'ndeki 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ındaki Cihazları bu hub'da 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, mydevice. Diğer tüm özellikleri aynı bırakın.

  4. Oluştur’u seçin.

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

  5. Kopyalama düğmelerini kullanarak Birincil bağlantı dizesi alanını kopyalayıp not edin. Bu bağlantı dizesine daha sonra ihtiyacınız olacak.

Cihaz örneğini çalıştırma

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

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

    Not

    Azure CLI'nın yerel yüklemesini kullanıyorsanız artık iki konsol penceresi açık olabilir. Bu bölümdeki komutları CLI için kullandığınız konsola değil, yeni açtığınız konsola girdiğinizden emin olun.

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

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

    Windows

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

    Linux veya Raspberry Pi işletim sistemi

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

    npm install
    

    Bu komut, cihaz örnekleri dizinindeki package.json dosyasında belirtilen uygun bağımlılıkları yükler.

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

    • adlı IOTHUB_DEVICE_CONNECTION_STRINGbir ortam değişkeni ayarlayın. Değişken değeri için önceki bölümde kaydettiğiniz cihaz bağlantı dizesini kullanın.
    • adlı IOTHUB_DEVICE_SECURITY_TYPEbir ortam değişkeni ayarlayın. değişkeni için değişmez dize değerini connectionStringkullanın.

    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şkenin 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 pnp_temperature_controller.js
    

    Not

    Bu kod örneği, el ile yapılandırma yapmadan akıllı cihazları çözümlerinizle tümleştirmenizi sağlayan Azure IoT Tak Çalıştır kullanır. Varsayılan olarak, bu belgedeki örneklerin çoğu IoT Tak Çalıştır kullanır. IoT PnP'nin avantajları ve kullanma veya kullanmama durumları hakkında daha fazla bilgi edinmek için bkz. IoT Tak Çalıştır 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 çıkış konsolunuzda görünür.

Telemetri görüntüleme

IoT Gezgini ile cihaz telemetrisini görüntüleyebilirsiniz. İsteğe bağlı olarak, Azure CLI kullanarak telemetri verilerini görüntüleyebilirsiniz.

Azure IoT Gezgini'nde telemetri verilerini görüntülemek için:

  1. IoT Gezgini'ndeki IoT hub'ınızdan Bu hub'daki cihazları 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'ı kullan seçeneğinin Evet olarak ayarlandığını onaylayın ve ardından Başlat'ı seçin.

  4. Cihaz buluta ileti gönderirken telemetri verilerini görüntüleyin.

    IoT Gezgini'nde cihaz telemetrisinin ekran görüntüsü

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

Tek tek cihaz bileşenleri tarafından gönderilen telemetri verilerini okumak için IoT Gezgini'ndeki 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 Gezgini'ndeki cihazınızda sol menüden IoT Tak Çalıştır bileşenleri seçin. Ardından bileşenler listesinden termostat1'i seçin.

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

  3. Telemetri bölmesinde, daha önce uyguladığınız adımları izleyin. Yerleşik olay hub'ı kullan seçeneğinin Evet olarak ayarlandığından emin olun ve ardından Başlat'ı seçin.

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

  1. 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 Azure IoT'de daha önce 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 çı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ışını öğreneceksiniz. Bir Azure IoT hub'ı ve cihaz oluşturmak için Azure CLI ve IoT Gezgini'ni kullanırsınız. Ardından 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. Sıcaklık denetleyicisi örnek uygulaması yerel makinenizde çalışır ve IoT Hub göndermek için simülasyon algılayıcı verileri oluşturur.

Ö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
  • Ubuntu 20.04 LTS
  • Raspberry Pi 3 Model B+ üzerinde çalışan Raspberry Pi OS (Raspbian) sürüm 10

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

  • Azure aboneliğiniz yoksa başlamadan önce ücretsiz olarak bir abonelik oluşturun .
  • Git'i seçin.
  • Python sürüm 3.7 veya üzeri. Python sürümünüzü denetlemek için komutunu çalıştırın python3 --version.
  • Azure IoT Gezgini: Azure IoT'yi izlemek ve yönetmek için 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 Gezgini'ni yüklemek istemiyorsanız, aynı adımları gerçekleştirmek için Azure CLI'yı kullanabilirsiniz.
  • Azure CLI. Bu hızlı başlangıçta Azure CLI komutlarını çalıştırmak için iki seçeneğiniz vardır:
    • Tarayıcınızda CLI komutlarını çalıştıran etkileşimli bir kabuk olan Azure Cloud Shell kullanın. Herhangi bir şey yüklemeniz gerekmeyen bu seçenek önerilir. Cloud Shell ilk kez kullanıyorsanız Azure portal oturum açın. Cloud Shell Başlatma ve Bash ortamını seçme Cloud Shell hızlı başlangıç bölümündeki adımları izleyin.
    • İsteğe bağlı olarak, yerel makinenizde Azure CLI'yı çalıştırın. Azure CLI zaten yüklüyse, CLI'yı ve uzantıları geçerli sürüme yükseltmek için komutunu çalıştırın az upgrade . Azure CLI'yı yüklemek için bkz. Azure CLI'yı yükleme. Geliştirme platformunuz olarak Raspberry Pi kullanıyorsanız Azure Cloud Shell kullanmanızı veya Azure CLI'yi başka bir bilgisayara yüklemenizi öneririz.

IoT hub oluşturma

Bu bölümde, IoT hub'ı ve kaynak grubu oluşturmak için Azure CLI'yi kullanacaksı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 merkezi bir ileti hub'ı işlevi görür.

IoT hub'ı ve kaynak grubu oluşturmak için:

  1. Azure CLI'ı başlatın:

    • Cloud Shell kullanıyorsanız, cli komutlarında Deneyin düğmesini seçerek Cloud Shell bölünmüş bir tarayıcı penceresinde başlatın. İsterseniz Cloud Shell ayrı bir tarayıcı sekmesinde de açabilirsiniz.
    • Azure CLI'yı yerel olarak kullanıyorsanız Windows CMD, PowerShell veya Bash gibi bir konsol açın ve Azure CLI'da oturum açın.

    Bu hızlı başlangıcın geri kalanında CLI komutlarını çalıştırmak için: komut söz dizimini kopyalayın, Cloud Shell pencerenize veya CLI konsolunuza 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 geçerli sürüme yükseltmek için az extension add komutunu çalıştırın.

    az extension add --upgrade --name azure-iot
    
  3. 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 komutunu çalıştırın az account list-locations. Bu öğreticide örnek komutta gösterildiği gibi eastus kullanılı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. Aşağıdaki komuttaki bu yer tutucuyu ve çevresindeki küme ayraçlarını, IoT hub'ınız için seçtiğiniz adı kullanarak değiştirin. IoT hub adı Azure'da genel olarak benzersiz olmalıdır. Bu hızlı başlangıcın geri kalanında yer tutucuyu gördüğünüz her yerde IoT hub adınızı kullanın.

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

    İpucu

    IoT hub'ı oluşturduktan sonra, bu hızlı başlangıcın geri kalanında IoT hub'ınız ile etkileşime geçmek için Azure IoT Gezgini'ni kullanacaksınız. IoT Gezgini, mevcut bir IoT Hub bağlanmanızı ve cihazları eklemenizi, yönetmenizi ve izlemenizi sağlayan bir GUI uygulamasıdır. Daha fazla bilgi için bkz. Azure IoT gezginini yükleme ve kullanma. İsteğe bağlı olarak, CLI komutlarını kullanmaya devam edebilirsiniz.

IoT Explorer'ı yapılandırma

Bu hızlı başlangıcın geri kalanında IoT Gezgini'ni kullanarak ioT hub'ınıza bir cihaz kaydedecek ve cihaz telemetrisini görüntüleyebileceksiniz. Bu bölümde, IoT Gezgini'ni yeni oluşturduğunuz IoT hub'ına bağlanacak ve ortak model deposundaki tak çalıştır modellerini okuyacak şekilde yapılandıracaksınız.

Not

Bir cihazı kaydetmek için Azure CLI'yi de kullanabilirsiniz. Yeni bir cihaz kaydetmek için az iot hub device-identity create --device-id mydevice --hub-name {YourIoTHubName} komutunu ve cihazın birincil bağlantı dizesini almak için az iot hub device-identity connection-string show --device-id mydevice --hub-name {YourIoTHubName} komutunu kullanın. Cihaz bağlantı dizesini not aldıktan sonra Cihaz örneğini çalıştırma bölümüne atlayabilirsiniz.

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

  1. IoT hub'ınızın 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 çevresindeki tırnak işaretleri olmadan kopyalayın.

  3. Azure IoT Gezgini'nde soldaki menüden IoT hub'ları'nı ve ardından + Bağlantı ekle'yi seçin.

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

  5. Kaydet’i seçin.

    IoT Gezgini'nde 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.

Genel model deposunu eklemek için:

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

  2. Sol menüde Ayarlar'IoT Tak Çalıştır ve ardından +Ekle'yi seçin ve açılan menüden Genel depo'yu seçin.

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

    IoT Gezgini'nde genel model deposu ekleme işleminin ekran görüntüsü

  4. Kaydet’i seçin.

Cihaz kaydetme

Bu bölümde yeni bir cihaz örneği oluşturacak ve oluşturduğunuz IoT hub'ına kaydedacaksınız. Cihazınızı daha sonraki bir bölümde güvenli bir şekilde bağlamak için yeni kaydedilen cihazın bağlantı bilgilerini kullanacaksınız.

Bir cihazı kaydetmek için:

  1. IoT Gezgini'ndeki 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ındaki Cihazları bu hub'da 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, mydevice. Diğer tüm özellikleri aynı bırakın.

  4. Oluştur’u seçin.

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

  5. Kopyalama düğmelerini kullanarak Birincil bağlantı dizesi alanını kopyalayıp not edin. Bu bağlantı dizesine daha sonra ihtiyacınız olacak.

Cihaz örneğini çalıştırma

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

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

    Not

    Azure CLI'nın yerel yüklemesini kullanıyorsanız artık iki konsol penceresi açık olabilir. Bu bölümdeki komutları CLI için kullandığınız konsola değil, yeni açtığınız konsola girdiğinizden emin olun.

  2. Azure IoT Python SDK cihaz örneklerini yerel makinenize kopyalayın:

    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 işletim sistemi

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

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

    • adlı IOTHUB_DEVICE_CONNECTION_STRINGbir ortam değişkeni ayarlayın. Değişken değeri için önceki bölümde kaydettiğiniz cihaz bağlantı dizesini kullanın.
    • adlı IOTHUB_DEVICE_SECURITY_TYPEbir ortam değişkeni ayarlayın. değişkeni için değişmez dize değerini connectionStringkullanın.

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

    python3 temp_controller_with_thermostats.py
    

    Not

    Bu kod örneği, el ile yapılandırma yapmadan akıllı cihazları çözümlerinizle tümleştirmenizi sağlayan Azure IoT Tak Çalıştır kullanır. Varsayılan olarak, bu belgedeki örneklerin çoğu IoT Tak Çalıştır kullanır. IoT Tak Çalıştır avantajları ve kullanma veya kullanmama durumları hakkında daha fazla bilgi edinmek için bkz. IoT Tak Çalıştır 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 çıkış konsolunuzda görünür.

Telemetri görüntüleme

IoT Gezgini ile cihaz telemetrisini görüntüleyebilirsiniz. İsteğe bağlı olarak, Azure CLI kullanarak telemetri verilerini görüntüleyebilirsiniz.

Azure IoT Gezgini'nde telemetri verilerini görüntülemek için:

  1. IoT Gezgini'ndeki IoT hub'ınızdan Bu hub'daki cihazları 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'ı kullan seçeneğinin Evet olarak ayarlandığını onaylayın ve ardından Başlat'ı seçin.

  4. Cihaz buluta ileti gönderirken telemetri verilerini görüntüleyin.

    IoT Gezgini'nde cihaz telemetrisinin ekran görüntüsü

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

Tek tek cihaz bileşenleri tarafından gönderilen telemetri verilerini okumak için IoT Gezgini'ndeki 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 Gezgini'ndeki cihazınızda sol menüden IoT Tak Çalıştır bileşenleri seçin. Ardından bileşenler listesinden termostat1'i seçin.

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

  3. Telemetri bölmesinde, daha önce uyguladığınız adımları izleyin. Yerleşik olay hub'ı kullan seçeneğinin Evet olarak ayarlandığından emin olun ve ardından Başlat'ı seçin.

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

  1. 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 Azure IoT'de daha önce 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 çı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: 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'yı 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 silindiğini onaylamak için 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'yi kullandınız. Ardından sıcaklık denetleyicisi oluşturmak, hub'a bağlamak ve telemetri göndermek için bir Azure IoT cihaz SDK'sı kullandınız. Telemetriyi izlemek için Azure CLI'yi de kullandınız.

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