STM32 Modbus实战：从零开始用HAL库实现RTU通信（附完整代码）
1. 项目准备与环境搭建
拿到一块STM32开发板（比如常见的F103C8T6），首先要确认硬件连接。RS485模块通常需要连接以下引脚：
- USART_TX → 485模块的DI（数据输入）
- USART_RX → 485模块的RO（数据输出）
- 任意GPIO → 485模块的DE/RE（发送使能）
关键硬件配置示例：
// 485使能引脚定义（以PG8为例） #define RS485_DE_GPIO_Port GPIOG #define RS485_DE_Pin GPIO_PIN_8使用STM32CubeMX进行基础配置：
- 启用USART（通常选择USART2或USART3）
- 配置波特率（9600/19200/38400等）
- 设置8位数据位、无校验、1位停止位
- 启用USART全局中断
- 配置485控制引脚为GPIO输出
注意：波特率误差必须控制在2%以内，建议使用8MHz或72MHz主频配合常用波特率
2. Modbus协议栈移植
推荐两种实现方案：
方案A：移植FreeModbus
- 下载源码（GitHub搜索FreeModbus）
- 保留以下关键文件：
port/目录下的硬件相关代码modbus/目录下的协议栈核心
- 修改
portserial.c适配HAL库：
void vMBPortSerialEnable( BOOL xRxEnable, BOOL xTxEnable ) { if( xTxEnable ) { HAL_GPIO_WritePin(RS485_DE_GPIO_Port, RS485_DE_Pin, GPIO_PIN_SET); } else { HAL_GPIO_WritePin(RS485_DE_GPIO_Port, RS485_DE_Pin, GPIO_PIN_RESET); } }方案B：手写精简状态机
typedef enum { MB_IDLE, MB_RX_ADDR, MB_RX_FUNC, MB_RX_DATA, MB_PROCESS, MB_TX_RESPONSE } ModbusState; void ModbusRTU_Handler(UART_HandleTypeDef *huart) { static ModbusState state = MB_IDLE; static uint8_t buffer[256]; static uint16_t index = 0; switch(state) { case MB_IDLE: if(HAL_UART_Receive_IT(huart, &buffer[0], 1) == HAL_OK) { state = MB_RX_ADDR; } break; // ...其他状态处理 } }3. 关键问题解决方案
3.1 3.5字符时间判定
在9600波特率下，3.5字符时间≈3.5ms。实现方案：
// 在USART中断回调中添加定时器 void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { __HAL_TIM_SET_AUTORELOAD(&htim3, 35); // 3.5ms @10kHz HAL_TIM_Base_Start_IT(&htim3); } // 定时器溢出中断处理 void TIM3_IRQHandler(void) { if(__HAL_TIM_GET_FLAG(&htim3, TIM_FLAG_UPDATE)) { __HAL_TIM_CLEAR_IT(&htim3, TIM_IT_UPDATE); HAL_TIM_Base_Stop_IT(&htim3); ProcessCompleteFrame(); } }3.2 CRC16校验优化
查表法比直接计算快10倍以上：
const uint16_t crc16_table[256] = { 0x0000, 0xC0C1, 0xC181, 0x0140, 0xC301, 0x03C0, 0x0280, 0xC241, // ...完整256项表格 }; uint16_t Modbus_CRC16(uint8_t *pdata, uint16_t len) { uint16_t crc = 0xFFFF; while(len--) { crc = (crc >> 8) ^ crc16_table[(crc ^ *pdata++) & 0xFF]; } return crc; }4. 完整工程调试技巧
4.1 典型问题排查表
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 无响应 | 地址不匹配 | 检查从机地址设置 |
| CRC错误 | 波特率偏差 | 校准时钟源 |
| 数据错位 | 3.5字符时间不准 | 调整定时器参数 |
| 通信断续 | 终端电阻未接 | 在总线两端加120Ω电阻 |
4.2 Modbus Poll测试配置
连接设置：
- 选择正确的COM端口
- 设置与设备相同的波特率
- RTU模式
常用功能码测试示例：
[Read Holding Registers] Device Address: 1 Function Code: 03 Starting Address: 40001 Quantity: 10调试建议：先使用单个寄存器读写测试，再扩展至多寄存器
5. 性能优化与扩展
5.1 内存优化技巧
对于资源受限的STM32F103：
- 使用
__packed关键字减少内存占用 - 将Modbus映射到寄存器时使用共用体：
typedef union { struct { uint16_t coil0_15 :16; uint16_t coil16_31 :16; } bits; uint32_t value; } CoilRegister;5.2 多任务集成
在FreeRTOS中的典型应用：
void ModbusTask(void *argument) { eMBInit(MB_RTU, 1, 1, 38400, MB_PAR_NONE); eMBEnable(); for(;;) { eMBPoll(); osDelay(10); } }实际项目中遇到过最棘手的bug是当波特率提高到115200时，由于GPIO翻转速度不够导致485使能信号延迟。解决方案是：
- 改用更高性能的IO口（如配置为50MHz输出）
- 在发送前提前置高DE引脚
- 发送结束后延迟1-2us再置低
