STM32与FreeRTOS实现Modbus RTU从站开发

1. 项目概述与背景

作为一名在工业自动化领域摸爬滚打多年的工程师，我经常需要设计各种Modbus从站设备。今天要分享的是一个典型的开关量传感器从设备实现方案，基于STM32和FreeRTOS，使用libmodbus库完成开发。这个项目虽然看起来简单，但包含了工业现场设备开发的诸多核心要素。

这个设备的主要功能包括：

• 3个按键输入（作为Modbus离散输入DI）
• 2个继电器输出（控制外部设备）
• 3个LED状态指示
  通过RS485接口以Modbus RTU协议与主站通信，波特率115200bps，8数据位，无校验，1停止位。

在实际工业应用中，这类设备常用于：

• 现场按钮状态监测
• 设备启停控制
• 状态指示灯控制
• 简单的I/O扩展

2. 硬件设计与接口定义

2.1 硬件选型与连接

我们使用的是STM32F103C8T6最小系统板，搭配MAX485芯片实现RS485通信。具体硬件连接如下表所示：

注意：继电器建议使用光耦隔离驱动电路，避免干扰MCU工作。RS485接口必须加120Ω终端电阻，特别是在长距离通信时。

2.2 电平逻辑转换处理

硬件设计中一个容易忽略但至关重要的细节是电平逻辑的统一。在我们的系统中存在两种不同的电平逻辑：

1. 按键输入：低电平有效（按下时为低）
2. 继电器控制：高电平有效
3. LED控制：低电平有效

这种不一致性必须在软件中正确处理。在Modbus协议中，我们约定：

• 所有离散输入（DI）和线圈（DO）都采用"1表示激活状态"
• 在硬件接口层进行电平转换

3. Modbus协议实现

3.1 寄存器地址规划

根据Modbus RTU协议规范，我们为设备分配了如下地址空间：

注意：Modbus地址是从0开始编号的，而许多PLC软件（如西门子）的地址是从1开始的，且使用不同的前缀表示寄存器类型。在实际应用中需要特别注意这种映射关系。

3.2 libmodbus库配置

我们使用开源的libmodbus库实现Modbus RTU从站功能。关键配置参数如下：

c复制#define SLAVE_ADDR 1       // 设备地址
#define BAUDRATE 115200    // 波特率
#define PARITY 'N'         // 无校验
#define DATA_BIT 8         // 数据位
#define STOP_BIT 1         // 停止位

#define NB_BITS 5          // 线圈数量(继电器2 + LED3)
#define NB_INPUT_BITS 3    // 离散输入数量(按键3)
#define NB_REGISTERS 0     // 保持寄存器数量(未使用)
#define NB_INPUT_REGISTERS 0 // 输入寄存器数量(未使用)

初始化Modbus上下文的代码如下：

c复制modbus_t *ctx = modbus_new_rtu("/dev/ttyS1", BAUDRATE, PARITY, DATA_BIT, STOP_BIT);
if (ctx == NULL) {
    printf("Failed to create Modbus context\n");
    return -1;
}

modbus_set_slave(ctx, SLAVE_ADDR);  // 设置从站地址
modbus_set_response_timeout(ctx, 1, 0); // 设置超时1秒

4. 软件架构与实现

4.1 FreeRTOS任务设计

我们使用FreeRTOS实时操作系统来管理任务，确保Modbus通信的实时性。系统只创建一个主任务，堆栈大小设置为512字节（128*4），优先级为普通优先级。

任务创建代码：

c复制void MX_FREERTOS_Init(void) {
    osThreadAttr_t defaultTask_attributes = {
        .name = "ModbusSlaveTask",
        .stack_size = 128 * 4,
        .priority = (osPriority_t) osPriorityNormal,
    };
    
    osThreadNew(ModbusSlaveTask, NULL, &defaultTask_attributes);
}

4.2 Modbus数据处理流程

主任务的核心是一个无限循环，处理流程如下：

1. 接收Modbus请求
2. 更新输入状态（读取按键）
3. 处理请求并回复响应
4. 更新输出状态（控制继电器和LED）

c复制void ModbusSlaveTask(void *argument) {
    modbus_t *ctx;
    modbus_mapping_t *mb_mapping;
    uint8_t *query;
    int rc;
    
    // 初始化Modbus上下文
    ctx = modbus_new_rtu("uart1", 115200, 'N', 8, 1);
    modbus_set_slave(ctx, SLAVE_ADDR);
    
    // 创建数据映射
    mb_mapping = modbus_mapping_new_start_address(
        0, NB_BITS,        // 线圈起始地址0，数量5
        0, NB_INPUT_BITS,  // 离散输入起始地址0，数量3
        0, NB_REGISTERS,   // 保持寄存器(未使用)
        0, NB_INPUT_REGISTERS); // 输入寄存器(未使用)
    
    // 主循环
    for (;;) {
        // 接收请求
        rc = modbus_receive(ctx, query);
        
        // 更新输入状态
        UpdateInputs(mb_mapping);
        
        // 处理请求
        if (rc > 0) {
            modbus_reply(ctx, query, rc, mb_mapping);
        }
        
        // 更新输出状态
        UpdateOutputs(mb_mapping);
    }
}

4.3 输入输出处理细节

4.3.1 输入状态更新

按键状态的读取需要考虑消抖处理。我们在代码中实现简单的软件消抖：

c复制void UpdateInputs(modbus_mapping_t *mb_mapping) {
    static uint32_t last_read_time = 0;
    static uint8_t key1_state = 0, key2_state = 0, key3_state = 0;
    
    // 每50ms读取一次按键状态
    if (HAL_GetTick() - last_read_time < 50) {
        return;
    }
    last_read_time = HAL_GetTick();
    
    // 读取按键状态（低电平有效）
    GPIO_PinState val1 = HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_3);
    GPIO_PinState val2 = HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_4);
    GPIO_PinState val3 = HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_5);
    
    // 消抖处理
    key1_state = (val1 == GPIO_PIN_RESET) ? 1 : 0;
    key2_state = (val2 == GPIO_PIN_RESET) ? 1 : 0;
    key3_state = (val3 == GPIO_PIN_RESET) ? 1 : 0;
    
    // 更新Modbus映射
    mb_mapping->tab_input_bits[0] = key1_state;
    mb_mapping->tab_input_bits[1] = key2_state;
    mb_mapping->tab_input_bits[2] = key3_state;
}

4.3.2 输出状态更新

输出控制需要考虑继电器和LED的不同电平逻辑：

c复制void UpdateOutputs(modbus_mapping_t *mb_mapping) {
    // 继电器1控制 (PB5, 高电平有效)
    HAL_GPIO_WritePin(GPIOB, GPIO_PIN_5, 
        mb_mapping->tab_bits[0] ? GPIO_PIN_SET : GPIO_PIN_RESET);
    
    // 继电器2控制 (PB4, 高电平有效)
    HAL_GPIO_WritePin(GPIOB, GPIO_PIN_4, 
        mb_mapping->tab_bits[1] ? GPIO_PIN_SET : GPIO_PIN_RESET);
    
    // LED1控制 (PB11, 低电平有效)
    HAL_GPIO_WritePin(GPIOB, GPIO_PIN_11, 
        mb_mapping->tab_bits[2] ? GPIO_PIN_RESET : GPIO_PIN_SET);
    
    // LED2控制 (PB12, 低电平有效)
    HAL_GPIO_WritePin(GPIOB, GPIO_PIN_12, 
        mb_mapping->tab_bits[3] ? GPIO_PIN_RESET : GPIO_PIN_SET);
    
    // LED3控制 (PB13, 低电平有效)
    HAL_GPIO_WritePin(GPIOB, GPIO_PIN_13, 
        mb_mapping->tab_bits[4] ? GPIO_PIN_RESET : GPIO_PIN_SET);
}

5. 调试与问题排查

5.1 常见调试工具

1. Modbus Poll：功能强大的Modbus主站测试工具，可以发送各种功能码并显示响应
2. 串口调试助手：监控原始RS485数据
3. 逻辑分析仪：分析GPIO信号时序
4. 万用表：测量实际电压电平

5.2 典型问题与解决方案

5.2.1 通信失败问题

现象：主站无法与从站通信，无任何响应

排查步骤：

1. 检查RS485接线是否正确（A对A，B对B）
2. 确认波特率、数据位、停止位、校验位设置一致
3. 测量MAX485芯片的供电电压（5V）
4. 检查DE/RE控制信号是否正确
5. 确认终端电阻是否接好（120Ω）

5.2.2 数据错误问题

现象：通信正常但数据不正确

排查步骤：

1. 检查Modbus地址映射是否正确
2. 验证电平逻辑转换是否正确
3. 检查GPIO初始化配置（输入/输出模式，上拉/下拉）
4. 使用逻辑分析仪确认GPIO信号

5.2.3 继电器误动作问题

现象：继电器在没有控制命令时自行动作

解决方案：

1. 在继电器控制线上增加下拉电阻（10K）
2. 初始化时明确设置继电器为关闭状态
3. 检查电源稳定性，避免电压波动导致误动作

6. 性能优化与扩展

6.1 响应时间优化

默认情况下，libmodbus的响应超时设置为1秒。对于实时性要求高的应用，可以适当缩短：

c复制modbus_set_response_timeout(ctx, 0, 100000); // 设置100ms超时

6.2 增加保持寄存器功能

如果需要存储设备参数（如设备地址、波特率等），可以扩展保持寄存器功能：

1. 修改宏定义：

c复制#define NB_REGISTERS 10 // 保持寄存器数量

2. 初始化时设置默认值：

c复制mb_mapping->tab_registers[0] = 1;    // 设备地址
mb_mapping->tab_registers[1] = 115200; // 波特率
// ...其他寄存器初始化

3. 通过功能码06（写单个寄存器）和03（读保持寄存器）访问

6.3 支持广播地址

Modbus广播地址为0，从站不应回复广播请求，但需要执行写操作：

c复制// 在modbus_receive后检查地址
if (query[0] == 0) { // 广播地址
    // 处理请求但不回复
    modbus_reply(ctx, query, rc, mb_mapping);
    continue;
}

7. 实际应用建议

1. EMC设计：工业现场干扰大，建议：

   • 使用屏蔽双绞线连接RS485
   • 在RS485接口增加TVS二极管保护
   • 继电器线圈增加续流二极管

2. 电源设计：

   • 使用隔离DC-DC模块
   • 增加足够的滤波电容
   • 继电器电源与MCU电源分开

3. 软件健壮性：

   • 增加看门狗定时器
   • 实现通信超时复位功能
   • 关键参数存储在备份寄存器中

4. 维护接口：

   • 保留SWD调试接口
   • 增加状态指示灯
   • 预留固件升级接口（如USB DFU）

8. 项目总结与心得

这个项目虽然功能简单，但涵盖了工业设备开发的多个重要方面。在实际开发过程中，我总结了以下几点经验：

1. 电平逻辑一致性：在设计初期就要明确所有I/O的电平逻辑，并在文档中清晰标注。不一致的电平逻辑是后期调试的主要痛点之一。

2. Modbus地址规划：合理的地址规划能大大简化后期维护工作。建议制作详细的地址映射表，并保持与PLC程序一致。

3. 实时性考虑：FreeRTOS任务优先级设置要合理，确保Modbus通信的实时性。同时要避免在任务中执行耗时操作。

4. 错误处理：工业现场环境复杂，必须考虑各种异常情况。比如通信中断后的自动恢复、错误数据的过滤等。

5. 测试覆盖：不仅要测试正常功能，还要模拟各种异常情况（如通信干扰、电源波动等）下的设备行为。

这个设计方案已经成功应用于多个工业现场，运行稳定可靠。读者可以根据实际需求进行裁剪和扩展，比如增加模拟量输入输出、支持更多通信协议等。