IoT Platform:Konular

Konu kategorileri

Konu kategorileri ürünler açısından tanımlanır. Her konu kategorisi, aynı ürün içindeki farklı cihazlar için bir dizi konuyu temsil eder. Bir product için birden fazla konu kategorisi tanımlayabilirsiniz. Bir konu kategorisi, bir product içindeki tüm cihazlar için geçerli olur.

Aşağıdaki maddeler bir konu kategorisinin nasıl kullanılacağını açıklamaktadır:

• Bir konu kategorisi için özellikleri tanımlayın.

  Bir konu kategorisi birkaç alandan oluşur. Alanları eğik çizgi (/) ile ayırın. Örnek: /${productKey}/${deviceName}/user/update.

  ${productKey} ve ${deviceName} alanları sabittir. Son ek ve ön ek alanları farklı amaçlara sahip mesajları tanımlamak için kullanılır.

  • ${productKey}: ürünün ProductKey değeridir.

    Değişkeni gerçek bir ProductKey değeriyle değiştirmeniz gerekir.

  • ${deviceName}: cihazın DeviceName değeridir.

    Bir konu kategorisinde ${deviceName}, ürün içindeki tüm cihazları temsil eden bir değişkendir. Değişkeni gerçek bir DeviceName değeriyle değiştirmeniz gerekmez.

• Bir konu kategorisi üzerindeki izinleri tanımlayın.

  • Publish: Bir ürünün cihazları, bir konu kategorisinin konularına mesaj yayınlayabilir.

  • Subscribe: Bir ürünün cihazları, mesaj almak için bir konu kategorisinin konularına abone olabilir.

  • Publish and Subscribe: Cihazlar ilgili konulara mesaj yayınlayabilir ve bu konulardan mesaj alabilir.

Konu tanımlama

Bir konu kategorisindeki ${productKey}/${deviceName} ifadesi benzersiz bir cihazı belirtir. İki değişken gerçek değerlerle değiştirildikten sonra cihazın konusu oluşturulur.

Konular, konu kategorileriyle aynı biçime sahiptir. Bir konu ile bir konu kategorisi arasındaki fark, konu kategorisindeki ${deviceName} değişkeninin konuda gerçek bir DeviceName değeriyle değiştirilmesidir.

Aşağıdaki örneklerde a19mzPZ*** ürünündeki device1 ve device2 cihazlarının konuları gösterilmektedir:

• /a19mzPZ****/device1/user/update

• /a19mzPZ****/device2/user/update

Bir konu kategorisinin özellikleri ve izinleri belirli konulara eşlenir. Aşağıdaki maddeler bir konunun nasıl kullanılacağını açıklamaktadır:

• Konular mesaj iletişimi için kullanılır.

  Önemli

  Yukarı yönlü ve aşağı yönlü mesajlaşmayı hata ayıklarken belirtilen konuların gerekli izinlere sahip olduğundan emin olun.

• Konular yalnızca belirtilen cihazlar tarafından kullanılabilir.

  Örneğin, /a19mzPZ****/device1/user/update konusu 1. Cihaz adlı bir cihaza aittir. Yalnızca 1. Cihaz, abone olunan konuya mesaj yayınlayabilir veya bu konudan mesaj alabilir. Diğer cihazlar bu konuyu kullanamaz.

• Bir cihazın mesajlaşmasını yönetin.

  Bir cihazın durumunu görüntülemek için şu adımları uygulayın: IoT Platform konsolu giriş yapın ve Devices sayfasında cihazı devre dışı bırakın. Cihazı devre dışı bırakmak için sunucuda DisableThing işlemini de çağırabilirsiniz. Cihazı devre dışı bırakmak istemiyorsanız cihaza gönderilen mesajları yönetebilirsiniz.

Konu oluşturma

Aşağıdaki şekilde konuların nasıl oluşturulduğu gösterilmektedir.

1. IoT Platform konsolu üzerinde oturum açın ve bir ürün oluşturun. Daha fazla bilgi için bkz. Ürün oluşturma.

   Bir ürün oluşturduktan sonra IoT Platform, ürün için Topics for Basic Communications, Topics for TSL Communications ve Custom Topics dahil olmak üzere önceden tanımlanmış konu kategorileri sağlar.

   Product Details sayfasında konu kategorilerini görüntülemek için Topic Categories sekmesini tıklayın. Daha fazla bilgi için bkz. Konuları sınıflandırma. Topic Categories sekmesinde Topic Category seçeneğini tıklayın. Konu Kategorisi sekmesinde Konu Kategorisini Düzenle seçeneğini tıklayın, parametreleri yapılandırın ve ürüne özel bir konu kategorisi oluşturmak için Tamam'ı tıklayın. Daha fazla bilgi için bkz. İletişim için özel konuları kullanma.

2. Bir ürüne cihaz ekleyin. Daha fazla bilgi için bkz. Cihaz ekleme.

   Bir cihaz eklendiğinde, ürünün tüm konu kategorileri otomatik olarak cihaza eşlenerek belirli konular oluşturulur. Bir konu kategorisinin özellikleri ve izinleri de belirli konulara eşlenir. Her cihaz için ayrı konular oluşturmanıza gerek yoktur.

   Önemli

   • Konular, cihazı yapılandırdıktan ve cihazı IoT Platform'a bağladıktan sonra yalnızca Device Details sayfasının Topic List sekmesinde görüntülenir. Cihazın Subscribe iznine sahip olduğu bir konuya abone olmak ve konuyu Topic List sekmesinde görüntülemek için aşağıdaki yöntemlerden birini kullanabilirsiniz.

     • Cihaz simülasyonunu kullanma: Cihaz çevrimiçi olduktan sonra IoT Platform, cihazda Subscribe iznine sahip temel iletişim konularına ve Thing Specification Language (TSL) iletişim konularına otomatik olarak abone olur. Ayrıca Cihaz Simülasyonu sayfasındaki özel konuların Upstream Debug özelliğini kullanarak özel konulara da abone olabilirsiniz.

     • MQTT.fx kullanarak cihazı simüle etme ve IoT Platform'a bağlama: Cihaz çevrimiçi olduktan sonra konulara abone olmak için Subscribe özelliğini kullanabilirsiniz.

     • Cihazı IoT Platform'a bağlamak, cihazı etkinleştirmek ve ardından konulara abone olmak için Link SDK'yı geliştirin. Daha fazla bilgi için 3. Adım'a bakın.

     • SubscribeTopic: Yapılandırılmış veya simüle edilmiş bir cihazı IoT Platform'a bağladıktan ve cihaz beklendiği gibi çevrimiçi olduktan sonra, cihaz için bir konuya abone olmak üzere bu işlemi çağırabilirsiniz.

   • Yukarı yönlü ve aşağı yönlü mesajlaşmayı hata ayıklarken belirtilen konuların gerekli izinlere sahip olduğundan emin olun.

     Product Details sayfasının Topic Categories sekmesinde her konunun Allowed Operations parametresini görüntüleyebilirsiniz.

3. Cihazı yapılandırın ve IoT Platform'a bağlayın.

   Bir cihazın IoT Platform ile iletişim kurabilmesi ve IoT Platform'un çeşitli özelliklerini kullanabilmesi için cihazın ilgili konulara abone olması gerekir. Ayrıca Publish iznine sahip konulara mesaj yayınlama mantığını da belirtmeniz gerekir. Cihazı yapılandırma hakkında daha fazla bilgi için bkz. Link SDK belgeleri.

   • Cihaz, belirtilen konulara abone olmak ve IoT Platform'dan mesaj almak için SUB komutunu gönderebilir. Cihazı yapılandırma hakkında daha fazla bilgi için bkz. Link SDK belgeleri.

     IoT Platform tarafından sağlanan C için Link SDK'nın 3,1, 3,2 ve 4.x sürümleri otomatik konu aboneliğini destekler. Desteklenen konular hakkında daha fazla bilgi için bkz. Otomatik abone olunan konular.

     Önemli

     Bir cihaz, IoT Platform'da önceden tanımlanmış /sys/${productKey}/${deviceName}/thing/service/property/set gibi bir sistem konusuna abone olabilir. Ancak cihaz, adı /sys/${productKey}/${deviceName} ile başlayan sistem konularına abone olmak için /sys/${productKey}/${deviceName}/# ifadesini kullanamaz.

   • Cihaz, Publish iznine sahip bir konuya PUB komutunu göndererek IoT Platform'a mesaj gönderebilir. Cihazı yapılandırma hakkında daha fazla bilgi için bkz. Link SDK belgeleri.

   Cihazı doğrulayın ve IoT Platform'a bağlayın. Daha fazla bilgi için bkz. Cihazları doğrulama.

   Bir cihaz bir konuya abone olmak için SUB komutu gönderdikten sonra konuyu görüntülemek için şu adımları uygulayın: IoT Platform konsolu üzerinde oturum açın, Devices > Devices yolunu izleyin, cihazı bulun ve İşlemler sütununda View seçeneğini tıklayın. Device Details sayfasında Topic List seçeneğini tıklayın. Görüntülenen sekmede, abone olunan tüm konular Subscribed Topics bölümünde listelenir.

   Not

   Cihaz, belirtilen konulardan aboneliği iptal etmek için UNSUB komutunu gönderebilir. Ardından konular Subscribed Topics bölümünden kaldırılır.

İletişim için konuları kullanma

Aşağıdaki şekilde bir cihaz IoT Platform'a bağlandıktan sonraki iletişim süreci gösterilmektedir.

Konuları sınıflandırma

Konular; temel iletişim konuları, TSL iletişim konuları ve özel konular olarak sınıflandırılır. Aşağıdaki tabloda konu türleri açıklanmaktadır.

Sınırlamalar

Bir ürün için bir konu kategorisindeki konu sayısı, ürüne eklenen cihaz sayısına eşittir. Daha fazla bilgi için bkz. Sınırlamalar.