Skip to content

环境搭建与第一个工程 ​

目标很明确:从空目录开始,编译出一个能下载、能打印的工程。这一步没打通,后面所有实验都会停在「跑不起来」。

工具链怎么选 ​

方案组成优点缺点
Keil MDKµVision + ARMCC/AC6上手快、调试器集成好、教程多商业授权,跨平台差
GCC + Makearm-none-eabi-gcc + Makefile免费、可脚本化、贴近 Linux 工作流需自己维护构建脚本
PlatformIOVSCode 插件依赖自动管理、多平台统一抽象层厚,出问题难定位

建议:先用 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 sizetext + 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 的四种配置和按键消抖一次做完。

以资料沉淀经验,用产品验证想法 · 嵌入式资料与产品文档