3. 裸机开发环境搭建

RISC-V 裸机开发的第一步，不是写代码，而是把“从源码到芯片上运行”的整条工具链打通。与在操作系统上写应用不同，裸机程序没有现成的 C 运行环境、没有动态链接器、没有默认的入口地址，甚至连栈指针都要自己设置。因此，本章围绕一条完整的构建与调试链路展开：工具链安装 → 交叉编译 → 链接脚本 → 启动流程 → 调试器与仿真器。理解这条链路，后续所有外设驱动才有稳定的落地基础。

一、核心原理：为什么裸机需要“交叉”工具链

宿主机通常是 x86_64 的 Linux 或 Windows，而目标芯片是 RISC-V 架构。宿主机上的 gcc 生成的是 x86 指令，无法在 RISC-V 上执行，所以必须使用 riscv64-unknown-elf-gcc 或 riscv32-unknown-elf-gcc 这类交叉编译器。它包含一整套工具：编译器、汇编器、链接器、objcopy、objdump、gdb 等。

裸机程序与 Linux 应用最大的区别在于“没有操作系统兜底”。Linux 应用由内核加载，入口是 _start，栈由内核分配；而裸机程序上电后，CPU 从复位向量取第一条指令，此时内存、时钟、栈都未初始化。因此，链接脚本决定代码放在哪里，启动代码负责设置栈、清零 BSS、跳转到 C 的 main。这三者缺一不可。

二、方法流程：从安装到烧录的完整步骤

以 Ubuntu 宿主机、RISC-V 32 位裸机目标为例，推荐流程如下：

1. 安装工具链：可直接使用发行版包，或从源码构建。验证命令为 riscv32-unknown-elf-gcc -v。
2. 编写启动汇编：设置栈指针、清零 BSS、跳转 main。
3. 编写链接脚本：定义 MEMORY 与 SECTIONS，指定入口 _start。
4. 交叉编译与链接：生成 ELF，再 objcopy 为 bin 或 hex。
5. 仿真或烧录：用 QEMU 验证，或用 OpenOCD + GDB 连接真实芯片。

# 安装工具链（Ubuntu 示例）
sudo apt install gcc-riscv64-unknown-elf

# 编译与链接
riscv32-unknown-elf-gcc -march=rv32imac -mabi=ilp32 \
  -nostdlib -T link.ld -o firmware.elf start.S main.c

# 生成二进制
riscv32-unknown-elf-objcopy -O binary firmware.elf firmware.bin

# 查看反汇编与符号
riscv32-unknown-elf-objdump -d firmware.elf | head -40
riscv32-unknown-elf-nm firmware.elf | grep -E "_start|main"

三、链接脚本与启动流程：地址决定一切

链接脚本是裸机工程的“地图”。它告诉链接器：Flash 从 0x20000000 开始，RAM 从 0x80000000 开始；.text 放 Flash，.data 和 .bss 放 RAM。若地址写错，程序可能下载成功却无法运行。

ENTRY(_start)

MEMORY {
  FLASH (rx) : ORIGIN = 0x20000000, LENGTH = 512K
  RAM  (rwx) : ORIGIN = 0x80000000, LENGTH = 64K
}

SECTIONS {
  .text : { *(.text*) *(.rodata*) } > FLASH
  .data : { *(.data*) } > RAM AT> FLASH
  .bss  : { *(.bss*) *(COMMON) } > RAM
}

启动汇编通常完成三件事：设置 sp 指向 RAM 顶部；把 .data 从 Flash 拷贝到 RAM；把 .bss 清零；最后 call main。若使用 C 库函数，还需初始化 gp。很多“程序跑飞”问题，根源就是栈指针未设置或 BSS 未清零。

四、调试器与仿真器：先仿真，再上板

调试裸机程序推荐“双轨制”：先用 QEMU 做指令级仿真，快速验证启动流程；再用 OpenOCD + GDB 连接真实开发板，观察外设寄存器。QEMU 可直接加载 ELF 并停在入口：

qemu-system-riscv32 -machine virt -nographic \
  -bios none -kernel firmware.elf -S -s

# 另一个终端
riscv32-unknown-elf-gdb firmware.elf
(gdb) target remote :1234
(gdb) b main
(gdb) c

真实硬件上，OpenOCD 通过 JTAG 或 USB 调试器连接芯片，GDB 再连接 OpenOCD 的 3333 端口。常用命令包括 monitor reset halt、load、info registers、x/8xw 0x80000000。通过查看 mstatus、mepc、mcause，可以快速定位异常入口。

五、常见误区与复盘清单