当前位置： 首页 > news >正文

在ARM开发板上从零搭建Modbus RTU主从通信（基于libmodbus 3.1.10与RS485）

news 2026/5/29 7:46:14

在ARM开发板上从零搭建Modbus RTU主从通信（基于libmodbus 3.1.10与RS485）

工业自动化领域对设备间通信的可靠性要求极高，而Modbus协议凭借其简单、开放的特性，成为工业控制系统中应用最广泛的通信协议之一。特别是在嵌入式系统中，Modbus RTU通过RS485物理层实现，能够满足长距离、抗干扰的工业环境需求。本文将手把手指导开发者如何在ARM架构的开发板上，从零开始搭建完整的Modbus RTU主从通信系统。

1. 环境准备与工具链配置

在开始之前，我们需要准备以下硬件和软件环境：

  • 硬件设备：

    • ARM架构开发板（如树莓派、RK3399等）
    • RS485转USB适配器或开发板自带RS485接口
    • 必要的连接线缆（双绞线推荐）

  • 软件工具：

    • 交叉编译工具链（如arm-linux-gnueabihf）
    • libmodbus 3.1.10源码包
    • 开发主机（推荐使用Ubuntu系统）

首先需要安装ARM交叉编译工具链：

sudo apt update sudo apt install gcc-arm-linux-gnueabihf

验证工具链安装是否成功：

arm-linux-gnueabihf-gcc --version

提示：如果开发板使用不同的架构（如aarch64），需要安装对应的交叉编译工具链，例如gcc-aarch64-linux-gnu。

2. libmodbus库的交叉编译与移植

2.1 获取并解压源码

从libmodbus官方GitHub仓库下载最新稳定版（3.1.10）：

wget https://github.com/stephane/libmodbus/archive/v3.1.10.tar.gz -O libmodbus-3.1.10.tar.gz tar -zxvf libmodbus-3.1.10.tar.gz cd libmodbus-3.1.10

2.2 配置交叉编译环境

执行以下命令配置编译选项：

./configure --host=arm-linux-gnueabihf \ --prefix=/usr/local/arm-libmodbus \ --enable-static \ --enable-shared

关键参数说明：

  • --host：指定目标平台架构
  • --prefix：设置安装目录
  • --enable-static：生成静态库
  • --enable-shared：生成动态库

2.3 编译与安装

执行编译和安装命令：

make -j$(nproc) sudo make install

编译完成后，库文件将安装在/usr/local/arm-libmodbus目录下，包含以下重要文件：

/usr/local/arm-libmodbus/ ├── include/modbus/ │ ├── modbus.h │ ├── modbus-rtu.h │ └── modbus-tcp.h └── lib/ ├── libmodbus.a ├── libmodbus.la ├── libmodbus.so -> libmodbus.so.5.1.0 ├── libmodbus.so.5 -> libmodbus.so.5.1.0 └── libmodbus.so.5.1.0

2.4 移植到ARM开发板

将编译好的库文件打包并复制到开发板：

cd /usr/local/arm-libmodbus sudo tar czvf arm-libmodbus.tar.gz lib include

将生成的arm-libmodbus.tar.gz文件传输到开发板（可通过scp、U盘等方式），然后在开发板上执行：

tar xzvf arm-libmodbus.tar.gz sudo cp -r lib/* /usr/lib/ sudo cp -r include/* /usr/include/ sudo ldconfig

注意：如果开发板的文件系统为只读，需要先将其挂载为可读写模式，或考虑将库文件安装到其他可写目录（如/usr/local/lib）。

3. RS485硬件连接与配置

3.1 硬件连接方式

典型的RS485连接示意图：

设备端连接线开发板端
A+双绞线A+
B-双绞线B-
GND屏蔽层GND

关键注意事项：

  • 使用双绞线而非普通导线，可显著提高抗干扰能力
  • 总线两端需接120Ω终端电阻
  • 避免星型拓扑，应采用总线型拓扑结构

3.2 开发板串口配置

确认开发板的串口设备文件（通常为/dev/ttySx或/dev/ttyUSBx），然后设置正确的波特率、数据位、停止位和校验位：

stty -F /dev/ttyS0 115200 cs8 -parenb -cstopb

如果需要启用RS485模式（部分开发板需要）：

sudo apt install setserial setserial /dev/ttyS0 rs485

4. Modbus主从站程序开发

4.1 主站程序实现

创建master.c文件：

#include <stdio.h> #include <modbus.h> #include <errno.h> #include <unistd.h> #include "config.h" int main() { modbus_t *ctx; uint16_t tab_reg[10] = {0}; int rc; // 创建RTU上下文 ctx = modbus_new_rtu("/dev/ttyS0", BAUD_RATE, 'N', 8, 1); if (ctx == NULL) { fprintf(stderr, "无法创建Modbus上下文\n"); return -1; } // 设置从站地址 modbus_set_slave(ctx, 1); // 设置响应超时（毫秒） modbus_set_response_timeout(ctx, 1, 0); // 连接设备 if (modbus_connect(ctx) == -1) { fprintf(stderr, "连接失败: %s\n", modbus_strerror(errno)); modbus_free(ctx); return -1; } // 主循环：每2秒读取一次寄存器 while (1) { rc = modbus_read_registers(ctx, 0, 5, tab_reg); if (rc == -1) { fprintf(stderr, "读取失败: %s\n", modbus_strerror(errno)); } else { printf("成功读取%d个寄存器:\n", rc); for (int i = 0; i < rc; i++) { printf("寄存器%d: 0x%04X (%d)\n", i, tab_reg[i], tab_reg[i]); } } sleep(2); } // 清理资源 modbus_close(ctx); modbus_free(ctx); return 0; }

4.2 从站程序实现

创建slave.c文件：

#include <stdio.h> #include <modbus.h> #include <errno.h> #include <signal.h> #include <stdlib.h> #include "config.h" modbus_t *ctx = NULL; modbus_mapping_t *mb_mapping = NULL; void cleanup(int sig) { if (mb_mapping != NULL) { modbus_mapping_free(mb_mapping); } if (ctx != NULL) { modbus_close(ctx); modbus_free(ctx); } exit(sig == SIGINT ? 0 : 1); } int main() { signal(SIGINT, cleanup); signal(SIGTERM, cleanup); // 创建RTU上下文 ctx = modbus_new_rtu("/dev/ttyS0", BAUD_RATE, 'N', 8, 1); if (ctx == NULL) { fprintf(stderr, "无法创建Modbus上下文\n"); return -1; } // 设置从站地址 modbus_set_slave(ctx, 1); // 启用调试模式（可选） // modbus_set_debug(ctx, TRUE); // 创建寄存器映射 mb_mapping = modbus_mapping_new(0, 0, 10, 0); if (mb_mapping == NULL) { fprintf(stderr, "无法创建寄存器映射\n"); cleanup(1); } // 初始化寄存器值 for (int i = 0; i < 10; i++) { mb_mapping->tab_registers[i] = i * 10; } // 连接设备 if (modbus_connect(ctx) == -1) { fprintf(stderr, "连接失败: %s\n", modbus_strerror(errno)); cleanup(1); } // 主循环：处理请求 uint8_t query[MODBUS_RTU_MAX_ADU_LENGTH]; while (1) { int rc = modbus_receive(ctx, query); if (rc > 0) { modbus_reply(ctx, query, rc, mb_mapping); } else if (rc == -1) { fprintf(stderr, "接收错误: %s\n", modbus_strerror(errno)); } } return 0; }

4.3 公共配置文件

创建config.h文件：

#ifndef CONFIG_H #define CONFIG_H // 串口设备 #define SERIAL_PORT "/dev/ttyS0" // 波特率设置 #define BAUD_RATE 115200 // 从站地址 #define SLAVE_ID 1 #endif // CONFIG_H

5. 交叉编译与系统集成

5.1 Makefile编写

创建Makefile文件：

CC = arm-linux-gnueabihf-gcc CFLAGS = -Wall -I/usr/local/arm-libmodbus/include/modbus LDFLAGS = -L/usr/local/arm-libmodbus/lib -lmodbus -lpthread .PHONY: all clean all: master slave master: master.o $(CC) -o $@ $^ $(LDFLAGS) slave: slave.o $(CC) -o $@ $^ $(LDFLAGS) %.o: %.c config.h $(CC) $(CFLAGS) -c $< -o $@ clean: rm -f master slave *.o

5.2 交叉编译执行

在开发主机上执行编译：

make clean make

编译完成后，将生成的master和slave可执行文件复制到ARM开发板。

5.3 运行测试

在开发板上分别运行主站和从站程序：

# 在一个终端运行从站 ./slave # 在另一个终端运行主站 ./master

预期输出示例（主站）：

成功读取5个寄存器: 寄存器0: 0x0000 (0) 寄存器1: 0x000A (10) 寄存器2: 0x0014 (20) 寄存器3: 0x001E (30) 寄存器4: 0x0028 (40)

6. 高级功能与性能优化

6.1 错误处理与重试机制

增强主站程序的鲁棒性：

int read_with_retry(modbus_t *ctx, int addr, int nb, uint16_t *dest) { int retries = 3; while (retries-- > 0) { int rc = modbus_read_registers(ctx, addr, nb, dest); if (rc == nb) return 0; // 成功 usleep(100000); // 100ms延迟后重试 } return -1; // 重试失败 }

6.2 多线程处理

从站程序可以使用多线程处理多个请求：

void *handle_requests(void *arg) { modbus_t *ctx = (modbus_t *)arg; uint8_t query[MODBUS_RTU_MAX_ADU_LENGTH]; while (1) { int rc = modbus_receive(ctx, query); if (rc > 0) { modbus_reply(ctx, query, rc, mb_mapping); } } return NULL; } // 在主函数中创建线程 pthread_t thread; pthread_create(&thread, NULL, handle_requests, ctx);

6.3 性能监控

添加性能统计功能：

struct { unsigned long total_requests; unsigned long failed_requests; struct timeval last_print; } stats = {0}; // 在请求处理循环中 stats.total_requests++; if (rc == -1) stats.failed_requests++; // 定期打印统计信息 struct timeval now; gettimeofday(&now, NULL); if (now.tv_sec - stats.last_print.tv_sec >= 5) { printf("请求统计: 总数=%lu, 失败=%lu (%.2f%%)\n", stats.total_requests, stats.failed_requests, (float)stats.failed_requests/stats.total_requests*100); stats.last_print = now; }
http://www.jsqmd.com/news/569110/

相关文章：

  • 跨平台资源嗅探下载解决方案：res-downloader技术指南
  • 5分钟快速部署Hunyuan-MT-7B翻译模型：零基础小白也能用的33种语言互译神器
  • Matlab硬件支持包离线安装全攻略：无需维护服务的替代方案
  • 2026新款自动连点器，工作室/老司机必备工具，解放双手，安卓已开源
  • Chromium指纹浏览器开发必看：这些目录你了解吗？
  • Pixel Aurora Engine效果展示：同一Prompt生成FC/NES/SNES三种主机风格
  • Qwen3.5揭秘：MTP多Token预测技术，让大模型生成速度翻倍！
  • Image-to-Video在内容创作中的应用：快速生成社交媒体短视频
  • MinIO Java客户端封装实战：手把手教你实现文件上传下载与桶管理
  • 无偿分享 软件合集
  • 别再手动调阈值了！用Python+OpenCV实现3种自动图像分割，附完整GUI代码
  • 3分钟解锁网易云音乐隐藏功能：BetterNCM Installer一键安装指南
  • AI协作者：在快马平台通过对话式开发践行opcore simlify设计哲学
  • 从选型到踩坑：工程师必懂的ADC频谱指标实战指南（避坑SFDR、IMD与谐波失真）
  • 从MobileNet到ViT：一个‘深度卷积’如何弥合CNN与Transformer的鸿沟？
  • 颠覆传统系统管理：Winhance中文版效率工具全解析
  • Leather Dress Collection惊艳案例：Leather Bustier Pants生成复古机车风广告大片
  • Spring Boot 3.0 + Java 17 微服务实战：用Gradle统一管理多模块依赖与版本，告别配置混乱
  • Android WiFi断连问题解析：IpReachabilityMonitor机制与LOST_PROVISIONING的应对策略
  • 卡证检测矫正模型GPU算力优化部署：显存占用低至2.1GB实测
  • 利用快马ai快速生成stm32温湿度监测系统原型代码
  • RS485接口的EMC设计与浪涌防护实战解析
  • 前端加密后端解：SpringBoot项目整合SM2国密算法保护API数据传输实战
  • ComfyUI LCM-Turbo极速出图：1分钟生成高质量AI图片实战
  • Zephyr与MCUBoot的深度整合：从构建到安全启动的完整指南
  • 终极指南：用Ripes可视化工具深入理解RISC-V处理器架构与性能优化
  • 千问3.5-2B效果展示：同一张图不同提示词（描述/OCR/注意点）的差异化输出对比
  • Windows 11 + CUDA 12.1 保姆级教程：手把手搞定Detectron2环境搭建（含Git加速与权限避坑）
  • Janus-Pro-7B效果展示：模糊照片→清晰描述→生成同风格新图三连击
  • 避开这些坑！uView Steps组件自定义样式时最容易犯的5个错误