2. 嵌入式系统与BSP概述

说实话，做嵌入式BSP开发，第一步不是写代码，而是把“家伙事儿”备齐。我见过太多新手卡在环境搭建上，一卡就是半天，最后发现是工具链版本不对，或者调试器驱动没装好。这一章，咱们就把这些基础工作捋清楚。

本章核心目标：搭建一个可复用的BSP开发环境，包括交叉编译工具链、调试器（JLink/ST-Link）配置，以及Makefile和CMake工程模板。完成后，你能从零开始编译、烧录、调试一个裸机程序。

2.1 交叉编译工具链：为什么需要它？

你想想看，你的电脑是x86架构，而嵌入式芯片通常是ARM、RISC-V或者MIPS。x86上编译出来的程序，ARM芯片跑不了。怎么办？交叉编译就是干这个的——在x86主机上生成目标芯片能执行的机器码。

我个人习惯用ARM GCC（gcc-arm-none-eabi）。它开源、免费，社区活跃，而且支持所有主流ARM Cortex-M/R/A系列。我曾在项目中遇到过用厂商自带编译器结果优化选项踩坑的情况，换成GCC后问题迎刃而解。

2.1.1 安装步骤（以Ubuntu 22.04为例）

  1. 下载工具链：从ARM官网或Linaro获取预编译包。
  2. 解压到指定目录：我习惯放在 /opt/toolchains/ 下。
  3. 配置环境变量：将bin目录加入 PATH。
# 下载（以gcc-arm-none-eabi-10.3-2021.10为例）
wget https://developer.arm.com/-/media/Files/downloads/gnu-rm/10.3-2021.10/gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2

# 解压
sudo tar -xjf gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2 -C /opt/toolchains/

# 配置环境变量（写入 ~/.bashrc）
export PATH="/opt/toolchains/gcc-arm-none-eabi-10.3-2021.10/bin:$PATH"

# 验证
arm-none-eabi-gcc --version

小提示：如果你用Windows，我建议装WSL2或者直接用MSYS2。别在Windows cmd下硬搞，路径和权限问题会让你怀疑人生。

2.1.2 验证工具链

写一个最简单的main.c，编译看看：

// main.c
int main(void) {
    while(1);
    return 0;
}

arm-none-eabi-gcc -c -mcpu=cortex-m4 -mthumb -o main.o main.c
arm-none-eabi-ld -Ttext=0x08000000 -o main.elf main.o
arm-none-eabi-objcopy -O binary main.elf main.bin

如果没报错，说明工具链能用了。嗯，这里要注意：-mcpu 参数一定要和你芯片的CPU核匹配。我见过有人用Cortex-M0的芯片，却指定了Cortex-M4，编译出来的程序跑起来直接HardFault。

2.2 调试器配置：JLink与ST-Link

调试器是BSP开发的“眼睛”。没有它，你只能靠printf和LED灯猜问题。我个人偏爱JLink，速度快、稳定，但ST-Link胜在便宜、随板附赠。下面分别说。

2.2.1 JLink配置

JLink的驱动和工具包从SEGGER官网下载。安装后，主要用两个工具：JLinkExe（命令行）和JLinkGDBServer（配合GDB调试）。

我曾经在一个量产项目中，因为JLink固件版本太旧，导致无法识别新出的芯片。所以建议：定期更新JLink固件。

# 启动JLink GDB Server（以STM32F407为例）
JLinkGDBServer -device STM32F407VG -if SWD -speed 4000 -port 2331

# 连接成功后，你会看到类似输出：
# Connecting to target...
# Connected to target
# Waiting for GDB connection...

避坑指南：我曾经遇到过JLink连接不上目标板，折腾半天发现是SWD线太长（超过20cm），信号衰减导致。SWD线最好控制在10cm以内，而且不要用杜邦线对插，直接焊上去最稳。

2.2.2 ST-Link配置

ST-Link通常用STM32CubeProgrammer或者OpenOCD来驱动。我个人习惯用OpenOCD，因为它开源、跨平台，而且支持脚本化操作。

# 安装OpenOCD（Ubuntu）
sudo apt-get install openocd

# 启动OpenOCD连接ST-Link（以STM32F103为例）
openocd -f interface/stlink.cfg -f target/stm32f1x.cfg

# 成功后，你会看到：
# Info : STLINK V2J29M27 (API v2) VID:PID 0483:3748
# Info : Target voltage: 3.3V
# Info : stm32f1x.cpu: hardware has 6 breakpoints, 4 watchpoints

这里有个细节：ST-Link的V2版本和V3版本，OpenOCD的配置文件不一样。V2用 stlink.cfg，V3用 stlink-v3.cfg。别搞混了。

2.2.3 调试器对比

特性 JLink ST-Link
速度 最高50 MHz (SWD) 最高4 MHz (SWD)
价格 ￥300~2000+ ￥20~100（随板附赠）
芯片支持 几乎所有ARM芯片 仅STM32/STM8
软件生态 SEGGER全家桶，稳定 OpenOCD + ST工具，够用
推荐场景 量产调试、性能分析 学习、原型验证

2.3 工程模板建立：Makefile与CMake

有了工具链和调试器，接下来就是搭工程框架。我见过有人每次新建项目都从头写Makefile，说实话，没必要。建立一个模板，以后直接复制改改就能用。

2.3.1 Makefile模板

Makefile适合小型项目，简单直接。下面是一个通用的BSP裸机工程Makefile：

# 工具链
CROSS_COMPILE = arm-none-eabi-
CC = $(CROSS_COMPILE)gcc
LD = $(CROSS_COMPILE)ld
OBJCOPY = $(CROSS_COMPILE)objcopy
SIZE = $(CROSS_COMPILE)size

# 目标芯片参数
MCU = cortex-m4
FPU = -mfloat-abi=hard -mfpu=fpv4-sp-d16
TARGET = bsp_demo

# 目录结构
SRC_DIR = src
INC_DIR = inc
BUILD_DIR = build

# 源文件
SRCS = $(wildcard $(SRC_DIR)/*.c)
OBJS = $(SRCS:$(SRC_DIR)/%.c=$(BUILD_DIR)/%.o)

# 编译参数
CFLAGS = -mcpu=$(MCU) -mthumb $(FPU) -Wall -O2 -g
CFLAGS += -I$(INC_DIR)
LDFLAGS = -T linker.ld -nostartfiles

# 默认目标
all: $(BUILD_DIR)/$(TARGET).bin

# 编译规则
$(BUILD_DIR)/%.o: $(SRC_DIR)/%.c | $(BUILD_DIR)
	$(CC) $(CFLAGS) -c $< -o $@

# 链接
$(BUILD_DIR)/$(TARGET).elf: $(OBJS)
	$(CC) $(CFLAGS) $(LDFLAGS) $^ -o $@
	$(SIZE) $@

# 生成bin
$(BUILD_DIR)/$(TARGET).bin: $(BUILD_DIR)/$(TARGET).elf
	$(OBJCOPY) -O binary $< $@

# 创建build目录
$(BUILD_DIR):
	mkdir -p $@

# 清理
clean:
	rm -rf $(BUILD_DIR)

# 烧录（通过OpenOCD）
flash: $(BUILD_DIR)/$(TARGET).bin
	openocd -f interface/stlink.cfg -f target/stm32f4x.cfg \
		-c "program $(BUILD_DIR)/$(TARGET).bin 0x08000000" \
		-c "reset run" -c "exit"

.PHONY: all clean flash

个人习惯：我会在Makefile里加一个 debug 目标，自动启动JLink GDB Server并连接GDB。这样一条命令就能进调试，省得每次敲一堆命令。

2.3.2 CMake模板

项目大了以后，Makefile维护起来很痛苦。CMake是更好的选择，尤其是当你要支持多个芯片型号、多个编译配置时。

# CMakeLists.txt
cmake_minimum_required(VERSION 3.16)
project(bsp_demo C ASM)

# 设置工具链
set(CMAKE_SYSTEM_NAME Generic)
set(CMAKE_SYSTEM_PROCESSOR arm)

set(TOOLCHAIN_PREFIX arm-none-eabi-)
set(CMAKE_C_COMPILER ${TOOLCHAIN_PREFIX}gcc)
set(CMAKE_ASM_COMPILER ${TOOLCHAIN_PREFIX}gcc)

# 目标芯片参数
set(MCU cortex-m4)
set(FPU "-mfloat-abi=hard -mfpu=fpv4-sp-d16")

# 编译选项
set(CMAKE_C_FLAGS "-mcpu=${MCU} -mthumb ${FPU} -Wall -O2 -g")
set(CMAKE_EXE_LINKER_FLAGS "-T${CMAKE_SOURCE_DIR}/linker.ld -nostartfiles")

# 源文件
file(GLOB_RECURSE SOURCES "src/*.c" "src/*.s")

# 头文件路径
include_directories(inc)

# 生成目标
add_executable(${PROJECT_NAME}.elf ${SOURCES})

# 生成bin文件
add_custom_command(TARGET ${PROJECT_NAME}.elf POST_BUILD
    COMMAND ${TOOLCHAIN_PREFIX}objcopy -O binary
    ${PROJECT_NAME}.elf ${PROJECT_NAME}.bin
)

# 烧录
add_custom_target(flash
    COMMAND openocd -f interface/stlink.cfg -f target/stm32f4x.cfg
        -c "program ${PROJECT_NAME}.bin 0x08000000"
        -c "reset run" -c "exit"
    DEPENDS ${PROJECT_NAME}.elf
)

使用CMake时，我喜欢建一个 build 目录做out-of-source构建：

mkdir build && cd build
cmake ..
make

2.3.3 Makefile vs CMake 怎么选？

维度 Makefile CMake
学习曲线 低，语法简单 中等，概念多
跨平台 需手动适配 原生支持
多配置管理 麻烦（Debug/Release） 内置支持
IDE集成 一般 VS Code/CLion完美支持
推荐项目规模 单文件~10个文件 10个文件以上

我个人建议：学习阶段用Makefile，能帮你理解编译链接的每个步骤。实际项目用CMake，维护成本低得多。

2.4 本章知识体系总览

下面这张图，把本章的核心知识点串起来了。你可以把它当作环境搭建的“检查清单”。

开发环境搭建知识体系 交叉编译工具链 调试器配置 工程模板 ARM GCC安装 环境变量配置 JLink配置 ST-Link配置 Makefile模板 CMake模板 输出：可编译、烧录、调试的BSP工程 关键检查点 1. 工具链版本与芯片架构匹配（ARMv7-M / ARMv8-M 等） 2. 调试器固件版本与OpenOCD/JLink驱动兼容 3. 工程模板中的链接脚本（linker.ld）与芯片内存映射一致 4. 烧录地址是否正确（通常为Flash起始地址，如0x08000000）

2.5 验证环境：一个完整的“点灯”流程

环境搭好没，跑个点灯程序就知道了。这是嵌入式界的“Hello World”。

  1. 编写代码：在 src/main.c 里写GPIO控制代码。
  2. 编译：执行 make 或 cmake --build .，生成 .bin 文件。
  3. 烧录：执行 make flash 或 cmake --build . --target flash。
  4. 观察：如果LED亮了，恭喜你，环境搭建成功！

我曾经遇到过一个坑：烧录成功后LED不亮，查了半天发现是GPIO时钟没使能。很多新手会忽略这一步——STM32的GPIO需要先开启对应的AHB/APB时钟才能用。记得在初始化代码里加上 RCC->AHB1ENR |= RCC_AHB1ENR_GPIOxEN。

好了，环境搭建就到这里。工具链、调试器、工程模板，这三样东西备齐了，后面的BSP开发才能顺畅。记住：磨刀不误砍柴工，花点时间把环境搞稳定，比后面反复折腾要划算得多。

← 上一章 📖 返回目录 下一章 →