node-red-contrib-modbus-rtu

Một node mạnh mẽ và linh hoạt để xây dựng gói tin Modbus RTU, tự động tính toán CRC16, và giải mã dữ liệu số thực (Float) trực tiếp trong Node-RED.

A robust Node-RED node for building Modbus RTU frames, automatic CRC16 calculation, and decoding Floating-point data.

🌟 Tính năng nổi bật / Key Features

• Tự động tính CRC16: Không cần viết code để tính checksum, node sẽ tự động chèn 2 byte CRC vào cuối Buffer.
• Xử lý số thực (Float): Hỗ trợ chuyển đổi mảng byte nhận về thành số thực với định dạng ABCD hoặc CDAB (đặc biệt hữu ích cho các dòng đồng hồ năng lượng như Selec, Elmeasure...).
• Cấu hình động (Dynamic): Cho phép thay đổi Slave ID, mã hàm, địa chỉ thanh ghi ngay trong quá trình chạy thông qua msg.payload.
• Kiểm tra gói tin (Check CRC): Hỗ trợ xác thực gói tin nhận về từ thiết bị ngoại vi có toàn vẹn hay không.
• Hỗ trợ đa dạng mã hàm: 01, 02, 03, 04, 05, 06, 15, 16.

🛠 Cấu hình / Configuration

Trong cửa sổ cài đặt node, bạn có các tùy chọn tại mục Function:

| Function | Mô tả (Description) | Cách dùng (Usage) | | :--- | :--- | :--- | | ADD CRC (0) | Chỉ thêm CRC | Thêm 2 byte CRC16 vào cuối msg.payload (Buffer). | | DYNAMIC (-1) | Cấu hình động | Lấy thông số từ msg.payload = {id, fn, addr, count}. | | CHECK CRC (-2) | Kiểm tra lỗi | Kiểm tra và bóc tách dữ liệu nếu CRC của gói tin nhận về là đúng. | | FLOATs ABCD (-3) | Chuyển đổi số thực | Chuyển mảng byte nhận về thành mảng số thực định dạng ABCD. | | FLOATs CDAB (-4) | Chuyển đổi số thực | Chuyển mảng byte nhận về thành mảng số thực định dạng CDAB (Selec Meter). | | Mã hàm (1-16) | Mã hàm cố định | Xây dựng gói tin dựa trên Slave ID, Address, Count trên giao diện. |

📖 Ví dụ / Examples

1. Tạo gói tin Modbus từ giao diện (GUI)

Cấu hình: Slave ID: 1, Function: 3, Address: 0, Count: 2.

• Input: Bất kỳ gói tin nào kích hoạt node.
• Output (Buffer): 01 03 00 00 00 02 C4 0B

2. Cấu hình động (Dynamic Mode)

Sử dụng một node function trước node này:

msg.payload = {
    id: 2,
    fn: 4,
    addr: 10,
    count: 1
};
return msg;

3. Giải mã dữ liệu đồng hồ Selec (NA111)

Nối đầu ra của node TCP/Serial vào node này, chọn Function: FLOATs CDAB (-4) và cài đặt Làm tròn (Decimal).

Kết quả: msg.payload trả về mảng số thực đã giải mã (Ví dụ: [220.5, 49.9, 0.98]).

🚀 Cài đặt / Installation

Chạy lệnh sau trong thư mục dữ liệu Node-RED (thường là ~/.node-red):

Bash npm install node-red-contrib-modbus-rtu

👤 Thông tin tác giả / Author

Tác giả: Do Duy Cop

Dự án: S-Connect IoT System

GitHub: node-red-contrib-modbus-rtu

Email: [email protected]

📄 Bản quyền / License

Dự án được phát hành dưới giấy phép MIT. 2026 © Do Duy Cop.