RISC-V SDK 与 Toolchain

一、SDK 与工具链概览

SDK 组织驱动、中间件与应用代码，工具链负责配置、编译、固件生成与调试。下图展示 RISC-V SDK 与 AUTOSAR 的分层架构及集成关系。

工具链基于标准 RISC-V GNU 生态构建，编译与调试两端共用同一套 riscv32-unknown-elf-* 命令，不引入私有编译器或私有调试协议。SCons 提供 Windows、Linux 与 WSL2 的统一构建入口；Make/Kbuild 沿用 Linux / WSL 环境。 跨平台复用配置时，应对齐编译器版本、编译选项、源码与依赖，再验证产物一致性。

二、GCC 编译器

2.1 安装与验证

工具链按平台提供各自独立的预编译包，解压后加入可执行文件搜索路径即可使用；也可通过环境变量 指定工具链根目录，不必修改系统 PATH。安装完成后，应确认编译器、调试器与调试服务 三者版本相互配套——版本不匹配时，典型表现是符号无法解析、调试连接建立失败或寄存器读值异常。

2.2 目标架构与 ABI

面向多核异构架构，各核心的指令集扩展与 ABI 由构建配置按所选平台自动推导， 开发者无需手工拼接 ISA 字符串：性能核可启用原子操作、压缩指令与浮点扩展， 辅助核则采用更精简的组合，以换取面积与功耗。

2.3 编译选项

优化等级、调试信息与 C 库选择全部通过菜单配置暴露，可交互勾选， 也可固化到工程的预置配置中，保证团队之间构建结果一致。

2.4 配置与编译

构建系统提供两套共用配置的入口，二者共用同一份构建配置文件： 在 Windows 上生成的配置，可以直接拿到 Linux 上继续编译。仓库同时预置了大量常用配置模板， 覆盖不同核心、不同运行时（裸机 / RTOS）与各外设示例的组合，一条命令即可初始化工程。

菜单配置以树形结构组织全部可选项——通用设置、运行时、SoC、驱动、中间件、应用与测试用例， 保存后写回构建配置文件。两套构建方式复用 Kconfig 定义与 .config，分别通过原生 Kconfig 前端和 Kconfiglib 提供菜单界面：

2.5 编译输出

三、GDB 调试器与调试服务

3.1 调试拓扑

调试服务通过 JTAG 连接芯片，向上为每个核心开放一个独立的 GDB 端口，同时提供 Telnet 命令行接口。 多核可以各开一个 GDB 会话并行调试，独立控制各核心；共享内存、复位与硬件调试资源仍需协调。

3.2 连接调试器

原生 Windows 与 Linux 环境可直接访问 USB 调试器。WSL2 无法直接访问 USB 设备， 需要在 Windows 主机侧通过 USB 转发工具把 JTAG 调试器透传进子系统：绑定设备后再挂载到 WSL， 之后 WSL 内即可像本地设备一样使用。

3.3 启动调试服务

调试服务通过接口配置文件选择调试适配器型号，通过目标配置文件 描述芯片的调试链路、核心数量与片内 Flash 布局，一次拉起全部核心。更换调试器时只需替换接口配置文件， 目标配置保持不变；因此同一套目标配置可以同时服务于量产芯片、FPGA 原型与仿真模型。

启动时还可按需附加若干可选行为：允许远程主机连接以支持跨网络或跨子系统调试、 调试期间挂起看门狗与定时器以免暂停时被复位打断、以及不复位目标直接接入以观察运行中的系统状态。

3.4 连接 GDB

调试服务启动后，GDB 以标准远程调试协议连接对应核心的端口，并加载同一份带符号表的固件文件 获取符号信息。连接命令在各平台完全一致；多核调试时开多个终端，各自连接对应端口即可， 独立控制各核心；共享内存、复位与硬件调试资源仍需协调。

连接成功后即可下载程序并运行。远程连接超时可按需放宽，以适应网络或 JTAG 响应较慢的场景； 写入片内 Flash 时还需按 Flash 的 page 大小设置远程写入包长度，保证写入按页对齐。

3.5 调试能力

调试链路提供完整的源码级调试能力，均为 GDB 标准功能，无需学习私有命令：

• 断点：按函数名或地址设置软件断点；需要在只读区或 Flash 中中断时使用硬件断点， 数量受目标调试单元限制且多核共享。
• 单步：源码行级与指令级两种粒度，可进入或跳过被调函数。
• 观察点：变量被读、被写或读写时自动中断，用于定位内存被意外改写一类问题。
• 寄存器与内存：查看通用寄存器与控制状态寄存器、按字节/半字/字读写任意地址、 修改程序计数器改变执行流。
• 多核切换：在调试会话中切换当前操作的核心，或分别复位某一个核心。
• Cache 一致性：提供数据 Cache 回写与失效操作，保证调试时看到的内存与真实内容一致。

除 GDB 内建命令外，调试服务自身的命令（Flash 擦写、内存读写、目标切换、复位、日志级别调整等） 也可在 GDB 会话中直接下发，无需切换到另一个终端。

3.6 Flash 编程

片内 Flash 编程由调试服务内置的编程算法完成，提供三种入口，覆盖开发调试到产线烧录的不同场景：

三种方式都需遵循 Flash 的对齐约束：读取按字对齐，写入按块对齐，擦除按扇区对齐， 擦除后存储单元为全 1。串口方式另外支持协议版本查询、波特率协商与写后校验， 可在一条命令内完成整个固件文件的烧录与校验。

3.7 常见问题