NiuBoL giao diện cảm biến với nền tảng akenza.io thông qua giao thức MQTT

Quá trình tích hợp với nền tảng akenza.io thông qua giao thức MQTT yêu cầu hoàn thành các bước như cấu hình thiết bị, tạo luồng dữ liệu, đăng ký thiết bị và triển khai mã. Dưới đây là hướng dẫn chi tiết, dựa trên tài liệu chính thức của akenza và các tính năng của giao thức MQTT, giải thích cách đạt được tích hợp từng bước.

Bước 1: Tạo tài khoản akenza.io

1. Đăng ký tài khoản:

- Truy cập trang đăng ký tạihttps://akenza.iovà tạo tài khoản. Nếu bạn đã có tài khoản, hãy đăng nhập trực tiếp.

- Sau khi đăng nhập, bạn sẽ được chuyển đến bảng điều khiển nền tảng akenza.

2. Hiểu nền tảng:

- Nền tảng akenza hỗ trợ giao thức MQTT và sử dụng Eclipse Mosquitto làm nhà môi giới MQTT. Nền tảng đóng vai trò là nhà môi giới và các thiết bị đóng vai trò là khách hàng MQTT.

Bước 2: Tạo luồng dữ liệu MQTT

Luồng dữ liệu xác định cách các thiết bị giao tiếp với nền tảng akenza thông qua MQTT.

1. Điều hướng đến Luồng dữ liệu:

- Trong bảng điều khiển akenza, nhấp vào "Luồng dữ liệu" ở menu bên trái.

- Nhấp vào nút "Tạo luồng dữ liệu".

2. Chọn Kết nối MQTT:

- Trong loại kết nối, chọn "Kết nối thiết bị qua MQTT".

- Loại thiết bị: Chọn "Truyền qua" để nhận các định dạng dữ liệu thô (nên sử dụng định dạng JSON).

- Trình kết nối đầu ra: Chọn đích lưu trữ cho dữ liệu, chẳng hạn như akenza DB (cơ sở dữ liệu mặc định) hoặc các trình kết nối được hỗ trợ khác như InfluxDB hoặc Webhook.

3. Tạo bí mật (khóa):

- Sau khi tạo luồng dữ liệu, hệ thống sẽ tự động tạo bí mật (khóa) để xác thực thiết bị.

- Ghi lại bí mật này, vì nó sẽ được sử dụng trong cấu trúc chủ đề MQTT và kết nối thiết bị.

4. Lưu luồng dữ liệu:

- Sau khi xác nhận cài đặt của bạn, hãy nhấp vào "Tạo" để lưu luồng dữ liệu.

Bước 3: Đăng ký thiết bị

1. Điều hướng đến Không gian làm việc:

- Trong menu bên trái, nhấp vào "Không gian làm việc".

- Nhấp vào nút "Tạo thiết bị".

2. Điền thông tin thiết bị:

- Tên thiết bị: Đặt tên cho thiết bị của bạn, ví dụ: "Cảm biến thời tiết" hoặc "Cảm biến đất".

- Mô tả (không bắt buộc): Thêm mô tả cho thiết bị.

- Thẻ/Trường tùy chỉnh (tùy chọn): Thêm thẻ hoặc trường tùy chỉnh để phân loại.

- Luồng dữ liệu: Chọn luồng dữ liệu MQTT đã tạo ở bước trước.

3. Tạo ID thiết bị:

- Nhấp vào "Tạo ID" để tạo ID duy nhất cho thiết bị.

4. Hoàn thành đăng ký:

- Nhấp vào "Tạo thiết bị" để hoàn tất đăng ký thiết bị.

- Sau khi đăng ký, tìm thiết bị trong menu Thiết bị và nhấp để vào trang chi tiết thiết bị.

5. Lấy cấu hình API:

- Trong trang chi tiết thiết bị trong tab "Cấu hình API", hãy lấy thông tin sau:

-MQTT Broker Host: Thường mqtt.akenza.io.

-MQTT Tên người dùng: Tên người dùng.

-MQTT Mật khẩu: Mật khẩu.

- Chủ đề đường lên: /up/{secret}/id/{deviceId}.

- Chủ đề đường xuống (tùy chọn): /down/{secret}/id/{deviceId}.

Bước 4: Định cấu hình thiết bị để kết nối với MQTT

Sử dụng một thiết bị như cảm biến Niubol hoặc một thiết bị hỗ trợ MQTT khác, định cấu hình thiết bị đó để kết nối với nhà môi giới MQTT akenza. Các hướng dẫn sau đây giả định rằng bạn đang sử dụng trình thu thập dữ liệu Niubol.

Bước 5: Xác minh dữ liệu

1. Xem nhật ký tin nhắn:

- Trong Không gian làm việc của nền tảng akenza, hãy tìm thiết bị của bạn và chuyển đến trang chi tiết thiết bị của nó.

- Trong tab "Nhật ký tin nhắn", hãy xem dữ liệu đường lên do thiết bị gửi.

- Dữ liệu phải xuất hiện ở định dạng JSON, ví dụ:{"sensor":"temperature","value":25.5}.

2. Trực quan hóa dữ liệu:

- Trong tab Trình tạo bảng điều khiển, hãy xem KPI và biểu đồ dữ liệu lịch sử của thiết bị.

- Nếu chủ đề đường xuống được định cấu hình, bạn có thể kiểm tra việc gửi lệnh đến thiết bị.

Bước 6: Bật TLS (Tùy chọn)

Để tăng cường bảo mật, bạn nên sử dụng mã hóa TLS:

1. Sử dụng cổng 8883 thay vì 1883 để giao tiếp được mã hóa.

Ghi chú:

1. Phương thức xác thực:

- AKENZA hỗ trợ hai phương thức xác thực:

- Bí mật đường lên: Sử dụng khóa chia sẻ làm mật khẩu MQTT.

- JWT: Sử dụng khóa riêng của thiết bị để tạo JWT làm mật khẩu (an toàn hơn, yêu cầu cấu hình bổ sung).

- Chọn loại xác thực khi tạo luồng dữ liệu.

2. Cấu trúc chủ đề:

- Định dạng chủ đề đường lên: /up/{secret}/id/{deviceId}.

- Định dạng chủ đề đường xuống: /down/{secret}/id/{deviceId}.

- Đảm bảo các chủ đề khớp với cấu hình thiết bị.

3. Khắc phục sự cố:

- Nếu kết nối không thành công, hãy kiểm tra:

- Đảm bảo tên người dùng, mật khẩu và chủ đề MQTT là chính xác.

- Xác minh kết nối mạng ổn định (Wi-Fi hoặc mạng di động).

- Đảm bảo rằng các cổng không bị chặn bởi tường lửa (1883 hoặc 8883).

- Sử dụng màn hình nối tiếp hoặc nhật ký để xem mã lỗi.

4. Các định dạng được hỗ trợ:

- akenza chấp nhận các tin nhắn MQTT được định dạng JSON, vì vậy hãy đảm bảo dữ liệu do thiết bị gửi ở định dạng chính xác.

Tài nguyên tham khảo:

- Tài liệu chính thức của akenza: Kết nối MQTT:

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

- Hướng dẫn: Cách tích hợp thiết bị Arduino qua MQTT trên akenza:

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