RISC-V 代理内核与引导加载器技术文档

1. 安装指南

环境准备

• 确保已设置环境变量 RISCV 指向 RISC-V 工具的安装路径。
• 安装 riscv-gnu-toolchain 包。

构建步骤

1. 创建构建目录：

   mkdir build
   cd build
   

2. 配置构建选项，指定前缀路径和宿主机类型：

   ../configure --prefix=$RISCV --host=riscv64-unknown-elf
   

3. 编译项目：

   make
   

4. 安装构建结果：

   make install
   

32位版本构建

要构建32位版本（RV32），请在配置步骤中加入 --with-arch=rv32i 参数。

../configure --prefix=$RISCV --host=riscv64-unknown-elf --with-arch=rv32i

开放BSD构建步骤

• 安装 riscv-gnu-toolchain，然后遵循通用构建步骤。

  # pkg_add riscv-elf-binutils riscv-elf-gcc riscv-elf-newlib
  

2. 项目的使用说明

RISC-V 代理内核（pk）是一个轻量级的应用执行环境，用于托管静态链接的 RISC-V ELF 二进制文件。它旨在支持具有有限 I/O 能力的挂载式 RISC-V 实现，并通过代理到宿主机来处理 I/O 相关的系统调用。

本项目还包括了伯克利引导加载器（bbl），它是一个用于挂载式 RISC-V 系统的监管执行环境，旨在托管 RISC-V Linux 移植。

3. 项目API使用文档

本项目目前不提供特定的 API 文档。用户应直接参考源代码和项目的具体实现来了解如何与 pk 和 bbl 交互。

4. 项目安装方式

项目安装方式已在“安装指南”一节中详细描述。构建完成后，可通过以下步骤安装：

make install

这将把构建的产品安装到对应宿主机类型的目录下，例如 $RISCV/riscv64-unknown-elf 或 $RISCV/riscv32-unknown-elf。