Di IoT Platform, Anda dapat menentukan model Thing Specification Language (TSL) untuk suatu Produk. Model TSL mengabstraksikan produk fisik menjadi model data yang terdiri dari properti, layanan, dan event. Model ini memungkinkan IoT Platform mengelola dan berinteraksi dengan Perangkat. Setelah membuat produk, Anda dapat menentukan model TSL-nya. Perangkat yang termasuk dalam produk tersebut secara otomatis mewarisi model TSL tersebut.
Prasyarat
Anda telah membuat produk. Untuk informasi selengkapnya, lihat Buat produk dan perangkat.
Latar Belakang
Topik ini menggunakan lampu jalan sebagai contoh untuk menunjukkan cara menentukan dua properti untuk suatu produk: Main Light Switch dan Current. Setelah Anda menentukan model TSL, Anda dapat menghubungkan beberapa perangkat lampu jalan ke produk tersebut. Setiap perangkat secara otomatis mewarisi model TSL yang telah ditentukan. Untuk mempelajari lebih lanjut tentang model TSL, lihat Apa itu model TSL?.
Prosedur
-
Masuk ke IoT Platform console.
-
Pada tab Overview, klik Public Instance.
-
Di panel navigasi sebelah kiri, pilih . Pada halaman Products, temukan produk lampu jalan yang telah Anda buat dan klik View di kolom Actions.
-
Pada halaman Product Details, klik tab Define Feature, lalu klik Edit Draft.
-
Pada halaman Edit Draft, di bagian Default Module, klik Add Self-defined Feature untuk mengonfigurasi model TSL, lalu klik OK.
Konfigurasikan properti Main Light Switch dan Current untuk produk lampu jalan.
-
Konfigurasikan properti Main Light Switch: atur Feature Type ke Property, masukkan Main Light Switch untuk Feature Name, masukkan
LightSwitchuntuk Identifier, pilihbooluntuk Data Type (0 untuk Off, 1 untuk On), dan pilih read/write untuk Read/Write Type. -
Konfigurasikan properti Current: atur Feature Type ke Property, masukkan Current untuk Feature Name, masukkan
LightCurrentuntuk Identifier, pilih float untuk Data Type, atur rentang nilai ke 0 hingga 9, atur step ke 0,1, pilih Ampere / A sebagai satuan, pilih read-only untuk Read/Write Type, dan masukkan "Electrical parameters use 4-byte floating-point data." untuk Description.
-
-
(Opsional) Klik TSL Model. Pada tab Full TSL, Anda dapat melihat model TSL lengkap untuk produk tersebut dalam format JSON.
File JSON mencakup array schema, profile, dan properties. Sebagai contoh, properti LightSwitch (Main Light Switch) menggunakan tipe data bool dan mode akses rw (read/write). Nilai 0 menunjukkan Off dan 1 menunjukkan On. Di pojok kanan bawah, klik Export Model File untuk mengekspor model TSL ke file lokal.
-
Publikasikan model TSL.
PentingModel TSL harus dipublikasikan agar berlaku.
-
Di pojok kiri bawah halaman Edit Draft untuk Define Feature, klik Publish. Kotak dialog Publish TSL Model? akan muncul.
-
Klik Add Publication Note dan masukkan nomor versi serta deskripsi versi.
Parameter
Deskripsi
Nomor Versi
Tetapkan nomor versi untuk model TSL saat ini. Nantinya, Anda dapat mengelola model TSL berdasarkan nomor versi tersebut.
Nomor versi mendukung huruf, angka, dan titik (.). Panjangnya dapat mencapai 1 hingga 16 karakter.
Deskripsi Versi
Jelaskan versi saat ini dari model TSL. Mendukung karakter Tionghoa, huruf, karakter Jepang, angka, dan simbol khusus. Deskripsi dapat mencapai maksimal 100 karakter. Satu karakter Tionghoa atau Jepang dihitung sebagai satu karakter.
-
Jika versi sudah dipublikasikan sebelumnya, Anda harus membandingkan draft dengan versi yang telah dipublikasikan untuk mengonfirmasi perubahan.
Klik Comparison Result untuk melihat perubahan dalam kotak dialog Comparison Result. Setelah Anda mengonfirmasi perubahan tersebut, klik Confirm and View. Anda akan dikembalikan ke kotak dialog Publish TSL Model, dan kotak centang "I have reviewed the comparison between the current version and the online version" akan dipilih secara otomatis.
Jika Anda tidak perlu membandingkan versi, Anda dapat memilih secara manual kotak centang I have reviewed the comparison between the current version and the online version.
-
Klik OK untuk mempublikasikan model TSL.
-