IoT Platform:TSL özelliği ekleme

Ön koşullar

Bir ürün oluşturulmuş olmalıdır. Daha fazla bilgi için bkz. Ürün oluşturma.

Kullanım notları

• TSL özelliklerini modüller içinde yapılandırmanız gerekir. Her bir üründe varsayılan modüllerin sayısı ile özel modüllerin sayısının toplamı 20'yi aşamaz.

• Bir ürün yayınlandıysa, söz konusu ürünün TSL modelini değiştiremezsiniz. Bir TSL modelini değiştirmek için önce TSL modeli tanımlanmış olan ürünü yayından kaldırmalısınız.

• Yeni bir sürüm oluşturmak amacıyla TSL modelinin önceki bir sürümünü değiştirebilirsiniz.

• IoT Platform, bir TSL modelinin en son 10 sürümünü kaydedebilir. Daha eski sürümlerin üzerine yazılır.

• Bir TSL modelini değiştirdikten sonra güncellemenin etkili olması için modeli yayınlamanız gerekir.

Daha fazla bilgi için bkz. Sınırlamalar.

Yordam

1. IoT Platform konsoluna giriş yapın.

2. IoT Platform konsolunun sol üst köşesinde IoT Platform'un etkinleştirildiği bölgeyi seçin.

3. All environment sekmesinde, Overview sayfasında yönetmek istediğiniz örneği bulun ve örnek ID değerine veya örnek adına tıklayın.

4. Sol gezinme bölmesinde Devices > Products seçeneklerini belirleyin. Ürün listesinde yönetmek istediğiniz ürünü bulun ve İşlemler sütunundaki View seçeneğine tıklayın.

5. ürün ayrıntıları sayfasında Define Feature sekmesine tıklayın, Edit Draft seçeneğine tıklayın ve ardından Default Module veya Add Module seçeneğine tıklayın.

6. İsteğe bağlı. Bir modül eklemek istiyorsanız gerekli parametreleri yapılandırın ve OK seçeneğine tıklayın. Ardından eklenen modülün adına tıklayın. Aşağıdaki tabloda parametreler açıklanmaktadır.

   Parameter	Description
   Module Name	Ad 4 ila 30 karakter uzunluğunda olmalı ve harf, rakam ile alt çizgi (_) içerebilir.
   Module Identifier	Modülün kimliği. Kimlik bir ürün içinde benzersiz olmalıdır. Kimlik 1 ila 30 karakter uzunluğunda olmalı ve harf, rakam ile alt çizgi (_) içerebilir.
   Module Description	Modülün açıklaması. Açıklama 1 ila 4096 karakter uzunluğunda olmalıdır.

7. İsteğe bağlı. Version History açılan listesinden bir sürüm seçin ve Roll Back seçeneğine tıklayın. Ardından TSL modelini geçmiş sürüme göre değiştirebilirsiniz.

8. Özel bir özellik ekleyin.

   Add Self-defined Feature seçeneğine tıklayın. Ardından ürüne bir özellik, hizmet veya olay ekleyebilirsiniz.

   • Özellik ekleme: Add Self-defined Feature iletişim kutusunda Özellik Türü alanında Properties seçeneğini belirleyin. Parametreleri yapılandırın ve OK seçeneğine tıklayın.

     Aşağıdaki tabloda parametreler açıklanmaktadır.

     Parameter	Description
     Feature Name	Özelliğin adı. Örnek: güç tüketimi. Ad bir ürün içinde benzersiz olmalıdır. Ad 1 ila 30 karakter uzunluğunda olmalı ve harf, rakam, kısa çizgi (-), alt çizgi (_), eğik çizgi (/) ve nokta (.) içerebilir. Ad bir harf veya rakamla başlamalıdır.
     Identifier	Özelliğin kimliği. Kimlik bir ürün içinde benzersiz olmalıdır. Kimlik, Alink JSON biçimindeki identifier parametresinin değeriyle gösterilir. Cihaz, özellik verilerini raporlamak için bu kimliği anahtar olarak kullanır. IoT Platform, verileri alıp almamak için kimliği kontrol eder. Kimlik 1 ila 50 karakter uzunluğunda olmalı ve harf, rakam ile alt çizgi (_) içerebilir. Örnek: PowerConsumption. Not Bu parametreyi aşağıdaki ayrılmış sözcüklerden biri olarak ayarlayamazsınız: set, get, post, property, event, time ve value.
     Data type	int32: 32 bit tamsayı. Bir değer aralığı, adım boyutu ve birim belirtmeniz gerekir. float: tek duyarlıklı kayan noktalı sayı. Bir değer aralığı, adım boyutu ve birim belirtmeniz gerekir. double: çift duyarlıklı kayan noktalı sayı. Bir değer aralığı, adım boyutu ve birim belirtmeniz gerekir. enum: numaralandırma. Bir Enum öğesi için bir değer ve açıklama belirtmeniz gerekir. Örnekler: 1-ısıtma modu ve 2-soğutma modu. bool: Boolean. Boolean değerini tanımlamak için 0 veya 1 kullanmanız gerekir. Örnekler: 0 kapalı, 1 açık anlamına gelir. text: dize. Dizenin uzunluğunu belirtmeniz gerekir. Dize 1 ila 10.240 bayt uzunluğunda olmalıdır. date: zaman damgası. Dize biçiminde bir UTC zaman damgası. Birim: milisaniye. struct: JSON nesnesi. Bir JSON yapısı tanımlamanız ve yapıya JSON parametreleri eklemeniz gerekir. Örneğin, bir lambanın rengini Red, Green ve Blue parametrelerinden oluşan bir yapı olarak tanımlayabilirsiniz. İç içe geçmiş yapılar desteklenmez. array: dizi. Bir dizideki veri türünü ve öğe sayısını belirtmeniz gerekir. Öğe türü için geçerli değerler: int32, float, double, text ve struct. Bir dizideki öğeler aynı türde olmalıdır. Öğe sayısı için geçerli değerler: 1 ila 512. Not Bir ürünün Ağ Geçidi Bağlantı Protokolü parametresi Modbus olarak ayarlandığında bu parametre gerekli değildir.
     Value range	Veri Türü parametresi int32, float veya double olarak ayarlanmışsa özellik için bir değer aralığı belirtin.
     Step	Özellik değerlerinin değiştirilebileceği minimum adım boyutu. Veri Türü parametresi int32, float veya double olarak ayarlanmışsa iş gereksinimlerinize göre bir adım boyutu belirtebilirsiniz. Örneğin, bir termometre ürününe sıcaklık özelliğini eklemek istiyorsunuz. Veri Türü parametresini int32, Adım parametresini 2, Birim parametresini °C ve Değer Aralığı parametresini 0 ila 100 olarak ayarlayabilirsiniz. Bu durumda, sıcaklık her 2°C değiştiğinde termometre ürününe ait cihaz 0°C, 2°C, 4°C, 6°C veya 8°C gibi bir sıcaklık değeri raporlar.
     Örnek fiyatının birimi.	İş senaryonuza göre Yok veya diğer değerleri seçebilirsiniz.
     Read/Write Type	Read/Write: GET istekleri ve SET istekleri desteklenir. Read-only: Yalnızca GET istekleri desteklenir. Not Bir ürünün Ağ Geçidi Bağlantı Protokolü parametresi Modbus olarak ayarlandığında bu parametre gerekli değildir.
     Description	Özelliğin açıklaması. Açıklama 100 karakteri aşmamalıdır.
     Extended Information	Genişletilmiş bilgiler, bağlantı protokolü ile cihazın standart TSL modeli arasındaki eşlemeyi belirtir. Bir TSL modelinde genişletilmiş ayarları yapılandırdıktan sonra bu ayarları IoT Platform konsolundaki TSL modelinin TSL Extension Information sekmesinde görüntüleyebilirsiniz. Bir gateway sub-device öğesinin Gateway Connection Protocol parametresi Custom, OPC UA veya Modbus olarak ayarlandığında genişletilmiş bilgileri belirtmeniz gerekir. Gateway Connection Protocol parametresi Custom olarak ayarlandığında özel yapılandırmalar için JSON biçiminde bir açıklama belirtin. Açıklama 1 ila 1.024 karakter uzunluğunda olmalıdır. Gateway Connection Protocol parametresi OPC UA olarak ayarlandığında bir düğüm adı girin. Bir özellik için belirttiğiniz her düğüm adı benzersiz olmalıdır. Gateway Connection Protocol parametresi Modbus olarak ayarlandığında aşağıdaki parametreleri yapılandırın: İşlem Türü: Bu parametreyi aşağıdaki değerlerden birine ayarlayabilirsiniz. Discrete Input (salt okunur, 0x02) Coil Status (salt okunur, 0x01) Coil Status (okuma ve yazma, 0x01-okuma, 0x05-yazma) Coil Status (okuma ve yazma, 0x01-okuma, 0x0F-yazma) Coil Status (salt yazılır, 0x05) Coil Status (salt yazılır, 0x0F) Holding Registers (salt okunur, 0x03) Holding Registers (okuma ve yazma, 0x03-okuma, 0x06-yazma) Holding Registers (okuma ve yazma, 0x03-okuma, 0x10-yazma) Holding Registers (salt yazılır, 0x06) Holding Registers (salt okunur, 0x10) Input Registers (salt okunur, 0x04) Kayıt Defteri Adresi: 0x ile başlayan onaltılık bir değer belirtmeniz gerekir. Geçerli değerler: 0x0 to 0xFFFF. Örnek: 0xFE. Orijinal Veri Türü: Birden çok veri türü desteklenir. Geçerli değerler: int16, uint16, int32, uint32, int64, uint64, float, double, string, bool ve bits. Bit Konumu: Orijinal Veri Türü parametresi bits olarak ayarlandığında bu parametreyi yapılandırmanız gerekir. Verilerin depolandığı bit konumunu seçin. Değer Aralığı: Değer aralığı, orijinal verilerin belirtilen ölçekleme faktörü kullanılarak işlenmesinden sonra elde edilir. Değer aralığını aşan veriler atılır. IoT Platform aşağıdaki işlem türleri için varsayılan değer aralıklarını tanımlar: Coil Status: 0 ila 1 Discrete Input: 0 ila 1 Holding Registers: -2147483648 ila 2147483647 Input Registers: -2147483648 ila 2147483647 Kayıt Defterindeki Yüksek Bayt ve Düşük Baytı Değiştir: Kayıt defterindeki 16 bitlik tamsayının ilk 8 biti ile son 8 bitinin değiştirilip değiştirilmeyeceğini belirtir. Geçerli değerler: true: Sistem ilk 8 biti ile son 8 biti değiştirir. false: Sistem ilk 8 biti ile son 8 biti değiştirmez. Kayıt Defteri Bit Sırasını Değiştir: Orijinal 32 bitlik tamsayının ilk 16 biti ile son 16 bitinin değiştirilip değiştirilmeyeceğini belirtir. Geçerli değerler: true: Sistem ilk 16 biti ile son 16 biti değiştirir. false: Sistem ilk 16 biti ile son 16 biti değiştirmez. Ölçekleme Faktörü: Bir tamsayı veya kayan noktalı sayı belirtir. Varsayılan değer: 1. Değer 0 veya negatif olamaz. Veri Raporu: At Specific Time veya Report Changes seçeneklerinden birini seçebilirsiniz.

   • Hizmet ekleme: Add Self-defined Feature iletişim kutusunda Özellik Türü alanında Services seçeneğini belirleyin. Parametreleri yapılandırın ve OK seçeneğine tıklayın.

     Not

     Ağ Geçidi Bağlantı Protokolü parametresi Modbus olarak ayarlandığında hizmet ekleyemezsiniz.

     Aşağıdaki tabloda parametreler açıklanmaktadır.

     Parameter	Description
     Feature Name	Hizmetin adı. Ad 1 ila 30 karakter uzunluğunda olmalı ve harf, rakam, kısa çizgi (-), alt çizgi (_), eğik çizgi (/) ve nokta (.) içerebilir. Ad bir harf veya rakamla başlamalıdır.
     Identifier	Hizmetin kimliği. Kimlik bir ürün içinde benzersiz olmalıdır. Kimlik, Alink JSON biçiminde hizmet için belirtilen identifier parametresinin değeriyle gösterilir. Kimlik 1 ila 50 karakter uzunluğunda olmalı ve harf, rakam ile alt çizgi (_) içerebilir. Not Bu parametreyi aşağıdaki ayrılmış sözcüklerden biri olarak ayarlayamazsınız: set, get, post, property, event, time ve value.
     Invocation method	Asynchronous: IoT Platform, hizmet çağrıldıktan sonra sonucu döndürür. IoT Platform cihazdan yanıt beklememektedir. Synchronous: IoT Platform cihazdan yanıt bekler. Yanıt dönmezse hizmet çağrısı zaman aşımına uğrar.
     Input Parameters	İsteğe bağlı. Hizmetin giriş parametreleri. Açılan iletişim kutusunda bir giriş parametresi eklemek için + Add Parameter seçeneğine tıklayın. Ağ Geçidi Bağlantı Protokolü parametresi OPC UA olarak ayarlandığında parametrelerin sırasını belirtmek için bir parametre dizini yapılandırmanız gerekir. Not Bu parametreyi aşağıdaki ayrılmış sözcüklerden biri olarak ayarlayamazsınız: set, get, post, property, event, time ve value. Giriş parametresi olarak bir özellik kullanabilir veya özel bir giriş parametresi yapılandırabilirsiniz. Örneğin, Automatic Sprinkling hizmetini tanımlarken önceden tanımlanmış Sprinkling Interval ve Sprinkling Amount özelliklerini giriş parametresi olarak kullanabilirsiniz. IoT Platform Automatic Sprinkling hizmetini çağırdığında sprinkler cihazı belirtilen sulama aralığına ve miktarına göre sulamaya başlar. Her hizmet için en fazla 20 giriş parametresi ekleyebilirsiniz.
     Output Parameters	İsteğe bağlı. Hizmetin çıkış parametreleri. Açılan iletişim kutusunda bir çıkış parametresi eklemek için + Add Parameter seçeneğine tıklayın. Ağ Geçidi Bağlantı Protokolü parametresi OPC UA olarak ayarlandığında parametrelerin sırasını belirtmek için bir parametre dizini yapılandırmanız gerekir. Not Bu parametreyi aşağıdaki ayrılmış sözcüklerden biri olarak ayarlayamazsınız: set, get, post, property, event, time ve value. Çıkış parametresi olarak bir özellik kullanabilir veya özel bir çıkış parametresi yapılandırabilirsiniz. Örneğin, Automatic Sprinkling hizmetini tanımlarken önceden tanımlanmış Soil Humidity özelliğini çıkış parametresi olarak kullanabilirsiniz. IoT Platform Automatic Sprinkling hizmetini çağırdığında toprak nemiyle ilgili veriler döndürülür. Her hizmet için en fazla 20 çıkış parametresi ekleyebilirsiniz.
     Extended Information	Genişletilmiş bilgiler, bağlantı protokolü ile cihazın standart TSL modeli arasındaki eşlemeyi belirtir. Bir TSL modelinde genişletilmiş ayarları yapılandırdıktan sonra bu ayarları IoT Platform konsolundaki TSL modelinin TSL Extension Information sekmesinde görüntüleyebilirsiniz. Bir gateway sub-device öğesinin Gateway Connection Protocol parametresi Custom veya OPC UA olarak ayarlandığında genişletilmiş bilgileri belirtmeniz gerekir. Gateway Connection Protocol parametresi Custom olarak ayarlandığında özel yapılandırmalar için JSON biçiminde bir açıklama belirtin. Açıklama 1 ila 1.024 karakter uzunluğunda olmalıdır. Gateway Connection Protocol parametresi OPC UA olarak ayarlandığında bir düğüm adı girin. Bir hizmet için belirttiğiniz her düğüm adı benzersiz olmalıdır.
     Description	Hizmetin açıklaması. Açıklama 1 ila 100 karakter uzunluğunda olmalıdır.

   • Olay ekleme: Add Self-defined Feature iletişim kutusunda Özellik Türü alanında Events seçeneğini belirleyin. Parametreleri yapılandırın ve OK seçeneğine tıklayın.

     Not

     Ağ Geçidi Bağlantı Protokolü parametresi Modbus olarak ayarlandığında olay ekleyemezsiniz.

     Aşağıdaki tabloda parametreler açıklanmaktadır.

     Parameter	Description
     Feature Name	Olayın adı. Ad 1 ila 30 karakter uzunluğunda olmalı ve harf, rakam, kısa çizgi (-), alt çizgi (_), eğik çizgi (/) ve nokta (.) içerebilir. Ad bir harf veya rakamla başlamalıdır.
     Identifier	Olayın kimliği. Kimlik bir ürün içinde benzersiz olmalıdır. Kimlik, Alink JSON biçimindeki identifier parametresinin değeriyle gösterilir. Cihaz, olay verilerini raporlamak için bu kimliği anahtar olarak kullanır. Örnek: ErrorCode. Kimlik 1 ila 50 karakter uzunluğunda olmalı ve harf, rakam ile alt çizgi (_) içerebilir. Not Bu parametreyi aşağıdaki ayrılmış sözcüklerden biri olarak ayarlayamazsınız: set, get, post, property, event, time ve value.
     The type of the event.	Farklı türdeki olaylar için mantıksal işleme veya analiz gerçekleştirebilirsiniz. Info: Cihazlar görev tamamlama bildirimi gibi genel bildirimleri raporlar. Alert: Cihazlar, cihaz çalışırken oluşan acil durumları veya özel durumları raporlar. Bu tür olaylara yüksek öncelik atanır. Error: Cihazlar, cihaz çalışırken oluşan acil durumları veya özel durumları raporlar. Bu tür olaylara yüksek öncelik atanır.
     Output Parameters	Bir olayın çıkış parametreleri. Açılan iletişim kutusunda bir çıkış parametresi eklemek için + Add Parameter seçeneğine tıklayın. Çıkış parametresi olarak bir özellik kullanabilir veya özel bir çıkış parametresi yapılandırabilirsiniz. Örneğin, önceden tanımlanmış Voltage özelliğini çıkış parametresi olarak kullanabilirsiniz. Bir cihaz voltajla ilgili bir hata raporlarsa sorun giderme amacıyla cihazın voltajı da raporlanır. Ağ Geçidi Bağlantı Protokolü parametresi OPC UA olarak ayarlandığında parametrelerin sırasını belirtmek için bir parametre dizini yapılandırmanız gerekir. Not Bu parametreyi aşağıdaki ayrılmış sözcüklerden biri olarak ayarlayamazsınız: set, get, post, property, event, time ve value. Bir olay için en fazla 50 çıkış parametresi tanımlayabilirsiniz.
     Extended Information	Genişletilmiş bilgiler, bağlantı protokolü ile cihazın standart TSL modeli arasındaki eşlemeyi belirtir. Bir TSL modelinde genişletilmiş ayarları yapılandırdıktan sonra bu ayarları IoT Platform konsolundaki TSL modelinin TSL Extension Information sekmesinde görüntüleyebilirsiniz. Bir gateway sub-device öğesinin Gateway Connection Protocol parametresi Custom veya OPC UA olarak ayarlandığında genişletilmiş bilgileri belirtmeniz gerekir. Gateway Connection Protocol parametresi Custom olarak ayarlandığında özel yapılandırmalar için JSON biçiminde bir açıklama belirtin. Açıklama 1 ila 1.024 karakter uzunluğunda olmalıdır. Gateway Connection Protocol parametresi OPC UA olarak ayarlandığında bir düğüm adı girin. Bir olay için belirttiğiniz her düğüm adı benzersiz olmalıdır.
     Description	Olayın açıklaması. Açıklama 1 ila 100 karakter uzunluğunda olmalıdır.

TSL modelini yayınlama

1. Define Feature > Edit Draft seçeneklerini belirleyin. Açılan sayfanın sol alt köşesinde Release online seçeneğine tıklayın. Release model online? iletişim kutusu görünür.

2. İsteğe bağlı. +Add post notes seçeneğine tıklayın ve bir sürüm numarası ile not girin.

   Parameter	Description
   Version Number	TSL modelinin sürüm numarası. TSL modelini sürüm numarasına göre yönetebilirsiniz. Sürüm numarası 1 ila 16 karakter uzunluğunda olmalı ve harf, rakam ile nokta (.) içerebilir.
   note	TSL modelinin açıklaması. Açıklama harf, rakam ve özel karakterler içerebilir. Açıklama 1 ila 100 karakter uzunluğunda olmalıdır.

3. Çevrimiçi bir sürüm varsa yayınlamak istediğiniz mevcut sürüm ile çevrimiçi sürüm arasındaki farkları kontrol etmeniz gerekir.

   View Differences seçeneğine tıklayın. View Differences panelinde sürümler arasındaki farkları görüntüleyebilirsiniz. Ayarları onayladıktan sonra Confirm seçeneğine tıklayın. Release model online? iletişim kutusunda onay kutusu otomatik olarak seçilir.

   Sürümler arasındaki farkları görüntülemek istemiyorsanız "Mevcut sürüm ile çevrimiçi sürüm arasındaki farkları doğruladığınızdan emin olun." seçeneğini belirleyin.

4. TSL modelini yayınlamak için OK seçeneğine tıklayın.

Çalıştırma sonucu

Bir TSL modeli yayınladıktan sonra yayımlanan modeli IoT Platform konsolunda görüntüleyebilirsiniz. Product Details sayfasının Define Feature sekmesinde aşağıdaki işlemleri gerçekleştirebilirsiniz:

• JSON biçimindeki TSL modelini görüntülemek için TSL Model seçeneğine tıklayın.

İlgili API işlemleri

Sonraki adımlar

Varsayılan olarak, bir ürünün cihazları tarafından gönderilen TSL verileri otomatik olarak bir sıcak veri depolama alanına yazılır. İş gereksinimlerinize göre bazı veya tüm TSL modelleri için sıcak veri depolama hizmetini durdurabilirsiniz.