精选已发布更新于 2026-09-23
MFM气体质量流量计
基于 STM32H743VIH6、LVGL 图形界面与 FreeRTOS 任务管理的气体质量流量计,支持多气体切换与混合气体测量,并可在负压工况下工作。
- C
- RTOS
- LVGL

HNR_PF200
基于 STM32H743VIHx 的气体流量测量与显示固件。工程集成绝压、差压与温度采集,气体物性与流量计算,240 x 320 LVGL 触摸界面,RS-485 Modbus RTU 从站、W25Q80 参数保存,以及串口 Bootloader 固件升级。
硬件平台
| 项目 | 配置 |
|---|---|
| MCU | STM32H743VIH6 / Cortex-M7 / TFBGA100 |
| 主频 | 480 MHz,HSE 25 MHz,PLL M=5、N=192、P=2、Q=5 |
| 总线 | AHB 240 MHz,APB1/APB2/APB4 120 MHz(各 2 分频) |
| RTOS | FreeRTOS(CMSIS-RTOS V2),Tick 1 kHz,heap 50 KB,优先级 0-55 |
| UI | LVGL 8.3.11,SquareLine Studio 工程 |
| 屏幕 | 240 x 320 TFT LCD,RGB565,SPI4 + DMA;双缓冲位于 D2 SRAM 0x30000000 |
| 触摸 | FT6336U 电容触摸,I2C2,TP_INT = PC13 EXTI |
| ADC | ADS131A0x,SPI1;ADC_DRDY = PB7 EXTI9_5 下降沿 |
| 差压/温度 | DP 压力温度模块,I2C3(Start_Average16 连续平均,约 22 Hz) |
| DAC | DAC8552 双通道 16 位,SPI3 |
| Flash | W25Q80(1 MiB),SPI6;地址 0 保存参数块 |
| RS-485 | UART7 RX DMA + IDLE 中断,PE9 ENA_485 方向控制 |
| 调试 | UART4 921600 8N1,RX DMA + IDLE 中断,发送为轮询 |
| 时基 | TIM12 = HAL 1 ms Tick,TIM6 = lv_tick_inc(1) |
| 模拟输出 | TIM4_CH2 PWM(周期 1000),GP210_Set_Current() 输出 0-25 mA |
| 固件布局 | 链接脚本 FLASH 从 0x08020000 起,长度 1920 KiB;main() 固定写入 SCB->VTOR = 0x08020000 |
软件结构
APP/
├── Core/
│ ├── APP_Task/ # 应用任务
│ │ ├── User/ # APP_Task.c:APP_Init()、MPU、异常 Hook
│ │ ├── RS485/ # Modbus RTU 从站任务
│ │ ├── Debug_Uart/ # UART4 调试指令任务
│ │ ├── Flow/ # ADC 采集处理与流量计算任务
│ │ ├── DP/ # 差压/温度采集任务
│ │ ├── lvgl/ # LVGL 任务与 UI 消息队列
│ │ ├── Parameter_Save/ # W25Q80 参数保存
│ │ └── Voltage_Motor/ # 板级电压监测任务
│ ├── BSP/ # 板级驱动:ADC、DAC、LCD、Flash、触摸、串口、DP 模块
│ ├── CmBacktrace/ # 异常回溯
│ ├── filter/ # 卡尔曼滤波、绝压标定
│ ├── portable_gas_property/ # 可移植气体属性计算库
│ ├── Inc/ # CubeMX 生成头文件与 FreeRTOSConfig
│ ├── Src/ # main.c、外设初始化、中断等
│ └── Startup/ # 启动汇编
├── Modbus/ # PF200 兼容 Modbus RTU 从站与 API 文档
├── ui/ # LVGL UI、页面、字体、图片资源
├── tools/ # 上位机脚本与测试资料
│ ├── Updata/ # 串口 Bootloader 升级工具(XMODEM-1K)
│ ├── Flow_aylse/ # 流量系数拟合脚本与示例数据
│ ├── compile_commands/ # clangd 数据库生成脚本
│ ├── 软件测试/ # 协议说明与测试报告
│ └── 屏幕测试图片/ # 屏幕测试用图片
├── lvgl/ # LVGL 源码与移植层(lv_port_disp/indev)
├── Drivers/ # STM32 HAL / CMSIS
├── Middlewares/ # FreeRTOS
└── Debug/ # STM32CubeIDE Debug 构建目录与产物
启动流程
main()
-> SCB->VTOR = 0x08020000
-> SCB_EnableICache() / SCB_EnableDCache()
-> HAL_Init() / SystemClock_Config()
-> GPIO / DMA / SPI1 / SPI3 / SPI4 / SPI6 / TIM7 / TIM6 / DMA2D
/ I2C3 / UART4 / UART7 / I2C2 / TIM3 / TIM4 初始化
-> APP_Init()
-> MPU_Config()
-> RS485_Task_Init() # UART_Int()、Modbus 从站初始化(地址 1)、RS485 任务
-> Debug_Task_Init() # UART4 调试任务
-> W25Q80_Init()
-> Parameter_Init() # 读回并应用参数
-> Flow_Task_Init() # ADS131 初始化、Process/Flow 任务
-> DP_Task_Init() # 由 Flow_Task_Init() 调用
-> Voltage_Motor_Task_Init()
-> lvgl_Task_Init() # TIM6 启动、lv_init、ui_init、应用参数、lvgl 任务
-> cm_backtrace_init()
-> CheckFPU() / PGA281_Init()
-> HAL_TIM_PWM_Start(&htim4, TIM_CHANNEL_2)
-> 打印剩余 heap
-> osKernelInitialize() -> 创建 defaultTask(空闲占位)-> osKernelStart()
主要任务
任务栈参数以字(word)为单位。
| 任务 | 优先级 | 栈大小 | 创建位置 | 功能 |
|---|---|---|---|---|
RS485_Task | 10 | 4 KiB | RS485_Task_Init() | 等待 UART7 接收信号量,把接收块交给 Modbus RTU 从站解析 |
lvgl_task | 9 | 8 KiB | lvgl_Task_Init() | 消费 UI 消息队列,每 5 ms 调用 lv_timer_handler(),是唯一操作控件的任务 |
DP_Task | 9 | 4 KiB | DP_Task_Init() | I2C3 读取差压与温度,卡尔曼滤波、调零、温度平均,投递队列与 UI |
Flow_Task | 8 | 2 KiB | Flow_Task_Init() | 消费 DP_Data_Queue,调用流量模型并刷新流量 label |
Process_Task | 7 | 8 KiB | Flow_Task_Init() | 等待 ADS131_Semaphore,SPI 读取 ADC,滤波、换算并刷新绝压 label |
Debug_Task | 6 | 2 KiB | Debug_Task_Init() | 解析 UART4 文本指令(保存参数、标定、复位) |
Voltage_Motor_Task | 6 | 2 KiB | Voltage_Motor_Task_Init() | 读取 Voltage_Motor_Raw_Queue 换算板级电压(当前无生产者) |
defaultTask | Low | 512 B | main() | 空闲占位,不做业务 |
任务间通信
| 对象 | 类型 | 生产者 | 消费者 |
|---|---|---|---|
ADS131_Semaphore | 二值信号量 | PB7 EXTI 回调 | Process_Task |
TP_Semaphore | 二值信号量 | PC13 EXTI 回调 | LVGL 触摸读回调 |
RS485_UART_Semaphore | 计数信号量(10) | UART7 IDLE 中断 | RS485_Task |
Debug_UART_Semaphore | 计数信号量(10) | UART4 IDLE 中断 | Debug_Task |
DP_Data_Queue | 队列(4 × DP_Data) | DP_Task | Flow_Task |
Voltage_Motor_Raw_Queue | 队列(3 × 3 × int32_t) | 无(发送代码被注释) | Voltage_Motor_Task |
g_lvgl_ui_queue | 队列(16 × label 消息) | 采集任务 | lvgl_task |
- UART4/UART7 通过
HAL_UART_Receive_DMA()+ IDLE 中断把数据切分为接收块,接收块由 10 槽环形控制块管理,中断中释放对应信号量。 RS485_Task、Debug_Task在消费接收块前调用SCB_InvalidateDCache_by_Addr(),避免读到 D-Cache 旧数据。- UI 更新统一走
lvgl_ui_post_label_text(),消息中的文本最多 15 个字符;其他任务不应直接操作 LVGL 控件。
采集与计算链路
ADS131A0x CH3 --SPI1--> 20 点平均 --> 右移 4 位 --> 绝压两级卡尔曼
--> 死区滤波 --> pressure = K*raw + B --> Absolute_Pressure_ex
DP 模块 --I2C3--> 差压卡尔曼 --> 调零(DP offset) --> DP_Data_Queue --> Flow_Task
---> 温度 15 点平均 --> temp_ex
Absolute_Pressure_ex + DP + temp --> flow_Bloenm() --> Gas_Calc(按气体编号) --> Flow_ex
测量全局量 --> LVGL 消息队列 + Modbus 寄存器
固件升级
tools/Updata/Updata.py 是上位机升级脚本:通过 UART4(默认 COM3 / 921600)向应用发送 BootUpdate,等待 Bootloader 的 XMODEM 接收请求(C)后以 XMODEM-1K 发送 Debug/*.bin,结束后可保持串口输出 MCU 日志。
python tools/Updata/Updata.py --list-ports
python tools/Updata/Updata.py -f Debug/H7_ALICAT.bin -p COM3 -b 921600 --monitor
python tools/Updata/Updata.py -f Debug/H7_ALICAT.bin -p COM3 -b 921600 --rescue --monitor
./flash.sh # 普通模式:-p COM3 -b 921600 --monitor
./flash.sh c # 救砖模式:额外带 --rescue
UI 页面
UI 入口为 ui_init(),页面声明在 ui/ui.h 中:
| 页面 | 文件 | 用途 |
|---|---|---|
| Screen1 | ui/screens/ui_Screen1.c | 主测量页:绝压、流量、温度、气体、单位等 |
| Screen2 | ui/screens/ui_Screen2.c | 设置入口 |
| Screen3 | ui/screens/ui_Screen3.c | 显示设置:单位、亮度、温度单位等 |
| Screen10 | ui/screens/ui_Screen10.c | 清零确认页(置 Zero_flag) |
| Screen11 | ui/screens/ui_Screen11.c | 标定导航页(仅页面跳转按钮) |
| Screen12 | ui/screens/ui_Screen12.c | 气体选择页(9 个气体卡片) |
| Screen15 | ui/screens/ui_Screen15.c | Modbus 地址和波特率设置页 |
| 显示名 | 编号 | 流量模型支持 |
|---|---|---|
| AIR | 0 | 支持 |
| Ar | 1 | 支持 |
| CO | 3 | 不支持 |
| CO2 | 4 | 支持 |
| O2 | 11 | 支持 |
| N2 | 26 | 支持 |
| C2H4 | 1 | 与 Ar 共用编号 |
| C2H2 | 14 | 不支持 |
| C2H6 | 5 | 不支持 |
相关文档
| 文档 | 说明 |
|---|---|
| Modbus/API文档.md | PF200 兼容 Modbus RTU API 与寄存器表 |
| tools/软件测试/485协议.md | RS-485 报文示例与解析 |
| tools/软件测试/DOC-MANUAL-MODBUS-中文版.md | Modbus 手册中文整理 |
| tools/软件测试/ADC测试报告.md | ADC 测试报告 |
| tools/软件测试/DAC测试报告.md | DAC 测试报告 |
| tools/软件测试/代码运行时间测试报告.md | 关键代码运行时间测试 |
| tools/软件测试/软件测试_LCD_UI.md | LCD UI 软件测试 |
| Core/portable_gas_property/README.md | 可移植气体属性库说明 |

