Modbus-Master-Slave-for-Arduino 教程
1. 项目介绍
Modbus-Master-Slave-for-Arduino 是一个专为Arduino平台设计的库,实现了Modbus RTU协议中的主(Master)和从(Slave)机逻辑。该库支持以下功能码:
- 1(读线圈状态)
- 2(读离散输入状态)
- 3(读保持寄存器)
- 4(读输入寄存器)
- 5(写单个线圈)
- 6(写单个保持寄存器)
- 15(写多个线圈)
- 16(写多个保持寄存器)
请注意,版本2.x.x不向后兼容1.x.x版本。
2. 项目快速启动
安装库
在Arduino IDE中,打开Sketch > Include Library > Manage Libraries
,然后搜索Modbus-Master-Slave-for-Arduino
并安装最新版本。
主机(Master)示例
#include <ModbusMaster.h>
#define SLAVE_ID 1 // 设备ID
#define REG_ADDR 100 // 寄存器地址
ModbusMaster node(SLAVE_ID);
void setup() {
Serial.begin(9600); // 设置串口波特率
node.begin(Serial);
}
void loop() {
static uint16_t regValue = 0;
if (node.requestFrom(SLAVE_ID, 2)) { // 向ID为SLAVE_ID的设备请求2字节数据
node.readHoldingRegisters(REG_ADDR, 1); // 读取REG_ADDR寄存器
if (node.isError()) {
Serial.println("通信错误");
} else {
regValue = node.getResponse()[0]; // 获取寄存器值
Serial.print("收到值: ");
Serial.println(regValue);
}
}
delay(1000); // 延时1秒
}
从机(Slave)示例
#include <ModbusRTUSlave.h>
#define REG_ADDR 100 // 寄存器地址
#define REG_COUNT 2 // 要保持的寄存器数量
void setup() {
Serial.begin(9600);
ModbusRTUSlave slave(1); // 创建一个ID为1的从机实例
slave.addRegister(REG_ADDR, REG_COUNT, false); // 添加寄存器
}
void loop() {
if (slave.poll()) { // 处理Modbus请求
if (slave.getFunctionCode() == 3) { // 读保持寄存器
int16_t startAddress = slave.getAddress();
uint16_t* data = slave.getData();
for (int i = 0; i < slave.getCount(); i++) {
data[i] = analogRead(A0); // 将ADC值写入寄存器
}
}
}
}
3. 应用案例和最佳实践
- 在工业自动化场景中,通过使用此库,您可以创建能够与其他Modbus设备进行通信的Arduino控制器,如监控PLC状态或控制执行器。
- 最佳实践包括确保正确设置串口参数(波特率、校验位等),以及使用适当的延迟防止过度占用通信频道。
4. 典型生态项目
- 4-20ma/ModbusMaster: 另一实现Modbus Master功能的Arduino库,适用于更复杂的应用。
- Arduino的其他Modbus库: 除了这个库外,还有其他针对特定需求的Modbus库,例如用于TCP/IP网络的库。
要了解更多关于Modbus通信的知识和实践,可以查阅相关论坛(如Arduino官方论坛)上的讨论和示例项目,或者参考GitHub上的其他Modbus Arduino项目。同时,记得定期检查更新以获取最新的功能和修复。