第3章 开发环境搭建：硬件平台选择、IDE配置与基础工程模板
说实话，做嵌入式开发这么多年，我见过太多人在环境搭建这一步就栽了跟头。不是工具链装不上，就是工程模板配不对，折腾一整天还没开始写一行代码。这一章，我就带你把这些坑都填平。
3.1 硬件平台怎么选？STM32 vs ESP32
很多新手会纠结：到底选STM32还是ESP32？我的建议很直接——看你的项目需求。
| 对比项 | STM32（以F4/H7为例） | ESP32（以ESP32-S3为例） |
|---|---|---|
| 内核 | Cortex-M4/M7 | Xtensa LX7双核 |
| 主频 | 168MHz ~ 480MHz | 240MHz |
| SRAM | 192KB ~ 1MB | 512KB |
| WiFi/BLE | 需外挂 | 内置 |
| 生态成熟度 | 工业级，文档齐全 | 物联网，社区活跃 |
| 裸机开发友好度 | ★★★★★ | ★★★☆☆ |
我个人习惯：做工业控制、传感器采集这类对实时性要求高的项目，首选STM32。它的中断响应、定时器精度、DMA通道数，都是为裸机事件驱动量身打造的。而如果项目需要联网、OTA升级，ESP32确实方便，但它的FreeRTOS是默认跑起来的，想完全裸机反而要多费些功夫。
3.2 IDE配置：从零搭建开发环境
IDE这块，我推荐Keil MDK或者STM32CubeIDE。前者是老牌工具，后者是ST官方出品，免费且集成了CubeMX。我个人更倾向Keil，因为它的调试器用起来顺手，编译速度也快。
3.2.1 Keil MDK安装要点
- 版本选择： 建议用MDK 5.38或更高版本。太老的版本对Cortex-M7支持不好。
- 器件包： 安装对应芯片的DFP（Device Family Pack）。比如STM32F4系列就装Keil.STM32F4xx_DFP.2.17.1.pack。
- 编译器： 默认用ARM Compiler 6（基于Clang），比ARMCC 5快不少。但要注意，有些老代码可能不兼容AC6。
- 调试器： 我用的是J-Link，稳定。ST-Link也行，但偶尔会掉线。
3.2.2 工程模板结构
我不喜欢用CubeMX自动生成的工程，太臃肿了。我自己维护了一套极简模板，结构如下：
project_root/
├── app/ # 应用层代码
│ ├── main.c
│ ├── event_dispatch.c
│ └── event_dispatch.h
├── bsp/ # 板级支持包
│ ├── bsp_led.c
│ ├── bsp_led.h
│ ├── bsp_uart.c
│ └── bsp_uart.h
├── driver/ # 外设驱动
│ ├── stm32f4xx_gpio.c
│ ├── stm32f4xx_usart.c
│ └── stm32f4xx_it.c
├── startup/ # 启动文件
│ └── startup_stm32f407xx.s
├── linker/ # 链接脚本
│ └── STM32F407VETx_FLASH.ld
└── Makefile # 或者Keil工程文件你看，这个结构很清晰。app层放事件调度逻辑，bsp层封装板级外设，driver层是ST的标准库或HAL库。各层之间单向依赖，app不直接调用driver，而是通过bsp中转。这样做的好处是——换板子时只需要改bsp层。
3.3 基础工程模板：让LED先亮起来
环境搭好了，第一件事就是点灯。别笑，点灯是嵌入式界的"Hello World"。它能验证你的工具链、下载器、GPIO配置全部正常。
3.3.1 最小系统代码
下面这个例子，我故意没用HAL库，而是直接操作寄存器。为什么？因为事件驱动架构要求你对硬件有绝对的控制力，HAL库的封装有时候会掩盖细节。
// main.c - 事件驱动裸机最小系统
#include "stm32f4xx.h"
// 事件标志位
volatile uint32_t g_events = 0;
#define EVENT_LED_TOGGLE (1 << 0)
// 定时器中断服务函数
void TIM2_IRQHandler(void)
{
if (TIM_GetITStatus(TIM2, TIM_IT_Update))
{
TIM_ClearITPendingBit(TIM2, TIM_IT_Update);
g_events |= EVENT_LED_TOGGLE; // 设置事件标志
}
}
int main(void)
{
// 初始化系统时钟
SystemInit();
// 初始化GPIO - 直接操作寄存器
RCC->AHB1ENR |= RCC_AHB1ENR_GPIODEN;
GPIOD->MODER |= (1 << 24); // PD12推挽输出
GPIOD->OTYPER &= ~(1 << 12);
// 配置TIM2定时器
RCC->APB1ENR |= RCC_APB1ENR_TIM2EN;
TIM2->PSC = 16000 - 1; // 16MHz / 16000 = 1KHz
TIM2->ARR = 1000 - 1; // 1KHz / 1000 = 1Hz
TIM2->DIER |= TIM_DIER_UIE;
TIM2->CR1 |= TIM_CR1_CEN;
NVIC_EnableIRQ(TIM2_IRQn);
// 事件循环
while (1)
{
if (g_events & EVENT_LED_TOGGLE)
{
g_events &= ~EVENT_LED_TOGGLE;
GPIOD->ODR ^= (1 << 12); // 翻转LED
}
}
}3.4 知识体系总览
为了让你对整个开发环境有个全局认识，我画了张图。它把硬件、工具链、工程结构、运行流程串在了一起。
3.5 验证你的环境
模板建好了，怎么验证它能不能用？我一般按这个步骤来：
- 编译： 按F7，看0 Error 0 Warning。如果有报错，八成是器件包没装对或者启动文件版本不匹配。
- 下载： 用J-Flash或者Keil的Download按钮。如果提示"No Cortex-M SW Device Found"，检查一下SWD接线，或者看看板子是不是进入了休眠模式。
- 运行： 复位后LED应该以1Hz的频率闪烁。如果不闪，先查时钟配置，再查GPIO模式。
嗯，环境搭建这部分就到这里。你跟着走一遍，应该半小时内就能让LED闪起来。有了这个基础，后面的事件驱动架构才能有地方跑。记住，工具是死的，思路是活的。别在环境上纠结太久，赶紧动手试试吧。