第一章 课程导论与调试环境搭建

各位同学好，我是老周。做嵌入式这行十几年了，踩过的坑比吃过的盐还多。今天开始咱们一起走一遍《STM32外设驱动与通信协议故障排查实战》这门课。

第一节课，我不打算直接扔代码。咱们先把家伙事儿备齐了，把战场打扫干净。你想想看，调试工具都没配好，出了问题你连看都看不见，那还排查个啥？

1.1 这门课到底讲什么？

说白了，这门课就干三件事：

• 搞懂外设 —— GPIO、UART、SPI、I2C、定时器、DMA，这些STM32上最常见的外设，它们到底怎么工作的。
• 学会排查 —— 出了问题别慌。从现象倒推原因，用逻辑分析仪抓波形，用示波器看时序，用调试器单步跟踪。
• 实战驱动 —— 每个外设我都会带着你写驱动，然后故意埋几个坑进去，咱们一起把它揪出来。

我在项目中遇到过太多这样的场景：工程师调了两天的I2C，最后发现是上拉电阻焊错了。这种低级错误，其实用逻辑分析仪看一眼波形就能秒杀。可惜很多人连分析仪怎么用都不知道。

1.2 调试工具链：你的三把刀

做嵌入式调试，工具就是你的眼睛。我个人习惯把工具分成三个层级：

工具	主要用途	我推荐的理由
逻辑分析仪	抓数字信号波形，看协议时序	便宜、上手快，排查通信协议必备
示波器	看模拟信号质量、噪声、上升沿	模拟问题必须用它，比如晶振起振、电源纹波
J-Link调试器	单步执行、断点、查看变量	代码逻辑问题，靠它最直接

逻辑分析仪

这东西我建议人手一个。淘宝上几十块的就能用，配合Saleae Logic或者PulseView软件，抓个UART、SPI、I2C完全够用。我曾经用一台8通道的逻辑分析仪，半小时内定位了一个困扰团队三天的SPI时钟极性配置错误。

示波器

示波器比逻辑分析仪贵不少，但有些问题非它不可。比如I2C总线的上拉电阻选大了，上升沿变缓，逻辑分析仪可能还能识别，但实际通信已经不可靠了。这时候只有示波器能看到那个「圆角」的波形。

我建议新手先买个二手普源或者鼎阳的，100MHz带宽、1GSa/s采样率，足够应付大部分STM32项目。

J-Link调试器

调试器这块，J-Link是行业标准。虽然贵了点，但稳定、兼容性好。我见过有人用几十块的盗版ST-Link，调试到一半断连，代码下载到一半卡死……嗯，那种感觉，你懂的。

1.3 开发环境配置与验证

开发环境这块，主流就两个：Keil MDK和STM32CubeIDE。我个人的建议是：

• Keil MDK —— 老牌、稳定、编译快。适合做产品级项目，尤其是代码量大的时候。
• STM32CubeIDE —— 免费、基于Eclipse、集成了CubeMX。适合学习、原型验证，以及不想折腾License的同学。

两个我都用，但今天咱们以Keil为例走一遍配置流程。CubeIDE的配置大同小异，我会在课程资料里附上对应的步骤。

Keil MDK配置步骤

1. 安装Keil MDK 5.38或更新版本（建议用ARM Compiler 6）
2. 安装对应芯片的Device Family Pack（比如STM32F4xx_DFP）
3. 新建工程，选择芯片型号
4. 配置Debug选项：选择J-Link / J-Trace Cortex
5. 在Settings里确认SWD连接正常，能看到Device ID

配置完别急着写代码。先跑一个最简单的GPIO翻转程序，验证整个链路通不通。

// 验证代码：PA5引脚翻转（对应开发板上的LED）
#include "stm32f4xx.h"

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

int main(void) {
    // 使能GPIOA时钟
    RCC->AHB1ENR |= RCC_AHB1ENR_GPIOAEN;
    // 配置PA5为输出模式
    GPIOA->MODER |= GPIO_MODER_MODER5_0;
    GPIOA->MODER &= ~GPIO_MODER_MODER5_1;

    while(1) {
        GPIOA->ODR ^= GPIO_ODR_OD5;  // 翻转PA5
        delay(500000);
    }
}

下载到板子上，如果LED开始闪烁，恭喜你，环境通了。如果不闪，别急，咱们按下面这个流程排查：

1.4 本章知识体系总览

下面这张图，把咱们第一章的核心内容串起来了。你可以把它当作一个「调试环境搭建检查清单」来用。

1.5 写在开始之前

最后说几句心里话。做嵌入式调试，最忌讳的就是「猜」。代码跑不通，就加个延时试试？不行再换个引脚试试？这种碰运气的方式，运气好能蒙对，运气不好能折腾你一周。

正确的做法是什么？用工具看数据。逻辑分析仪抓波形，示波器看信号质量，调试器看寄存器值。数据不会骗人。

这门课里，我会带着你一步步建立这种「数据驱动」的调试思维。从下一章开始，咱们就正式进入GPIO的实战排查。但今天，先把环境搭好，把工具备齐。磨刀不误砍柴工，这句话在嵌入式领域，永远是真理。