modbus-serial技术文档
modbus-serial是一个专为Node.js设计的纯JavaScript实现的MODBUS-RTU(串行和TCP)库,支持与工业设备进行高效通信。该模块简化了与采用RS485、RS232等串行接口的标准MODBUS协议电子设备交互的过程,如灌溉控制器、机器人等,并且可以与Arduino这样的开源硬件平台无缝对接。
安装指南
要安装modbus-serial库,您只需在您的Node.js项目目录下执行以下npm命令:
npm install modbus-serial
遇到安装问题时,尝试附加这些选项来构建:
npm install modbus-serial --unsafe-perm --build-from-source
项目的使用说明
快速启动
在使用modbus-serial之前,确保您的Node.js环境已经设置好,并且兼容建议的LTS版本。此库允许您通过不同的类实现对不同类型的通讯支持,比如MODBUS-RTU和MODBUS-TCP。
示例代码
下面是一个简单的例子,展示如何读取并写入一个设备的寄存器:
const ModbusRTU = require("modbus-serial");
const client = new ModbusRTU();
client.connectRTUBuffered("/dev/ttyUSB0", { baudRate: 9600 }, () => {
client.setID(1);
client.writeRegisters(5, [0, 0xffff])
.then(() => client.readHoldingRegisters(5, 2))
.then(console.log);
});
这个示例中,我们首先连接到一个指定的串行端口,然后设置从站ID为1,接着尝试向地址5开始的两个寄存器写入数据,之后立即读取这两个寄存器的数据并打印出来。
支持的功能
modbus-serial实现了多种功能码(FC),涵盖了读写线圈状态、输入状态、保持寄存器和输入寄存器等基本操作。此外,它还支持多个客户端类型(如MODBUS-RTU、ASCII以及TCP客户端)和服务器端的功能。
项目API使用文档
详细的方法文档可在该项目的GitHub Wiki页面找到,这里列举几个关键的API调用来简述:
- readCoils(coil, len): 读取线圈状态。
- writeCoil(coil, binary): 写单个线圈的状态。
- readHoldingRegisters(addr, len): 读取保持寄存器。
- writeRegisters(addr, valueAry): 写多个寄存器。
- connectRTUBuffered: 连接到RTU模式的设备,带缓冲处理。
- connectTCP: 连接到TCP上的MODBUS服务器。
- setID: 设置从站ID。
具体使用方法及参数详情,请参考项目Wiki。
项目安装方式
已在“安装指南”部分提供。通过npm命令安装即可。
本技术文档提供了modbus-serial的基本安装步骤、使用说明和API快速概览,旨在帮助开发者快速上手,与工业设备进行有效的MODBUS通信。对于更深入的定制需求和高级用法,请参考官方文档和示例代码。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考