手把手教你在优麒麟上搭建 RISC-V 交叉编译环境

由于 RISC-V 设备价格昂贵、不易采购等诸多原因，许多小伙伴虽然很感兴趣，但仍无法参与 RISC-V 开发工作，今天就教大家如何在优麒麟上搭建 RISC-V 交叉编译环境，快学起来吧！

交叉编译（Cross Compile）指编译代码的平台，和执行编译后源代码的平台是两个不同的平台，比如在 x86/Linux 平台下使用交叉编译工具链编译 ARM/Linux 平台下的可执行文件。今天我们要讲的就是在优麒麟（x86/Linux）上编译 RISC-V 架构可执行文件的方法。

我们为什么需要交叉编译呢，主要有以下考虑：

01.性能与速度

交叉编译的目标平台往往 CPU 性能较差，内存和磁盘性能也可能不能满足编译的要求，这时候就要依赖性能资源更好的编译主机进行编译。

02.缺乏编译条件

就算目标平台性能足够且资源充足，可以本地编译，但第一个在目标平台运行的本地编译器总是需要我们通过交叉编译获得。

03.软件编译环境

一个完整的 Linux 发行版需要由数百个包构成，而我们往往只关注需要在目标主机上安装的包，所以我们可以在交叉编译的主机上配置这些环境，而不是把时间浪费在配置目标主机的编译依赖上。

本文包含以下两部分：

1、如何搭建一个 RISC-V 的交叉编译环境。

2、交叉编译 Linux 内核。

一、搭建 RISC-V 交叉编译环境。

通常来讲，在搭建交叉编译环境时需要考虑不同体系架构的不同特性，包括 CPU 架构是 64 位还是 32 位系统、字节序是大端（ big-endian ）或小端（ little-endian ）、内存字节对齐方式等，不过好在 RISC-V 已经有完善的工具链，包含交叉编译所需的 binutils 、 gcc 和 glibc 3 个部分。

●  首先需要 RISC-V 交叉编译工具链，如果网络较慢，可以忽略其中的 qemu 子项目

git clone --recursive https://github.com/riscv/riscv-gnu-toolchain

这是 RISC-V 的 C/C++ 交叉编译工具链，其支持两种构建模式：

1. 通用 ELF/Newlib 工具链

2. Linux-ELF/glibc 工具链

●  安装所需依赖包

sudo apt-get install -y autoconf automake autotools-dev curl libmpc-dev libmpfr-dev libgmp-dev gawk build-essential bison flex texinfo gperf libtool patchutils bc zlib1g-dev libexpat-dev libncurses-dev device-tree-compiler libssl-dev gdisk swig

●  接下来开始编译

cd riscv-gnu-toolchain./configure --prefix=/opt/riscv（路径可以根据个人习惯自定义）sudo make linux -j `nproc`

编译完成后，刚才指定的路径 opt/riscv/bin 下会生成以下文件：

优麒麟

交叉编译所需的工具，包括 Binutils（ld，as，ar 等，了解详情可参考https://sourceware.org/binutils/docs-2.37/binutils/index.html  ）、gcc 、gdb  等都在其中。

可以将这个路径添加到环境变量中：

export PATH=/opt/riscv/bin:$PATH

也可以添加到：

echo "export PATH=/opt/riscv/bin:$PATH" >> ~/.bashrc

到这里我们就完成了交叉编译所需环境的搭建。

二、编译 Linux 内核

接下来我们以内核源码为例，了解一下上述交叉编译工具链的使用方法。

●  首先下载内核源码

git clone https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git

●  不过这里下载较慢，可以去国内的镜像站下载，比如清华大学镜像站

git clone https://mirrors.tuna.tsinghua.edu.cn/git/linux-stable.git

●  下载完成后

git checkout

接下来将需要打上你想要编译的开发板的 patch ,以 hifive unmatched 为例

●  首先下载

git clone https://github.com/sifive/meta-sifive

这里面还包含了编译 OpenSBI 和 U-Boot 所需的 patch ，编译过程大同小异，如果想要自己构建一个系统镜像，可以分别编译这两个工具。这里以内核为例：

●  打上所有 patch

for f in path to /meta-sifive/recipes-kernel/linux/files/*.patch; do echo $f;patch -p1 < $f;done

●  复制 defconfig 配置文件

cp path to /meta-sifive/recipes-kernel/linux/files/defconfig  ./.config

如果想避免产生额外后缀名，可以添加

touch .scmversion

接下来开始编译内核，这里需要指定 make 的两个参数：

1、CROSS_COMPILE：交叉编译器的前缀，表示将代码编译编译成目标 CPU 指令的工具，如果不指定，make 会默认使用系统自带的 gcc 来编译，这里指定我们之前编译出来的 riscv64-unknown-linux-gnu- 为前缀。

2、ARCH：即 architecture ，用于选择编译哪种 CPU 架构，也就是编译 arch/ 目录下的哪个子目录，这里指定 ARCH=riscv ，arch/riscv 目录下也包含此架构特有的 Kconfig 配置文件，所以 make menuconfig 时也会用到这个目录。

make CROSS_COMPILE=riscv64-unknown-linux-gnu- ARCH=riscv olddefconfigmake CROSS_COMPILE=riscv64-unknown-linux-gnu- ARCH=riscv -j`nproc`

也可以将内核和内核模块打成 tar 包或 deb 包

make CROSS_COMPILE=riscv64-unknown-linux-gnu- ARCH=riscv    INSTALL_MOD_STRIP=1 -j`nproc` tarbz2-pkgmake CROSS_COMPILE=riscv64-unknown-linux-gnu- ARCH=riscv INSTALL_MOD_STRIP=1 -j`nproc` bindeb-pkg

添加版本号

version=`cat include/config/kernel.release`;echo $version

编译完成后，会生成 path to/arch/riscv/boot/Image 内核镜像文件和 path to/arch/riscv/boot/dts/sifive/hifive-unmatched-a00.dtb 硬件 dtb 文件。

如果选择打成 deb 包，会生成三个 .deb 文件:

1. linux-headers-...

2. linux-libc-dev_...

3. linux-image-...

（其中省略号表示版本号）

到这里我们就完成了 RISC-V 架构 Linux 内核的编译，接下来便可以基于这个内核制作自己的系统镜像。

各位小伙伴，你学会了吗？

更多问题反馈和优化建议，请点击进入优麒麟社区论坛告诉我们哦~

参考文档：

https://github.com/carlosedp/riscv-bringup/tree/bbef412a4456acefdf814a9e14a75ce2778992ed/unmatched#build-u-boot

https://github.com/sifive/meta-sifive/tree/2021.12/recipes-kernel/linux/files

https://github.com/riscv-collab/riscv-gnu-toolchain

https://github.com/sifive/freedom-u-sdk