STM32F103精英板实战：手把手教你移植开源Modbus主机库，实现稳定主从机通信

张

张建站

2026/5/14 12:16:16

10分钟阅读

STM32F103精英板实战手把手教你移植开源Modbus主机库实现稳定主从机通信在工业控制领域Modbus协议因其简单可靠的特点成为设备间通信的事实标准。对于使用STM32F103系列开发产品的工程师来说掌握Modbus主从机通信实现是必备技能。本文将基于正点原子精英开发板带你从零开始移植开源Modbus主机库并与现有从机代码整合构建完整的双向通信系统。1. 工程准备与环境搭建1.1 硬件选型与连接正点原子精英板搭载STM32F103ZET6芯片具备丰富的外设资源。要实现Modbus主从机通信我们需要两块STM32F103精英板分别作为主机和从机两个RS485转TTL模块推荐使用MAX3485芯片的方案杜邦线若干硬件连接示意图主机端从机端RS485总线USART2_TX(PA2)USART2_TX(PA2)A线USART2_RX(PA3)USART2_RX(PA3)B线PD7(控制方向)PD7(控制方向)-GNDGNDGND注意RS485总线需要终端电阻匹配在总线两端各接一个120Ω电阻。1.2 软件资源准备我们需要准备以下软件组件主机库选择采用经过优化的开源Modbus主机框架从机库使用FreeModbus v1.6已适配精英板开发环境Keil MDK 5.25STM32CubeMX用于外设初始化串口调试工具如Modbus Poll/Slave关键文件结构Modbus_Master_Demo/ ├── Drivers/ ├── Inc/ │ ├── mb_config.h // Modbus配置头文件 │ ├── mb_port.h // 硬件抽象层接口 │ └── mb_include.h // 通用定义 ├── Src/ │ ├── main.c // 主程序 │ ├── mb_host.c // Modbus主机核心 │ ├── mb_hook.c // 回调函数实现 │ └── mb_port.c // 硬件驱动适配 └── STM32F103VE.ioc // CubeMX工程文件2. Modbus主机库移植详解2.1 硬件抽象层适配Modbus主机库的核心移植工作集中在mb_port.c文件需要实现以下硬件相关接口// 串口初始化适配精英板USART2 void mb_port_uartInit(uint32_t baud, uint8_t parity) { GPIO_InitTypeDef GPIO_InitStruct {0}; USART_InitTypeDef USART_InitStruct {0}; // 使能时钟 __HAL_RCC_GPIOA_CLK_ENABLE(); __HAL_RCC_USART2_CLK_ENABLE(); __HAL_RCC_GPIOD_CLK_ENABLE(); // 配置USART2 TX/RX引脚 GPIO_InitStruct.Pin GPIO_PIN_2|GPIO_PIN_3; GPIO_InitStruct.Mode GPIO_MODE_AF_PP; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOA, GPIO_InitStruct); // 配置485方向控制引脚 GPIO_InitStruct.Pin GPIO_PIN_7; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_PP; HAL_GPIO_Init(GPIOD, GPIO_InitStruct); // USART参数配置 USART_InitStruct.BaudRate baud; USART_InitStruct.WordLength USART_WORDLENGTH_8B; USART_InitStruct.StopBits USART_STOPBITS_1; USART_InitStruct.Parity parity ? USART_PARITY_EVEN : USART_PARITY_NONE; USART_InitStruct.Mode USART_MODE_TX_RX; HAL_USART_Init(USART2, USART_InitStruct); // 使能中断 HAL_NVIC_SetPriority(USART2_IRQn, 0, 1); HAL_NVIC_EnableIRQ(USART2_IRQn); }2.2 定时器配置关键点Modbus RTU模式要求严格的3.5字符间隔定时我们使用TIM4实现void mb_port_timerInit(uint32_t baud) { TIM_HandleTypeDef htim4; uint32_t timer_period; // 计算3.5字符时间对应的定时器周期 if(baud 19200) { timer_period 1750; // 固定1750us } else { timer_period 35000000 / baud; // 3.5 * 10^6 / baud (us) } // TIM4初始化 htim4.Instance TIM4; htim4.Init.Prescaler 72 - 1; // 1MHz计数频率 htim4.Init.CounterMode TIM_COUNTERMODE_UP; htim4.Init.Period timer_period; HAL_TIM_Base_Init(htim4); // 中断配置 HAL_NVIC_SetPriority(TIM4_IRQn, 0, 2); HAL_NVIC_EnableIRQ(TIM4_IRQn); }2.3 中断服务函数实现正确处理串口和定时器中断是稳定通信的关键// USART2全局中断服务函数 void USART2_IRQHandler(void) { if(__HAL_USART_GET_FLAG(husart2, USART_FLAG_RXNE)) { uint8_t ch (uint8_t)(USART2-DR 0x00FF); mbh_uartRxIsr(ch); // 主机库接收处理 } if(__HAL_USART_GET_FLAG(husart2, USART_FLAG_TC)) { mbh_uartTxIsr(); // 主机库发送完成处理 } } // TIM4全局中断服务函数 void TIM4_IRQHandler(void) { if(__HAL_TIM_GET_FLAG(htim4, TIM_FLAG_UPDATE)) { __HAL_TIM_CLEAR_FLAG(htim4, TIM_FLAG_UPDATE); mbh_timer3T5Isr(); // 3.5T超时处理 } }3. 主从机协同工作实现3.1 资源冲突解决方案当同一块精英板同时运行主从机代码时需注意以下资源分配资源类型主机使用从机使用冲突解决方案定时器TIM4(3.5T定时)TIM3(FreeModbus)无冲突USARTUSART2USART1使用不同串口GPIOPD7(方向控制)PG8(方向控制)物理分开存储区0x2000C000起0x20008000起修改链接脚本分散加载3.2 双机通信测试方案建议按照以下步骤验证通信可靠性基础功能测试主机读取从机保持寄存器主机写入从机线圈状态主机读取从机输入寄存器压力测试// 主机端压力测试代码示例 void modbus_stress_test(void) { static uint32_t last_time 0; static uint8_t test_phase 0; if(HAL_GetTick() - last_time 1000) { // 每秒切换测试模式 last_time HAL_GetTick(); test_phase (test_phase 1) % 3; switch(test_phase) { case 0: // 读取测试 mbh_send(SLAVE_ADDR, READ_HLD_REG, 0, NULL, 10); break; case 1: // 写入测试 holding_reg[0] rand() % 65535; mbh_send(SLAVE_ADDR, WRITE_HLD_REG, 0, holding_reg, 1); break; case 2: // 混合测试 if(rand() % 2) { mbh_send(SLAVE_ADDR, READ_AI, 0, NULL, 5); } else { coils_reg[0] ^ 0xFF; mbh_send(SLAVE_ADDR, WRITE_COIL, 0, (uint16_t*)coils_reg, 8); } break; } } }异常情况处理从机无响应时主机重试机制CRC校验错误处理超时机制验证4. 工程优化与性能提升4.1 通信效率优化技巧通过以下方法可以显著提升Modbus通信效率批量读写优化单次请求最多读取125个寄存器或2000个线圈使用功能码15和16进行批量写入定时器精度调整// 提高定时器分辨率 void optimize_timer(void) { TIM4-PSC 36 - 1; // 2MHz计数频率 TIM4-ARR timeout_us * 2; // 调整超时值 }中断优先级配置// 推荐中断优先级设置 HAL_NVIC_SetPriority(USART2_IRQn, 0, 0); // 最高优先级 HAL_NVIC_SetPriority(TIM4_IRQn, 1, 1); // 次高优先级4.2 内存优化策略针对STM32F103有限的RAM资源可采取以下优化缓冲区精简// 修改mb_config.h中的配置 #define MBH_RTU_MAX_SIZE 256 // 原值512 #define MBH_QUEUE_SIZE 4 // 命令队列大小寄存器映射优化// 使用位带操作替代数组存储 #define COIL_BITBAND_ADDR(n) (0x22000000 ((uint32_t)coil_storage - 0x20000000)*32 (n)*4) #define SET_COIL(n, val) (*(volatile uint32_t*)COIL_BITBAND_ADDR(n) val)代码空间优化使用-O2优化等级启用链接时优化(LTO)移除不必要的库函数4.3 诊断与调试技巧当通信出现问题时可按以下步骤排查物理层检查测量RS485总线A/B线电压差应大于200mV检查终端电阻阻值120Ω确认方向控制信号时序协议层分析使用逻辑分析仪捕获原始数据帧检查Modbus报文格式[地址][功能码][数据][CRC16]验证CRC校验计算结果软件调试手段// 添加调试输出 void debug_print_frame(uint8_t *data, uint8_t len) { printf(Frame: ); for(int i0; ilen; i) { printf(%02X , data[i]); } printf(\r\n); }在实际项目中我曾遇到因定时器周期计算错误导致的通信不稳定问题。通过调整定时器预分频值将3.5T时间精度提高到1us级别后通信成功率从85%提升到99.9%以上。这提醒我们在Modbus RTU模式下时间相关的参数必须精确计算和配置。