【亲测免费】 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通信。对于更深入的定制需求和高级用法，请参考官方文档和示例代码。