2. 移植环境搭建：交叉编译工具链配置与裸机工程验证

好，咱们正式开始动手了。这一章我带你把开发环境搭起来。说实话，环境搭建这事儿看着琐碎，但真踩过坑的人都知道——工具链版本不对、调试器驱动没装好，能卡你整整一天。我个人习惯是先把地基打牢，后面移植RTOS时才不会手忙脚乱。

2.1 交叉编译工具链：GCC for ARM/RISC-V

先说说交叉编译。你想想看，咱们的PC是x86架构，但目标芯片是ARM或RISC-V。PC上编译出来的二进制，得让ARM芯片能跑。这就需要交叉编译工具链。

ARM GCC工具链

我推荐用ARM官方维护的gcc-arm-none-eabi。为什么？因为它是专门针对裸机和RTOS的，没有Linux底层那套东西，干净利落。

下载与安装（以Ubuntu 20.04为例）

# 下载ARM GCC 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

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

# 添加环境变量
echo 'export PATH=$PATH:/opt/gcc-arm-none-eabi-10.3-2021.10/bin' >> ~/.bashrc
source ~/.bashrc

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

嗯，这里要注意：版本号别追最新。我在项目中遇到过，太新的工具链对某些老芯片支持反而不好。10.3这个版本经过大量验证，稳得很。

RISC-V GCC工具链

RISC-V这边稍微复杂点。官方推荐的是riscv64-unknown-elf-gcc。如果你用的是芯来科技或平头哥的芯片，他们通常提供定制版工具链。

# 下载RISC-V GNU工具链
git clone https://github.com/riscv-collab/riscv-gnu-toolchain
cd riscv-gnu-toolchain

# 配置为裸机模式（不带Linux）
./configure --prefix=/opt/riscv --with-arch=rv32imc --with-abi=ilp32
make -j4

# 验证
riscv64-unknown-elf-gcc --version

我的经验：RISC-V的ABI选择容易搞错。rv32imc配ilp32是常见组合。如果你芯片带浮点单元，记得改成ilp32f或ilp32d。我刚开始玩RISC-V时，就因为ABI选错，编译出来的程序一跑就崩。

2.2 硬件调试器：J-Link与ST-Link驱动安装

工具链搞定，接下来是调试器。调试器就是你的眼睛，没有它，你只能靠猜。

J-Link（SEGGER）

J-Link是我用得最多的调试器。它支持ARM全系列，速度也快。

# 下载J-Link Linux安装包
wget https://www.segger.com/downloads/jlink/JLink_Linux_V794e_x86_64.deb

# 安装
sudo dpkg -i JLink_Linux_V794e_x86_64.deb

# 安装后检查
JLinkExe -v

驱动装好后，插上J-Link，运行JLinkExe，如果能识别到芯片，说明驱动没问题。

避坑指南：我曾经因为USB线质量差，导致J-Link频繁掉线。换了根带屏蔽的USB线，问题立刻解决。调试器对USB线材很敏感，别在这上面省钱。

ST-Link（STMicroelectronics）

ST-Link是STM32开发板自带的调试器。如果你用STM32系列芯片，它是最方便的选择。

# 安装ST-Link工具（开源版）
sudo apt-get install stlink-tools

# 验证
st-info --version

# 连接开发板后查看信息
st-info --probe

ST-Link的驱动在Linux下基本是免驱的。Windows下需要装ST官方驱动，这个我就不展开了。

2.3 裸机工程模板：从零搭建LED闪烁

工具链和调试器都就位了。接下来，咱们建一个裸机工程模板。说白了，就是让芯片先跑起来，点个灯。这是嵌入式开发的"Hello World"。

工程目录结构

我个人习惯这样组织代码：

project/
├── startup/          # 启动文件
│   └── startup_stm32f407xx.s
├── src/              # 源代码
│   └── main.c
├── inc/              # 头文件
│   └── main.h
├── ld/               # 链接脚本
│   └── stm32f407xx.ld
├── Makefile          # 编译脚本
└── README.md

启动文件（startup_stm32f407xx.s）

启动文件是芯片上电后执行的第一段代码。它负责设置堆栈指针、初始化中断向量表、最后跳转到main函数。

.syntax unified
.cpu cortex-m4
.fpu softvfp
.thumb

.global vectors
.global Reset_Handler

.section .isr_vector, "a", %progbits
vectors:
    .word _estack
    .word Reset_Handler
    .word NMI_Handler
    // ... 其他中断向量

.section .text.Reset_Handler
.weak Reset_Handler
.type Reset_Handler, %function
Reset_Handler:
    ldr r0, =_estack
    mov sp, r0
    bl main
    b .

链接脚本（stm32f407xx.ld）

链接脚本告诉链接器：代码放哪里，数据放哪里。这个写错了，程序跑不起来。

MEMORY
{
    FLASH (rx) : ORIGIN = 0x08000000, LENGTH = 1024K
    RAM (xrw) : ORIGIN = 0x20000000, LENGTH = 128K
}

SECTIONS
{
    .isr_vector : {
        . = ALIGN(4);
        KEEP(*(.isr_vector))
        . = ALIGN(4);
    } > FLASH

    .text : {
        . = ALIGN(4);
        *(.text)
        *(.text*)
        . = ALIGN(4);
    } > FLASH

    // ... 其他段
}

主程序（main.c）

终于到点灯环节了。以STM32F407为例，控制GPIO输出高低电平：

#include "stm32f4xx.h"

void delay(volatile uint32_t count) {
    while (count--) {
        __NOP();
    }
}

int main(void) {
    // 使能GPIOD时钟
    RCC->AHB1ENR |= RCC_AHB1ENR_GPIODEN;

    // 配置PD12为推挽输出
    GPIOD->MODER |= GPIO_MODER_MODER12_0;
    GPIOD->OTYPER &= ~GPIO_OTYPER_OT_12;
    GPIOD->OSPEEDR |= GPIO_OSPEEDER_OSPEEDR12;

    while (1) {
        GPIOD->BSRR = GPIO_BSRR_BS_12;   // 点亮LED
        delay(500000);
        GPIOD->BSRR = GPIO_BSRR_BR_12;   // 熄灭LED
        delay(500000);
    }
}

Makefile

有了Makefile，一键编译：

TARGET = led_blink
CC = arm-none-eabi-gcc
OBJCOPY = arm-none-eabi-objcopy

CFLAGS = -mcpu=cortex-m4 -mthumb -mfloat-abi=soft
CFLAGS += -O0 -g -Wall -std=c99
CFLAGS += -Iinc

LDFLAGS = -T ld/stm32f407xx.ld -specs=nano.specs

SRCS = src/main.c startup/startup_stm32f407xx.s
OBJS = $(SRCS:.c=.o)

all: $(TARGET).bin

$(TARGET).elf: $(OBJS)
    $(CC) $(CFLAGS) $(LDFLAGS) -o $@ $^

$(TARGET).bin: $(TARGET).elf
    $(OBJCOPY) -O binary $< $@

%.o: %.c
    $(CC) $(CFLAGS) -c -o $@ $<

clean:
    rm -f $(OBJS) $(TARGET).elf $(TARGET).bin

flash: $(TARGET).bin
    st-flash write $(TARGET).bin 0x08000000

验证步骤：

  1. 执行make，生成led_blink.bin
  2. 连接ST-Link到开发板
  3. 执行make flash，烧录到芯片
  4. 按下复位键，观察LED是否以约1Hz频率闪烁

2.4 常见问题与排查

问题现象 可能原因 解决方案
编译报错"arm-none-eabi-gcc: command not found" 环境变量未配置 检查PATH是否包含工具链bin目录
烧录后LED不亮 GPIO引脚配置错误 核对芯片手册，确认引脚号和寄存器地址
J-Link无法识别芯片 接线错误或电压不匹配 检查SWDIO/SWCLK接线，确认目标板供电
程序跑飞 堆栈设置错误 检查链接脚本中_estack是否指向RAM末尾

我的调试习惯：第一次点灯失败时，别急着改代码。先用调试器读一下芯片的IDCODE，确认调试器确实连上了芯片。然后单步执行，看程序是否进入了main函数。这一步能排除90%的硬件连接问题。

好了，环境搭建就到这儿。你现在应该有一个能编译、烧录、验证的裸机工程模板了。下一章，咱们就在这个模板上，把FreeRTOS移植进来。到时候你会发现，地基打得牢，后面盖楼就快得多。

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