1. 课程导论与开发环境搭建
1.1 为什么需要软件架构？
很多初学者拿到STM32，第一件事就是往main函数里堆代码。点亮LED、读取按键、驱动传感器……全塞在一个while循环里。项目小的时候还能跑，一旦功能多起来，问题就来了：改一个定时器参数，串口莫名其妙不工作了；加一个传感器驱动，系统响应变慢了。
我早期做项目时就吃过这个亏。那是一个工业数据采集器，功能不算复杂，但客户要求后期能扩展。我图省事，所有逻辑都写在main.c里。结果客户要加一个协议转换功能，我改了三天，改出了五个bug。从那以后，我再也不敢轻视软件架构了。
软件架构的核心价值：
- 模块化 —— 每个功能独立成模块，互不干扰
- 可移植性 —— 换芯片平台时，业务逻辑代码几乎不用改
- 可调试性 —— 出问题能快速定位到具体模块
- 可维护性 —— 新同事接手代码，一周内能上手
说白了，软件架构就是给代码定规矩。你想想看，盖房子没有图纸能行吗？写单片机程序也一样。裸机虽然没有操作系统，但我们可以自己搭一套“轻量级框架”，把硬件驱动、中间件、业务逻辑分层管理。
这套课程要做的，就是带着你从零开始，搭建一套真正能用在项目里的STM32裸机架构。不是讲理论，是实战。
1.2 STM32CubeIDE 安装与配置
工欲善其事，必先利其器。我们选STM32CubeIDE作为开发环境。为什么选它？因为它是ST官方出品，免费，而且集成了CubeMX配置工具。你不需要在CubeMX和IDE之间来回切换，一个软件全搞定。
安装步骤
- 下载安装包 —— 去ST官网搜索STM32CubeIDE，选择对应操作系统版本。我建议下载最新稳定版，别追beta版。
- 运行安装程序 —— 一路默认选项即可。安装路径不要带中文，这是老生常谈了。
- 选择工作空间 —— 启动时会让你选workspace路径。我个人习惯在D盘建一个
STM32_Workspace文件夹，和项目代码分开存放。 - 安装固件包 —— 首次创建项目时，IDE会提示下载对应芯片的固件包。网络不好的话，可以手动下载后导入。
小技巧： 如果你在公司内网，代理设置要提前配好。Window → Preferences → General → Network Connections，把代理填进去。不然下载固件包会卡死。
创建第一个工程
打开STM32CubeIDE，点击 File → New → STM32 Project。选择你的芯片型号，比如我们课程用的STM32F407VET6。然后会进入CubeMX配置界面——这里可以配置时钟、外设、引脚等。
我建议初学者先别急着改配置，直接点生成代码。看看IDE自动生成了哪些文件，熟悉一下目录结构。后面我们会一步步改造它。
1.3 调试工具链准备
写代码只是第一步，调试才是重头戏。没有调试器，你就像蒙着眼睛修车。我们课程主要用两种调试器：J-Link 和 ST-Link。
| 调试器 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| J-Link | 速度快，功能强，支持断点多 | 价格较高，正版贵 | 项目开发、性能调试 |
| ST-Link | 便宜，STM32开发板自带 | 速度一般，断点有限 | 学习、简单调试 |
我个人建议：学习阶段用ST-Link完全够用。等做项目了，再考虑J-Link。不过要注意，市面上很多便宜的J-Link是盗版，固件容易升级失败。我曾经买过一个，用了两个月就变砖了……
连接与验证
把调试器连接到开发板的SWD接口。标准接法是：
- SWDIO → 数据线
- SWCLK → 时钟线
- GND → 地线
- 3.3V → 电源（可选，部分调试器可供电）
连接好后，在STM32CubeIDE里配置调试器：Run → Debug Configurations → 选择你的工程 → Debugger选项卡。选对调试器类型，点击Debug。如果能正常下载并进入调试界面，说明环境搭建成功。
注意： 如果提示“No target connected”，先检查接线。我遇到过好几次，都是SWDIO和SWCLK接反了。另外，有些开发板需要按住复位键再点击下载，松手后才能连接。这是硬件设计问题，不是你的错。
1.4 本章知识体系
下面这张图，概括了本章的核心内容。你可以把它当作一张“地图”，后面每章都会在这张图上添加新的模块。
1.5 本章小结
这一章我们做了三件事：
- 理解了软件架构的重要性 —— 它不是花架子，是让你少加班的利器
- 装好了STM32CubeIDE —— 开发环境就位，能创建工程了
- 准备好了调试工具 —— J-Link或ST-Link，能连上目标板了
环境搭好了，后面才能放开手脚写代码。下一章，我们会正式开始搭建软件架构的第一层：硬件抽象层。到时候你会看到，好的架构是怎么把硬件细节“藏”起来的。
嗯，先到这里。去喝杯水，准备迎接后面的实战内容。