Azure IoT Central çözümünde özellikleri kullanma

Bu nasıl yapılır kılavuzu, Azure IoT Central uygulamanızdaki bir cihaz şablonunda tanımlanan cihaz özelliklerini nasıl kullanacağınızı gösterir.

Özellikler belirli bir noktaya değerleri temsil eder. Örneğin bir cihaz, ulaşmaya çalıştığı hedef sıcaklığı bildirmek için bir özellik kullanabilir. Varsayılan olarak, cihaz özellikleri IoT Central'da salt okunur durumdadır. Yazılabilir özellikler, cihazınızla Azure IoT Central uygulamanız arasında durumu eşitlemenize olanak sağlar.

Azure IoT Central uygulamasında bulut özelliklerini de tanımlayabilirsiniz. Bulut özelliği değerleri hiçbir zaman bir cihazla değiş tokuş etmez ve bu makalenin kapsamı dışındadır.

IoT Pug ve Play özellik kuralları hakkında bilgi edinmek için bkz. IoT Tak Çalıştır kuralları.

Bir cihazın IoT Central ile yaptığı özellik verileri hakkında daha fazla bilgi edinmek için bkz . Telemetri, özellik ve komut yükleri.

IoT Central REST API'sini kullanarak özellikleri yönetmeyi öğrenmek için bkz . Cihazları denetlemek için IoT Central REST API'sini kullanma..

Cihaz SDK'larını kullanmadan bir cihazda özellikleri uygulamayı öğrenmek için bkz . MQTT protokolunu kullanarak IoT hub'ı ile iletişim kurma.

Özelliklerinizi tanımlama

Özellikler, cihazınızın durumunu temsil eden veri alanlarıdır. Bir cihazın açık/kapalı durumu gibi cihazın dayanıklı durumunu göstermek için özellikleri kullanın. Özellikler, cihazın yazılım sürümü gibi temel cihaz özelliklerini de temsil edebilir. Özellikleri salt okunur veya yazılabilir olarak bildirirsiniz.

Aşağıdaki ekran görüntüsünde Azure IoT Central uygulamasındaki bir özellik tanımı gösterilmektedir.

Aşağıdaki tabloda bir özellik özelliğinin yapılandırma ayarları gösterilmektedir.

Alan	Veri Akışı Açıklaması
Görünen ad	Pano kutucuklarında ve cihaz formlarında kullanılan özellik değerinin görünen adı.
Veri Akışı Adı	Özelliğin adı. Azure IoT Central bu alan için görünen addan bir değer oluşturur, ancak gerekirse kendi değerinizi seçebilirsiniz. Bu alan alfasayısal olmalıdır. Cihaz kodu bu Ad değerini kullanır.
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 Azure IoT Central'a bildirebilir. Özellik yazılabilirse cihaz, özellik değerlerini Azure IoT Central'a bildirebilir. Ardından Azure 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.
Unit	Mph%, veya °C gibi özellik değeri için bir birim.
Görüntü birimi	Pano kutucuklarında ve cihaz formlarında 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ı.

Azure IoT Central'ın bir cihaz şablonunda özellikleri tanımlamak için kullandığı Dijital İkiz Tanım Dili (DTDL) hakkında bilgi edinmek için bkz. IoT Tak Çalıştır kuralları > Salt okunur özellikler.

Görünen ad ve açıklama gibi isteğe bağlı alanlar, arabirime ve özelliklere daha fazla ayrıntı eklemenize olanak sağlar.

Bir özellik oluşturduğunuzda, Object ve Enum gibi karmaşık şema türlerini belirtebilirsiniz.

Nesne gibi karmaşık Şemayı seçtiğinizde nesne şemasını tanımlamanız gerekir.

Salt okunur özellikleri uygulama

Varsayılan olarak, özellikler salt okunur olur. Salt okunur özellikler, cihaz raporu özellik değerinin Azure IoT Central uygulamanızda güncelleştirilmesine olanak sağlar. Azure IoT Central uygulamanız salt okunur bir özelliğin değerini ayarlayamaz.

Azure IoT Central, cihaz ile Azure IoT Central uygulaması arasında özellik değerlerini eşitlemek için cihaz ikizlerini kullanır. Cihaz özelliği değerleri, cihaz ikizi bildirilen özelliklerini kullanır. Daha fazla bilgi için bkz . cihaz ikizleri.

Cihaz, özellik güncelleştirmelerini JSON yükü olarak gönderir. Daha fazla bilgi için bkz . Telemetri, özellik ve komut yükleri.

Azure IoT Central uygulamanıza özellik güncelleştirmesi göndermek için Azure IoT cihaz SDK'sını kullanabilirsiniz.

Birden çok dilde uygulanan uygulamalar için bkz . İstemci uygulaması oluşturma ve Azure IoT Central uygulamanıza bağlama.

Azure IoT Central uygulamasındaki aşağıdaki görünümde cihaz salt okunur özellikleri gösterilir:

Yazılabilir özellikleri uygulama

IoT Central işleci bir formda yazılabilir özellikler ayarlar. Azure IoT Central özelliği cihaza gönderir. Azure IoT Central, cihazdan bir bildirim bekler.

Birden çok dilde uygulanan uygulamalar için bkz . İstemci uygulaması oluşturma ve Azure IoT Central uygulamanıza bağlama.

Yanıt iletisi ve av alanlarını içermelidirac. ad alanı isteğe bağlıdır. Daha fazla bilgi edinmek için bkz. IoT Tak Çalıştır > kuralları Yazılabilir özellikler.

Operatör Azure IoT Central kullanıcı arabiriminde yazılabilir bir özellik ayarladığında, uygulama değeri cihaza göndermek için cihaz ikizi istenen özelliğini kullanır. Cihaz daha sonra cihaz ikizi bildirilen özelliğini kullanarak yanıt verir. Azure IoT Central bildirilen özellik değerini aldığında, özellik görünümünü Kabul Edildi durumuyla güncelleştirir.

Değeri girip Kaydet'i seçtiğinizde ilk durum Beklemede'dir. Cihaz değişikliği kabul ettiğinde durum Kabul Edildi olarak değişir.

Atanmamış cihazlarda özellikleri kullanma

Bir cihaz şablonuna atanmamış bir cihazda yazılabilir özellikleri görüntüleyebilir ve güncelleştirebilirsiniz.

Atanmamış bir cihazda mevcut özellikleri görüntülemek için Cihazlar bölümünde cihaza gidin, Cihazı yönet'i ve ardından Cihaz Özellikleri'ni seçin:

Yazılabilir özellikleri bu görünümde güncelleştirebilirsiniz:

Sonraki adımlar

Azure IoT Central uygulamanızda özellikleri kullanmayı öğrendiğinize göre bkz:

• IoT Tak Çalıştır kuralları
• Telemetri, özellik ve komut yükleri
• İstemci uygulaması oluşturma ve Azure IoT Central uygulamanıza bağlama