📚 课程目录第1章搭建RISC-V SoC仿真调试环境

1. 搭建RISC-V SoC仿真调试环境

任务目标

在本案例中，你将完成RISC-V嵌入式开发的最小工具链闭环：安装RISC-V GCC交叉编译器、OpenOCD调试桥接软件和GDB调试器，并验证从源码编译到调试器连接的全流程可用性。完成本案例后，你应能独立编译一个RISC-V裸机程序，并启动GDB会话进行基础调试操作。

环境准备

以下操作基于 Ubuntu 22.04 LTS（x86_64主机）。若使用其他Linux发行版或macOS，请相应调整包管理器命令。Windows用户建议使用WSL2。

# 安装RISC-V GCC工具链（含GDB）
sudo apt update
sudo apt install -y gcc-riscv64-unknown-elf gdb-multiarch

# 安装OpenOCD（需从源码编译以获取最新RISC-V支持）
sudo apt install -y autoconf automake libtool make pkg-config libusb-1.0-0-dev
git clone https://github.com/riscv/riscv-openocd.git
cd riscv-openocd
./bootstrap
./configure --enable-ftdi --enable-jtag
make -j$(nproc)
sudo make install

验证安装：

riscv64-unknown-elf-gcc --version
openocd --version
gdb-multiarch --version

三条命令均应输出版本信息且无报错。

最小可复现工程

创建以下三个文件，构成一个完整的RISC-V裸机程序与链接脚本：

// main.c - RISC-V裸机入口程序
volatile unsigned int *gpio_out = (unsigned int *)0x10000000;

void _start(void) {
    // 向GPIO输出寄存器写入0xFF，模拟点亮LED
    *gpio_out = 0xFF;
    while (1) {
        // 死循环保持程序运行
    }
}

// link.ld - 链接脚本
OUTPUT_ARCH(riscv)
ENTRY(_start)

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

SECTIONS {
    .text : {
        *(.text._start)
        *(.text*)
    } > RAM

    .rodata : {
        *(.rodata*)
    } > RAM

    .data : {
        *(.data*)
    } > RAM

    .bss : {
        *(.bss*)
    } > RAM
}

# Makefile
CROSS = riscv64-unknown-elf-
CC = $(CROSS)gcc
CFLAGS = -march=rv32i -mabi=ilp32 -O0 -g -nostdlib -nostartfiles -ffreestanding
LDFLAGS = -T link.ld -nostdlib

all: firmware.elf

firmware.elf: main.c link.ld
	$(CC) $(CFLAGS) $(LDFLAGS) -o $@ main.c

clean:
	rm -f firmware.elf

# 启动QEMU模拟调试（无需真实硬件即可验证）
qemu-debug: firmware.elf
	qemu-system-riscv32 -M virt -nographic -kernel firmware.elf -s -S

编译与验证

执行编译并检查生成文件：

make
riscv64-unknown-elf-objdump -d firmware.elf | head -20

预期输出：反汇编显示_start入口位于0x80000000，首条指令为向0x10000000地址写入0xFF的store操作。若编译报错，请检查工具链安装路径是否正确。

调试流程验证

本案例使用QEMU模拟RISC-V目标机，验证GDB远程调试能力（无需真实开发板）：

# 终端1：启动QEMU并等待GDB连接
make qemu-debug

# 终端2：启动GDB并连接
gdb-multiarch firmware.elf
(gdb) target remote :1234
(gdb) info registers pc
(gdb) x/4i $pc
(gdb) si
(gdb) info registers pc

验证通过条件：

target remote连接成功无报错；
info registers pc显示pc = 0x80000000；
x/4i $pc能反汇编出4条有效指令；
执行si单步后，pc值递增且指向下一条指令。

若以上步骤全部通过，说明交叉编译工具链、GDB远程调试协议和RISC-V目标模拟环境均已正确配置，具备后续芯片级调试案例的基础环境。

常见问题排查

gdb-multiarch无法识别RISC-V架构：执行gdb-multiarch --configuration确认包含riscv支持；若无，改用riscv64-unknown-elf-gdb（随工具链安装）。
OpenOCD编译失败：确认已安装libusb开发头文件；若使用旧版本Ubuntu，可能需要--enable-legacy-ftdi选项。
QEMU未安装：执行sudo apt install qemu-system-misc。