STM32与威纶通屏Modbus RTU通讯实战：从协议解析到工业HMI应用

1. 项目缘起：当嵌入式大脑遇上工业触手

最近在做一个工业现场的小型控制项目，核心是一块STM32F103做主控，需要实时显示十几个传感器的数据，并且能通过屏幕下发几个简单的控制指令。选型的时候，我直接跳过了传统的按键+数码管方案，也没用那种小尺寸的TFT屏自己折腾GUI，而是选择了一款威纶通（Weinview）的MT8071iE工业触控屏。原因很简单：在粉尘、震动、电磁干扰常见的车间环境里，工业屏的可靠性、防护等级和成熟的组态软件，能省去后期无数的维护麻烦。这个决定很正确，但随之而来的核心问题就是：如何让STM32这块“嵌入式大脑”和威纶通这块“工业触手”顺畅地对话？

这其实就是典型的嵌入式HMI（人机界面）应用场景。STM32负责底层逻辑控制、数据采集和运算，而威纶通屏则负责友好的人机交互和数据可视化。两者之间的桥梁，就是通讯协议。翻看威纶通的手册和STM32的例程，你会发现选项不少：Modbus RTU over RS485、Modbus TCP over Ethernet、甚至自由口协议。对于大多数中小型、对实时性要求不是极端苛刻的项目，RS485总线+Modbus RTU协议的组合几乎是性价比和可靠性的黄金标准。它硬件简单，两根线就能组网，传输距离远（理论上可达1200米），抗干扰能力强，正好契合工业现场的需求。我这次的项目也不例外，选择了这条最经典、最稳妥的路径。

接下来的内容，我会完整复盘从硬件接线、协议理解、STM32程序实现到威纶通画面组态的全过程。这不是一个简单的“点灯”教程，而是会深入到帧结构解析、数据地址映射、异常处理以及那些手册里不会写的调试坑点。无论你是刚开始接触工控的嵌入式开发者，还是想为STM32项目添加一个专业级交互界面的爱好者，相信这些从实际项目中踩出来的经验，都能让你少走弯路。

2. 通讯基石：深入理解Modbus RTU协议栈

在动手接线和写代码之前，我们必须对Modbus RTU协议有一个清晰的认识。很多人觉得它就是一串十六进制数，照着格式发就行，但真正理解其设计哲学，才能在调试时快速定位问题。

Modbus本质上是一种主从（Master-Slave）架构的问答协议。在我们的系统里，威纶通触摸屏通常作为主站（Master），STM32作为从站（Slave）。屏负责发起所有的数据请求，STM32则被动响应。这很重要，它决定了程序的流程：STM32的串口中断服务程序中，核心任务是解析主站发来的命令帧，并组织相应的应答帧发回去，而不是主动上报数据（除非用特殊功能码或自定义协议变体）。

一个完整的Modbus RTU帧由以下几部分组成：

1. 从站地址（1字节）：用于标识网络上的哪个设备应答。地址范围1-247，0是广播地址（从站不应答）。你的STM32设备需要设置一个唯一的地址。
2. 功能码（1字节）：告诉从站要做什么。最常用的几个：
   • 0x03：读保持寄存器（Holding Register）。这是最核心的功能，威纶通屏读取STM32的数据（如传感器值、状态）主要用它。
   • 0x06：写单个寄存器。屏向STM32写入一个控制命令或设定值。
   • 0x10：写多个寄存器。批量写入数据时效率更高。
3. 数据区（N字节）：根据功能码不同，内容不同。对于读请求（0x03），这里包含起始寄存器地址和要读的寄存器数量；对于写响应，这里包含被写入的寄存器地址和值。
4. CRC校验（2字节）：循环冗余校验，用于检查帧在传输过程中是否出错。这是Modbus RTU可靠性的关键，必须由软件计算，硬件CRC通常不适用。

寄存器地址映射是关键中的关键，也是最容易混乱的地方。Modbus协议中的“寄存器”是一个16位（2字节）的数据单元。威纶通软件（如EasyBuilder Pro）里配置的“设备地址”，需要和你STM32程序中定义的寄存器地址空间一一对应。

这里有一个巨大的坑点：协议地址 vs. 数据模型地址。Modbus协议帧里携带的地址是“基于0”的地址。例如，你想访问你STM32程序中定义的第一个保持寄存器（我们假设你把它命名为holdingReg[0]），在发送的Modbus帧中，这个寄存器的地址是0x0000。但是，在很多主站软件（包括威纶通的部分老版本或某些驱动）以及文档描述中，习惯使用“基于1”的地址，即他们所说的“40001”地址对应协议地址0x0000。威纶通的新版驱动通常可以直接配置偏移量，你需要非常清楚你使用的驱动约定是什么。在我的项目里，我统一在STM32端使用“基于0”的地址逻辑，在威纶通软件中，则选择对应的驱动并设置正确的偏移量（通常是0）。

注意：务必仔细核对威纶通设备属性页中的“站号”（从机地址）、“地址类型”（如4x代表保持寄存器）以及“实际地址”的偏移设置。一个数字对不上，通讯就会失败。

3. 硬件连接与STM32底层驱动配置

硬件连接是通讯物理层的基础，务必扎实。

3.1 RS485电路连接

STM32芯片本身只有UART（通用异步收发器），是TTL电平。要连接RS485网络，需要一个电平转换芯片，最常用的是SP3485或MAX3485。接线要点如下：

• STM32_UART_TX->SP3485_DI(数据输入)
• STM32_UART_RX->SP3485_RO(数据输出)
• STM32_GPIO->SP3485_DE和RE(通常这两个引脚短接，用同一个GPIO控制收发方向)
• SP3485_A和B线 -> 连接到威纶通屏的RS485端口（A对A，B对B）。
• 在RS485总线两端（通常是威纶通屏端和最后一个STM32设备端），需要各接一个120欧姆的终端电阻，以消除信号反射，保证长距离传输的波形质量。如果设备数量少、距离近，有时可以不接，但规范做法是接上。

控制收发方向的GPIO配置至关重要。RS485是半双工，同一时刻只能有一个设备发送。STM32默认应处于接收状态。只有在UART发送数据前，才将GPIO拉高，使能发送器；发送完成后，立即拉低，切换回接收状态。这个切换时机要精准，特别是在发送完最后一字节数据后，需要等待该字节完全从硬件移位寄存器发出（可通过查询TC传输完成标志或使用DMA+TC中断），再延时一小段时间（如几十微秒）后才能切换方向。切换太快，最后一个字节可能发送不完整；切换太慢，会影响对方回应的接收。

3.2 STM32 UART与DMA配置

为了提高效率并减少CPU中断负担，我强烈推荐使用DMA（直接存储器访问）来收发UART数据。

• 接收（RX）：配置UART为IDLE（空闲）中断 + DMA循环接收模式。将DMA指向一个较大的环形缓冲区（如256字节）。当总线空闲（超过一帧字符时间）时，会触发UART空闲中断。在中断服务程序里，我们可以根据DMA的当前指针位置，计算出本次接收到的数据长度，然后将这一帧数据交给协议解析函数处理。这种方式可以自动处理任意长度的帧，且不丢数据。
• 发送（TX）：配置为DMA单次发送模式。当需要发送应答帧时，将组织好的数据放入发送缓冲区，启动DMA传输。在DMA传输完成中断中，去切换RS485方向控制引脚为接收状态。

以下是基于STM32 HAL库的核心配置代码逻辑摘要：

// 1. UART 初始化 huart1.Instance = USART1; huart1.Init.BaudRate = 9600; // 与威纶通屏设置一致 huart1.Init.WordLength = UART_WORDLENGTH_8B; huart1.Init.StopBits = UART_STOPBITS_1; huart1.Init.Parity = UART_PARITY_NONE; // Modbus RTU 通常无校验 huart1.Init.Mode = UART_MODE_TX_RX; huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE; HAL_UART_Init(&huart1); // 2. 使能UART空闲中断 __HAL_UART_ENABLE_IT(&huart1, UART_IT_IDLE); // 3. DMA接收配置（循环模式） hdma_usart1_rx.Instance = DMA1_Channel5; hdma_usart1_rx.Init.Direction = DMA_PERIPH_TO_MEMORY; hdma_usart1_rx.Init.Mode = DMA_CIRCULAR; // 循环模式 hdma_usart1_rx.Init.PeriphInc = DMA_PINC_DISABLE; hdma_usart1_rx.Init.MemInc = DMA_MINC_ENABLE; hdma_usart1_rx.Init.PeriphDataAlignment = DMA_PDATAALIGN_BYTE; hdma_usart1_rx.Init.MemDataAlignment = DMA_MDATAALIGN_BYTE; HAL_DMA_Init(&hdma_usart1_rx); __HAL_LINKDMA(&huart1, hdmarx, hdma_usart1_rx); HAL_UART_Receive_DMA(&huart1, uart_rx_buf, RX_BUF_SIZE); // 4. 空闲中断处理函数（在stm32f1xx_it.c中） void USART1_IRQHandler(void) { if(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_IDLE) != RESET) { __HAL_UART_CLEAR_IDLEFLAG(&huart1); // 清除空闲中断标志 // 计算本次接收到的数据长度 uint16_t rx_len = RX_BUF_SIZE - __HAL_DMA_GET_COUNTER(&hdma_usart1_rx); if(rx_len > 0) { // 将 uart_rx_buf 中前 rx_len 个字节复制到解析缓冲区 // 调用协议解析函数 process_modbus_frame() } } HAL_UART_IRQHandler(&huart1); }

4. STM32从站协议解析与实现

有了稳定的数据流，接下来就是核心的协议解析。我们需要在STM32中实现一个Modbus从站。

4.1 数据结构定义

首先，在内存中开辟几块区域，模拟Modbus的设备数据模型。虽然我们只用了保持寄存器，但规范定义有助于理解。

#define HOLDING_REG_NUM 100 // 保持寄存器数量，根据需求定义 #define COIL_REG_NUM 16 // 线圈（开关量）数量 // Modbus 从站数据模型 typedef struct { uint8_t device_addr; // 本设备地址 uint16_t holdingReg[HOLDING_REG_NUM]; // 保持寄存器数组，存放温度、压力等数据 uint16_t inputReg[50]; // 输入寄存器（只读） uint8_t coils[COIL_REG_NUM]; // 线圈（可读可写，位） uint8_t discreteInputs[16]; // 离散输入（只读，位） } ModbusSlave_t; ModbusSlave_t mb_slave = { .device_addr = 0x01, // 假设设备地址为1 };

4.2 帧解析与分发

在空闲中断中获取到一帧数据后，process_modbus_frame函数需要做以下工作：

1. 长度校验：帧长度至少为4字节（地址+功能码+CRC低+CRC高），否则丢弃。
2. CRC校验：计算接收帧（除最后两个CRC字节外）的CRC，与帧中自带的CRC对比。不一致则丢弃，绝不响应。这是保证数据可靠性的第一道关卡。
3. 地址匹配：检查帧中地址是否与本设备地址或广播地址匹配。
4. 功能码分发：根据功能码，调用相应的处理函数。

void process_modbus_frame(uint8_t *frame, uint16_t len) { // 1. 基本长度检查 if(len < 4) return; // 2. CRC校验 uint16_t crc_received = (frame[len-1] << 8) | frame[len-2]; uint16_t crc_calculated = modbus_crc16(frame, len-2); if(crc_received != crc_calculated) return; // CRC错误，静默丢弃 // 3. 地址检查 (广播地址0x00通常不处理) uint8_t addr = frame[0]; if(addr != mb_slave.device_addr && addr != 0x00) return; // 4. 功能码分发 uint8_t func_code = frame[1]; switch(func_code) { case 0x03: // 读保持寄存器 handle_read_holding_registers(frame, len); break; case 0x06: // 写单个寄存器 handle_write_single_register(frame, len); break; case 0x10: // 写多个寄存器 handle_write_multiple_registers(frame, len); break; default: // 不支持的函数码，可构造异常响应 send_exception_response(addr, func_code, 0x01); // 非法功能码 break; } }

4.3 处理“读保持寄存器”（0x03）请求

这是威纶通屏读取数据的主要方式。请求帧格式：[地址][0x03][起始地址高][起始地址低][寄存器数量高][寄存器数量低][CRC低][CRC高]。

例如，请求读取设备1的保持寄存器，从地址0开始，读2个寄存器。帧为：01 03 00 00 00 02 CRC。

STM32的响应帧格式：[地址][0x03][字节数][数据1高][数据1低][数据2高][数据2低]...[CRC]。

void handle_read_holding_registers(uint8_t *req, uint16_t req_len) { // 解析请求帧中的起始地址和寄存器数量 uint16_t start_addr = (req[2] << 8) | req[3]; // 基于0的地址 uint16_t reg_count = (req[4] << 8) | req[5]; // 合法性检查：地址是否越界，数量是否超限（协议规定一次最多读125个寄存器） if((start_addr + reg_count) > HOLDING_REG_NUM || reg_count > 125) { send_exception_response(req[0], 0x03, 0x02); // 非法数据地址 return; } // 组织响应帧 uint8_t resp_frame[256]; uint8_t resp_len = 0; resp_frame[resp_len++] = req[0]; // 地址 resp_frame[resp_len++] = 0x03; // 功能码 resp_frame[resp_len++] = reg_count * 2; // 字节数 = 寄存器数 * 2 // 填充寄存器数据 for(int i = 0; i < reg_count; i++) { uint16_t reg_value = mb_slave.holdingReg[start_addr + i]; resp_frame[resp_len++] = (reg_value >> 8) & 0xFF; // 高字节在前 resp_frame[resp_len++] = reg_value & 0xFF; // 低字节在后 } // 计算CRC并添加到帧尾 uint16_t crc = modbus_crc16(resp_frame, resp_len); resp_frame[resp_len++] = crc & 0xFF; resp_frame[resp_len++] = (crc >> 8) & 0xFF; // 通过UART发送响应帧（注意先切换RS485方向为发送） rs485_set_tx(); HAL_UART_Transmit_DMA(&huart1, resp_frame, resp_len); // 发送完成后，在DMA发送完成中断中切换回接收方向 rs485_set_rx(); }

4.4 处理“写单个寄存器”（0x06）请求

这是屏控制STM32的常用方式，比如点击按钮发送一个启动命令。请求帧格式：[地址][0x06][寄存器地址高][寄存器地址低][寄存器值高][寄存器值低][CRC]。

STM32需要验证地址合法性，然后将值写入对应的holdingReg[]，最后原样返回整个请求帧作为应答。这是Modbus协议的规定，主站以此确认写入成功。

void handle_write_single_register(uint8_t *req, uint16_t req_len) { uint16_t reg_addr = (req[2] << 8) | req[3]; uint16_t reg_value = (req[4] << 8) | req[5]; if(reg_addr >= HOLDING_REG_NUM) { send_exception_response(req[0], 0x06, 0x02); return; } // 写入数据 mb_slave.holdingReg[reg_addr] = reg_value; // ！！！关键点：写寄存器后，可能需要触发实际动作。 // 例如，reg_addr=0 代表“电机启停命令”，这里需要调用电机控制函数。 if(reg_addr == 0) { control_motor(reg_value); } // 原样返回请求帧作为应答 rs485_set_tx(); HAL_UART_Transmit_DMA(&huart1, req, req_len); // req就是完整的请求帧 // 发送完成后切换方向 }

5. 威纶通EasyBuilder Pro组态配置详解

STM32端准备就绪后，需要在威纶通的上位机软件EasyBuilder Pro中进行配置，建立连接并设计画面。

5.1 设备连接配置

1. 新建工程，选择与你硬件型号完全一致的触摸屏型号（如MT8071iE）。
2. 进入“系统参数设置”。
3. 在“设备列表”中新增设备。
   • 设备类型：选择Modbus RTU。注意，威纶通可能有多个Modbus驱动，如“Modbus RTU (Legacy)”和“Modbus RTU”，通常选后者。
   • 接口类型：选择RS485 2W（两线制）。
   • COM端口：选择触摸屏背面标识的RS485端口号（如COM2）。
   • 站号：填写STM32程序中设置的device_addr（如1）。
   • 通讯参数：波特率、数据位、停止位、校验位必须与STM32的UART配置完全一致（例如：9600, 8, 1, None）。

5.2 变量与地址映射

这是连接逻辑与画面的桥梁。在“设备”下的“本机设备”中找到你刚添加的Modbus RTU设备，右键“新增设备”。

• 设备类型：保持为刚才的Modbus RTU设备。
• 设备属性：这里需要极其小心。
  • 站号：同上。
  • 地址类型：对于我们在STM32中定义的holdingReg[]数组，应选择4x Holding Register。
  • 实际地址：这是最容易出错的地方。假设STM32中holdingReg[0]的协议地址是0。在威纶通中，如果你想访问它，通常需要填写1。因为威纶通（以及很多主流HMI软件）的“4x”地址默认是“基于1”的，即40001对应协议地址0。所以“实际地址”填1，软件内部会将其处理为访问协议地址0。务必查阅当前版本EasyBuilder Pro的驱动手册或通过测试验证。一个安全的测试方法是：在STM32端将holdingReg[0]固定为一个特殊值（如0x55AA），在威纶通中分别用地址1和0建立两个数值显示元件，看哪个能读到正确值。

5.3 画面元件关联与调试

1. 放置元件：从元件库拖拽“数值显示”、“数值输入”、“位状态设定开关”、“仪表”等到画面。
2. 关联变量：双击元件，在“属性”->“地址”中，选择之前定义的设备，并填写偏移地址。例如，关联holdingReg[5]（协议地址5），如果威纶通“基于1”，则此处填6。
3. 下载与在线模拟：配置好画面后，可以先使用EasyBuilder Pro的“离线模拟”或“在线模拟”功能进行测试，无需连接实际硬件。在线模拟时，软件会模拟主站发送请求，但需要STM32实际响应，所以通常还是直接下载到屏里测试更真实。
4. 下载到触摸屏：通过网线或USB线将工程下载到威纶通触摸屏。

6. 联调实战：问题排查与性能优化

将程序烧录进STM32，工程下载到威纶通屏，连接好RS485线，上电。如果一切顺利，屏幕上应该能正确显示STM32发送的数据，并且操作开关能控制STM32。但现实往往是骨感的，下面是我遇到过的典型问题及排查手段。

6.1 通讯完全失败，无任何数据

• 检查硬件：万用表测量RS485的A、B线之间是否有电压差（静止时应有稳定电平，通讯时有跳变）。确认A-A、B-B连接正确。检查STM32的RS485收发控制引脚波形，发送时是否拉高。
• 检查波特率等参数：确保STM32和威纶通屏的波特率、数据位、停止位、校验位一个比特都不差。常用9600-8-N-1。
• 监听数据：使用USB转RS485适配器连接到总线，借助串口助手（如SecureCRT、Modbus Poll/Slave）监听数据流。这是最强大的调试手段。
  • 如果看不到威纶通屏发出的请求帧，检查屏的通讯参数和设备地址设置。
  • 如果能看到请求帧但无STM32应答，检查STM32程序：是否收到数据（RX灯或调试打印）？CRC计算是否正确？地址是否匹配？应答帧发送函数是否被调用？RS485方向切换时机是否正确？
  • 如果能看到STM32的应答帧，但屏上显示“通讯超时”或“无效数据”，检查威纶通的设备地址和变量地址映射，特别是地址偏移。

6.2 数据能读但显示不对，或写操作不生效

• 字节序问题：Modbus协议规定大端序（高字节在前）。STM32是ARM Cortex-M内核，内存存储是小端序。当你把一个uint16_t类型的变量（如0x1234）直接存入holdingReg[]时，在内存中是0x34 0x12。如果你直接按字节发送，就变成了0x34, 0x12，这与Modbus要求的大端序0x12, 0x34相反。因此，在组织响应帧时，必须手动进行字节交换，如前文代码所示(reg_value >> 8) & 0xFF先发高字节。同样，收到写命令时，也要将收到的高低字节组合成正确的uint16_t值。
• 地址映射错误：再次强调，反复确认威纶通中变量地址与STM32寄存器数组下标的对应关系。建立一个测试变量，在STM32中定期变化（如每秒加1），在威纶通上观察是否正确显示。
• 写操作后STM32无动作：检查handle_write_single_register函数中，在更新了holdingReg[]数组后，是否调用了相应的控制函数。写寄存器只是更新了内存，需要你手动关联到具体的IO操作或函数调用。

6.3 通讯不稳定，偶尔断线或数据错误

• 终端电阻：长距离或多设备时，务必在总线两端安装120Ω终端电阻。
• 总线拓扑与接地：尽量使用总线型拓扑，避免星型连接。确保所有设备的RS485地线（如果有）良好共地，但避免与强电地形成环流。可以使用屏蔽双绞线，屏蔽层单点接地。
• 软件超时与重发：威纶通屏作为主站，有默认的通讯超时时间和重试次数。如果STM32响应太慢，可能导致屏报错。可以在STM32端优化代码，确保在接收到有效帧后尽快响应（通常在几十毫秒内）。也可以适当增加屏的超时时间。
• 中断优先级与阻塞：确保UART空闲中断和DMA中断的优先级设置合理，避免被其他高优先级中断（如SysTick）长时间阻塞，导致数据接收不完整。避免在中断服务函数中进行复杂运算或调用可能阻塞的函数（如HAL_Delay）。

6.4 性能与资源优化

• 使用DMA和空闲中断：如前所述，这是稳定高效接收的不二法门。
• 合理规划寄存器地址：将需要频繁读取的数据（如实时温度、速度）放在连续的寄存器地址块，这样威纶通屏可以用一次0x03请求读取多个数据，减少通讯频率。
• 心跳或状态监测：可以在威纶通屏上做一个“通讯状态”指示灯，关联一个STM32的特定寄存器。STM32在主循环中定期更新该寄存器（如每秒取反），屏通过定时读取该寄存器来判断通讯是否正常。
• 批量操作：对于初始化时需要写入大量参数的情况，优先使用0x10（写多个寄存器）功能码，而不是多次调用0x06，可以极大提高效率。

整个调试过程，串口监听工具是你的眼睛。通过它，你能清晰地看到每一帧请求和应答的原始十六进制数据，结合Modbus协议手册，任何问题都无处遁形。从硬件链路到软件逻辑，从字节序到地址映射，一步步排查，最终让STM32与威纶通屏稳定、可靠地对话，看到屏幕上实时跳动起来自单片机世界的数据时，那种成就感，正是嵌入式开发的乐趣所在。