3. 单片机ADC外设配置实战

好，咱们进入第三章。前面两章我们把ADC和串口的基本概念捋了一遍，从这章开始，要真刀真枪地写代码了。很多初学者一上来就被STM32的各种库搞懵——标准库、HAL库、LL库，到底学哪个？我个人建议，如果你不是做那种极端追求性能的底层驱动，直接上手HAL库。为什么？因为HAL库把硬件抽象得比较干净，配合CubeMX图形化配置，开发效率能翻倍。

3.1 HAL库到底是什么？

HAL是Hardware Abstraction Layer的缩写，说白了就是硬件抽象层。它的核心思想是：同一套API，换芯片不改代码。比如你用STM32F103写了个GPIO控制函数，换到STM32F407上，只要重新生成一下初始化代码，业务逻辑基本不用动。

我刚开始从标准库转HAL库时，其实挺抗拒的。总觉得HAL库封装太厚，代码跑起来慢。后来做了几个项目才发现，HAL库的延迟主要在外设初始化阶段，真正跑起来以后，性能差距几乎可以忽略。而且HAL库的代码可读性比标准库好太多，团队协作时，新人上手快得多。

这里有个关键点：HAL库并不是完全抛弃寄存器操作。它提供了LL库（Low Layer）作为补充。当你需要极致性能时，可以直接调用LL库的函数，或者干脆自己操作寄存器。但大部分场景下，HAL库足够用了。

3.2 使用CubeMX生成GPIO工程

CubeMX是ST官方推出的图形化配置工具。你想想看，以前配一个时钟树，要翻几百页数据手册，算分频系数，一不小心就配错了。用CubeMX，鼠标点几下就搞定。我建议所有初学者都从CubeMX开始，先把精力放在业务逻辑上，不要一开始就跟寄存器死磕。

3.2.1 新建工程的基本步骤

1. 选择芯片型号：比如STM32F103C8T6，或者你手头开发板的具体型号
2. 配置时钟树：HSE、PLL、系统时钟，CubeMX会自动计算合法性
3. 配置GPIO：选择引脚，设置输入/输出模式、上下拉、速度等
4. 生成代码：选择IDE（MDK、IAR、STM32CubeIDE），点击生成

我记得第一次用CubeMX时，生成完代码直接编译报错，找了半天发现是时钟配置里HSE的数值填错了。后来养成习惯：每次生成代码前，先点一下"Clock Configuration"页面，确认所有时钟都在合法范围内。

3.2.2 GPIO配置的关键参数

参数	选项	说明
GPIO mode	Output / Input / Alternate Function / Analog	输出、输入、复用功能、模拟模式
GPIO Pull-up/Pull-down	No pull / Pull-up / Pull-down	内部上拉/下拉电阻配置
Maximum output speed	Low / Medium / High / Very High	输出速度，高频信号用High以上
User Label	自定义名称	给引脚起个名字，代码中直接用宏定义

3.3 HAL_GPIO_WritePin函数详解

这个函数是GPIO输出的核心API。它的原型长这样：

void HAL_GPIO_WritePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState);

三个参数，我一个个说：

• GPIOx：GPIO组，比如GPIOA、GPIOB、GPIOC。这是STM32的硬件分组，每组最多16个引脚。
• GPIO_Pin：引脚编号，用宏表示，比如GPIO_PIN_0、GPIO_PIN_1。可以同时操作多个引脚，用"|"连接，比如GPIO_PIN_0 | GPIO_PIN_1。
• PinState：输出状态，只有两个值——GPIO_PIN_RESET（低电平）和GPIO_PIN_SET（高电平）。

举个例子，控制LED亮灭：

// 点亮LED（假设LED接在PA0，低电平点亮）
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_RESET);

// 熄灭LED
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_SET);

// 同时控制PA0和PA1输出高电平
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0 | GPIO_PIN_1, GPIO_PIN_SET);

3.4 一个完整的GPIO输出示例

咱们写一个最简单的流水灯程序，用CubeMX生成工程，然后手动添加逻辑。假设开发板上接了4个LED，分别挂在PA0-PA3。

CubeMX配置要点：

• PA0-PA3设置为Output模式
• 速度选Low（LED不需要高速）
• User Label分别命名为LED0、LED1、LED2、LED3

生成代码后，在main.c的while(1)循环里添加：

while (1)
{
  // 逐个点亮LED
  HAL_GPIO_WritePin(LED0_GPIO_Port, LED0_Pin, GPIO_PIN_RESET);
  HAL_Delay(200);
  HAL_GPIO_WritePin(LED0_GPIO_Port, LED0_Pin, GPIO_PIN_SET);

  HAL_GPIO_WritePin(LED1_GPIO_Port, LED1_Pin, GPIO_PIN_RESET);
  HAL_Delay(200);
  HAL_GPIO_WritePin(LED1_GPIO_Port, LED1_Pin, GPIO_PIN_SET);

  HAL_GPIO_WritePin(LED2_GPIO_Port, LED2_Pin, GPIO_PIN_RESET);
  HAL_Delay(200);
  HAL_GPIO_WritePin(LED2_GPIO_Port, LED2_Pin, GPIO_PIN_SET);

  HAL_GPIO_WritePin(LED3_GPIO_Port, LED3_Pin, GPIO_PIN_RESET);
  HAL_Delay(200);
  HAL_GPIO_WritePin(LED3_GPIO_Port, LED3_Pin, GPIO_PIN_SET);
}

注意看，这里用的LED0_GPIO_Port和LED0_Pin就是CubeMX根据User Label自动生成的宏。你不需要记住PA0对应哪个寄存器，直接写逻辑就行。

3.5 HAL库GPIO的核心知识结构

为了让你更直观地理解HAL库GPIO的整个体系，我画了一张图：

这张图把整个链路串起来了：CubeMX配置 → HAL API调用 → LL/寄存器操作 → 硬件执行。你平时写代码，主要跟第二层打交道。但出了问题需要调试时，要能往下看到寄存器层。

3.6 几个容易忽略的细节

嗯，这里有几个点，我当年都吃过亏，给你提个醒：

• GPIO初始化顺序：CubeMX生成的MX_GPIO_Init()函数里，会先使能GPIO的时钟，再配置寄存器。如果你自己写代码，千万别忘了先开时钟，否则配置无效。
• 输出速度不是越快越好：LED、按键这类低频信号，用Low速度就够了。速度设高了，反而会增加功耗和EMI干扰。
• HAL_Delay的精度：HAL_Delay()基于SysTick定时器，精度是1ms。如果需要微秒级延时，得用定时器或者自己写循环。