第一章 课程导论与开发环境搭建

各位同学，欢迎来到《STM32裸机外设驱动分层架构部署与调试实战》。我是你们这门课的主讲工程师。在正式开始之前，我想先聊聊这门课到底要解决什么问题。

做嵌入式开发这些年，我见过太多人把代码写成一锅粥。中断服务函数里塞几百行逻辑，外设初始化散落在各个文件里，换个芯片平台就得重写大半。说白了，这不是技术问题，是架构问题。这门课就是要带大家建立一套可复用、可移植的裸机驱动框架。

1.1 STM32裸机开发概述

裸机开发，就是没有操作系统。你直接操作寄存器，控制外设，调度任务。很多人觉得裸机简单，其实恰恰相反——没有操作系统帮你管理资源，所有事情都得你自己来。

我个人习惯把裸机项目分成三类：

• 小型项目：单文件或两三个文件，逻辑简单，比如按键控制LED
• 中型项目：模块化组织，每个外设一个文件，比如UART+SPI+定时器
• 大型项目：分层架构，驱动层、中间件层、应用层分离，比如多传感器融合项目

这门课讲的就是第三种。为什么？因为当你面对一个包含十几个外设、几十个功能模块的项目时，没有分层架构，后期维护就是噩梦。我在项目中遇到过，一个同事把GPIO配置、定时器中断、I2C读写全写在一个文件里，最后改一个引脚定义，整个项目编译报错三十多处。嗯，这种坑踩过一次就够了。

1.2 分层架构思想

分层架构不是什么新鲜概念。计算机网络的OSI七层模型，操作系统的内核态用户态，都是分层。嵌入式裸机也一样。

我们这门课采用的分层模型是这样的：

你想想看，这样做的好处是什么？驱动层只关心寄存器怎么配，中间件层只关心数据怎么处理，应用层只关心业务怎么跑。每一层只跟相邻层打交道，互不干扰。

我曾经在一个项目里，客户要求把主控从STM32F4换成GD32。因为驱动层做了硬件抽象，我只改了底层寄存器映射文件，上层代码一行没动。三天搞定移植。如果没有分层，这个工作量至少翻五倍。

下面这张图展示了我们课程的核心分层结构：

1.3 硬件平台介绍（STM32F4）

这门课选用的是STM32F407ZGT6开发板。为什么选这个型号？

参数	STM32F407ZGT6	选型理由
内核	Cortex-M4F	带FPU，适合算法验证
主频	168MHz	性能充裕，跑复杂逻辑不卡
Flash	1MB	装得下分层架构+中间件
SRAM	192KB	够用，不用操心内存碎片
外设资源	USART×6, SPI×3, I2C×3, TIM×14	覆盖课程所有实验需求

我个人建议，如果你手头是STM32F1系列，大部分代码也能跑，只是寄存器地址和时钟配置略有差异。课程里我会标注哪些地方跟F1不一样。

1.4 IDE安装与配置（Keil MDK）

Keil MDK是ARM开发的老牌工具。虽然现在也有STM32CubeIDE，但Keil在调试体验和工程管理上，我个人觉得更顺手。

安装步骤不复杂，但有几个坑要注意：

1. 版本选择：建议MDK 5.38或更新版本，老版本对Cortex-M4支持不够好
2. 器件包：安装完IDE后，记得装Keil.STM32F4xx_DFP.2.17.1或更新版本
3. 编译器：默认ARMCC v6，如果你习惯v5，可以在工程选项里切换
4. License：评估版有32KB代码限制，做课程实验够用，但完整项目建议买正版

配置完成后，新建一个空工程，选择STM32F407ZG芯片。这时候你会看到Keil自动帮你勾选了CMSIS core和Device Startup。别动它，这是基础框架。

1.5 调试工具准备（J-Link / ST-Link）

调试器是嵌入式开发的命根子。没有它，你只能靠printf和LED闪烁来猜问题。说实话，那效率太低了。

课程里我两种调试器都会演示，但日常开发我更推荐J-Link：

特性	J-Link	ST-Link
速度	最高50MHz SWO	最高4MHz SWO
断点数量	无限（硬件+软件）	6个硬件断点
RTT支持	原生支持	需第三方工具
价格	较贵（教育版可接受）	免费（开发板自带）
适用场景	复杂调试、性能分析	日常开发、简单调试

接线很简单：SWD接口只需要4根线——SWDIO、SWCLK、GND、VCC（可选）。我习惯把VCC也接上，这样调试器可以检测目标板电压，避免电平不匹配。

1.6 第一个实验：点亮LED

按照惯例，第一个程序是点亮LED。但这次我们不是随便点一下，而是用分层架构的方式来做。

代码结构如下：

// driver_gpio.h — 驱动层
#ifndef DRIVER_GPIO_H
#define DRIVER_GPIO_H

#include "stm32f4xx.h"

void GPIO_InitOutput(GPIO_TypeDef* GPIOx, uint16_t Pin);
void GPIO_SetPin(GPIO_TypeDef* GPIOx, uint16_t Pin);
void GPIO_ResetPin(GPIO_TypeDef* GPIOx, uint16_t Pin);

#endif

// driver_gpio.c — 驱动层实现
#include "driver_gpio.h"

void GPIO_InitOutput(GPIO_TypeDef* GPIOx, uint16_t Pin)
{
    // 开启时钟
    if(GPIOx == GPIOF) RCC->AHB1ENR |= RCC_AHB1ENR_GPIOFEN;
    
    // 配置为推挽输出
    GPIOx->MODER &= ~(0x3 << (Pin * 2));
    GPIOx->MODER |=  (0x1 << (Pin * 2));
    
    // 设置输出类型为推挽
    GPIOx->OTYPER &= ~(0x1 << Pin);
    
    // 设置速度
    GPIOx->OSPEEDR &= ~(0x3 << (Pin * 2));
    GPIOx->OSPEEDR |=  (0x2 << (Pin * 2));
}

void GPIO_SetPin(GPIO_TypeDef* GPIOx, uint16_t Pin)
{
    GPIOx->BSRR = (uint32_t)Pin;
}

void GPIO_ResetPin(GPIO_TypeDef* GPIOx, uint16_t Pin)
{
    GPIOx->BSRR = (uint32_t)(Pin << 16);
}

// app_main.c — 应用层
#include "driver_gpio.h"

#define LED_PIN   GPIO_PIN_9
#define LED_PORT  GPIOF

void Delay(volatile uint32_t count)
{
    while(count--);
}

int main(void)
{
    GPIO_InitOutput(LED_PORT, LED_PIN);
    
    while(1)
    {
        GPIO_SetPin(LED_PORT, LED_PIN);
        Delay(500000);
        GPIO_ResetPin(LED_PORT, LED_PIN);
        Delay(500000);
    }
}

你看，应用层的main函数完全不知道寄存器长什么样。它只知道调用GPIO_SetPin和GPIO_ResetPin。这就是分层的好处——以后你想把LED换成蜂鸣器，只需要改驱动层，应用层代码不用动。