[ Node-RED ] Mengenal Function Node - Tools Ampuh Berbasis Java

 

Bagi penggiat IT yang mungkin kebingungan akan logika dari flow dan beragam node yang ada pada platform IOT Node-RED, mungkin pada saat belajar awal perlu berkenalan dengan node yang bernama  : "FUNCTION". Ya gak jauh berbeda dengan function atau sub-routine pada bahasa pemrograman apapun, function akan menyediakan editor script berbasis java yang akan memudahkan mengubah dan mengolah pesan Input Output pada flow yang anda buat.

Namun perlu diperhatikan komunikasi antar node bukan hanya kirim-terima String biasa, namun keseluruhan berpola JSON seperti contoh berikut:

atau kalau saya copy salah satu pesan raw dari salah satu output debug sebuah pesan yg diterima dari response perangkat modbus seperti berikut ini :

{"topic":"polling","payload":[30,0,71],"responseBuffer":{"data":[30,0,71],"buffer":[0,30,0,0,0,71]},"input":{"topic":"polling","from":"Modbus-DHT22","payload":{"unitid":"6","fc":4,"address":"0","quantity":"3","messageId":"6080af997665b3af28e2168f"},"queueLengthByUnitId":{"unitId":6,"queueLength":0},"queueUnitId":6,"unitId":6},"sendingNodeId":"1c4bea20.9b9666","_msgid":"b2c9254b.4553e8"}

Sepanjang itu pesan yg dikirimkan oleh node MODBUS READ ke node Debug yg saya buat. Jadi secara praktisnya saya hanya butuh data pada object bernama "payload" yang berisikan data array :[30,0,71]  . Jadi yg nantinya saya olah adalah data dari 3 isi array itu saja.

Kemudian saya ingin merubah data payload tadi menjadi NUMBER yang akan saya tampilkan pada web UI berupa GAUGE / Meter. Karena memang yang diminta oleh gauge adalah input data berupa  angka maka saya butuh sebuah Function untuk merubahnya.

Penjelasan dari function diatas adalah sebagai berikut :

• Variabel temp mengambil data msg.payload yg dikirimkan oleh node modbus read
• Data array 0 dan 1 dimasukkan ke dalam variabel
• Karena data 0 berupa puluhan dan 1 berupa angka dibelakang koma, butuh melakukan penggabungan dengan jalan mengalikan data 0 / puluhan dengan 100, menambahkan dengan data 1 lalu membagi hasilnya dengan 100
• Hasil suhu yg didapat berupa integer kemudian diubah ke float melalui parseFloat
• Selanjutnya suhu yg sudah berupa desimal float dibungkus kembali menjadi Json  : {payload:suhu} dan dikembalikan ke flow dengan perintah return .

Dengan function yang tepat maka hasil yg diinginkan pun tercapai. Jadi kunci disini adalah kemampuan javascript / programming yang harus cukup dimiliki oleh pengguna Node-RED.

Yang menjadi perhatian dalam function adalah bagaimana menyimpan variabel yang nantinya akan diambil saat flow berikutnya, semisal saya ingin mengubah 7 segmen secara increment. Jika ketemu masalah seperti ini maka yang perlu dipahami adalah perintah java berupa context atau flow. Perhatikan node berikut :

Output Function 7 segmen yg ingin kita dapatkan adalah membaca node inject dan  tombol pada dashboard /web UI yang akan merubah angka 7 segmen naik turun. Singkat saja scriptnya, dimana payload dari inject atau tombol berupa msg.payload = 1 untuk tambah dan msg.payload = 2 untuk pengurangan. Sedangkan variabel 7 segmen yang harus disimpan dan dipanggil lagi pada flow berikutnya disimpan melalui flow.get dan flow.set . Selengkapnya seperti berikut :

var count=flow.get('count') || 0;

var temp = msg.payload

if(temp == 1) count+=1;

else if(temp == 2) count-=1;

if(count > 9) count =0;

if(count < 0) count =9;

flow.set('count',count);

var result = {payload:count};

return[result];

Garis besar dari script diatas seperti ini : 

• Ambil nilai variabel 'count' yg disimpan pada flow (global) ke dalam variabel count lokal , jika belum ada kasikan nilai 0,   var count=flow.get('count') || 0; 
• Ambil nilai payload yang diberikan oleh inject atau tombol ui, kemudian cek apakah 1 atau 2 dan lakukan penambahan atau pengurangan variabel count
• Set kondisi maksimum dan minimum dari count
• Simpan kembali nilai variabel count lokal ke variabel count global dengan perintah : flow.set('count',count);
• Kembalikan data ke flow dan lanjut dikirim ke node Modbus Write

Dengan susunan script function yang tepat maka flows node-RED yang diingikan tercapai. Function node yang simple juga sudah disediakan, tinggal drag drop dan siap pakai, namun dengan beberapa keterbatasan. Jadi kalau mau berkreasi lebih manfaatkan script Function saja sesuai keinginan. 

Penjelasan function yang saya buat ini adalah kelanjutan dari praktek Modbus-RTU-Serial sebelumnya yg dapat dibaca disini.