从传感器文档到实际代码：手把手解析Modbus RTU协议在STM32上的移植与应用-深圳市維司達科技有限公司

从传感器文档到实际代码：手把手解析Modbus RTU协议在STM32上的移植与应用

在工业自动化领域，Modbus RTU协议因其简单可靠的特点，成为连接PLC、传感器和控制器的事实标准协议。许多开发者虽然理解Modbus的基本原理，但当面对具体传感器厂商提供的技术文档时，却常常陷入"文档看得懂，代码不会写"的困境。本文将从一个真实的液压传感器案例出发，带你完整走通从文档解析到代码实现的闭环路径。

1. 理解传感器文档的关键要素

拿到一份传感器Modbus文档时，开发者往往会看到类似这样的指令示例：010300000001840A。这串16进制代码包含了Modbus通信的所有核心要素，我们需要像拆解密码一样逐层解析：

从机地址：第1字节（01）表示设备地址，需与硬件拨码开关设置一致
功能码：第2字节（03）代表读取保持寄存器操作
起始地址：第3-4字节（0000）指定要读取的寄存器起始地址
寄存器数量：第5-6字节（0001）表示要读取的寄存器个数
CRC校验：最后2字节（840A）是整个帧的校验码

注意：不同厂商的文档格式可能差异很大，但核心要素都遵循Modbus协议规范。重点查找"通信协议"或"寄存器映射表"章节。

以某液压传感器为例，其压力值存放在保持寄存器40001中（对应Modbus协议中的地址0000）。我们需要构造的查询帧就是上述示例中的010300000001840A。

2. 构建STM32的Modbus RTU通信框架

在STM32上实现Modbus RTU需要搭建三个核心模块：

2.1 硬件接口配置

// USART2初始化（RS485接口） void USART2_Init(void) { huart2.Instance = USART2; huart2.Init.BaudRate = 9600; huart2.Init.WordLength = UART_WORDLENGTH_8B; huart2.Init.StopBits = UART_STOPBITS_1; huart2.Init.Parity = UART_PARITY_NONE; huart2.Init.Mode = UART_MODE_TX_RX; huart2.Init.HwFlowCtl = UART_HWCONTROL_NONE; HAL_UART_Init(&huart2); // 配置DE/RE控制引脚（RS485方向控制） GPIO_InitStruct.Pin = GPIO_PIN_1; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); }

2.2 定时器实现RTU帧间隔

Modbus RTU要求帧间至少有3.5个字符的静默时间。对于9600波特率：

// 计算3.5字符时间（单位：ms） #define RTU_FRAME_GAP 4 // 9600bps时约为3.85ms // 定时器中断处理 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim->Instance == TIM3) { if(++rtu_gap_timer >= RTU_FRAME_GAP) { rtu_frame_ready = 1; // 标记帧接收完成 rtu_gap_timer = 0; } } }

2.3 核心数据结构设计

typedef struct { uint8_t addr; uint8_t func; uint16_t reg_addr; uint16_t reg_num; uint16_t crc; } ModbusRTU_Frame; typedef struct { uint8_t buf[MODBUS_BUF_SIZE]; uint16_t index; uint8_t complete; } ModbusRTU_RxBuffer;

3. 实现Modbus主站请求构造

根据传感器文档构造请求帧的关键步骤：

填充从机地址和功能码
转换寄存器地址为大端格式
计算CRC16校验码
通过RS485发送完整帧

void Modbus_ReadHoldingRegisters(uint8_t slave_addr, uint16_t start_reg, uint16_t reg_num) { uint8_t tx_buf[8]; // 构造请求帧 tx_buf[0] = slave_addr; // 从机地址 tx_buf[1] = 0x03; // 功能码 tx_buf[2] = start_reg >> 8; // 寄存器地址高字节 tx_buf[3] = start_reg & 0xFF; // 寄存器地址低字节 tx_buf[4] = reg_num >> 8; // 寄存器数量高字节 tx_buf[5] = reg_num & 0xFF; // 寄存器数量低字节 // 计算CRC uint16_t crc = Modbus_CRC16(tx_buf, 6); tx_buf[6] = crc & 0xFF; tx_buf[7] = crc >> 8; // RS485发送模式 HAL_GPIO_WritePin(RS485_DE_GPIO_Port, RS485_DE_Pin, GPIO_PIN_SET); HAL_UART_Transmit(&huart2, tx_buf, 8, 100); HAL_GPIO_WritePin(RS485_DE_GPIO_Port, RS485_DE_Pin, GPIO_PIN_RESET); }

4. 解析传感器响应数据

当收到传感器响应时，需要：

验证CRC校验
检查异常响应
提取有效数据

void Modbus_ProcessResponse(uint8_t *data, uint16_t len) { // 校验CRC uint16_t crc_received = (data[len-1] << 8) | data[len-2]; uint16_t crc_calculated = Modbus_CRC16(data, len-2); if(crc_received != crc_calculated) { // CRC校验失败处理 return; } // 检查异常响应 if(data[1] & 0x80) { uint8_t error_code = data[2]; // 错误处理逻辑 return; } // 解析正常响应 uint8_t byte_count = data[2]; float pressure; memcpy(&pressure, &data[3], sizeof(float)); // 数据转换（大端转小端） pressure = __REV(*(uint32_t*)&pressure); printf("当前压力值: %.2f MPa\n", pressure); }

5. CRC16校验的高效实现

Modbus使用的CRC-16算法可以通过查表法优化：

static const uint16_t crc16_table[256] = { 0x0000, 0xC0C1, 0xC181, 0x0140, 0xC301, 0x03C0, 0x0280, 0xC241, // ... 完整表格省略 }; uint16_t Modbus_CRC16(uint8_t *data, uint16_t len) { uint16_t crc = 0xFFFF; for(uint16_t i = 0; i < len; i++) { crc = (crc >> 8) ^ crc16_table[(crc ^ data[i]) & 0xFF]; } return crc; }

6. 构建可复用的Modbus处理框架

为了使代码能够适配不同传感器，建议采用分层设计：

硬件抽象层：处理USART和定时器配置
协议核心层：实现Modbus RTU帧处理
应用接口层：提供寄存器读写API
设备驱动层：封装具体传感器协议

// 应用接口示例 typedef struct { uint8_t addr; float (*read_pressure)(void); int (*set_sampling_rate)(uint8_t rate); } Modbus_Sensor; Modbus_Sensor pressure_sensor = { .addr = 0x01, .read_pressure = read_pressure_impl, .set_sampling_rate = set_sampling_rate_impl }; // 使用示例 float current_pressure = pressure_sensor.read_pressure();

在调试Modbus通信时，经常会遇到这些问题：