rustsbi/prototyper/docs/booting-openwrt-in-qemu-using-uboot-and-rustsbi.md

使用RustSBI & U-Boot在QEMU中启动 Openwrt

本教程给出了使用RustSBI和U-Boot在QEMU中启动Openwrt的基本流程。

本教程使用软件版本如下：

软件	版本
riscv64-linux-gnu-gcc	14.1.0
qemu-system-riscv64	9.0.1
RustSBI Prototyper	0.0.0
U-Boot	2024.04

准备RustSBI Prototyper， U-Boot ，Openwrt

创建工作目录并进入该目录

$ mkdir workshop && cd workshop

Clone RustSBI Prototyper

$ git clone https://github.com/rustsbi/prototyper.git && cd prototyper && git checkout main && cd ..

Clone U-Boot

$ git clone https://github.com/u-boot/u-boot.git && cd u-boot && git checkout v2024.04 && cd ..

Clone & Patch Openwrt

$ git clone https://git.openwrt.org/openwrt/openwrt.git 
$ cd ./openwrt
$ git checkout 603a3c6

应用本项目目录下的 docs/openwrt-patch.patch。

$ curl https://raw.githubusercontent.com/rustsbi/prototyper/refs/heads/main/docs/openwrt-patch.patch --output openwrt-patch.patch
$ git apply openwrt-patch.patch

编译RustSBI Prototyper

进入prototyper目录

$ cd prototyper

编译RustSBI Prototyper

$ cargo prototyper

编译U-Boot SPL

进入U-Boot目录

$ cd u-boot

导出环境变量

$ export ARCH=riscv
$ export CROSS_COMPILE=riscv64-linux-gnu-
$ export OPENSBI=../prototyper/target/riscv64imac-unknown-none-elf/release/rustsbi-prototyper.bin 

生成.config文件,编译U-Boot

# To generate .config file out of board configuration file
$ make qemu-riscv64_spl_defconfig
$ sed -i.bak 's/CONFIG_BOOTCOMMAND=*/CONFIG_BOOTCOMMAND="scsi scan; fatload scsi 0:3 84000000 Image; setenv bootargs root=\/dev\/sda4 rw earlycon console=\/dev\/ttyS0 rootwait; booti 0x84000000 - ${fdtcontroladdr};"/' .config
$ make -j$(nproc)

编译 Openwrt

首先，你应先按照 https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem 配置自己的编译环境。

（以下内容参照并修改自 https://openwrt.org/docs/guide-developer/toolchain/use-buildsystem）

更新 Feeds：

$ cd openwrt
# Update the feeds
$ ./scripts/feeds update -a
$ ./scripts/feeds install -a

修改配置：

$ make -j$(nproc) menuconfig

进入 Target System，选中 $SiFive U-based RISC-V boards。

修改内核配置：

$ make -j$(nproc) kernel_menuconfig

进入后将
Device Drivers $\rightarrow$ Serial ATA and Parallel ATA drivers (libata) $\rightarrow$ AHCI SATA support
Device Drivers $\rightarrow$ Network device support $\rightarrow$ Ethernet driver support $\rightarrow$ Intel devices $\rightarrow$ Intel(R) PRO/1000 Gigabit Ethernet support
设为 built-in。

编译镜像：

# Build the firmware image
$ make -j$(nproc) defconfig download clean world

拷贝并解压镜像：

$ cd ..
$ cp ./openwrt/bin/targets/sifiveu/generic/openwrt-sifiveu-generic-sifive_unleashed-ext4-sdcard.img.gz ./
$ gzip -dk openwrt-sifiveu-generic-sifive_unleashed-ext4-sdcard.img.gz

使用RustSBI 原型系统和U-Boot启动 Openwrt

进入workshop目录

$ cd workshop

运行下面命令

$ qemu-system-riscv64 \
-machine virt -nographic -m 4096 -smp 1 \
-bios ./u-boot/spl/u-boot-spl \
-device virtio-rng-pci -device ahci,id=ahci -device ide-hd,bus=ahci.0,drive=mydrive \
-drive file=./openwrt-sifiveu-generic-sifive_unleashed-ext4-sdcard.img,format=raw,if=none,id=mydrive \
-device loader,file=./u-boot/u-boot.itb,addr=0x80200000 \
-device e1000,netdev=n1 -netdev user,id=n1,hostfwd=tcp::12055-:22