Data Converters บน ThingsBoard: การเขียนสคริปต์ Uplink & Downlink แปลง Payload อุปกรณ์ IoT
เขียนโดยทีมวิศวกรระบบ Wireless Solution Asia (WSA) | อัปเดตล่าสุด: มีนาคม 2026 | เวลาอ่านประมาณ 7 นาที
คำตอบโดยสรุป (Direct Answer)
Data Converters เป็นฟังก์ชันพิเศษใน ThingsBoard PE (ทำงานร่วมกับ Platform Integrations) ที่ช่วยแปลงรูปแบบข้อมูลระหว่างอุปกรณ์ภายนอกกับระบบ ThingsBoard โดยแบ่งเป็น: 1) Uplink Data Converter ทำหน้าที่ถอดรหัส (Decode) ข้อมูลดิบที่ส่งเข้ามา เช่น สตริง Hex/Binary จากเซ็นเซอร์ LoRaWAN หรือ NB-IoT ให้กลายเป็นโครงสร้างมาตรฐาน JSON Telemetry และ Attributes พร้อมระบุ Device Name อัตโนมัติ และ 2) Downlink Data Converter ทำหน้าที่แปลงคำสั่ง RPC Command จากแดชบอร์ดให้กลายเป็น Byte Payload เฉพาะทางที่อุปกรณ์ปลายทางสามารถเข้าใจได้
โครงสร้างของ Uplink Data Converter (JavaScript)
สคริปต์ Uplink จะได้รับพารามิเตอร์ payload, metadata และต้องส่งออกอ็อบเจกต์ที่มี deviceName, deviceType, telemetry, และ attributes ดังตัวอย่างการแปลง Hex String จากเซ็นเซอร์วัดอุณหภูมิและความชื้น:
// Uplink Data Converter Example
var data = decodeToJson(payload);
var rawHex = data.data; // e.g. "010A0258"
// Parse Bytes: 01 = Temp (26.6 C), 0258 = Hum (60.0%)
var tempRaw = parseInt(rawHex.substring(2, 6), 16);
var humRaw = parseInt(rawHex.substring(6, 10), 16);
var result = {
deviceName: data.devEUI,
deviceType: "LoRaWAN-Environment-Sensor",
telemetry: {
temperature: tempRaw / 10.0,
humidity: humRaw / 10.0,
battery: data.batteryLevel
},
attributes: {
rssi: data.rssi,
snr: data.snr,
fPort: data.fPort
}
};
return result;
การสร้าง Downlink Data Converter สำหรับควบคุมอุปกรณ์
เมื่อวิศวกรกดปุ่มบน Dashboard เพื่อเปิดปั๊มน้ำหรือเปิดวาล์ว คำสั่ง RPC จะถูกส่งเข้า Downlink Data Converter เพื่อเข้ารหัสเป็น Hex Frame ก่อนยิงกลับไปยัง LoRaWAN Network Server (ChirpStack / The Things Stack):
// Downlink Data Converter Example
var result = {
contentType: "JSON",
data: JSON.stringify({
devEUI: metadata['device_devEUI'],
confirmed: true,
fPort: 2,
data: msg.params.enabled ? "01FF" : "0100" // Hex Command
})
};
return result;
คำถามที่พบบ่อย (Frequently Asked Questions)
สามารถทดสอบ Data Converter ก่อน Deploy ใช้งานจริงได้หรือไม่?
ได้ ในหน้าต่าง Data Converter ของ ThingsBoard มีแท็บ 'Test Converter' ให้จำลอง Payload และกดปุ่ม Test เพื่อดูผลลัพธ์ JSON output ได้ทันทีแบบไม่ต้องรออุปกรณ์จริงส่งข้อมูล
Data Converter มีผลต่อ Memory หรือ CPU ของเซิร์ฟเวอร์มากหรือไม่?
ThingsBoard รันสคริปต์ผ่าน Nashorn หรือ GraalVM JS Engine ที่มี Cache Compiled Script ทำให้ใช้ CPU ต่ำและประมวลผลได้หลายพันแพ็กเก็ตต่อวินาที
หากเซ็นเซอร์ส่งข้อมูลมาเป็น JSON อยู่แล้ว จำเป็นต้องเขียน Uplink Converter หรือไม่?
ยังคงต้องมีสคริปต์สั้นๆ เพื่อแมป Field Name จาก JSON ภายนอกให้ตรงกับโครงสร้างที่ ThingsBoard ต้องการ เช่น การระบุ deviceName และ telemetry keys
ต้องการผู้เชี่ยวชาญ ThingsBoard ช่วยออกแบบและติดตั้งระบบ?
Wireless Solution Asia ให้คำปรึกษา จัดหา License ThingsBoard PE แท้ และบริการ Training ทีมวิศวกรแบบครบวงจร
ติดต่อทีมงาน WSA ทันที