主题
环境搭建与第一个工程
目标很明确:从空目录开始,编译出一个能下载、能打印的工程。这一步没打通,后面所有实验都会停在「跑不起来」。
工具链怎么选
| 方案 | 组成 | 优点 | 缺点 |
|---|---|---|---|
| Keil MDK | µVision + ARMCC/AC6 | 上手快、调试器集成好、教程多 | 商业授权,跨平台差 |
| GCC + Make | arm-none-eabi-gcc + Makefile | 免费、可脚本化、贴近 Linux 工作流 | 需自己维护构建脚本 |
| PlatformIO | VSCode 插件 | 依赖自动管理、多平台统一 | 抽象层厚,出问题难定位 |
建议:先用 Keil 建立「能跑」的信心,再用 GCC 建立「懂构建」的能力。想转 Linux 方向,GCC 这条路必须走一遍。
工程目录
text
blinky/
├── Makefile
├── linker/
│ └── stm32f103c8.ld # 链接脚本(厂商或社区提供)
├── startup/
│ └── startup_stm32f103.s # 启动文件:向量表 + Reset_Handler
├── inc/
│ ├── board.h
│ └── stm32f103_regs.h # 寄存器定义
└── src/
├── main.c
└── board.c把「芯片相关」和「业务相关」分开,是后续换芯片时唯一能省下大量时间的做法。
最小 Makefile
makefile
PREFIX = arm-none-eabi-
CC = $(PREFIX)gcc
OBJCOPY = $(PREFIX)objcopy
SIZE = $(PREFIX)size
MCU = -mcpu=cortex-m3 -mthumb
CFLAGS = $(MCU) -Wall -Wextra -O2 -g -std=c11 \
-ffunction-sections -fdata-sections -Iinc
LDFLAGS = $(MCU) -Tlinker/stm32f103c8.ld -Wl,--gc-sections -Wl,-Map=build/app.map
SRCS = src/main.c src/board.c
OBJS = $(SRCS:src/%.c=build/%.o)
TARGET = build/app
all: $(TARGET).bin
build/%.o: src/%.c
@mkdir -p build
$(CC) $(CFLAGS) -c $< -o $@
$(TARGET).elf: $(OBJS) startup/startup_stm32f103.o
$(CC) $(LDFLAGS) $^ -o $@
$(TARGET).bin: $(TARGET).elf
$(OBJCOPY) -O binary $< $@
$(SIZE) $<
clean:
rm -rf build关键选项说明:
-ffunction-sections -fdata-sections+--gc-sections:把未使用的函数裁掉,小 Flash 芯片必开。-O2配合volatile:优化级别越高,缺volatile的 bug 越容易暴露(也越难查)。-g:保留调试信息,.elf才能对应到源码行。
编译与下载
bash
make # 生成 build/app.bin 与 app.elf
make size # 查看 Flash / RAM 占用下载可以走两条路:
bash
# 1) 命令行(ST-Link)
st-flash write build/app.bin 0x08000000
# 2) OpenOCD
openocd -f interface/stlink.cfg -f target/stm32f1x.cfg \
-c "program build/app.elf verify reset exit"先确认向量表地址
0x08000000 是 STM32 的 Flash 起始地址。换芯片(尤其是带 Bootloader 的方案)时,偏移量必须与链接脚本、VTOR 设置三者一致,否则下载成功但不运行。
printf 重定向
调试输出的第一步。以 GCC + newlib 为例,重写 _write:
c
#include <errno.h>
#include <sys/stat.h>
int _write(int fd, const char *buf, int len)
{
(void)fd;
for (int i = 0; i < len; i++) {
uart_send_byte((unsigned char)buf[i]); /* 阻塞发送,仅用于调试 */
}
return len;
}Keil 环境下则重写 fputc:
c
int fputc(int ch, FILE *f)
{
(void)f;
uart_send_byte((unsigned char)ch);
return ch;
}栈空间
printf 走 newlib 时栈需求可能超过 1KB。小资源芯片(如 4KB SRAM)上,建议改用精简的 printf 实现或只做整数格式化,否则会出现「一打印就 HardFault」。
验证标准
按顺序确认,全部通过才算环境就绪:
| 步骤 | 期望结果 |
|---|---|
make | 无 warning 通过,输出 bin/elf |
make size | text + data 未超出 Flash 容量 |
| 下载 | 工具报告 verify 成功 |
| 运行 | LED 按 1Hz 闪烁 |
| 串口 | 复位后打印版本号与启动信息 |
| 调试 | 能打断点、能观察局部变量 |
常见编译错误
| 报错 | 原因 | 处理 |
|---|---|---|
undefined reference to '_start' | 缺少启动文件或链接脚本 | 把 startup_*.s 加入编译 |
region 'FLASH' overflowed | 代码超过 Flash | 开 -Os,裁库,去掉浮点打印 |
region 'RAM' overflowed | 全局变量过大 | 减少大数组,改用 const 放 Flash |
multiple definition of ... | 头文件里定义了变量 | 头文件只放 extern,定义放 .c |
implicit declaration of function | 缺头文件 | 补 #include,别依赖隐式声明 |
下一步
环境通了就去GPIO 点灯实战,把 IO 的四种配置和按键消抖一次做完。