1. 课程导学与开发环境搭建
1.1 为什么需要分层架构？
做嵌入式开发这些年，我见过太多工程师把代码写成「一锅粥」。应用逻辑、寄存器操作、延时函数全混在一个文件里。项目小的时候还好，一旦产品迭代到第三版、第四版，改一个需求就得翻遍整个工程，那滋味……嗯，谁改谁知道。
分层架构说白了就是「各司其职」。我们把MCU的代码拆成三层：
- 硬件抽象层（HAL）：封装寄存器操作，提供统一的API。换芯片？只改这一层。
- 中间件层：协议栈、文件系统、RTOS等通用组件。不依赖具体硬件。
- 应用层：业务逻辑。调用中间件和HAL的接口，不直接碰寄存器。
我在一个工业控制项目里吃过亏——客户中途要求换MCU型号，因为代码耦合太紧，整整花了三周才移植完。后来重构为分层架构，同样的换型只用了两天。你想想看，这个时间成本差了多少？
课程核心目标：学完这一章，你能搭建一套可复用的分层工程模板，并验证调试器通信正常。后续29章的所有实战都基于这个环境。
1.2 开发板与工具链概览
本课程选用的是STM32F407VGT6开发板，Cortex-M4内核，带FPU。为什么选它？因为这款芯片在工业、消费电子领域覆盖面极广，而且它的外设资源足够演示我们后面要讲的所有中间件。
| 项目 | 参数 | 备注 |
|---|---|---|
| MCU型号 | STM32F407VGT6 | Cortex-M4 @168MHz |
| Flash/RAM | 1MB / 192KB | 足够跑FreeRTOS + LwIP |
| 调试器 | J-Link / ST-Link | 本课程以J-Link为主演示 |
| IDE | Keil MDK v5.38 / IAR EWARM v9.40 | 二选一，配置流程类似 |
我的建议：如果你手头有其他Cortex-M3/M4的开发板，也可以跟着学。HAL层的接口设计是通用的，换芯片只需要重写底层几个文件。
1.3 IDE安装与工程模板创建
安装过程我就不一步步截图了，网上的教程一抓一大把。我重点说几个容易踩坑的地方。
Keil MDK安装要点
- 安装路径不要带中文和空格。我见过有人装在「Program Files (x86)」里，结果编译某些组件时报路径错误。
- 安装完成后，务必通过Pack Installer安装STM32F4xx_DFP设备包。版本选2.17.0以上。
- License激活用管理员权限运行Keil，否则激活失败。
IAR EWARM安装要点
- IAR对中文路径更敏感，建议直接装到
C:\IAR_Projects\这类纯英文目录。 - 注册时选择「Offline Activation」，把生成的License文件保存好。
- 第一次打开工程时，IAR会提示安装器件支持包，点同意就行。
曾经有个学员：装完Keil后直接打开例程，发现编译报错「cannot open source file "stm32f4xx.h"」。检查了半天，原来是Pack没装。记住：先装IDE，再装Pack，最后导入工程。顺序错了就会出这种问题。
1.4 调试器连接验证
环境搭好了，怎么知道能不能用？写个点灯程序太慢，我一般直接读MCU的ID码来验证调试器通信。
操作步骤：
- 用SWD线连接开发板和J-Link。注意：VCC、GND、SWDIO、SWCLK四根线必须接对。SWO可选，不接也能调试。
- 打开Keil，点击「Project → Options for Target → Debug」选项卡，选择「J-LINK/J-TRACE Cortex」。
- 点击「Settings」，如果能读到Device ID和IDCODE，说明连接成功。
// 验证代码：读取MCU唯一ID
#include "stm32f4xx.h"
void Read_MCU_ID(void)
{
uint32_t *pUID = (uint32_t *)0x1FFF7A10;
printf("MCU Unique ID: %08X %08X %08X\r\n",
pUID[0], pUID[1], pUID[2]);
}如果读出来全是0xFFFFFFFF或者0x00000000，大概率是接线问题。我遇到过最奇葩的一次——SWDIO和SWCLK接反了，折腾了半小时才发现。
1.5 本章知识体系
下面这张图概括了本章的核心逻辑。你可以把它当作整个课程的「地图」：
1.6 常见问题与避坑指南
我曾经遇到一个典型问题：J-Link能识别到设备，但下载程序时提示「Flash Download failed - Target DLL has been cancelled」。排查下来是Keil的Flash算法选错了——STM32F407要用「STM32F4xx 1MB Flash」算法，而不是默认的「STM32F10x」。你可以在「Target → Flash Download → Add」里手动选择。
小技巧：第一次连接调试器时，建议用J-Link Commander（命令行工具）先跑一遍 connect 命令。如果能正常读到芯片信息，说明硬件接线没问题。这时候再去IDE里配置，可以快速定位是IDE设置问题还是硬件问题。
好了，环境搭建就到这里。记住：调试器能读到ID码，你的开发环境就准备好了。后面所有章节的代码，都会基于这个工程模板来扩展。