如何在Arduino上快速部署nanoMODBUS：从接线到通信的完整指南

滕娴殉

730人浏览 · 2026-07-29 08:20:33

滕娴殉 · 2026-07-29 08:20:33 发布

如何在Arduino上快速部署nanoMODBUS：从接线到通信的完整指南

【免费下载链接】nanoMODBUS A compact MODBUS RTU/TCP C library for embedded/microcontrollers 项目地址: https://gitcode.com/gh_mirrors/na/nanoMODBUS

nanoMODBUS是一款超轻量级的MODBUS RTU/TCP协议C语言库，专为嵌入式系统和微控制器设计。本指南将带你从零开始，在Arduino上快速实现nanoMODBUS的部署与通信，无需复杂编程基础，轻松搭建工业级数据传输系统。

📋 准备工作：材料与环境搭建

核心材料清单

Arduino开发板（Uno/Nano/Mega等）×2（分别作为客户端和服务器）
USB数据线 ×2
杜邦线若干
面包板（可选）
终端电阻（120Ω，长距离通信时建议使用）

开发环境配置

安装最新版Arduino IDE
克隆nanoMODBUS仓库：
git clone https://gitcode.com/gh_mirrors/na/nanoMODBUS
准备库文件：将仓库根目录下的nanomodbus.c和nanomodbus.h文件复制到Arduino项目文件夹

🔌 硬件连接：手把手教你接线

RTU通信接线图（两Arduino直接连接）

Arduino A（客户端）       Arduino B（服务器）
   TX0 (D1)  ────────────► RX0 (D0)
   RX0 (D0)  ◄───────────  TX0 (D1)
   GND       ────────────  GND

注意：若使用Arduino Mega等多串口板，可选择其他UART接口（如Serial1对应D18/D19）。长距离通信需在总线两端添加120Ω终端电阻。

💻 代码部署：客户端与服务器实现

服务器端代码（server-rtu.ino）

从仓库examples/arduino/server-rtu目录获取完整示例，核心功能包括：

初始化MODBUS服务器（从机地址0x01）
配置保持寄存器（地址0x0000-0x000F）
处理客户端请求并返回数据

关键初始化代码片段：

#include "nanomodbus.h"

nmbs_t nmbs;
uint16_t holding_registers[16] = {0};

void setup() {
  Serial.begin(9600);
  nmbs_server_rtu_init(&nmbs, &Serial, 0x01);
  nmbs_set_holding_registers(&nmbs, holding_registers, 0, 16);
}

void loop() {
  nmbs_server_rtu_poll(&nmbs);
}

客户端代码（client-rtu.ino）

从仓库examples/arduino/client-rtu目录获取完整示例，主要功能：

初始化MODBUS客户端
读取服务器保持寄存器
向服务器写入数据

数据读写核心代码：

#include "nanomodbus.h"

nmbs_t nmbs;
uint16_t regs[2];

void setup() {
  Serial.begin(9600);
  nmbs_client_rtu_init(&nmbs, &Serial, 0x01);
}

void loop() {
  // 读取服务器寄存器（地址0x0000，长度2）
  if (nmbs_client_read_holding_registers(&nmbs, 0x0000, regs, 2) == NMBS_SUCCESS) {
    Serial.print("Read: ");
    Serial.println(regs[0]);
  }
  
  // 向服务器写入数据（地址0x0001，值0x1234）
  nmbs_client_write_single_register(&nmbs, 0x0001, 0x1234);
  delay(1000);
}