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再置低
STM32 Modbus实战：从零开始用HAL库实现RTU通信（附完整代码）
发布时间：2026/6/9 6:41:39
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再置低
