Thing Specification Language (TSL) modeli, IoT Platform'da bir ürün için tanımlanan veri modelidir. TSL modeli, bir ürünün özelliklerini açıklamak için kullanılır. Bu konuda TSL modelinin kavramları ve sınırlamaları açıklanmaktadır.
Özellikler
TSL modeli; sensör, araç içi cihaz, bina veya fabrika gibi fiziksel bir varlığı cloud ortamında dijitalleştirir. TSL modeli; bir varlığın özelliklerini, hizmetlerini ve olaylarını içerir. TSL modeli, varlığın ne olduğunu, neler yapabileceğini ve hangi bilgileri sağlayabileceğini tanımlar. Bir ürünün TSL özelliklerini özellikler, hizmetler ve olaylar boyutlarında tanımlayabilirsiniz.
Özellik türü | Açıklama |
Property | Property, çalışan bir cihazın durumunu veya bilgilerini açıklayan bir TSL özelliğidir. Örneğin; bir property çevresel izleme cihazı tarafından toplanan sıcaklık bilgisi, akıllı lambanın açık veya kapalı durumu ya da elektrikli fanın rüzgar hızı olabilir. Property'ler okuma/yazma ve salt okunur olarak sınıflandırılır. Okuma/yazma property'leri için değer belirtebilir ve bu değerleri okuyabilirsiniz. Salt okunur property'lerin değerlerini yalnızca okuyabilirsiniz. |
Service | Service, harici çağrılar için bir cihaz tarafından sunulan bir komut veya yöntemdir. Çağırmak istediğiniz bir service için giriş ve çıkış parametrelerini yapılandırabilirsiniz. Bir service, giriş parametrelerinin değerlerini okur ve sonuçları çıkış parametrelerinde döndürür. Property'lere kıyasla service'ler, karmaşık iş mantığını uygulamak üzere bir komut kullanılarak çağrılabilir. Örneğin, belirli bir görevi gerçekleştirmek için bir service çağırabilirsiniz. Bir service'i senkron veya eşzamansız şekilde çağırabilirsiniz. |
Event | Event; bir cihaz çalışırken bildirim ve işlem amacıyla IoT Platform'a raporladığı uyarılar ve hatalar dahil olmak üzere bilgileri içerir. Bir event birden fazla çıkış parametresi içerebilir. Örneğin; bir event görev tamamlandığında gönderilen bir bildirim, cihazda hata oluştuğunda cihazın sıcaklığı ve hata zamanı veya cihaz için bir uyarı tetiklendiğinde cihazın durumu olabilir. Event'lere abone olabilir veya bunları iletebilirsiniz. |
IoT Platform, bir ürün için property'ler, service'ler ve event'ler dahil olmak üzere birden fazla özellik kümesi tanımlamanıza olanak tanır. Bir TSL modülü, bir özellik kümesini ifade eder. Farklı TSL modülleri birbirini etkilemez.
TSL modülleri, endüstriyel senaryolardaki karmaşık cihaz modelleme sorunlarını çözmenize yardımcı olur. Aynı ürünü kullanarak farklı özelliklere sahip cihazlar geliştirebilirsiniz.
Örneğin, elektrikli fan ısıtıcı ürününün property'leri arasında Power Switch, Gear (high, medium, and low) ve Indoor Temperature bulunur. İlk iki property'yi bir modüle, üç property'yi de başka bir modüle ekleyebilirsiniz. Ardından, cihazları TSL modüllerine göre geliştirebilirsiniz. Bu sayede, aynı üründeki farklı cihazlar farklı özelliklere sahip olur.
IoT Platform varsayılan modülü sağlar. İş gereksinimlerinize göre özel modüller ekleyebilirsiniz. Her bir üründe varsayılan modül sayısı ile özel modül sayısının toplamı 20'yi aşamaz.
1 Ocak 2021 tarihinden önce tanımlanan özellikler varsayılan modülde sınıflandırılır.
Açıklama
IoT Platform, modülleri ve ürün özelliklerini açıklamak için TSL sağlar.
İş senaryonuza bağlı olarak bir TSL modülünde property'ler, service'ler veya event'ler tanımlayabilirsiniz.
Her TSL dosyası JSON biçimindedir. IoT Platform konsolunda JSON biçimli bir TSL modelini görüntülemek veya dışa aktarmak için aşağıdaki adımları uygulayın: Product Details sayfasında Define Feature seçeneğine tıklayın. Define Feature sekmesinde TSL Model seçeneğine tıklayın. TSL alanları hakkında daha fazla bilgi için bkz. TSL alanı açıklamaları.
IoT Platform'a bir veya daha fazla TSL modeli ekleyebilirsiniz. Aynı anda birden fazla TSL modeli içe aktardığınızda özel TSL dosyaları oluşturabilirsiniz. Daha fazla bilgi için bkz. Sınırlamalar.
Sınırlamalar
TSL özelliklerinin sınırlamaları hakkında bilgi için bkz. Sınırlamalar. Aşağıdaki tabloda TSL dosyalarını içe aktarırken geçerli olan sınırlamalar açıklanmaktadır.
İşlem | Sınır |
Tek bir TSL dosyası içe aktarma | Dosya uzantısı Geçerli karakterler satır sonları ve hizalama karakterlerini içermez. |
Birden fazla TSL dosyası içe aktarma |
|