返回项目列表
精选已发布更新于 2026-09-23

MFM气体质量流量计

基于 STM32H743VIH6、LVGL 图形界面与 FreeRTOS 任务管理的气体质量流量计,支持多气体切换与混合气体测量,并可在负压工况下工作。

  • C
  • RTOS
  • LVGL
MFM气体质量流量计

HNR_PF200

基于 STM32H743VIHx 的气体流量测量与显示固件。工程集成绝压、差压与温度采集,气体物性与流量计算,240 x 320 LVGL 触摸界面,RS-485 Modbus RTU 从站、W25Q80 参数保存,以及串口 Bootloader 固件升级。

硬件平台

项目配置
MCUSTM32H743VIH6 / 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 分频)
RTOSFreeRTOS(CMSIS-RTOS V2),Tick 1 kHz,heap 50 KB,优先级 0-55
UILVGL 8.3.11,SquareLine Studio 工程
屏幕240 x 320 TFT LCD,RGB565,SPI4 + DMA;双缓冲位于 D2 SRAM 0x30000000
触摸FT6336U 电容触摸,I2C2,TP_INT = PC13 EXTI
ADCADS131A0x,SPI1;ADC_DRDY = PB7 EXTI9_5 下降沿
差压/温度DP 压力温度模块,I2C3(Start_Average16 连续平均,约 22 Hz)
DACDAC8552 双通道 16 位,SPI3
FlashW25Q80(1 MiB),SPI6;地址 0 保存参数块
RS-485UART7 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_Task104 KiBRS485_Task_Init()等待 UART7 接收信号量,把接收块交给 Modbus RTU 从站解析
lvgl_task98 KiBlvgl_Task_Init()消费 UI 消息队列,每 5 ms 调用 lv_timer_handler(),是唯一操作控件的任务
DP_Task94 KiBDP_Task_Init()I2C3 读取差压与温度,卡尔曼滤波、调零、温度平均,投递队列与 UI
Flow_Task82 KiBFlow_Task_Init()消费 DP_Data_Queue,调用流量模型并刷新流量 label
Process_Task78 KiBFlow_Task_Init()等待 ADS131_Semaphore,SPI 读取 ADC,滤波、换算并刷新绝压 label
Debug_Task62 KiBDebug_Task_Init()解析 UART4 文本指令(保存参数、标定、复位)
Voltage_Motor_Task62 KiBVoltage_Motor_Task_Init()读取 Voltage_Motor_Raw_Queue 换算板级电压(当前无生产者)
defaultTaskLow512 Bmain()空闲占位,不做业务

任务间通信

对象类型生产者消费者
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_TaskFlow_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 中:

页面文件用途
Screen1ui/screens/ui_Screen1.c主测量页:绝压、流量、温度、气体、单位等
Screen2ui/screens/ui_Screen2.c设置入口
Screen3ui/screens/ui_Screen3.c显示设置:单位、亮度、温度单位等
Screen10ui/screens/ui_Screen10.c清零确认页(置 Zero_flag)
Screen11ui/screens/ui_Screen11.c标定导航页(仅页面跳转按钮)
Screen12ui/screens/ui_Screen12.c气体选择页(9 个气体卡片)
Screen15ui/screens/ui_Screen15.cModbus 地址和波特率设置页
显示名编号流量模型支持
AIR0支持
Ar1支持
CO3不支持
CO24支持
O211支持
N226支持
C2H41与 Ar 共用编号
C2H214不支持
C2H65不支持

相关文档

文档说明
Modbus/API文档.mdPF200 兼容 Modbus RTU API 与寄存器表
tools/软件测试/485协议.mdRS-485 报文示例与解析
tools/软件测试/DOC-MANUAL-MODBUS-中文版.mdModbus 手册中文整理
tools/软件测试/ADC测试报告.mdADC 测试报告
tools/软件测试/DAC测试报告.mdDAC 测试报告
tools/软件测试/代码运行时间测试报告.md关键代码运行时间测试
tools/软件测试/软件测试_LCD_UI.mdLCD UI 软件测试
Core/portable_gas_property/README.md可移植气体属性库说明

其他项目