Link IoT Edge:Tool debugging Modbus

Prosedur

1. Masuk ke IoT Platform console.
2. Di panel navigasi sebelah kiri, pilih Link IoT Edge > Edge Instances.
   Temukan instans yang telah ditetapkan perangkat Modbus, lalu klik View.
3. Pada halaman Instance Details, pilih tab Devices & Drivers. Di daftar drop-down All Drivers, pilih driver Modbus, lalu klik Debug di sebelah kanan nama perangkat.
   Catatan Jika opsi Debug tampak redup, klik Reset di pojok kanan atas halaman Instance Details untuk mereset edge instance.

   
4. Pada halaman Channel Debugging, klik Add Property untuk melakukan debugging konfigurasi.
   • Tabel berikut menjelaskan parameter coil.

     Tabel 1. Parameter coil

     Parameter	Deskripsi
     Address	Alamat coil. Alamat harus dalam format heksadesimal dan diawali dengan 0x. Anda harus menentukan alamat coil berdasarkan properti perangkat Anda. Misalnya, jika alamat suhu perangkat adalah alamat 1, atur parameter menjadi 0x1.
     Property Name	Nama properti. Tentukan nama properti dan simpan konfigurasinya. Pada tab Define Feature di halaman Product Details, Anda dapat melihat nama properti dengan memilih filter Self-Defined Features di kolom Feature Name.
     Read Function Code	Kode fungsi yang digunakan untuk membaca atau menginput status coil.
     Write Function Code	Kode fungsi yang digunakan untuk menulis ke coil. Catatan Ketika read function code diatur ke 0x02 (input state), Anda tidak dapat melakukan operasi write.
     Current Value	Nilai parameter terukur dari TSL untuk perangkat Modbus. Contohnya, nilai saat ini dapat berupa iluminansi, suhu, dan kelembapan yang diukur.
     Actions	Read: Mengirim instruksi ke gateway untuk membaca nilai terukur. Gateway mengirim perintah baca ke perangkat dan mengembalikan hasilnya ke kolom Current Value. Write: Mengirim perintah ke gateway untuk menulis pengukuran. Gateway mengirim perintah tulis ke perangkat dan memperbarui kolom Current Value. Catatan Ketika read function code diatur ke 0x02 (input state), Anda tidak dapat melakukan operasi write. Delete: Menghapus coil ini dari TSL Produk tempat perangkat tersebut berada. Penting Setelah Anda menghapus produk dan menyimpan konfigurasi, semua perangkat di bawah produk tersebut akan terpengaruh.

   • Tabel berikut menjelaskan parameter register.

     Tabel 2. Parameter register

     Parameter	Deskripsi
     Address	Alamat awal properti. Alamat harus dalam format heksadesimal dan diawali dengan 0x. Penting Saat Anda menambahkan satu atau beberapa alamat register, alamat-alamat tersebut tidak boleh tumpang tindih. Jika alamat register tumpang tindih, akan terjadi error saat Anda menyimpan konfigurasi. Anda harus menentukan alamat register berdasarkan properti perangkat Anda. Misalnya, jika suhu perangkat ditunjukkan oleh angka 1 pada alamat IP, atur parameter menjadi 0x1.
     Property Name	Nama properti.
     Read Function Code	Kode fungsi yang digunakan untuk membaca dari register.
     Write Function Code	Kode fungsi yang digunakan untuk menulis ke register. Catatan Ketika read function code diatur ke 0x04 (input register), Anda tidak dapat melakukan operasi write. Jika Anda ingin menulis data bertipe selain int16 dan uint16 ke holding register, pilih kode fungsi 0x10.
     Data type	Tipe data register. Nilai yang valid: int16, uint16, int32, uint32, int64, uint64, float, dan double. Tipe data yang berbeda menggunakan jumlah register yang berbeda. Untuk informasi selengkapnya, lihat tabel Jumlah register untuk setiap tipe data pada bagian berikutnya.
     Unit	Pilih satuan pengukuran untuk perangkat.
     Current Value	Nilai parameter terukur dari TSL untuk perangkat Modbus. Contohnya, nilai saat ini dapat berupa iluminansi, suhu, dan kelembapan yang diukur.
     Actions	Read: Mengirim instruksi ke gateway untuk membaca nilai terukur. Gateway mengirim perintah baca ke perangkat dan mengembalikan hasilnya ke kolom Current Value. Write: Mengirim perintah ke gateway untuk menulis pengukuran. Gateway mengirim perintah tulis ke perangkat dan memperbarui kolom Current Value. Catatan Ketika read function code diatur ke 0x04 (input register), Anda tidak dapat melakukan operasi write. Advanced: mengonfigurasi lebih banyak parameter register. Untuk deskripsi parameter, lihat tabel Konfigurasi lanjutan berikut. Delete: Menghapus register ini dari TSL Produk tempat perangkat tersebut berada. Penting Setelah Anda menghapus produk dan menyimpan konfigurasi, semua perangkat di bawah produk tersebut akan terpengaruh.

     Tabel 3. Parameter lanjutan

     Parameter	Deskripsi
     Swap Bytes	Parameter ini mengontrol urutan byte yang digunakan untuk mengurai informasi register. Secara default, digunakan pengurutan big-endian. true: Digunakan pengurutan little-endian. false: Digunakan pengurutan big-endian. Contoh 1: Saat nilai 12345 ditulis, nilai heksadesimal yang sesuai adalah 0x3039. Jika parameter ini diatur ke false, urutan byte untuk mengirim dan menerima nilai tersebut adalah 30 39. Jika diatur ke true, urutannya menjadi 39 30. Contoh 2: Jika Anda menggunakan kode fungsi 0x10 untuk mengirim pesan RTU guna menulis ke holding register stasiun perangkat dengan slaveID 1. Jika parameter ini diatur ke false, pesan lengkapnya adalah: 01 10 02 00 01 30 39 f7 E1. Jika diatur ke true, pesannya menjadi: 01 10 02 00 01 39 30 33 14.
     Swap Registers	Parameter ini mengontrol urutan penguraian register. Tipe data harus berupa int16 atau uint16. Secara default, sistem memperlakukan register dengan alamat lebih rendah sebagai register yang memiliki nilai bit lebih tinggi. Oleh karena itu, nilai bit lebih tinggi dikirim terlebih dahulu dan register dengan alamat lebih rendah diurai terlebih dahulu. Sebagai contoh, jika Anda mengirim data int64 (0x1234567890ABCDEF) ke perangkat, data tersebut dibagi menjadi empat register. (Swap Bytes diatur ke false). Jika parameter ini diatur ke false, urutan pesannya adalah 12 34 56 78 90 AB CD EF. Jika diatur ke true, urutannya menjadi CD EF 90 AB 56 78 12 34.
     Zoom Factor	Menetapkan cara penskalaan data mentah perangkat. Ketika performa operasi floating-point buruk, Anda dapat mengubah titik desimal menjadi bilangan bulat. Parameter ini memungkinkan Anda menetapkan faktor skala untuk data asli perangkat. Sebagai contoh, ketika perangkat menggunakan 1234 untuk merepresentasikan 12.34, faktor skala harus diatur ke 0.01. Semua nilai data yang ditetapkan untuk perangkat secara otomatis dikalikan dengan 100 dan dikirim ke perangkat. Saat nilai 12.34 ditetapkan di cloud atau di konsol, driver secara otomatis mengonversi 12.34 menjadi 1234 dan mengirim data hasil konversi tersebut ke perangkat. Sebaliknya, saat perangkat mengirim pesan, nilai 1234 dikonversi menjadi 12.34 sebelum dikirim ke platform IoT atau perangkat lain.

     Tabel 4. Jumlah register untuk setiap tipe data

     Tipe data	Jumlah register	Deskripsi
     int16	1	Tipe integer bertanda 16-bit.
     uint16	1	Tipe integer tak bertanda 16-bit.
     int32	2	Tipe integer bertanda 32-bit.
     uint32	2	Tipe integer tak bertanda 32-bit.
     int64	4	Tipe integer bertanda 64-bit.
     uint64	4	Tipe integer tak bertanda 64-bit.
     float	2	Tipe floating-point presisi tunggal (32 bit).
     double	4	Tipe floating-point presisi ganda (64 bit).

5. Setelah debugging selesai, klik Save configuration untuk memperbarui definisi fitur produk ke server.
   Notifikasi Saved muncul, menandakan bahwa data telah disimpan ke server.

   Catatan Setelah konfigurasi disimpan, fitur kustom akan dibuat. Pada tab Define Feature di halaman Product Details, Anda dapat melihat fitur tersebut dengan memilih filter Self-Defined Features pada kolom Feature Name. Parameter Identifier secara otomatis dihasilkan oleh sistem setelah konfigurasi disimpan. Identifier dihasilkan berdasarkan aturan berikut:

   Nilai kolom Identifier didasarkan pada nilai parameter Identifier dalam TSL perangkat. Format parameter Identifier adalah register type_4-bit hexadecimal address. Sebagai contoh, jika read function code dalam konfigurasi diatur ke 01, tipe register adalah coilStatus, alamat diatur ke 0x00, dan alamat heksadesimal 4-bit adalah 0000, maka nilai Identifier-nya adalah coilStatus_0000.

Operasi lainnya

• Reset: Pada halaman debug, Anda dapat mengklik Reset untuk mereset konfigurasi saat ini.
• Channel Configurations: Anda dapat mengklik Channel Configurations di pojok kanan atas halaman konfigurasi untuk memodifikasi parameter channel komunikasi Modbus, lalu klik OK untuk menyimpan perubahan.
• Log Debugging: Pada halaman Channel Debugging, Anda dapat mengklik Log Debugging untuk melihat log debugging atau mengklik Clear Screen untuk menghapus log pada halaman ini.

Kode fungsi untuk berbagai tipe register dan coil