NiuBoL เซ็นเซอร์เชื่อมต่อกับแพลตฟอร์ม akenza.io ผ่านโปรโตคอล MQTT

กระบวนการผสานรวมกับแพลตฟอร์ม akenza.io ผ่านโปรโตคอล MQTT จําเป็นต้องทําตามขั้นตอนต่างๆ เช่น การกําหนดค่าอุปกรณ์ การสร้างโฟลว์ข้อมูล การลงทะเบียนอุปกรณ์ และการใช้โค้ด ด้านล่างนี้คือคําแนะนําโดยละเอียด โดยอิงจากเอกสารอย่างเป็นทางการของ akenza และคุณสมบัติของโปรโตคอล MQTT โดยอธิบายวิธีการบรรลุการผสานรวมทีละขั้นตอน

ขั้นตอนที่ 1: สร้างบัญชี akenza.io

1. ลงทะเบียนบัญชี:

- ไปที่หน้าลงทะเบียนที่https://akenza.ioและสร้างบัญชี หากคุณมีบัญชีอยู่แล้ว ให้เข้าสู่ระบบโดยตรง

- หลังจากเข้าสู่ระบบ คุณจะถูกนําไปยังแดชบอร์ดแพลตฟอร์ม akenza

2. ทําความเข้าใจแพลตฟอร์ม:

- แพลตฟอร์ม akenza รองรับโปรโตคอล MQTT และใช้ Eclipse Mosquitto เป็นโบรกเกอร์MQTT แพลตฟอร์มทําหน้าที่เป็นโบรกเกอร์และอุปกรณ์ทําหน้าที่เป็นไคลเอนต์MQTT

ขั้นตอนที่ 2: สร้างโฟลว์ข้อมูล MQTT

การไหลของข้อมูลกําหนดวิธีที่อุปกรณ์สื่อสารกับแพลตฟอร์ม akenza ผ่าน MQTT

1. ไปที่ Data Flow:

- ในแดชบอร์ด akenza ให้คลิกที่ "การไหลของข้อมูล" ในเมนูด้านซ้าย

- คลิกปุ่ม "สร้างโฟลว์ข้อมูล"

2. เลือกการเชื่อมต่อ MQTT:

- ในประเภทการเชื่อมต่อ ให้เลือก "เชื่อมต่ออุปกรณ์ผ่าน MQTT"

- ประเภทอุปกรณ์: เลือก "Passthrough" เพื่อรับรูปแบบข้อมูลดิบ (แนะนําให้ใช้รูปแบบ JSON)

- ตัวเชื่อมต่อเอาต์พุต: เลือกปลายทางการจัดเก็บข้อมูลสําหรับข้อมูล เช่น akenza DB (ฐานข้อมูลเริ่มต้น) หรือตัวเชื่อมต่ออื่นๆ ที่รองรับ เช่น InfluxDB หรือ Webhook

3. สร้างความลับ (คีย์):

- หลังจากสร้างโฟลว์ข้อมูลแล้ว ระบบจะสร้างข้อมูลลับ (คีย์) สําหรับการตรวจสอบอุปกรณ์โดยอัตโนมัติ

- บันทึกข้อมูลลับนี้ เนื่องจากจะใช้ในโครงสร้างหัวข้อ MQTT และการเชื่อมต่ออุปกรณ์

4. บันทึกโฟลว์ข้อมูล:

- หลังจากยืนยันการตั้งค่าของคุณแล้ว ให้คลิก "สร้าง" เพื่อบันทึกการไหลของข้อมูล

ขั้นตอนที่ 3: ลงทะเบียนอุปกรณ์

1. ไปที่พื้นที่ทํางาน:

- ในเมนูด้านซ้าย ให้คลิก "พื้นที่ทํางาน"

- คลิกปุ่ม "สร้างอุปกรณ์"

2. กรอกข้อมูลอุปกรณ์:

- ชื่ออุปกรณ์: ตั้งชื่ออุปกรณ์ เช่น "เซ็นเซอร์สภาพอากาศ" หรือ "เซ็นเซอร์ดิน"

- คําอธิบาย (ไม่บังคับ): เพิ่มคําอธิบายสําหรับอุปกรณ์

- แท็ก/ฟิลด์ที่กําหนดเอง (ไม่บังคับ): เพิ่มแท็กหรือฟิลด์ที่กําหนดเองสําหรับการจัดหมวดหมู่

- โฟลว์ข้อมูล: เลือกโฟลว์ข้อมูล MQTT ที่สร้างขึ้นในขั้นตอนก่อนหน้า

3. สร้าง ID อุปกรณ์:

- คลิก "สร้าง ID" เพื่อสร้าง ID เฉพาะสําหรับอุปกรณ์

4. ลงทะเบียนให้เสร็จสมบูรณ์:

- คลิก "สร้างอุปกรณ์" เพื่อลงทะเบียนอุปกรณ์ให้เสร็จสิ้น

- หลังจากลงทะเบียนแล้ว ให้ค้นหาอุปกรณ์ในเมนู Devices และคลิกเพื่อเข้าสู่หน้ารายละเอียดของอุปกรณ์

5. รับการกําหนดค่า API:

- ในหน้ารายละเอียดอุปกรณ์ภายใต้แท็บ "การกําหนดค่า API" ให้รับข้อมูลต่อไปนี้:

- โฮสต์โบรกเกอร์MQTT: โดยทั่วไปจะ mqtt.akenza.io

-MQTT ชื่อผู้ใช้: ชื่อผู้ใช้

-MQTT รหัสผ่าน: รหัสผ่าน

- หัวข้ออัปลิงค์: /up/{secret}/id/{deviceId}

- หัวข้อดาวน์ลิงก์ (ไม่บังคับ): /down/{secret}/id/{deviceId}

ขั้นตอนที่ 4: กําหนดค่าอุปกรณ์ให้เชื่อมต่อกับ MQTT

ใช้อุปกรณ์เช่นเซ็นเซอร์Niubol หรืออุปกรณ์ที่รองรับ MQTT อื่น ๆ กําหนดค่าให้เชื่อมต่อกับโบรกเกอร์ akenza MQTT วิธีการต่อไปนี้ถือว่าคุณกําลังใช้ตัวรวบรวมข้อมูล Niubol

ขั้นตอนที่ 5: ตรวจสอบข้อมูล

1. ดูบันทึกข้อความ:

- ในพื้นที่ทํางานของแพลตฟอร์ม akenza ให้ค้นหาอุปกรณ์ของคุณและไปที่หน้ารายละเอียดอุปกรณ์

- ในแท็บ "บันทึกข้อความ" ให้ดูข้อมูลอัปลิงค์ที่ส่งโดยอุปกรณ์

- ข้อมูลควรปรากฏในรูปแบบ JSON เช่น{"sensor":"temperature","value":25.5}

2. การแสดงข้อมูล:

- ในแท็บตัวสร้างแดชบอร์ด ให้ดู KPI ของอุปกรณ์และแผนภูมิข้อมูลในอดีต

- หากมีการกําหนดค่าหัวข้อดาวน์ลิงก์ คุณสามารถทดสอบการส่งคําสั่งไปยังอุปกรณ์ได้

ขั้นตอนที่ 6: เปิดใช้ TLS (ไม่บังคับ)

เพื่อเพิ่มความปลอดภัย ขอแนะนําให้ใช้การเข้ารหัส TLS:

1. ใช้พอร์ต 8883 แทน 1883 สําหรับการสื่อสารที่เข้ารหัส

หมายเหตุ:

1. วิธีการรับรองความถูกต้อง:

- Akenza รองรับวิธีการรับรองความถูกต้องสองวิธี:

- อัปลิงค์ลับ: ใช้คีย์ที่ใช้ร่วมกันเป็นรหัสผ่าน MQTT

- JWT: ใช้คีย์ส่วนตัวของอุปกรณ์เพื่อสร้าง JWT เป็นรหัสผ่าน (ปลอดภัยกว่า ต้องมีการกําหนดค่าเพิ่มเติม)

- เลือกประเภทการรับรองความถูกต้องเมื่อสร้างโฟลว์ข้อมูล

2. โครงสร้างหัวข้อ:

- รูปแบบหัวข้ออัปลิงค์: /up/{secret}/id/{deviceId}

- รูปแบบหัวข้อดาวน์ลิงค์: /down/{secret}/id/{deviceId}

- ตรวจสอบให้แน่ใจว่าหัวข้อตรงกับการกําหนดค่าอุปกรณ์

3. การแก้ไขปัญหา:

- หากการเชื่อมต่อล้มเหลว ให้ตรวจสอบ:

- ตรวจสอบให้แน่ใจว่าชื่อผู้ใช้ รหัสผ่าน และหัวข้อ MQTT ถูกต้อง

- ตรวจสอบว่าการเชื่อมต่อเครือข่ายมีความเสถียร (Wi-Fi หรือเครือข่ายเซลลูลาร์)

- ตรวจสอบให้แน่ใจว่าพอร์ตไม่ได้ถูกบล็อกโดยไฟร์วอลล์ (1883 หรือ 8883)

- ใช้จอภาพแบบอนุกรมหรือบันทึกเพื่อดูรหัสข้อผิดพลาด

4. รูปแบบที่รองรับ:

- akenza ยอมรับข้อความ JSON ที่จัดรูปแบบ MQTT ดังนั้นตรวจสอบให้แน่ใจว่าข้อมูลที่ส่งโดยอุปกรณ์อยู่ในรูปแบบที่ถูกต้อง

แหล่งข้อมูลอ้างอิง:

- เอกสารอย่างเป็นทางการของ akenza:MQTT การเชื่อมต่อ:

https://docs.akenza.io/akenza.io/get-started/your-data-flow/device-connector/mqtt

- บทช่วยสอน: วิธีรวมอุปกรณ์ Arduino ผ่าน MQTT บน akenza:

https://docs.akenza.io/akenza.io/tutorials/add-devices/how-to-integrate-an-arduino-device-via-mqtt-on-akenza