Model Thing Specification Language (TSL) adalah model data yang didefinisikan untuk suatu produk di IoT Platform. Model ini digunakan untuk menggambarkan fitur-fitur dari sebuah produk. Topik ini menjelaskan konsep dan batasan dari model TSL.
Fitur
Model TSL mendigitalkan entitas fisik di cloud, seperti sensor, perangkat terpasang pada kendaraan, gedung, atau pabrik. Model ini mencakup properti, layanan, dan peristiwa dari suatu entitas. Model TSL menggambarkan apa entitas tersebut, apa yang dapat dilakukan oleh entitas tersebut, dan informasi apa yang dapat disediakan oleh entitas tersebut. Anda dapat mendefinisikan fitur TSL dari suatu produk berdasarkan dimensi properti, layanan, dan peristiwa.
Jenis Fitur | Deskripsi |
Properti | Properti adalah fitur TSL yang menggambarkan status atau informasi dari perangkat yang sedang beroperasi. Sebagai contoh, properti bisa berupa informasi suhu yang dikumpulkan oleh perangkat pemantau lingkungan, keadaan hidup atau mati lampu pintar, atau kecepatan angin kipas listrik. Properti diklasifikasikan menjadi properti baca/tulis dan properti hanya-baca. Anda dapat menentukan nilai untuk properti baca/tulis dan membaca nilainya. Anda hanya dapat membaca nilai dari properti hanya-baca. |
Layanan | Layanan adalah perintah atau metode yang disediakan oleh perangkat untuk pemanggilan eksternal. Anda dapat mengonfigurasi parameter input dan output untuk layanan yang ingin Anda panggil. Layanan membaca nilai dari parameter input dan mengembalikan hasilnya dalam parameter output. Dibandingkan dengan properti, layanan dapat dipanggil menggunakan perintah untuk mengimplementasikan logika bisnis yang kompleks. Sebagai contoh, Anda dapat memanggil layanan untuk melakukan tugas tertentu. Anda dapat memanggil layanan secara sinkron atau asinkron. |
Peristiwa | Peristiwa berisi informasi yang dilaporkan perangkat ke IoT Platform untuk notifikasi dan pemrosesan ketika perangkat beroperasi, termasuk peringatan dan kegagalan. Peristiwa dapat berisi beberapa parameter output. Sebagai contoh, peristiwa dapat berupa notifikasi ketika tugas selesai, suhu dan waktu kegagalan perangkat ketika terjadi kegagalan pada perangkat, dan status perangkat ketika peringatan dipicu untuk perangkat tersebut. Anda dapat berlangganan atau mengirimkan peristiwa. |
IoT Platform memungkinkan Anda mendefinisikan beberapa set fitur untuk suatu produk, termasuk properti, layanan, dan peristiwa. Modul TSL menunjukkan satu set fitur. Modul TSL yang berbeda tidak saling memengaruhi.
Modul TSL memungkinkan Anda menyelesaikan masalah pemodelan perangkat yang kompleks dalam skenario industri. Anda dapat mengembangkan perangkat dengan fitur berbeda menggunakan produk yang sama.
Sebagai contoh, properti produk pemanas kipas listrik meliputi Power Switch, Gear (high, medium, and low), dan Indoor Temperature. Anda dapat menambahkan dua properti pertama dalam satu modul dan semua tiga properti dalam modul lain. Kemudian, Anda dapat mengembangkan perangkat berdasarkan modul TSL. Dengan cara ini, perangkat yang berbeda dalam produk yang sama memiliki fitur yang berbeda.
IoT Platform menyediakan modul default. Anda dapat menambahkan modul kustom sesuai kebutuhan bisnis Anda. Jumlah total modul default dan modul kustom di setiap produk tidak boleh melebihi 20.
Fitur yang didefinisikan sebelum 1 Januari 2021 dikategorikan ke dalam modul default.
Deskripsi
IoT Platform menyediakan TSL untuk menggambarkan modul dan fitur produk.
Anda dapat mendefinisikan properti, layanan, atau peristiwa dalam modul TSL berdasarkan skenario bisnis Anda.
Setiap file TSL berformat JSON. Untuk melihat atau mengekspor model TSL berformat JSON di konsol IoT Platform, lakukan langkah-langkah berikut: Pada halaman Product Details, klik Define Feature. Pada tab Definisikan Fitur, klik TSL Model. Untuk informasi lebih lanjut tentang bidang TSL, lihat Parameter TSL.
Anda dapat menambahkan satu atau lebih model TSL di IoT Platform. Saat Anda mengimpor beberapa model TSL secara bersamaan, Anda dapat membuat file TSL kustom. Untuk informasi lebih lanjut, lihat Batasan.
Batasan
Untuk informasi tentang batasan fitur TSL, lihat Batasan. Tabel berikut menggambarkan batasan yang berlaku saat Anda mengimpor file TSL.
Operasi | Batasan |
Impor file TSL tunggal | Akhiran file adalah Karakter valid tidak termasuk baris baru dan karakter penyelarasan. |
Impor beberapa file TSL |
|