Azure IoT Central uygulamanızda yeni bir cihaz türü tanımlama
Cihaz şablonu, Azure IoT Central uygulamasına bağlanan bir cihaz türünün özelliklerini ve davranışlarını tanımlayan bir şemadır.
Bu makalede IoT Central'da cihaz şablonunun nasıl oluşturulacağı açıklanır. Örneğin, sıcaklık ve konum gibi özellikler gibi telemetri gönderen bir algılayıcı için cihaz şablonu oluşturabilirsiniz. Bu cihaz şablonundan bir operatör gerçek cihazlar oluşturabilir ve bağlayabilir.
Aşağıdaki ekran görüntüsünde bir cihaz şablonu örneği gösterilmektedir:
Cihaz şablonu aşağıdaki bölümlere sahiptir:
- Model - Cihazınızın IoT Central uygulamanızla nasıl etkileşim kuracaklarını tanımlamak için modeli kullanın. Her modelin benzersiz bir model kimliği vardır ve cihazın özelliklerini tanımlar. Özellikler arabirimler halinde gruplandırılır. Arabirimler, farklı modellerdeki bileşenleri yeniden kullanmanıza veya özellik kümesini genişletmek için devralmayı kullanmanıza olanak tanır.
- Ham veriler - Belirlenen önizleme cihazınız tarafından gönderilen ham verileri görüntüleyin. Bu görünüm, bir cihaz şablonunda hata ayıklarken veya sorun giderirken kullanışlıdır.
- Görünümler - Cihazdaki verileri görselleştirmek için görünümleri ve bir cihazı yönetmek ve denetlemek için formlar kullanın.
Daha fazla bilgi edinmek için bkz . Cihaz şablonları nedir?.
IoT Central REST API'sini kullanarak cihaz şablonlarını yönetmeyi öğrenmek için bkz . Cihaz şablonlarını yönetmek için IoT Central REST API'sini kullanma.
Cihaz şablonu oluşturma
Cihaz şablonları oluşturmak için çeşitli seçenekleriniz vardır:
- IoT Central GUI'de cihaz şablonunu tasarlar.
- Cihaz kataloğundan bir cihaz şablonunu içeri aktarın. İsteğe bağlı olarak, cihaz şablonunu IoT Central'daki gereksinimlerinize göre özelleştirin.
- Cihaz IoT Central'a bağlandığında, uyguladığı modelin model kimliğini göndermesini sağlayın. IoT Central, modeli model deposundan almak ve bir cihaz şablonu oluşturmak için model kimliğini kullanır. IoT Central uygulamanızın ihtiyaç duyduğu tüm bulut özelliklerini ve görünümlerini cihaz şablonuna ekleyin.
- Cihaz IoT Central'a bağlandığında IoT Central'ın cihazın gönderdiği verilerden bir cihaz şablonu tanımını otomatik olarak oluşturmasına izin verin.
- Dijital İkiz Tanım Dili (DTDL) V2 ve IoT Central DTDL uzantısını kullanarak bir cihaz modeli yazın. Cihaz modelini IoT Central uygulamanıza el ile aktarın. Ardından IoT Central uygulamanızın ihtiyaç duyduğu bulut özelliklerini ve görünümlerini ekleyin.
- Cihaz şablonlarını yönetmek için IoT Central REST API'sini kullanma seçeneğini kullanarak ioT Central uygulamasına cihaz şablonları da ekleyebilirsiniz.
Not
Her durumda, cihaz kodunun modelde tanımlanan özellikleri uygulaması gerekir. Cihaz kodu uygulaması, cihaz şablonunun bulut özellikleri ve görünümler bölümlerinden etkilenmez.
Bu bölümde, katalogdan bir cihaz şablonunu içeri aktarma ve IoT Central GUI kullanarak şablonu özelleştirme işlemi gösterilmektedir. Bu örnekte, cihaz kataloğundaki ESP32-Azure IoT Kit cihaz şablonu kullanılmaktadır:
- Yeni bir cihaz şablonu eklemek için Cihaz şablonları sayfasında + Yeni'yi seçin.
- Türü seçin sayfasında, Önceden yapılandırılmış cihaz şablonu kullanma bölümünde ESP32-Azure IoT Seti kutucuğunu bulana kadar aşağı kaydırın.
- ESP32-Azure IoT Kit kutucuğunu ve ardından İleri: Gözden Geçir'i seçin.
- Gözden Geçir sayfasında Oluştur'u seçin. Oluşturduğunuz şablonun adı Algılayıcı Denetleyicisi'dir. Model Algılayıcı Denetleyicisi, SensorTemp ve Cihaz Bilgileri arabirimi gibi bileşenleri içerir. Bileşenler, bir ESP32 cihazının özelliklerini tanımlar. Yetenekler telemetriyi, özellikleri ve komutları içerir.
Cihaz şablonunu otomatik olarak oluşturma
Ayrıca, şu anda atanmamış bir cihazdan otomatik olarak bir cihaz şablonu da oluşturabilirsiniz. IoT Central, cihaz modelini çıkarsamak için cihazın gönderdiği telemetri ve özellik değerlerini kullanır.
Not
Şu anda bu önizleme özelliği, bileşenlerden gelen telemetriyi ve özellikleri kullanamıyor. Yalnızca kök telemetri ve özelliklerden yetenekler oluşturabilir.
Aşağıdaki adımlarda bu özelliğin nasıl kullanılacağı gösterilmektedir:
Cihazınızı IoT Central'a Bağlan ve verileri göndermeye başlayın. Ham veri görünümünde verileri gördüğünüzde, Şablonu yönet açılan listesinde Şablonu otomatik oluştur'u seçin:
Veri önizleme sayfasında ham verilerde gerekli değişiklikleri yapın ve Şablon oluştur'u seçin:
IoT Central, Veri önizleme sayfasında gösterilen veri biçimini temel alan bir şablon oluşturur ve cihazı bu şablona atar. Cihaz şablonları sayfasında cihaz şablonunda yeniden adlandırma veya özellik ekleme gibi başka değişiklikler de yapabilirsiniz:
Cihaz şablonunu yönetme
Şablonun düzenleyici sayfasından şablonu yeniden adlandırabilir veya silebilirsiniz.
Şablonu tanımladıktan sonra yayımlayabilirsiniz. Şablon yayımlanana kadar cihaza bağlanamazsınız ve cihaz Cihazlar sayfasında görünmez.
Cihaz şablonlarını değiştirme ve sürüm oluşturma hakkında daha fazla bilgi edinmek için bkz . Mevcut cihaz şablonunu düzenleme.
Modeller
Model, cihazınızın IoT Central uygulamanızla nasıl etkileşime geçtiğini tanımlar. Modelinizi daha fazla özellik ile özelleştirin, özellikleri devralmak için arabirimler ekleyin veya diğer arabirimleri temel alan yeni bileşenler ekleyin.
Cihaz modeli oluşturmak için şunları yapabilirsiniz:
- Sıfırdan özel bir model oluşturmak için IoT Central'ı kullanın.
- Bir JSON dosyasından DTDL modelini içeri aktar. Cihaz oluşturucu, uygulamanız için bir cihaz modeli yazmak için Visual Studio Code kullanabilir.
- Cihaz kataloğundaki cihazlardan birini seçin. Bu seçenek, üreticinin bu cihaz için yayımladığı cihaz modelini içeri aktarır. Bu şekilde içeri aktarılan bir cihaz modeli otomatik olarak yayımlanır.
Model kimliğini görüntülemek için modeldeki kök arabirimi seçin ve Kimliği düzenle'yi seçin:
Bileşen kimliğini görüntülemek için modeldeki bileşen arabirimlerinden herhangi birinde Kimliği Düzenle'yi seçin.
Daha fazla bilgi edinmek için IoT Tak Çalıştır modelleme kılavuzuna bakın.
Arabirimler ve bileşenler
Cihaz modelinizdeki arabirimleri görüntülemek ve yönetmek için:
Cihaz Şablonları sayfasına gidin ve oluşturduğunuz cihaz şablonunu seçin. Arabirimler, cihaz şablonunun Modeller bölümünde listelenir. Aşağıdaki ekran görüntüsünde bir cihaz şablonundaki Algılayıcı Denetleyicisi kök arabirimi örneği gösterilmektedir:
Kök arabirime devralınan bir arabirim veya bileşen eklemek için üç noktayı seçin. Arabirimler ve bileşen hakkında daha fazla bilgi edinmek için modelleme kılavuzunda birden çok bileşene bakın.
Modeli veya arabirimi dışarı aktarmak için Dışarı aktar'ı seçin.
Bir arabirimin veya özelliğin DTDL'sini görüntülemek veya düzenlemek için DTDL'yi Düzenle'yi seçin.
Özellikler
Bir arabirime veya bileşene özellik eklemek için + Yetenek ekle'yi seçin. Örneğin, Bir SensorTemp bileşenine Hedef Sıcaklık özelliği ekleyebilirsiniz.
Telemetri
Telemetri, cihazdan, genellikle bir algılayıcıdan gönderilen bir değer akışıdır. Örneğin, algılayıcı aşağıdaki ekran görüntüsünde gösterildiği gibi ortam sıcaklığını bildirebilir:
Aşağıdaki tabloda bir telemetri özelliğinin yapılandırma ayarları gösterilmektedir:
| Alan | Veri Akışı Açıklaması |
|---|---|
| Görünen Ad | Görünümlerde ve formlarda kullanılan telemetri değerinin görünen adı. |
| Veri Akışı Adı | Telemetri iletisindeki alanın adı. IoT Central bu alan için görünen addan bir değer oluşturur, ancak gerekirse kendi değerinizi seçebilirsiniz. Bu alanın alfasayısal olması gerekir. |
| Yetenek Türü | Telemetri. |
| Anlam Türü | Telemetrinin sıcaklık, durum veya olay gibi anlamsal türü. Semantik tür seçimi, aşağıdaki alanlardan hangilerinin kullanılabilir olduğunu belirler. |
| Şema | Çift, dize veya vektör gibi telemetri veri türü. Kullanılabilir seçenekleri semantik tür belirler. Şema, olay ve durum anlam türleri için kullanılamaz. |
| Önem | Yalnızca olay anlam türü için kullanılabilir. Önem dereceleri Hata, Bilgi veya Uyarı'dır. |
| Durum Değerleri | Yalnızca durum semantik türü için kullanılabilir. Her birinin görünen adı, adı, numaralandırma türü ve değeri olan olası durum değerlerini tanımlayın. |
| Birim | Telemetri değeri için mph, %veya °C gibi bir birim. |
| Görüntüleme Birimi | Görünümlerde ve formlarda kullanılacak bir görüntüleme birimi. |
| Yorum | Telemetri özelliği hakkındaki tüm açıklamalar. |
| Açıklama | Telemetri özelliğinin açıklaması. |
Properties
Özellikler belirli bir noktaya değerleri temsil eder. Yazılabilir özellikleri IoT Central'dan ayarlayabilirsiniz. Örneğin, bir cihaz, bir operatörün aşağıdaki ekran görüntüsünde gösterildiği gibi hedef sıcaklığı ayarlamasına izin vermek için yazılabilir bir özellik kullanabilir:
Aşağıdaki tabloda bir özellik özelliğinin yapılandırma ayarları gösterilmektedir:
| Alan | Veri Akışı Açıklaması |
|---|---|
| Görünen Ad | Görünümlerde ve formlarda kullanılan özellik değerinin görünen adı. |
| Veri Akışı Adı | Özelliğin adı. IoT Central bu alan için görünen addan bir değer oluşturur, ancak gerekirse kendi değerinizi seçebilirsiniz. Bu alanın alfasayısal olması gerekir. |
| Yetenek Türü | Özellik. |
| Anlam Türü | Özelliğin sıcaklık, durum veya olay gibi anlamsal türü. Semantik tür seçimi, aşağıdaki alanlardan hangilerinin kullanılabilir olduğunu belirler. |
| Şema | Çift, dize veya vektör gibi özellik veri türü. Kullanılabilir seçenekleri semantik tür belirler. Şema, olay ve durum anlam türleri için kullanılamaz. |
| Yazılabilir | Özellik yazılabilir değilse cihaz, özellik değerlerini IoT Central'a bildirebilir. Özellik yazılabilirse, cihaz özellik değerlerini IoT Central'a bildirebilir ve IoT Central cihaza özellik güncelleştirmeleri gönderebilir. |
| Önem | Yalnızca olay anlam türü için kullanılabilir. Önem dereceleri Hata, Bilgi veya Uyarı'dır. |
| Durum Değerleri | Yalnızca durum semantik türü için kullanılabilir. Her birinin görünen adı, adı, numaralandırma türü ve değeri olan olası durum değerlerini tanımlayın. |
| Birim | Mph%, veya °C gibi özellik değeri için bir birim. |
| Görüntüleme Birimi | Görünümlerde ve formlarda kullanılacak bir görüntüleme birimi. |
| Yorum | Özellik özelliği hakkındaki tüm açıklamalar. |
| Açıklama | Özellik özelliğinin açıklaması. |
| Color | DTDL'ye yönelik bir IoT Central uzantısı. |
| En düşük değer | En düşük değeri ayarlama - IoT Central uzantısını DTDL olarak ayarlayın. |
| En yüksek değer | Maksimum değeri ayarlama - IoT Central uzantısını DTDL olarak ayarlayın. |
| Ondalık basamaklar | DTDL'ye yönelik bir IoT Central uzantısı. |
Komutlar
IoT Central'dan cihaz komutlarını çağırabilirsiniz. Komutlar isteğe bağlı olarak cihaza parametre geçirir ve cihazdan bir yanıt alır. Örneğin, aşağıdaki ekran görüntüsünde gösterildiği gibi bir cihazı 10 saniye içinde yeniden başlatmak için bir komut çağırabilirsiniz:
Aşağıdaki tabloda bir komut özelliğinin yapılandırma ayarları gösterilmektedir:
| Alan | Veri Akışı Açıklaması |
|---|---|
| Görünen Ad | Görünümlerde ve formlarda kullanılan komutun görünen adı. |
| Veri Akışı Adı | Komutun adı. IoT Central bu alan için görünen addan bir değer oluşturur, ancak gerekirse kendi değerinizi seçebilirsiniz. Bu alanın alfasayısal olması gerekir. |
| Yetenek Türü | Komut. |
| Çevrimdışıysa kuyruk | Etkinleştirilirse, cihaz çevrimdışı olsa bile komutunu çağırabilirsiniz. Etkinleştirilmemişse, komutu yalnızca cihaz çevrimiçi olduğunda çağırabilirsiniz. |
| Yorum | Komut özelliği hakkındaki tüm açıklamalar. |
| Açıklama | Komut özelliğinin açıklaması. |
| İstek | Etkinleştirilirse, istek parametresinin adı, görünen adı, şeması, birimi ve görüntüleme birimi gibi bir tanımı. |
| Response | Etkinleştirilirse, komut yanıtının adı, görünen adı, şeması, birimi ve görüntüleme birimi gibi bir tanımı. |
| İlk değer | Varsayılan parametre değeri. Bu parametre, DTDL'ye yönelik bir IoT Central uzantısıdır. |
Cihazların komutları nasıl uyguladığı hakkında daha fazla bilgi edinmek için bkz . Telemetri, özellik ve komut yükleri > Komutları ve uzun süre çalışan komutlar.
Çevrimdışı komutlar
Cihaz şablonundaki bir komut için Çevrimdışıysa kuyruk seçeneğini etkinleştirerek cihaz şu anda çevrimdışıysa kuyruk komutlarını seçebilirsiniz.
Bu seçenek, cihazlara bildirim göndermek için IoT Hub buluttan cihaza iletileri kullanır. Daha fazla bilgi edinmek için Buluttan cihaza ileti gönderme Başlıklı IoT Hub makalesine bakın.
Buluttan cihaza iletiler:
- Çözümünüzden cihaza tek yönlü bildirimlerdir.
- en az bir kez ileti teslimi garantisi verin. IoT Hub, cihaz başına kuyruklarda buluttan cihaza iletileri kalıcı hale getirir ve bağlantı ve cihaz hatalarına karşı dayanıklılık sağlar.
- Buluttan cihaza iletiyi işlemek için cihazın bir ileti işleyicisi uygulaması gerekir.
Not
Çevrimdışı komutlar, modeli DTDL olarak dışarı aktarıyorsanız olarak durable işaretlenir.
Bulut özellikleri
IoT Central'da cihazlar hakkındaki bilgileri depolamak için bulut özelliklerini kullanın. Bulut özellikleri hiçbir zaman bir cihaza gönderilmez. Örneğin, cihazı yükleyen müşterinin adını veya cihazın son hizmet tarihini depolamak için bulut özelliklerini kullanabilirsiniz.
İpucu
Bulut özelliklerini yalnızca modeldeki Kök bileşenine ekleyebilirsiniz.
Aşağıdaki tabloda bir bulut özelliğinin yapılandırma ayarları gösterilmektedir:
| Alan | Veri Akışı Açıklaması |
|---|---|
| Görünen Ad | Görünümlerde ve formlarda kullanılan bulut özelliği değerinin görünen adı. |
| Veri Akışı Adı | Bulut özelliğinin adı. IoT Central bu alan için görünen addan bir değer oluşturur, ancak gerekirse kendi değerinizi seçebilirsiniz. |
| Anlam Türü | Özelliğin sıcaklık, durum veya olay gibi anlamsal türü. Semantik tür seçimi, aşağıdaki alanlardan hangilerinin kullanılabilir olduğunu belirler. |
| Şema | Çift, dize veya vektör gibi bulut özelliği veri türü. Kullanılabilir seçenekleri semantik tür belirler. |
Görünümler
Görünümler, operatörün bir cihazı izlemesine ve cihazla etkileşim kurmasına olanak sağlayan görünümler ve formlar tanımlamanızı sağlar. Görünümler, telemetri ve özellik değerlerini göstermek için grafikler gibi görselleştirmeleri kullanır.
Varsayılan görünümleri oluşturmak, önemli cihaz bilgilerinizi görselleştirmenin hızlı bir yoludur. Varsayılan üç görünüm şunlardır:
Varsayılan görünümler
- Komutlar: Cihaz komutlarını içeren ve operatörünüzün bunları cihazınıza göndermesine olanak tanıyan bir görünüm.
- Genel bakış: Grafik ve ölçümleri görüntüleyen cihaz telemetrisi içeren bir görünüm.
- Hakkında: Cihaz bilgilerini içeren, cihaz özelliklerini görüntüleyen bir görünüm.
Varsayılan görünümleri oluştur'ı seçtikten sonra, bunlar cihaz şablonunuzun Görünümler bölümüne otomatik olarak eklenir.
Özel görünümler
Operatörlerin grafikleri ve ölçümleri kullanarak bir cihazı görselleştirmesini sağlamak için cihaz şablonuna görünümler ekleyin. Bir cihaz şablonuna kendi özel görünümlerinizi ekleyebilirsiniz.
Cihaz şablonuna görünüm eklemek için:
- Cihaz şablonunuz gidin ve Görünümler'i seçin.
- Cihazı Görselleştirme'yi seçin.
- Görünüm adı'nda görünümünüz için bir ad girin.
- Kutucuk ekle'nin altındaki Görselle başlat'ı seçin ve kutucuğunuzun görsel türünü seçin. Ardından Kutucuk ekle'yi seçin veya görseli sürükleyip tuvale bırakın. Kutucuğu yapılandırmak için dişli simgesini seçin.
Görünümünüzü test etmek için Önizleme cihazını yapılandır'ı seçin. Bu özellik, görünümü bir operatör yayımlandıktan sonra görürken görmenizi sağlar. Görünümlerinizin doğru verileri gösterdiğini doğrulamak için bu özelliği kullanın. Aşağıdaki seçeneklerden birini seçin:
- Önizleme cihazı yok.
- Cihaz şablonunuz için yapılandırdığınız gerçek test cihazı.
- Cihaz kimliğini kullanarak uygulamanızda var olan bir cihaz.
Formlar
Operatörlerin özellikleri görüntüleyip ayarlayarak bir cihazı yönetmesini sağlamak için cihaz şablonuna form ekleyin. Operatörler yalnızca bulut özelliklerini ve yazılabilir cihaz özelliklerini düzenleyebilir. Bir cihaz şablonu için birden çok form olabilir.
Görünümler düğümünü seçin ve ardından Yeni bir görünüm eklemek için Düzenleme cihazı ve bulut verileri kutucuğunu seçin.
Form adını Cihazı yönet olarak değiştirin.
Forma eklenecek özellikleri ve bulut özelliklerini seçin. Ardından Bölüm ekle'yi seçin.
Yeni formunuzu kaydetmek için Kaydet'i seçin.
Cihaz şablonunu yayımlama
Cihaz modelinizi uygulayan bir cihazı bağlayabilmeniz için önce cihaz şablonunuzu yayımlamanız gerekir.
Bir cihaz şablonu yayımlamak için size cihaz şablonunuz gidin ve Yayımla'yı seçin.
Bir cihaz şablonunu yayımladıktan sonra operatör Cihazlar sayfasına gidebilir ve cihaz şablonunuzu kullanan gerçek veya sanal cihazlar ekleyebilir. Değişiklik yaparken cihaz şablonunuzu değiştirmeye ve kaydetmeye devam edebilirsiniz. Bu değişiklikleri Cihazlar sayfasının altında görüntülemek üzere operatöre göndermek istediğinizde, her seferinde Yayımla'yı seçmeniz gerekir.