1. 课程导学与开发环境搭建
各位同学，欢迎来到《STM32裸机模块化编程与调试故障定位实战》的第一章。我是你们这门课的主讲工程师。
说实话，我见过太多初学者卡在环境搭建这一步。装个软件装一天，最后连个灯都没点亮，信心直接归零。所以这一章，咱们不贪多，就干三件事：搞清楚学什么、选对芯片、把环境跑通。最后让板子上那个LED闪起来——这是嵌入式工程师的"Hello World"。
1.1 课程目标：你到底能学到什么？
这门课不是教你抄寄存器手册，也不是让你跑个RTOS就完事。我的核心目标就一个：让你在没有操作系统的情况下，写出能上生产线的模块化代码，并且出了问题自己能快速定位。
具体来说，学完这门课，你应该能：
- 用STM32CubeMX生成初始化代码，而不是从零手撸时钟树
- 把GPIO、定时器、串口、ADC这些外设封装成独立模块
- 掌握裸机下的状态机编程思想，而不是在主循环里堆if-else
- 遇到HardFault、死机、外设不响应时，有系统的排查思路
我在项目里带过不少新人，发现一个规律：能写好裸机程序的人，上RTOS也差不到哪去；反过来，一上来就怼RTOS的，往往连中断优先级都搞不明白。所以，咱们先把裸机这块地基打牢。
课程定位：这不是STM32的入门课，而是从"能跑"到"跑得稳、跑得巧"的进阶实战课。你需要有一点C语言基础和单片机概念，但不需要精通。
1.2 STM32选型建议：别在起跑线上选错车
经常有人问我："老师，我该买F103还是F407？" 我的回答是：看你的项目需求，别跟风。
我刚开始做项目时，老板说用F103，我就用F103。后来发现要跑个简单的GUI，F103的RAM根本不够用，硬着头皮上了F429。那次教训让我学会了选型要看三点：
| 需求场景 | 推荐系列 | 核心优势 | 注意避坑 |
|---|---|---|---|
| 入门学习、简单控制 | STM32F103C8T6 | 资料最多、价格便宜、够用 | RAM只有20KB，别想跑复杂算法 |
| 需要USB、CAN、多定时器 | STM32F407VGT6 | 带FPU、主频168MHz、外设丰富 | 功耗比F103高，注意散热 |
| 低功耗、电池供电 | STM32L4系列 | 多种低功耗模式、适合IoT | 价格稍高，调试时注意功耗模式切换 |
| 图形界面、大屏显示 | STM32F429/767 | 内置LCD控制器、大RAM | 封装大、布线复杂，不适合小项目 |
我个人建议：如果你刚接触STM32，先买一块F103C8T6的"最小系统板"，十几块钱，足够跑完这门课80%的例程。等你把裸机模块化编程练熟了，再根据实际项目换芯片。千万别一上来就买一千多的开发板，吃灰的概率很大。
选型小技巧：去ST官网查芯片的"Datasheet"和"Reference Manual"。Datasheet看电气特性，Reference Manual看寄存器——后者才是你写驱动时要反复翻的。
1.3 Keil MDK安装与配置：别让工具卡住你
Keil MDK，说白了就是ARM公司的集成开发环境。我用过IAR、GCC、STM32CubeIDE，但说实话，在调试裸机程序时，Keil的调试器和逻辑分析仪功能是最顺手的。
安装步骤其实很简单，但有几个坑我得提前说：
- 版本选择：建议用MDK 5.38或更高版本。太老的版本对新型号芯片支持不好。
- 安装路径：不要有中文！不要有空格！我见过有人装在"程序文件"文件夹下，结果编译报错找半天原因。
- Pack安装：安装完MDK后，记得打开Pack Installer，下载你所用芯片的器件支持包。比如F103就搜"STM32F1xx_DFP"。
- License激活：Keil需要许可证。如果你只是学习，可以用评估版（32KB代码限制），但咱们这门课的例程都控制在32KB以内，放心用。
安装完成后，我建议你做两件事：
- 把编辑器字体改成Consolas 12号，保护眼睛
- 开启"Browse Information"，方便代码跳转
我曾经踩过的坑：有一次装完MDK死活编译不过，提示找不到"core_cm3.h"。后来发现是Pack版本装错了——F103是Cortex-M3内核，我装成了M4的Pack。所以，一定要确认你的Pack和芯片内核匹配。
1.4 STM32CubeMX初体验：图形化配置，真香
早期写STM32程序，配置时钟和外设全靠手写寄存器。一个时钟树配错，系统频率直接翻车。后来ST出了CubeMX，图形化配置，自动生成初始化代码，这简直是嵌入式开发的福音。
我第一次用CubeMX时，心里还嘀咕："这生成代码靠谱吗？" 后来项目赶工期，用CubeMX配了一个带USB、SDIO、I2C的工程，生成代码直接跑通，我就服了。
CubeMX的核心功能就三个：
- 引脚分配：图形化界面，拖拽配置，避免引脚冲突
- 时钟树配置：自动计算分频系数，保证各总线频率合规
- 外设初始化代码生成：生成HAL库或LL库的初始化函数
咱们这门课会大量使用CubeMX生成基础代码，然后在此基础上做模块化封装。所以，你不用死记硬背每个寄存器的地址，但要知道生成的代码在干什么。
使用建议：CubeMX生成的代码默认放在"Core/Src"和"Core/Inc"目录下。我习惯把用户代码写在"User"文件夹里，和自动生成的代码分开，这样重新生成时不会覆盖。
1.5 第一个LED工程：点亮你的"Hello World"
好了，理论说完了，咱们动手。下面是我带你走一遍的流程，每一步都别跳。
1.5.1 在CubeMX中创建工程
- 打开CubeMX，点击"New Project"
- 在Part Number搜索框输入"STM32F103C8"，选中后双击
- 在Pinout & Configuration界面，找到PC13引脚（大部分F103板载LED接这个脚），右键选择"GPIO_Output"
- 点击"Clock Configuration"标签，配置HSE为8MHz外部晶振，系统时钟设为72MHz
- 点击"Project Manager"标签，设置工程名和路径，Toolchain选择"MDK-ARM"
- 点击"GENERATE CODE"，生成工程
1.5.2 在Keil中编写代码
打开生成的MDK工程，在main.c的while(1)循环里添加以下代码：
/* 用户代码开始 */
HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
HAL_Delay(500); // 延时500ms
/* 用户代码结束 */这段代码的作用：每500ms翻转一次PC13的电平，LED就会一亮一灭。
1.5.3 编译、下载、运行
- 点击Keil的"Build"按钮（或者按F7），编译工程
- 用ST-Link连接开发板和电脑，点击"Download"按钮（或者按F8）
- 按下开发板的复位键，观察LED是否闪烁
如果LED不亮，别慌：先检查ST-Link驱动是否安装，再确认下载器接线是否正确（SWDIO、SWCLK、GND三根线必须接）。我遇到过最奇葩的问题是——LED焊反了，正负极接反。所以，先拿万用表量一下引脚电平。
1.6 本章知识体系
下面这张图，帮你把第一章的核心脉络理清楚：
嗯，这张图把咱们第一章的内容串起来了。从课程目标出发，到选型、装工具、配环境，最后点亮LED——每一步都是后续章节的基础。
最后说一句：环境搭建遇到问题很正常，别死磕。去网上搜一下，或者问问身边的朋友。我当年第一次装Keil，折腾了整整一个下午才把LED点亮。但点亮那一刻，真的很有成就感。