简介面向已有一定单片机与RTOS基础的嵌入式开发者这份资料围绕FreeModbus协议栈的入门与进阶展开重点解决从机开源而主机源码收费、网上缺少易用开源主站参考的问题。内容结合STM32H743FreeRTOS移植实践讲解主站与从站协议栈的实现思路涵盖主从机在同一协议栈运行、阻塞与非阻塞请求、自定义超时以及常用Modbus方法调用等要点并从协议基础、主从机流程、接口调用到工程目录组织逐层梳理配有详尽注释的例程说明、主从流程图、协议整理文档和调试工具使用参考便于读者理解协议分层、移植适配与联调排错。资源包共1个文件为PDF格式约120KB内容以图文说明为主适合作为查阅型笔记与移植思路参考。目前已有506人学习适合需要快速建立FreeModbus主从站开发框架的读者。1. 从一次产线调试说起这套 FreeModbus 主从栈能解决什么去年帮一个做小型控制柜的朋友排查通讯问题现场是一块 STM32H743 板子跑 FreeRTOS既要作为从站被上位机轮询又要作为主站去读几路传感器。原来用的一版协议栈只有从机主机部分得自己照着寄存器时序撸轮询几台设备之后任务优先级一乱串口就丢帧查了整整两天。后来换成主从同栈的方案同一套源码里既能当从站又能主动发起请求阻塞、非阻塞模式可选超时自己定这类“一边被问、一边去问”的活儿才算稳下来。这份资源就是围绕这个场景整理的FreeModbus V1.6 原始从机源码加上在 STM32H743 FreeRTOS 上移植好的主从一体工程风格和原有从机接口保持一致还配了主机、从机流程图Modbus 应用协议文档以及 Modbus Slave、Modbus Poll 两个上位机调试工具。对嵌入式开发者来说它不是一份纯理论资料而是一份能直接编译下载、能对着流程图改的工程包。做过 RS485 现场总线、想搞清楚 Modbus 主站到底怎么在不阻塞任务的前提下收发帧的人读下去会比较有收获。2. 协议栈架构从机内核 新增主机层的组合方式2.1 原有 FreeModbus 从机的分层结构FreeModbus V1.6 本身是分层很干净的最底下是端口层port负责串口收发和定时器中间是协议核心处理功能码和 PDU 解析最上面是应用回调层用户注册寄存器读写函数。从机侧的调度靠的是状态机加轮询eMBPoll()在一个循环里推进接收、解析、响应、发送几个状态。移植到 STM32 上端口层要做的事很具体/* portserial.c 里的串口初始化按 H743 的实际外设改 */ BOOL xMBPortSerialInit( UCHAR ucPORT, ULONG ulBaudRate, UCHAR ucDataBits, eMBParity eParity ) { ( void )ucPORT; /* 1. 打开 USART 时钟与 GPIO 时钟配置 TX/RX 复用 */ /* 2. RS485 方向脚单独配置为推挽输出默认接收态 */ /* 3. 波特率、数据位、校验位由协议栈参数传入别写死 */ if( eParity MB_PAR_NONE ) { /* 8N1 或 8N2按实际从机设备配置 */ } else if( eParity MB_PAR_EVEN ) { /* 8E1Modbus 常用 */ } /* 4. 使能接收中断发送用中断或 DMA二者选其一 */ return TRUE; } /* 定时器用于 3.5 字符间隔判定这是 Modbus RTU 的命门 */ BOOL xMBPortTimersInit( USHORT usTimeOut50us ) { /* 按 50us 计数单位配置定时器超时值 3.5 字符时间 */ return TRUE; }这段代码的关键不在寄存器怎么写而在三点RS485 方向脚必须和发送完成中断严格配合发完最后一个字节才能切回接收早一步就把自己的回声吃掉了定时器单位是 50us3.5 字符时间要按波特率换算后填进去波特率越高这个窗口越窄校验位参数从协议栈传进来不要在端口层写死成 8N1否则换个校验方式就得改代码。常见的做法是在vMBPortSerialEnable()里统一管方向脚接收使能时拉低发送使能时拉高发送完成中断里再拉回来。我一般还会在方向脚切换后加一个极短的延时或者等 TC 标志具体看收发器芯片的响应速度这点后面避坑章节还会提到。2.2 主机层与从机共存的接口设计新增的主机部分没有另起炉灶而是照着从机的命名和返回码体系来做。核心接口大致是这几类初始化、使能、发起请求、轮询推进、获取结果。应用层发起一次读保持寄存器写法接近这样/* 主机模式初始化波特率和从机共用一套配置 */ eMBMasterInit( MB_RTU, 1, 115200, MB_PAR_EVEN ); /* 使能协议栈内部会启动接收和超时定时器 */ eMBMasterEnable(); /* 非阻塞方式发起请求从站地址 0x02读 10 个保持寄存器 */ eMBMasterReqReadHoldingRegister( 0x02, 0x0000, 10, 100 );这里第三个参数之后是超时时间单位是毫秒级别由用户在调用时指定这就是正文里说的“自定义超时、阻塞非阻塞可选”。非阻塞模式下函数立刻返回请求被挂到内部状态机上主循环里靠eMBMasterPoll()推进阻塞模式则在内部等结果返回或者超时适合在单独的任务里调用。主从共存的难点在于串口只有一路。我的处理方式是给主机和从机各一套状态机用运行模式标志位切换平时处于从机监听态应用层要主动读设备时切到主机发送态请求完成后再切回来。切换点必须放在帧间隔之后不能在一帧中间切否则总线上会出现半截帧。/* 运行模式切换示意实际工程里用状态机变量控制 */ typedef enum { MB_RUN_MODE_SLAVE 0, /* 从机监听等待上位机轮询 */ MB_RUN_MODE_MASTER /* 主机主动发起请求 */ } eMBRunMode; /* 主循环里根据模式分发 */ while( 1 ) { if( eCurMode MB_RUN_MODE_SLAVE ) { eMBPoll(); /* 从机状态机推进 */ } else { eMBMasterPoll(); /* 主机状态机推进 */ } }参数上要注意从站地址主机侧调用的第一个参数是从站地址范围 1 到 2470 是广播地址只写不读从机侧自己的地址在初始化时配置两边不能撞。同一个工程里既当从机又当主机时从机地址和它要访问的远端设备地址必须区分开这个在调试时最容易搞混。2.3 工程目录与文件职责移植好的工程结构大致是源码、端口、应用三层分开配合流程图看会快很多目录/文件职责freemodbus/modbus/协议核心RTU/ASCII 帧处理、功能码分发freemodbus/modbus/rtu/RTU 模式下的帧收发与 CRC 校验freemodbus/port/串口、定时器、事件移植层STM32 相关都在这里freemodbus/demo/从机与主机的应用回调示例主机新增源文件主机状态机、请求队列、超时管理main.c/ 任务文件FreeRTOS 任务创建协议栈轮询入口从机流程图和主机流程图这两份 visio 文件价值不小尤其是主机那份把“发起请求—等待响应—超时重试—回调通知”的完整状态迁移画出来了。第一次读主机源码之前先看图比直接啃状态机代码省时间。3. 在 STM32H743 FreeRTOS 上跑起来从编译到联调3.1 环境准备与工程导入硬件上需要一块 STM32H743 的开发板、一路 RS485 收发电路或者用 USB 转 485 模块对接 PC以及至少一个 Modbus 从机设备做对端没有实物就用资源里带的 Modbus Slave 软件模拟。软件侧准备 Keil MDK 或者 STM32CubeIDEFreeRTOS 用 CubeMX 生成或者工程里自带的都行注意堆栈给够——协议栈内部有缓冲区任务栈太小会直接跑飞。导入工程后先别急着编译检查三处芯片型号和启动文件是否匹配 H743FreeRTOS 的FreeRTOSConfig.h里configTOTAL_HEAP_SIZE是否够协议栈和几个任务用串口外设的引脚定义是否和板上实际接线一致。这三处不对后面调试全是白费功夫。时钟配置也要留意。H743 主频高串口挂在不同总线上分频系数不一样波特率算错会导致能收不能发或者全是乱码。稳妥的做法是先写个裸机串口回环测试确认波特率准确了再上协议栈。编译通过后下载先只跑从机模式用 Modbus Poll 连上去读几个寄存器。通了再切主机模式去读对端设备。分两步走比一上来就主从全开要好排查得多。3.2 从机侧寄存器回调与任务调度从机能不能被正确读到取决于应用回调注册得对不对。FreeModbus 要求注册几个回调函数分别处理读输入寄存器、读保持寄存器、写多个寄存器等/* 从机应用层回调注册按实际寄存器数量调整 */ eMBErrorCode eMBRegHoldingCB( UCHAR * pucRegBuffer, USHORT usAddress, USHORT usNRegs, eMBRegisterMode eMode ) { eMBErrorCode eStatus MB_ENOERR; USHORT i; /* 地址越界要返回非法数据地址让主站知道请求有问题 */ if( ( usAddress REG_HOLDING_START ) || ( ( usAddress usNRegs ) ( REG_HOLDING_START REG_HOLDING_NREGS ) ) ) { return MB_ENOREG; } if( eMode MB_REG_READ ) { /* 读把内部寄存器搬到协议栈缓冲区注意大端序 */ for( i 0; i usNRegs; i ) { pucRegBuffer[2 * i] ( UCHAR )( usRegHoldingBuf[i] 8 ); pucRegBuffer[2 * i 1] ( UCHAR )( usRegHoldingBuf[i] 0xFF ); } } else { /* 写从缓冲区搬回内部寄存器 */ for( i 0; i usNRegs; i ) { usRegHoldingBuf[i] ( USHORT )( pucRegBuffer[2 * i] 8 ) | ( USHORT )( pucRegBuffer[2 * i 1] ); } } return eStatus; }这段回调里有两个参数值得说清楚usAddress是主站请求的起始寄存器地址注意 Modbus 协议里地址是从 0 开始算的而上位机软件界面常常显示 40001 这种编号两者差一个偏移对不上就是“读回来全是 0”或者“返回非法地址”usNRegs是寄存器数量循环里乘以 2 是因为每个寄存器两个字节字节序必须是大端H743 是小端不做移位处理读出来就是高低字节颠倒。在 FreeRTOS 下这个回调会被协议栈状态机调用执行时间要尽量短别在里面做串口打印或者延时。寄存器数据用全局数组加临界区保护或者在任务里更新、回调里只做搬运避免多任务竞争。从机任务本身很简单/* 从机轮询任务优先级低于通讯相关任务即可 */ static void vModbusSlaveTask( void *pvParameters ) { ( void )pvParameters; /* 初始化并启动从机失败则挂起任务等待排查 */ if( eMBInit( MB_RTU, SLAVE_ADDR, 1, 115200, MB_PAR_EVEN ) ! MB_ENOERR ) { vTaskSuspend( NULL ); } eMBEnable(); for( ;; ) { /* 推进状态机内部非阻塞靠定时器和中断驱动 */ ( void )eMBPoll(); vTaskDelay( pdMS_TO_TICKS( 1 ) ); } }vTaskDelay给 1 个 tick 是为了让出 CPU但别给太大否则帧间隔判定会受影响。中断里收到字节后置事件任务里轮询处理这是 FreeModbus 的常规玩法。3.3 主机侧非阻塞请求与超时管理主机侧的重点是把请求发出去之后不堵住任务。典型写法是在一个任务里定时轮询设备列表每次发一个请求靠回调拿到结果/* 主机请求回调协议栈在收到响应或超时后调用 */ void vMBMasterRxCallback( UCHAR ucSlaveAddr, UCHAR ucFuncCode, UCHAR * pucData, USHORT usLen, eMBException eExc ) { if( eExc ! MB_EX_NONE ) { /* 从站返回异常码按功能码查询原因 */ return; } if( ucFuncCode MB_FUNC_READ_HOLDING_REGISTER ) { /* 解析数据区前两个字节可能是字节数 */ /* 把 usLen 个字节按大端序还原成寄存器值 */ } } /* 主机轮询任务逐个设备发起读请求非阻塞 */ static void vModbusMasterTask( void *pvParameters ) { ( void )pvParameters; eMBMasterInit( MB_RTU, MASTER_ADDR, 1, 115200, MB_PAR_EVEN ); eMBMasterEnable(); for( ;; ) { /* 对每个从站发起请求超时 100ms立刻返回 */ eMBMasterReqReadHoldingRegister( 0x02, 0x0000, 10, 100 ); /* 轮询推进等回调里置位完成标志 */ eMBMasterPoll(); /* 简单节流实际项目里用事件组或信号量同步 */ vTaskDelay( pdMS_TO_TICKS( 50 ) ); } }参数说明0x02是目标从站地址0x0000是起始寄存器10是数量100是超时毫秒数。超时值要根据波特率和帧长估算115200 下读 10 个寄存器一帧也就几毫秒留 100ms 是给从站处理时间留余量现场干扰大可以适当加长但别加太长否则一台设备掉线会拖慢整个轮询周期。非阻塞模式下一个任务里可以串行发多个请求但同一时刻总线上只能有一个请求在飞。我的做法是维护一个设备列表和一个索引收到回调后再发下一个用信号量在回调里释放、任务里等待。这样逻辑清晰也不会出现两个请求撞车。4. 联调避坑几个真实踩过的坑4.1 现象Modbus Poll 连上后一直超时从机毫无响应原因通常是三选一RS485 方向脚切换时机不对发送时没切到发送态或者发完没切回来导致数据根本没上总线从机地址配置和上位机请求的地址不一致校验方式不匹配上位机用 8N1、从机配了 8E1帧解析直接失败。解决顺序是先用示波器或者逻辑分析仪看总线波形确认从机有没有应答帧出来。有应答但上位机收不到查方向脚和接线 A/B 是否接反没有应答查地址和校验。没有分析仪就先在串口中断里打个断点看有没有进接收中断能快速定位是硬件层还是协议层。4.2 现象主机读回来的寄存器值高低字节颠倒原因是字节序处理漏了。Modbus 协议规定寄存器传输是大端而 STM32 是小端协议栈缓冲区里已经是网络字节序如果应用层直接用memcpy到uint16_t数组就会得到颠倒的值。解决方法是解析时手动移位组合value (buf[0] 8) | buf[1]。从机侧写缓冲区时同理先取高字节再取低字节。这个坑几乎每个第一次写 Modbus 的人都踩过对上位机界面看到 0x1234 变成 0x3412 就该反应过来。4.3 现象主从共存时偶发丢帧跑几小时后通讯断开原因是模式切换时机不对。主机发完请求还没等到响应就切回从机监听或者从机正在应答上位机时被主机抢占串口总线上出现两个设备同时发送的冲突帧。解决办法是切换模式前先确认当前帧已完整收发完毕用帧间隔定时器做门控。更稳的做法是加一个总线忙标志主机请求前检查标志从机正在应答时主机请求排队等待。这一点在资源里的主机流程图上有体现状态机里专门有等待总线空闲的迁移。4.4 现象编译通过但运行进 HardFault常见原因是任务栈不够或者中断优先级配置冲突。FreeModbus 的端口层会在中断里调用协议栈函数如果串口中断优先级高于 FreeRTOS 可管理的中断优先级上限就会触发断言或者直接死机。H743 上要把串口和定时器中断优先级数值设得比configMAX_SYSCALL_INTERRUPT_PRIORITY更大即优先级更低。另一个来源是堆栈协议栈内部缓冲区如果定义在栈上主任务栈给小了会溢出。检查启动文件里的栈大小和 FreeRTOS 堆配置先把栈加到 2KB 以上排除这个问题。调试时可以看 HardFault 时的栈回溯或者干脆在可疑函数里加计数变量定位到具体位置。5. 二次开发把这套主从栈改造成自己的轮询框架工程跑通之后真正要花时间的是把它嵌进自己的业务逻辑。我一般的做法是先不动协议栈源码而是在应用层加一层薄封装一个设备表、一个轮询调度器、一套回调分发。设备表里放从站地址、功能码、寄存器起始地址、数量、超时、回调函数指针调度器按固定周期遍历用信号量同步请求完成。/* 应用层设备表和协议栈解耦 */ typedef struct { UCHAR ucSlaveAddr; /* 从站地址 */ USHORT usRegStart; /* 起始寄存器 */ USHORT usRegCount; /* 寄存器数量 */ USHORT usTimeoutMs; /* 单次请求超时 */ void ( *pfnDone )( USHORT *pusData, USHORT usLen ); /* 完成回调 */ } ModbusPollItem; /* 轮询调度一次只发一个请求完成后再发下一个 */ void vPollSchedulerRun( void ) { static USHORT usIndex 0; ModbusPollItem *pItem g_pollTable[usIndex]; /* 发起非阻塞请求结果在协议栈回调里处理 */ eMBMasterReqReadHoldingRegister( pItem-ucSlaveAddr, pItem-usRegStart, pItem-usRegCount, pItem-usTimeoutMs ); /* 索引循环推进 */ usIndex ( usIndex 1 ) % g_pollTableSize; }这样改的好处是协议栈保持原样以后换芯片或者升级协议栈版本业务层不用跟着动。验证方法也简单先在设备表里只放一个从站用 Modbus Slave 模拟数据变化看回调里的值是否跟着变再逐步加设备观察轮询周期是否线性增长、有没有某一台超时拖慢全局。还有个技巧是把超时和重试分开配置。现场干扰大的设备给长超时加两次重试稳定的设备给短超时避免一台掉线设备拖垮整个周期。重试逻辑放在调度器里而不是协议栈里这样协议栈只负责单次请求职责更清楚。从那以后我每次移植这类协议栈都强制先把裸机串口回环和字节序验证走一遍再上主从联调——这两步省下来后面就得用示波器和断点一点点还回去。希望这套工程和流程图能帮你少走点弯路把时间花在业务上而不是帧格式上。本文还有配套的精品资源点击获取
简介面向已有一定单片机与RTOS基础的嵌入式开发者这份资料围绕FreeModbus协议栈的入门与进阶展开重点解决从机开源而主机源码收费、网上缺少易用开源主站参考的问题。内容结合STM32H743FreeRTOS移植实践讲解主站与从站协议栈的实现思路涵盖主从机在同一协议栈运行、阻塞与非阻塞请求、自定义超时以及常用Modbus方法调用等要点并从协议基础、主从机流程、接口调用到工程目录组织逐层梳理配有详尽注释的例程说明、主从流程图、协议整理文档和调试工具使用参考便于读者理解协议分层、移植适配与联调排错。资源包共1个文件为PDF格式约120KB内容以图文说明为主适合作为查阅型笔记与移植思路参考。目前已有506人学习适合需要快速建立FreeModbus主从站开发框架的读者。1. 从一次产线调试说起这套 FreeModbus 主从栈能解决什么去年帮一个做小型控制柜的朋友排查通讯问题现场是一块 STM32H743 板子跑 FreeRTOS既要作为从站被上位机轮询又要作为主站去读几路传感器。原来用的一版协议栈只有从机主机部分得自己照着寄存器时序撸轮询几台设备之后任务优先级一乱串口就丢帧查了整整两天。后来换成主从同栈的方案同一套源码里既能当从站又能主动发起请求阻塞、非阻塞模式可选超时自己定这类“一边被问、一边去问”的活儿才算稳下来。这份资源就是围绕这个场景整理的FreeModbus V1.6 原始从机源码加上在 STM32H743 FreeRTOS 上移植好的主从一体工程风格和原有从机接口保持一致还配了主机、从机流程图Modbus 应用协议文档以及 Modbus Slave、Modbus Poll 两个上位机调试工具。对嵌入式开发者来说它不是一份纯理论资料而是一份能直接编译下载、能对着流程图改的工程包。做过 RS485 现场总线、想搞清楚 Modbus 主站到底怎么在不阻塞任务的前提下收发帧的人读下去会比较有收获。2. 协议栈架构从机内核 新增主机层的组合方式2.1 原有 FreeModbus 从机的分层结构FreeModbus V1.6 本身是分层很干净的最底下是端口层port负责串口收发和定时器中间是协议核心处理功能码和 PDU 解析最上面是应用回调层用户注册寄存器读写函数。从机侧的调度靠的是状态机加轮询eMBPoll()在一个循环里推进接收、解析、响应、发送几个状态。移植到 STM32 上端口层要做的事很具体/* portserial.c 里的串口初始化按 H743 的实际外设改 */ BOOL xMBPortSerialInit( UCHAR ucPORT, ULONG ulBaudRate, UCHAR ucDataBits, eMBParity eParity ) { ( void )ucPORT; /* 1. 打开 USART 时钟与 GPIO 时钟配置 TX/RX 复用 */ /* 2. RS485 方向脚单独配置为推挽输出默认接收态 */ /* 3. 波特率、数据位、校验位由协议栈参数传入别写死 */ if( eParity MB_PAR_NONE ) { /* 8N1 或 8N2按实际从机设备配置 */ } else if( eParity MB_PAR_EVEN ) { /* 8E1Modbus 常用 */ } /* 4. 使能接收中断发送用中断或 DMA二者选其一 */ return TRUE; } /* 定时器用于 3.5 字符间隔判定这是 Modbus RTU 的命门 */ BOOL xMBPortTimersInit( USHORT usTimeOut50us ) { /* 按 50us 计数单位配置定时器超时值 3.5 字符时间 */ return TRUE; }这段代码的关键不在寄存器怎么写而在三点RS485 方向脚必须和发送完成中断严格配合发完最后一个字节才能切回接收早一步就把自己的回声吃掉了定时器单位是 50us3.5 字符时间要按波特率换算后填进去波特率越高这个窗口越窄校验位参数从协议栈传进来不要在端口层写死成 8N1否则换个校验方式就得改代码。常见的做法是在vMBPortSerialEnable()里统一管方向脚接收使能时拉低发送使能时拉高发送完成中断里再拉回来。我一般还会在方向脚切换后加一个极短的延时或者等 TC 标志具体看收发器芯片的响应速度这点后面避坑章节还会提到。2.2 主机层与从机共存的接口设计新增的主机部分没有另起炉灶而是照着从机的命名和返回码体系来做。核心接口大致是这几类初始化、使能、发起请求、轮询推进、获取结果。应用层发起一次读保持寄存器写法接近这样/* 主机模式初始化波特率和从机共用一套配置 */ eMBMasterInit( MB_RTU, 1, 115200, MB_PAR_EVEN ); /* 使能协议栈内部会启动接收和超时定时器 */ eMBMasterEnable(); /* 非阻塞方式发起请求从站地址 0x02读 10 个保持寄存器 */ eMBMasterReqReadHoldingRegister( 0x02, 0x0000, 10, 100 );这里第三个参数之后是超时时间单位是毫秒级别由用户在调用时指定这就是正文里说的“自定义超时、阻塞非阻塞可选”。非阻塞模式下函数立刻返回请求被挂到内部状态机上主循环里靠eMBMasterPoll()推进阻塞模式则在内部等结果返回或者超时适合在单独的任务里调用。主从共存的难点在于串口只有一路。我的处理方式是给主机和从机各一套状态机用运行模式标志位切换平时处于从机监听态应用层要主动读设备时切到主机发送态请求完成后再切回来。切换点必须放在帧间隔之后不能在一帧中间切否则总线上会出现半截帧。/* 运行模式切换示意实际工程里用状态机变量控制 */ typedef enum { MB_RUN_MODE_SLAVE 0, /* 从机监听等待上位机轮询 */ MB_RUN_MODE_MASTER /* 主机主动发起请求 */ } eMBRunMode; /* 主循环里根据模式分发 */ while( 1 ) { if( eCurMode MB_RUN_MODE_SLAVE ) { eMBPoll(); /* 从机状态机推进 */ } else { eMBMasterPoll(); /* 主机状态机推进 */ } }参数上要注意从站地址主机侧调用的第一个参数是从站地址范围 1 到 2470 是广播地址只写不读从机侧自己的地址在初始化时配置两边不能撞。同一个工程里既当从机又当主机时从机地址和它要访问的远端设备地址必须区分开这个在调试时最容易搞混。2.3 工程目录与文件职责移植好的工程结构大致是源码、端口、应用三层分开配合流程图看会快很多目录/文件职责freemodbus/modbus/协议核心RTU/ASCII 帧处理、功能码分发freemodbus/modbus/rtu/RTU 模式下的帧收发与 CRC 校验freemodbus/port/串口、定时器、事件移植层STM32 相关都在这里freemodbus/demo/从机与主机的应用回调示例主机新增源文件主机状态机、请求队列、超时管理main.c/ 任务文件FreeRTOS 任务创建协议栈轮询入口从机流程图和主机流程图这两份 visio 文件价值不小尤其是主机那份把“发起请求—等待响应—超时重试—回调通知”的完整状态迁移画出来了。第一次读主机源码之前先看图比直接啃状态机代码省时间。3. 在 STM32H743 FreeRTOS 上跑起来从编译到联调3.1 环境准备与工程导入硬件上需要一块 STM32H743 的开发板、一路 RS485 收发电路或者用 USB 转 485 模块对接 PC以及至少一个 Modbus 从机设备做对端没有实物就用资源里带的 Modbus Slave 软件模拟。软件侧准备 Keil MDK 或者 STM32CubeIDEFreeRTOS 用 CubeMX 生成或者工程里自带的都行注意堆栈给够——协议栈内部有缓冲区任务栈太小会直接跑飞。导入工程后先别急着编译检查三处芯片型号和启动文件是否匹配 H743FreeRTOS 的FreeRTOSConfig.h里configTOTAL_HEAP_SIZE是否够协议栈和几个任务用串口外设的引脚定义是否和板上实际接线一致。这三处不对后面调试全是白费功夫。时钟配置也要留意。H743 主频高串口挂在不同总线上分频系数不一样波特率算错会导致能收不能发或者全是乱码。稳妥的做法是先写个裸机串口回环测试确认波特率准确了再上协议栈。编译通过后下载先只跑从机模式用 Modbus Poll 连上去读几个寄存器。通了再切主机模式去读对端设备。分两步走比一上来就主从全开要好排查得多。3.2 从机侧寄存器回调与任务调度从机能不能被正确读到取决于应用回调注册得对不对。FreeModbus 要求注册几个回调函数分别处理读输入寄存器、读保持寄存器、写多个寄存器等/* 从机应用层回调注册按实际寄存器数量调整 */ eMBErrorCode eMBRegHoldingCB( UCHAR * pucRegBuffer, USHORT usAddress, USHORT usNRegs, eMBRegisterMode eMode ) { eMBErrorCode eStatus MB_ENOERR; USHORT i; /* 地址越界要返回非法数据地址让主站知道请求有问题 */ if( ( usAddress REG_HOLDING_START ) || ( ( usAddress usNRegs ) ( REG_HOLDING_START REG_HOLDING_NREGS ) ) ) { return MB_ENOREG; } if( eMode MB_REG_READ ) { /* 读把内部寄存器搬到协议栈缓冲区注意大端序 */ for( i 0; i usNRegs; i ) { pucRegBuffer[2 * i] ( UCHAR )( usRegHoldingBuf[i] 8 ); pucRegBuffer[2 * i 1] ( UCHAR )( usRegHoldingBuf[i] 0xFF ); } } else { /* 写从缓冲区搬回内部寄存器 */ for( i 0; i usNRegs; i ) { usRegHoldingBuf[i] ( USHORT )( pucRegBuffer[2 * i] 8 ) | ( USHORT )( pucRegBuffer[2 * i 1] ); } } return eStatus; }这段回调里有两个参数值得说清楚usAddress是主站请求的起始寄存器地址注意 Modbus 协议里地址是从 0 开始算的而上位机软件界面常常显示 40001 这种编号两者差一个偏移对不上就是“读回来全是 0”或者“返回非法地址”usNRegs是寄存器数量循环里乘以 2 是因为每个寄存器两个字节字节序必须是大端H743 是小端不做移位处理读出来就是高低字节颠倒。在 FreeRTOS 下这个回调会被协议栈状态机调用执行时间要尽量短别在里面做串口打印或者延时。寄存器数据用全局数组加临界区保护或者在任务里更新、回调里只做搬运避免多任务竞争。从机任务本身很简单/* 从机轮询任务优先级低于通讯相关任务即可 */ static void vModbusSlaveTask( void *pvParameters ) { ( void )pvParameters; /* 初始化并启动从机失败则挂起任务等待排查 */ if( eMBInit( MB_RTU, SLAVE_ADDR, 1, 115200, MB_PAR_EVEN ) ! MB_ENOERR ) { vTaskSuspend( NULL ); } eMBEnable(); for( ;; ) { /* 推进状态机内部非阻塞靠定时器和中断驱动 */ ( void )eMBPoll(); vTaskDelay( pdMS_TO_TICKS( 1 ) ); } }vTaskDelay给 1 个 tick 是为了让出 CPU但别给太大否则帧间隔判定会受影响。中断里收到字节后置事件任务里轮询处理这是 FreeModbus 的常规玩法。3.3 主机侧非阻塞请求与超时管理主机侧的重点是把请求发出去之后不堵住任务。典型写法是在一个任务里定时轮询设备列表每次发一个请求靠回调拿到结果/* 主机请求回调协议栈在收到响应或超时后调用 */ void vMBMasterRxCallback( UCHAR ucSlaveAddr, UCHAR ucFuncCode, UCHAR * pucData, USHORT usLen, eMBException eExc ) { if( eExc ! MB_EX_NONE ) { /* 从站返回异常码按功能码查询原因 */ return; } if( ucFuncCode MB_FUNC_READ_HOLDING_REGISTER ) { /* 解析数据区前两个字节可能是字节数 */ /* 把 usLen 个字节按大端序还原成寄存器值 */ } } /* 主机轮询任务逐个设备发起读请求非阻塞 */ static void vModbusMasterTask( void *pvParameters ) { ( void )pvParameters; eMBMasterInit( MB_RTU, MASTER_ADDR, 1, 115200, MB_PAR_EVEN ); eMBMasterEnable(); for( ;; ) { /* 对每个从站发起请求超时 100ms立刻返回 */ eMBMasterReqReadHoldingRegister( 0x02, 0x0000, 10, 100 ); /* 轮询推进等回调里置位完成标志 */ eMBMasterPoll(); /* 简单节流实际项目里用事件组或信号量同步 */ vTaskDelay( pdMS_TO_TICKS( 50 ) ); } }参数说明0x02是目标从站地址0x0000是起始寄存器10是数量100是超时毫秒数。超时值要根据波特率和帧长估算115200 下读 10 个寄存器一帧也就几毫秒留 100ms 是给从站处理时间留余量现场干扰大可以适当加长但别加太长否则一台设备掉线会拖慢整个轮询周期。非阻塞模式下一个任务里可以串行发多个请求但同一时刻总线上只能有一个请求在飞。我的做法是维护一个设备列表和一个索引收到回调后再发下一个用信号量在回调里释放、任务里等待。这样逻辑清晰也不会出现两个请求撞车。4. 联调避坑几个真实踩过的坑4.1 现象Modbus Poll 连上后一直超时从机毫无响应原因通常是三选一RS485 方向脚切换时机不对发送时没切到发送态或者发完没切回来导致数据根本没上总线从机地址配置和上位机请求的地址不一致校验方式不匹配上位机用 8N1、从机配了 8E1帧解析直接失败。解决顺序是先用示波器或者逻辑分析仪看总线波形确认从机有没有应答帧出来。有应答但上位机收不到查方向脚和接线 A/B 是否接反没有应答查地址和校验。没有分析仪就先在串口中断里打个断点看有没有进接收中断能快速定位是硬件层还是协议层。4.2 现象主机读回来的寄存器值高低字节颠倒原因是字节序处理漏了。Modbus 协议规定寄存器传输是大端而 STM32 是小端协议栈缓冲区里已经是网络字节序如果应用层直接用memcpy到uint16_t数组就会得到颠倒的值。解决方法是解析时手动移位组合value (buf[0] 8) | buf[1]。从机侧写缓冲区时同理先取高字节再取低字节。这个坑几乎每个第一次写 Modbus 的人都踩过对上位机界面看到 0x1234 变成 0x3412 就该反应过来。4.3 现象主从共存时偶发丢帧跑几小时后通讯断开原因是模式切换时机不对。主机发完请求还没等到响应就切回从机监听或者从机正在应答上位机时被主机抢占串口总线上出现两个设备同时发送的冲突帧。解决办法是切换模式前先确认当前帧已完整收发完毕用帧间隔定时器做门控。更稳的做法是加一个总线忙标志主机请求前检查标志从机正在应答时主机请求排队等待。这一点在资源里的主机流程图上有体现状态机里专门有等待总线空闲的迁移。4.4 现象编译通过但运行进 HardFault常见原因是任务栈不够或者中断优先级配置冲突。FreeModbus 的端口层会在中断里调用协议栈函数如果串口中断优先级高于 FreeRTOS 可管理的中断优先级上限就会触发断言或者直接死机。H743 上要把串口和定时器中断优先级数值设得比configMAX_SYSCALL_INTERRUPT_PRIORITY更大即优先级更低。另一个来源是堆栈协议栈内部缓冲区如果定义在栈上主任务栈给小了会溢出。检查启动文件里的栈大小和 FreeRTOS 堆配置先把栈加到 2KB 以上排除这个问题。调试时可以看 HardFault 时的栈回溯或者干脆在可疑函数里加计数变量定位到具体位置。5. 二次开发把这套主从栈改造成自己的轮询框架工程跑通之后真正要花时间的是把它嵌进自己的业务逻辑。我一般的做法是先不动协议栈源码而是在应用层加一层薄封装一个设备表、一个轮询调度器、一套回调分发。设备表里放从站地址、功能码、寄存器起始地址、数量、超时、回调函数指针调度器按固定周期遍历用信号量同步请求完成。/* 应用层设备表和协议栈解耦 */ typedef struct { UCHAR ucSlaveAddr; /* 从站地址 */ USHORT usRegStart; /* 起始寄存器 */ USHORT usRegCount; /* 寄存器数量 */ USHORT usTimeoutMs; /* 单次请求超时 */ void ( *pfnDone )( USHORT *pusData, USHORT usLen ); /* 完成回调 */ } ModbusPollItem; /* 轮询调度一次只发一个请求完成后再发下一个 */ void vPollSchedulerRun( void ) { static USHORT usIndex 0; ModbusPollItem *pItem g_pollTable[usIndex]; /* 发起非阻塞请求结果在协议栈回调里处理 */ eMBMasterReqReadHoldingRegister( pItem-ucSlaveAddr, pItem-usRegStart, pItem-usRegCount, pItem-usTimeoutMs ); /* 索引循环推进 */ usIndex ( usIndex 1 ) % g_pollTableSize; }这样改的好处是协议栈保持原样以后换芯片或者升级协议栈版本业务层不用跟着动。验证方法也简单先在设备表里只放一个从站用 Modbus Slave 模拟数据变化看回调里的值是否跟着变再逐步加设备观察轮询周期是否线性增长、有没有某一台超时拖慢全局。还有个技巧是把超时和重试分开配置。现场干扰大的设备给长超时加两次重试稳定的设备给短超时避免一台掉线设备拖垮整个周期。重试逻辑放在调度器里而不是协议栈里这样协议栈只负责单次请求职责更清楚。从那以后我每次移植这类协议栈都强制先把裸机串口回环和字节序验证走一遍再上主从联调——这两步省下来后面就得用示波器和断点一点点还回去。希望这套工程和流程图能帮你少走点弯路把时间花在业务上而不是帧格式上。本文还有配套的精品资源点击获取
