极简Modbus主机协议栈：三文件实现跨平台嵌入式通信

在工业自动化、智能家居和物联网设备开发中，Modbus RTU协议因其简单可靠而广受欢迎。但许多嵌入式工程师都遇到过这样的困境：需要一个轻量级的Modbus主机协议栈时，要么被迫使用臃肿的第三方库，要么不得不自己从头实现。本文将介绍一种仅需三个文件即可实现的Modbus RTU主机解决方案，完美适配STM32CubeMX工作流，并支持GD32、MM32等国产MCU平台。

1. 为什么需要极简Modbus主机协议栈？

传统Modbus实现方案通常存在几个痛点：

• 代码臃肿：完整协议栈往往包含大量冗余功能，占用宝贵的Flash空间
• 移植困难：依赖特定硬件或操作系统，跨平台适配成本高
• 学习曲线陡峭：复杂的状态机和回调机制增加了理解难度
• 国产MCU支持不足：许多现有方案针对STM32优化，难以迁移到其他架构

我们的极简方案通过以下设计解决了这些问题：

c复制// 协议栈核心数据结构示例
typedef struct {
    void (*delayms)(uint32_t nms);    // 毫秒延时函数
    void (*timerStart)(void);         // 定时器启动
    uint32_t (*sendData)(const void* buf, uint32_t len); // 数据发送
    // ... 其他必要接口
} MBRTUMaterTypeDef;

这种设计将硬件依赖抽象为几个简单函数指针，使得协议栈核心代码完全与硬件解耦。

2. 协议栈架构与核心API

2.1 极简文件结构

协议栈仅包含三个文件：

1. mbrtu_master.h - 协议栈头文件（声明和接口）
2. mbrtu_master.c - 协议栈实现（约800行代码）
3. mbrtu_master_example.c - 移植参考实现

这种精简结构带来以下优势：

• 编译时间缩短：仅需编译少量文件
• 维护成本低：核心逻辑集中，易于调试
• 内存占用小：RAM使用量可控制在200字节以内

2.2 关键API功能对比

| 功能码 | AP