STM32开发入门：从零到一掌握HAL库与CubeMX实战-尧图网络科技

1. 项目概述：从零认识STM32开发

如果你刚开始接触嵌入式开发，或者从51单片机、Arduino转向更复杂的应用，STM32这个名字大概率会频繁出现在你的视野里。它不是什么高深莫测的黑科技，而是一系列由意法半导体（STMicroelectronics）推出的、基于ARM Cortex-M内核的32位微控制器。简单来说，你可以把它理解为一个功能更强大、资源更丰富、能处理更复杂任务的“超级单片机”。我刚开始从51转过来的时候，也被它复杂的时钟树、众多的外设和陌生的开发环境搞得一头雾水，但一旦上手，你会发现它带来的灵活性和性能提升是巨大的。

那么，为什么STM32如此流行？核心在于它的“生态”。一个芯片要火，光有硬件性能不够，还得有完善的软件工具链和丰富的社区资源支持。STM32恰恰在这点上做得很好。对于开发者而言，入门STM32主要会接触到三个关键部分：芯片本身、集成开发环境（Keil MDK-ARM，常称Keil5）、以及图形化配置工具（STM32CubeMX）。而在这三者之上，ST官方大力推广的HAL库，则构成了我们编写应用程序的主要软件框架。这篇文章，我就以一个过来人的身份，带你捋清这几个核心概念之间的关系，并分享从环境搭建到第一个程序烧录的完整实操路径，以及我踩过的一些坑。我们的目标不是成为理论专家，而是能快速、顺畅地开始你的第一个STM32项目。

2. 开发环境全解析：Keil5与CubeMX的角色与协同

刚开始玩STM32，很多人会困惑：我到底该用哪个软件？Keil5和CubeMX是什么关系？这里我用一个简单的比喻：把开发STM32比作装修房子。

STM32芯片：就是你的毛坯房，里面有各种房间（外设：GPIO、USART、ADC等）和管线（时钟、电源）。
STM32CubeMX：相当于一个智能的装修设计软件。你不需要自己画水电图，只需要在图形界面上点点选选：“这里要装个灯（配置GPIO为输出）”、“那里要接个水龙头（配置USART）”、“客厅的空调功率大，需要独立的电路（配置定时器）”。CubeMX会根据你的选择，自动生成所有底层的、繁琐的初始化代码（C语言），并且把各个“房间”和“管线”都配置好，确保它们不会冲突。最重要的是，它能一键生成针对Keil5（或IAR等）的完整工程文件。
Keil MDK-ARM (Keil5)：这就是你的施工队和工具间。CubeMX生成工程后，你就在Keil5里进行“装修施工”——也就是编写具体的业务逻辑代码。比如，你告诉“灯”（GPIO）什么时候亮、什么时候灭；处理“水龙头”（USART）接收到的数据。Keil5提供了代码编辑、编译、调试、程序烧录等一系列功能。
HAL库：这是ST官方提供的一套标准化装修工具和材料包。以前（标准外设库时代），你可能需要自己拧螺丝、接电线，非常底层且容易出错。HAL库把这些操作封装成了一个个简单的函数，比如HAL_GPIO_WritePin()（开/关灯）、HAL_UART_Transmit()（从水龙头送水）。你只需要调用这些函数，不用关心底层的寄存器是怎么操作的，大大提高了开发效率和代码的可移植性。

所以，一个典型的现代STM32开发流程是：用CubeMX进行图形化配置，生成初始化代码和工程 -> 在Keil5中打开该工程，基于HAL库编写应用逻辑 -> 用Keil5编译、调试、烧录程序。

2.1 Keil5：老牌IDE的安装与核心配置避坑

Keil5（MDK-ARM）是ARM官方认可的经典IDE，虽然界面复古，但功能稳定、生态成熟。安装过程有几个关键点，不注意就会掉坑里。

安装步骤精要：

获取安装包：从ARM官网或国内镜像站下载MDK安装包（如MDK536.EXE）和对应的STM32芯片支持包（Device Family Pack，如Keil.STM32F1xx_DFP.2.4.1.pack）。务必分清，主安装包装的是编译器和IDE，芯片包是让Keil认识你的具体型号（如STM32F103C8T6）。
安装主程序：路径建议全英文，不要有空格。安装过程中会提示安装“ULINK”驱动等，一律勾选同意。
安装芯片包：有两种方式。一是直接双击下载好的.pack文件；二是在Keil5的菜单栏点击Pack Installer（一个立方体图标），在线搜索并安装。对于网络环境不好的情况，离线包更可靠。
许可证管理：这是最大的一道坎。Keil5是商业软件，需要有效的License才能编译超过32KB的代码。网上流传的“注册机”方法涉及破解，存在法律和安全风险，且在高版本（如5.36以上）中经常失效，导致编译时报错*** Target ‘XXX‘ uses ARM-Compiler ‘Default Compiler Version 5‘ which is not available。我个人的强烈建议是：对于学习和非商业用途，可以申请Keil官方提供的功能限制版（MDK-Lite）许可证，它完全免费、合法，只是有代码大小限制（32KB），但对于绝大多数入门和中级项目（如平衡车、数据采集、简单控制）已经绰绰有余。在Keil5中点击File -> License Management，在弹出的窗口右下角，复制CID，然后去ARM官网按照流程申请，将获得的LIC代码填入即可。

注意：网上教程常教的“替换ARMCC编译器”等方法非常不推荐，极易导致环境混乱，后续使用CubeMX生成代码时出现各种诡异问题。坚持使用官方原装工具链是最稳妥的。

工程管理与视图恢复：新手常会遇到“工程窗口（Project）不见了”的问题。别慌，点击菜单栏View -> Project Window即可恢复。同样，函数列表窗口是View -> Functions Window。建议花点时间熟悉View菜单下的各个组件，打造自己顺手的布局。

2.2 CubeMX：图形化配置的利器与版本选择

STM32CubeMX是ST的“亲儿子”工具，极大地降低了配置门槛。它的核心价值在于可视化配置和中间件集成。

可视化配置：通过图形界面配置引脚功能（自动解决冲突）、时钟树（直观设置各总线频率）、外设参数（如串口波特率、ADC采样时间）。你不再需要手动查阅数百页的数据手册去计算寄存器值。
中间件集成：可以一键集成FreeRTOS（实时操作系统）、FatFS（文件系统）、LWIP（网络协议栈）、USB库等复杂组件，并自动生成适配的代码框架，省去了繁琐的移植工作。

安装与更新建议：

下载：直接从ST官网下载安装程序。安装过程同样建议使用默认路径或全英文路径。
固件包管理：首次打开CubeMX，它会提示你下载STM32芯片的HAL库固件包（如STM32Cube_FW_F1_V1.8.5）。这个包很大（几百MB到上GB），包含了对应系列所有芯片的HAL库源码、驱动和示例。务必耐心下载完成，这是生成代码的基础。你可以在Help -> Manage embedded software packages中管理已安装的包。
版本选择：不要盲目追求最新版。新版本（如6.12.0）可能引入了新特性，但也可能存在未知Bug，或者与某些旧教程不兼容。对于初学者，选择一个稳定、教程资源丰富的版本（如6.6.x或6.8.x）可能更省心。你可以在ST官网找到历史版本下载。

基本工作流：

新建工程：选择你的芯片型号（如STM32F103C8T6）。
引脚配置：在芯片图上点击引脚，选择其功能（如GPIO_Output, USART2_TX等）。冲突的引脚会以颜色高亮。
时钟配置：在“Clock Configuration”标签页，像搭积木一样设置系统时钟源（通常用外部晶振HSE），并通过PLL倍频到想要的系统频率（如72MHz）。CubeMX会自动计算并显示各总线时钟，确保不超频。
外设配置：在“Pinout & Configuration”标签页，左侧启用所需外设（如ADC1, TIM2），右侧设置具体参数。
项目管理：在“Project Manager”标签页，设置工程名称、路径、IDE（选择MDK-ARM V5），并选择“Copy all used libraries into the project folder”以保持工程独立性。
生成代码：点击“GENERATE CODE”。CubeMX会生成一个完整的Keil5工程，所有初始化代码（main.c,gpio.c,usart.c等）都已就绪。

3. HAL库深度剖析：驱动开发的新范式

HAL（Hardware Abstraction Layer）库，即硬件抽象层库，是ST为了统一不同STM32系列芯片的编程接口、提升代码可移植性和开发效率而推出的新一代驱动库。它正在逐步取代旧的标准外设库（SPL）。

3.1 HAL库 vs. 标准外设库：理念之差

标准外设库（SPL）：更贴近寄存器操作，需要对硬件有较深理解。代码效率高，但移植性差（不同系列芯片库函数可能有差异），且不支持复杂的中间件。
HAL库：抽象程度更高。它采用句柄（Handle）结构体来管理一个外设的所有状态和参数（如UART_HandleTypeDef huart2），采用回调函数（Callback）机制来处理中断和事件。这种面向对象的思想，使得代码结构更清晰，移植性极强（F1到F4系列，代码改动很小）。代价是代码体积稍大，执行效率略有损耗，但对于当今性能过剩的Cortex-M芯片和大多数应用来说，这点损耗完全可以接受。

为什么推荐新手从HAL库开始？因为它让你能更快速地看到成果，把精力集中在“做什么”（应用逻辑）而不是“怎么做”（寄存器操作）上。例如，使用DMA（直接存储器访问）传输串口数据，用标准库配置非常繁琐，而HAL库只需调用HAL_UART_Transmit_DMA()和HAL_UART_Receive_DMA()几个函数，再配合CubeMX图形化配置DMA流，就能轻松实现，极大地降低了异步、高效数据处理的入门门槛。

3.2 HAL库的核心编程模型：轮询、中断与DMA

HAL库为每个外设的通信提供了三种模式，这是理解其用法的关键：

轮询（Polling）：CPU不断查询外设状态。代码简单，但CPU利用率低。例如，HAL_UART_Transmit(&huart2, data, size, timeout)会一直等待发送完成或超时。
中断（Interrupt）：外设操作完成后触发中断，CPU暂停当前任务去处理。效率高于轮询。例如，HAL_UART_Transmit_IT()启动发送后立即返回，发送完成后会触发中断，在HAL_UART_TxCpltCallback()回调函数中处理发送完成事件。
DMA（Direct Memory Access）：由DMA控制器在外设和内存之间搬运数据，完全不占用CPU。效率最高，用于大数据量传输。例如，HAL_UART_Transmit_DMA()。结合串口空闲中断（IDLE），是实现串口不定长数据接收的黄金搭档：DMA负责接收数据到缓冲区，空闲中断标志数据帧接收完毕，然后在回调函数中处理一整包数据。

实操心得：对于简单的LED闪烁、按键扫描，用轮询或中断都可以。但对于串口通信、ADC连续采样这类涉及数据流的外设，强烈建议从入门中期就开始学习并使用“中断+DMA”的模式。这不仅是性能最优解，也是实际项目中的标准做法。CubeMX可以很方便地配置中断和DMA通道，HAL库也提供了完整的函数支持。

3.3 代码结构导航：CubeMX生成工程的奥秘

用CubeMX生成Keil工程后，打开项目目录，你会看到一堆文件。别怕，主要关注这几个：

Core/Inc/和Core/Src/：用户代码核心区。
- main.c：程序入口。while(1)主循环在这里。用户代码要写在BEGIN和END注释对之间，这样下次用CubeMX重新生成代码时，你的代码不会被覆盖。
- stm32f1xx_it.c：中断服务函数集中地。所有外设的中断服务函数（如USART2_IRQHandler）都在此，它们内部会调用HAL库的中断处理函数。
- gpio.c,usart.c等：由CubeMX生成的外设初始化代码。
Drivers/STM32F1xx_HAL_Driver/：HAL库的源码，不需要修改，但可以查阅。
MDK-ARM/：Keil5的工程文件（.uvprojx）和链接脚本等。

一个关键技巧：当你需要自定义中断处理逻辑时，不要直接修改stm32f1xx_it.c里的函数，而是去重写HAL库提供的弱定义（Weak）的回调函数。例如，要处理串口接收完成中断，你可以在main.c或自己的用户文件中这样写：

void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart->Instance == USART2) { // 判断是哪个串口 // 你的处理代码，例如将收到的字节存入缓冲区 // 然后重新启动接收中断，准备接收下一个字节 HAL_UART_Receive_IT(&huart2, &rx_byte, 1); } }

这种设计保证了代码的模块化和可维护性。

4. 从零到一：第一个HAL库项目实战（点亮LED）

理论说了这么多，现在我们动手做一个最简单的项目：用STM32F103C8T6（蓝色小板）点亮一个LED。假设LED已连接在PC13引脚（很多最小板自带）。

4.1 CubeMX工程配置详解

芯片选择：打开CubeMX，点击“New Project”，在Part Number搜索框输入STM32F103C8，选择STM32F103C8Tx。
引脚配置：
- 在芯片图形上找到PC13，点击它，选择GPIO_Output。引脚颜色会变成绿色。
- 在左侧的“System Core”下拉菜单中点击GPIO，然后在右侧的配置面板中，点击刚配置的PC13。
- GPIO输出模式：默认为Output Push Pull（推挽输出），驱动能力强，高低电平明确，适合驱动LED。
- 上/下拉：选择No pull-up and no pull-down（既不上拉也不下拉），因为我们通过代码控制电平。
- 默认输出电平：设为High（高电平）。对于共阳极接法的LED（LED正极接VCC，负极接PC13），高电平熄灭，低电平点亮。这样配置更安全，防止一上电LED就常亮。
- 用户标签：可以给它起个别名，如USER_LED，这样生成的代码中引脚定义会更清晰。
时钟配置：
- 点击“Clock Configuration”标签页。对于F103，我们通常使用外部8MHz晶振（HSE）。
- 在图形界面上，点击HSE选择Crystal/Ceramic Resonator。
- 然后找到PLL相关选项，将PLL Source Mux选择为HSE。
- 将PLL Multiplication Factor（PLL倍频因子）设置为x9。这样，系统时钟SYSCLK = 8MHz * 9 = 72MHz。这是F103系列的最高主频。
- 检查HCLK、PCLK1、PCLK2的时钟，它们会自动计算。确保PCLK1（APB1总线时钟）不超过36MHz（定时器相关），PCLK2（APB2总线时钟）不超过72MHz。
项目管理与代码生成：
- 点击“Project Manager”标签页。
- Project Name：输入LED_Blink。
- Project Location：选择一个干净的英文路径。
- Toolchain / IDE：选择MDK-ARM V5。
- 在Code Generator部分，强烈建议勾选“Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral”。这会把每个外设的初始化代码单独成对文件，结构更清晰。
- 最后，点击右上角的GENERATE CODE。

4.2 Keil5中的代码编写与调试

打开工程：在生成的项目目录下，进入MDK-ARM文件夹，双击LED_Blink.uvprojx用Keil5打开。
编写主循环代码：在Core/Src/main.c文件中，找到while (1)主循环。在/* USER CODE BEGIN WHILE */和/* USER CODE END WHILE */之间添加闪烁代码：
```
while (1) { /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13); // 翻转PC13引脚的电平 HAL_Delay(500); // 延时500毫秒 } /* USER CODE END 3 */
```
HAL_GPIO_TogglePin()是HAL库提供的GPIO电平翻转函数。HAL_Delay()是一个基于系统滴答定时器（SysTick）实现的毫秒级延时函数，在HAL库初始化时已自动配置好。
编译与下载：
- 点击Keil5工具栏的Build（或按F7）按钮编译工程。下方“Build Output”窗口应显示0 Error(s), 0 Warning(s)。
- 连接你的ST-Link/V2调试器到板子的SWD接口（SWCLK, SWDIO, GND, 3.3V）。
- 点击Load（或按F8）按钮下载程序到芯片。看到“Flash Download completed”即表示成功。
观察结果：板载的LED（通常连接在PC13）应该开始以1秒的周期（亮500ms，灭500ms）闪烁。

注意：HAL_Delay()是一个阻塞式延时，在延时期间CPU无法做其他事情。对于简单的闪烁演示没问题，但在实际项目中，如果需要精确定时或执行多任务，应该使用硬件定时器（TIM）的中断模式。例如，可以配置一个定时器每1ms中断一次，在中断里维护一个全局计时变量，从而实现非阻塞的延时或任务调度，这是迈向更复杂应用（如平衡车控制、多任务处理）的关键一步。

5. 进阶外设与调试技巧实战指南

当你成功点亮LED后，就可以尝试更复杂的外设了。这里以串口通信和ADC采样为例，讲解配置要点和常见问题。

5.1 串口通信（USART）配置与“printf”重定向

串口是调试和通信的利器。我们配置USART1（PA9为TX，PA10为RX）与电脑通信。

CubeMX配置：

在“Connectivity”下启用USART1。
模式选择Asynchronous（异步通信）。
参数设置：波特率115200，字长8 Bits，停止位1，无校验，无硬件流控。
引脚PA9和PA10会自动配置。
如果想使用中断或DMA接收，需要在NVIC Settings或DMA Settings中启用并配置。

代码实现与“printf”重定向：为了方便调试，我们通常希望用printf函数通过串口输出信息。这需要重定向fputc函数。

在main.c中，包含头文件#include <stdio.h>。

在/* USER CODE BEGIN 4 */和/* USER CODE END 4 */之间（或其他用户代码区），添加以下函数：

#ifdef __GNUC__ #define PUTCHAR_PROTOTYPE int __io_putchar(int ch) #else #define PUTCHAR_PROTOTYPE int fputc(int ch, FILE *f) #endif PUTCHAR_PROTOTYPE { HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, 0xFFFF); // 通过huart1发送一个字符 return ch; }

在Keil5的工程选项里，需要勾选“Use MicroLIB”。这是针对嵌入式系统优化的精简C库，支持重定向。路径：Project -> Options for Target -> Target，勾选Use MicroLIB。
现在，你就可以在主函数中使用printf("Hello STM32!\r\n");了，信息将通过串口1发送到电脑，用串口助手（如XCOM、Putty）即可查看。

常见问题：

收不到数据：检查接线（TX接RX，RX接TX，共地）、波特率、串口助手端口设置。
printf导致程序卡死或输出乱码：首先检查是否启用了MicroLIB；其次，确保HAL_UART_Transmit函数中使用的串口句柄&huart1与CubeMX生成的全局变量名一致；最后，检查系统时钟配置是否正确，因为串口波特率发生器依赖系统时钟。

5.2 ADC采样与DMA传输

对于需要连续采集模拟信号（如传感器数据）的应用，ADC+DMA是标准方案。

CubeMX配置（以ADC1的通道0，对应PA0引脚为例）：

在“Analog”下启用ADC1。
在“Parameter Settings”中，选择Scan Conversion Mode为Enabled（扫描模式），Continuous Conversion Mode为Enabled（连续转换模式）。
在“DMA Settings”中，点击Add，选择ADC1，模式为Circular（循环模式）。这样ADC转换完成的数据会自动通过DMA搬运到指定内存，无需CPU干预。
在“NVIC Settings”中，可以启用ADC全局中断（如果需要转换完成回调）。
回到“Pinout & Configuration”视图，将PA0引脚配置为ADC1_IN0。

代码实现：

在main.c中定义DMA搬运的目标缓冲区：uint16_t adc_buffer[100]; // 假设缓存100个采样值。
在main函数的初始化部分（/* USER CODE BEGIN 2 */后），启动ADC的DMA转换：
```
HAL_ADC_Start_DMA(&hadc1, (uint32_t*)adc_buffer, 100);
```
这行代码会启动ADC1，并以DMA循环模式连续采样，结果自动存入adc_buffer数组。
之后，你就可以在程序任何地方直接读取adc_buffer数组来获取最新的ADC值了。由于是循环DMA，缓冲区会被不断覆盖，实现了连续采样。

实操心得：

采样时间：在ADC配置中，Sampling Time（采样时间）很重要。对于高阻抗信号源，需要更长的采样时间以保证采样电容充分充电，否则采样值会不准。一般可以设置为239.5 Cycles或更长。
DMA缓冲区溢出：在循环DMA模式下，如果CPU处理数据的速度跟不上ADC采样的速度，缓冲区会被新数据覆盖，导致数据丢失。解决方法一是增大缓冲区，二是使用双缓冲区（Double Buffer）模式，或通过ADC转换完成中断/半传输中断来通知CPU处理数据。

6. 开发中的高频问题与避坑指南

在STM32开发中，有些问题会反复出现。这里我总结了一份“避坑清单”，希望能帮你节省大量排查时间。

问题现象	可能原因	排查思路与解决方案
Keil5编译报错：`undefined symbol`	1. 未包含必要的源文件或库文件。 2. 函数名拼写错误。 3. 使用了C++编译器编译C代码（文件扩展名是`.cpp`）。	1. 在工程管理窗口，右键`Source Group`，确认所有需要的`.c`文件都已添加。 2. 检查函数声明和调用是否一致，注意大小写。 3. 将`.cpp`文件改为`.c`，或在工程选项`C/C++`中指定编译为C代码。
Keil5编译报错：`Target uses ARM-Compiler ‘Default Compiler Version 5‘ which is not available`	Keil5许可证无效或编译器路径错误。	1.首选方案：申请免费的MDK-Lite许可证。 2. 检查`Project -> Options for Target -> Target`中的`ARM Compiler`是否选择正确（通常是`Use default compiler version 5`或`Use default compiler version 6`）。切勿随意替换编译器文件夹！
CubeMX生成的代码编译后，程序大小超过芯片Flash限制	1. 优化等级太低。 2. 链接了未使用的库。	1. 在Keil5的`Options for Target -> C/C++`中，将`Optimization`等级从`-O0`（无优化）提高到`-O1`或`-O2`。 2. 在`Options for Target -> Target`中，确认只勾选了必要的库（如Use MicroLIB）。 3. 检查代码中是否包含了大量未使用的函数或变量。
程序下载失败，提示`No ULINK Device found`或`Cannot load Flash device description`	1. 调试器驱动未安装或连接不稳定。 2. 芯片型号/Flash算法选择错误。 3. 芯片进入了休眠/停止模式，或复位电路有问题。	1. 重新插拔ST-Link，检查接线（SWDIO, SWCLK, GND, 3.3V）。 2. 在Keil5的`Options for Target -> Debug`中选择正确的调试器，在`Utilities`中勾选正确的Flash算法（如STM32F10x Med-density）。 3. 尝试按住板子复位键再点击下载，在松开复位键的瞬间完成连接。或者检查板子的`BOOT0`引脚是否被拉高（应拉低才能从主Flash启动）。
串口发送数据正常，但接收不到（或乱码）	1. 硬件接线错误（TX/RX反接）。 2. 波特率、数据位、停止位、校验位不匹配。 3. 未正确开启接收（如未调用`HAL_UART_Receive_IT`）。 4. 中断优先级冲突，导致接收中断被阻塞。	1. 交叉检查TX/RX线。 2. 确保代码和串口助手设置完全一致。 3. 在初始化后调用一次`HAL_UART_Receive_IT(&huart1, &rx_data, 1)`启动中断接收。 4. 在CubeMX的NVIC配置中，为串口接收中断设置一个合适的优先级。
ADC采样值跳动大，不稳定	1. 模拟电源/参考电压不干净。 2. 采样时间太短。 3. 外部信号源阻抗过高。 4. PCB布局布线干扰。	1. 为模拟部分（VDDA）增加滤波电容（如10uF+0.1uF）。 2. 在CubeMX中增加ADC通道的采样周期（Sampling Time）。 3. 对于高阻抗信号，前端增加电压跟随器（运放）进行缓冲。 4. 模拟走线远离数字信号线，特别是高频时钟线。
使用FreeRTOS或LWIP等中间件时，程序运行异常	1. 系统堆栈（Heap）大小不足。 2. SysTick定时器被HAL库和RTOS重复配置冲突。 3. 中断优先级配置冲突。	1. 在`startup_stm32f1xx.s`或CubeMX的`Project Manager -> Advanced Settings`中增大堆（Heap）的大小。 2. 在CubeMX生成FreeRTOS代码时，它会自动处理SysTick。确保在`FreeRTOS`配置中正确设置了时钟源和频率。 3. FreeRTOS要求SysTick和PendSV中断的优先级为最低，需在CubeMX的NVIC配置中检查。

最后，分享一个我个人的深刻体会：STM32开发，官方的数据手册（Datasheet）、参考手册（Reference Manual）和HAL库的用户手册（UM）是你最好的朋友。遇到任何外设配置或函数使用的疑问，第一反应应该是去查阅这些文档，而不是盲目搜索零碎的博客。CubeMX生成的代码注释里，也常常包含了相关参考手册的章节号（如@brief Initializes the USART according to the specified parameters in the USART_InitTypeDef. @note Refer to Reference manual for details about USART initialization sequence.），跟着它去读手册，是提升嵌入式功力的不二法门。从点灯到驱动复杂的传感器、显示屏，再到跑起RTOS实现多任务，每一步的成长都离不开动手尝试和查阅文档。