ต่ออุปกรณ์เข้า TRIX Monitor

สำหรับผู้ติดตั้งอุปกรณ์ อุปกรณ์แค่ส่งค่าตามชื่อ topic ที่กำหนด ระบบจะบันทึก แสดงผล และเฝ้าระวังให้เอง อุปกรณ์หรือค่าที่วัดที่ระบบยังไม่เคยเห็น จะถูกสร้างให้อัตโนมัติตั้งแต่ข้อความแรก

อุปกรณ์ --MQTT over WSS--> mqtt.trix.technology --> TRIX Monitor --> dashboard / แจ้งเตือน

1. ข้อมูลที่ต้องใช้

ฟิลด์	ค่า
URL	`wss://mqtt.trix.technology/mqtt` (MQTT บน WebSocket + TLS พอร์ต 443)
Username / Password	ได้จากทีม TRIX หรือแท็บ Integrations ของลิงก์ portal
Topic	ส่งได้เฉพาะใต้ `trix/<site>/` ของคุณ broker จะปฏิเสธ topic อื่น

login ของอุปกรณ์ (แนะนำ) หนึ่งเครื่องหนึ่งรหัส ส่งได้เฉพาะ trix/<site>/<device-id>/# ถ้าเครื่องหายหรือรหัสหลุด ทีม TRIX ยกเลิกเฉพาะเครื่องนั้นได้ เครื่องอื่นทำงานต่อ รหัสผ่านแสดงครั้งเดียวตอนออก
login ของ site ส่งได้ทั้ง trix/<site>/# เหมาะกับ gateway หรือ Node-RED ที่ส่งแทนหลายเครื่อง

พอร์ต MQTT ธรรมดา (1883) ใช้ได้เฉพาะเครื่องในวง LAN เดียวกับเซิร์ฟเวอร์ อุปกรณ์ภาคสนามให้ใช้ WSS เสมอ

2. กติกา topic

trix/<site>/<device-id>/telemetry      payload: {"temperature_c":25.3,"humidity_pct":61.2}

<site> ชื่อย่อของ site ที่ทีม TRIX ตั้งให้
<device-id> ตั้งเองให้ไม่ซ้ำกันภายใน site ใช้ตัวพิมพ์เล็ก ตัวเลข และ - เช่น sensor-01, inv-01
ชื่อค่าที่วัดเป็นตัวพิมพ์เล็ก ลงท้ายด้วยหน่วย เช่น _c, _pct, _v, _w, _kwh ระบบเติมหน่วยให้เอง

รายละเอียดทั้งหมด (status, meta, คำสั่ง, OTA) อยู่ใน มาตรฐานข้อความอุปกรณ์ trix-node/1

อุปกรณ์รุ่นเก่าที่ส่ง 1 ค่าต่อ 1 topic ยังรับอยู่ เช่น trix/<site>/sensor-01/temperature_c payload 25.3 แต่อุปกรณ์ใหม่ควรส่งแบบ telemetry ที่เป็น JSON

3. ตั้งค่าอัตโนมัติด้วย QR (แนะนำ)

แท็บ Integrations มี QR และ Config URL รูปแบบ

https://trix.technology/api/portal/<รหัส>/config.json

อุปกรณ์ดึง JSON นี้ตอนบูตครั้งแรก ได้ที่อยู่ broker, login และ prefix ของ topic แล้วเก็บไว้ในหน่วยความจำของตัวเอง ไม่ต้องฝังรหัสผ่านไว้ใน firmware ถ้ารหัสหลุด ทีม TRIX ออกรหัสใหม่แล้ว URL เดิมใช้ไม่ได้ทันที

4. ทดสอบส่งค่าครั้งแรก

ใช้ MQTTX หรือโปรแกรม MQTT ใดก็ได้ที่ต่อ WebSocket ได้

Host wss://mqtt.trix.technology, Port 443, Path /mqtt, เปิด SSL/TLS
ใส่ username และ password
publish ไปที่ trix/<site>/sensor-01/telemetry ด้วย payload {"temperature_c":25.3}

ภายในประมาณ 1 วินาที ค่าจะเข้าระบบ และขึ้นบน dashboard ที่ผูกกับ sensor-01

5. ชื่อค่ามาตรฐาน

ชื่อ	ความหมาย	หน่วย
`temperature_c`	อุณหภูมิ	C
`humidity_pct`	ความชื้น	%
`pressure_hpa`	ความดันอากาศ	hPa
`voltage_v`	แรงดันไฟ	V
`current_a`	กระแส	A
`power_w`	กำลังไฟ	W
`energy_kwh`	พลังงานสะสม	kWh

ชื่ออื่นใช้ได้เช่นกัน ระบบสร้างให้ แล้วทีม TRIX ตั้งชื่อแสดงผลภาษาไทยให้ภายหลัง

6. ปัญหาที่พบบ่อย

อาการ	สาเหตุ
ต่อ broker ไม่ได้ (refused / not authorized)	username หรือ password ผิด หรือรหัสถูกยกเลิกแล้ว
ต่อได้ แต่ค่าไม่ขึ้น	topic อยู่นอก `trix/<site>/` ของคุณ หรือ payload ไม่ใช่ตัวเลข/JSON ตามรูปแบบ
ค่าขึ้นแต่หน่วยไม่ถูก	ชื่อค่าไม่ได้ลงท้ายด้วยหน่วยตามตาราง แจ้งทีม TRIX ให้ตั้งหน่วยให้

ติดปัญหาหรือต้องการข้อมูลเพิ่ม ติดต่อทีม TRIX