1.一套可落地的 STM32 六层架构 —— 开篇

概述

上一篇《MCU 项目软件分层设计规范——以 MCU 项目为例》介绍了 MCU 软件分层的设计原则、各层职责以及模块依赖关系。

有了分层规范，接下来更重要的问题是：如何把这些原则真正落到一个可运行、可持续迭代的 STM32 工程中？

接下来我准备了一系列文章，介绍软件分层工程目录怎样创建，还将以 GPIO、UART、ADC、TIM、I2C、SPI 等常用外设为例，演示外设驱动如何在 BSP、Driver、Device、Service、Application 等层中完成封装与调用。

文章不会把外设拆成彼此独立的示例，而是让每个模块都在同一个工程中逐步演进。每完成一篇文章，工程都会增加一个可编译、可下载、可验证的功能模块。

最终，这些模块将组成一个具备设备监测、阈值告警、参数保存、历史记录和通信控制能力的小型 STM32 RT-Thread 工程项目。

通过本系列文章，你将学会：

• 如何搭建一个基于 STM32 和 RT-Thread 的软件分层工程框架；
• 如何建立 BSP、Driver、Device、Service、Application 等分层目录；
• 如何明确各层模块的职责、接口与依赖关系；
• 如何将 GPIO、UART、ADC、PWM、I2C、SPI、UDP 等外设纳入统一工程；
• 如何完成 UART DMA 不定长接收、命令解析和日志输出；
• 如何实现 ADC 数据采集、电压换算、滤波和阈值告警；
• 如何使用 PWM 实现蜂鸣器告警和 LED 呼吸效果；
• 如何通过 EEPROM 实现参数掉电保存与上电恢复；
• 如何使用 SPI Flash 保存历史告警和运行日志；
• 如何通过 UDP 实现设备状态上报和远程控制；
• 如何让多个外设模块在同一个 STM32 工程中协同工作。

最终得到的不是一组零散的外设例程，而是一个可以运行、便于理解、能够继续扩展的 STM32 分层工程。

一、开发环境

不同开发板的引脚、外设实例和 BSP 配置可能有所差异，但工程组织方式、模块边界和实现思路可以复用。

二、最终工程目标

最终工程将包含以下模块，每层职责明确：

 GPIO  
 ├── LED 状态指示  
 └── 按键输入与模式控制  
 ​  
 Timer  
 ├── 软件定时器  
 └── 周期任务处理  
 ​  
 UART  
 ├── 日志输出  
 ├── FinSH / MSH 调试终端  
 ├── DMA 不定长接收  
 └── 串口命令处理  
 ​  
 ADC  
 ├── 模拟量采集  
 ├── 电压换算  
 ├── 数据滤波  
 └── 阈值告警  
 ​  
 PWM  
 ├── 蜂鸣器控制  
 ├── LED 呼吸效果  
 └── 声光告警策略  
 ​  
 I2C  
 └── AT24Cxx EEPROM 参数保存与上电恢复  
 ​  
 SPI  
 └── W25Q128 Flash 历史告警与运行记录存储  
 ​  
 UDP  
 ├── 设备状态上报  
 └── 外部控制命令接收

最终将形成如下业务闭环：

 ADC 检测到低电压  
     ↓  
 换算、滤波、阈值判断  
     ↓  
 生成低压告警  
     ├── LED 切换故障状态  
     ├── PWM 驱动蜂鸣器提示  
     ├── UART 输出告警日志  
     ├── UDP 上报告警信息  
     └── W25Q128 保存历史记录

系统阈值、工作模式等配置也支持掉电保存：

 按键 / UDP 修改参数  
     ↓  
 更新系统配置  
     ↓  
 AT24Cxx EEPROM 保存  
     ↓  
 下次上电自动恢复

三、文章路线

四、下一篇预告

下一篇将从 v0.1 开始，搭建基于 STM32F429 和 RT-Thread 的分层基础工程框架，完成：

• STM32F429 BSP 正常启动
• RT-Thread 基础运行环境配置
• FinSH / MSH 串口终端可用
• 建立 app、service、device、bsp、platform、component 分层目录
• 配置公共头文件、项目配置与版本信息
• 设计工程统一初始化入口
• 输出工程启动日志
• 为后续外设模块预留目录和接口位置

从 v0.1 开始，后续每增加一个模块，都会在同一个 STM32 工程中持续演进。

关注我，一起从零构建一个可运行、可维护、可持续迭代的 STM32 分层工程。