使用 Qemu 运行内核
安装模拟器 Qemu
如果你在使用 Linux (Ubuntu) ,需要到 Qemu 官方网站下载源码并自行编译,因为 Ubuntu 自带的软件包管理器 apt 中的 Qemu 的版本过低无法使用。参考命令如下:
1. $ wget https://download.qemu.org/qemu-4.1.1.tar.xz
2. $ tar xvJf qemu-4.1.1.tar.xz
3. $ cd qemu-4.1.1
4. $ ./configure --target-list=riscv32-softmmu,riscv64-softmmu
5. $ make -j
6. $ export PATH=$PWD/riscv32-softmmu:$PWD/riscv64-softmmu:$PATH
可查看更详细的安装和使用命令。同时,我们在每次开机之后要使用此命令来允许模拟器过量使用内存(不是必须的),否则无法正常使用 Qemu:
1. $ sudo sysctl vm.overcommit_memory=1
如果你在使用 macOS,只需要 Homebrew 一个命令即可:
1. $ brew install qemu
最后确认一下 Qemu 已经安装好,且版本在 4.1.0 以上:
1. $ qemu-system-riscv64 --version
2. QEMU emulator version 4.1.1
3. Copyright (c) 2003-2019 Fabrice Bellard and the QEMU Project developers
使用 OpenSBI
新版 Qemu 中内置了 OpenSBI firrmwire(固件),它主要负责在操作系统运行前的硬件初始化和加载操作系统的功能。我们使用以下命令尝试运行一下:
1. $ qemu-system-riscv64 \
2. --machine virt \
3. --nographic \
4. --bios default
6. OpenSBI v0.4 (Jul 2 2019 11:53:53)
7. ____ _____ ____ _____
8. / __ \ / ____| _ \_ _|
9. | | | |_ __ ___ _ __ | (___ | |_) || |
10. | | | | '_ \ / _ \ '_ \ \___ \| _ < | |
11. | |__| | |_) | __/ | | |____) | |_) || |_
12. \____/| .__/ \___|_| |_|_____/|____/_____|
13. | |
14. |_|
16. Platform Name : QEMU Virt Machine
17. Platform HART Features : RV64ACDFIMSU
18. Platform Max HARTs : 8
19. Current Hart : 0
20. Firmware Base : 0x80000000
21. Firmware Size : 112 KB
22. Runtime SBI Version : 0.1
24. PMP0: 0x0000000080000000-0x000000008001ffff (A)
25. PMP1: 0x0000000000000000-0xffffffffffffffff (A,R,W,X)
可以看到我们已经在 qemu-system-riscv64 模拟的 virt machine 硬件上将 OpenSBI 这个 firmwire 跑起来了。Qemu 可以使用 Ctrl+a 再按下 x 退出。
OpenSBI的内部实现 如果对OpenSBI的内部实现感兴趣,可以看看RISCV OpenSBI Deep_Dive 介绍文档。
加载内核镜像
为了确信我们已经跑起来了内核里面的代码,我们最好在 rust_main 里面加一点东西。
1. // src/main.rs
3. #![feature(asm)]
5. // 在屏幕上输出一个字符,目前我们先不用了解其实现原理
6. pub fn console_putchar(ch: u8) {
7. let ret: usize;
8. let arg0: usize = ch as usize;
9. let arg1: usize = 0;
10. let arg2: usize = 0;
11. let which: usize = 1;
12. unsafe {
13. asm!("ecall"
14. : "={x10}" (ret)
15. : "{x10}" (arg0), "{x11}" (arg1), "{x12}" (arg2), "{x17}" (which)
16. : "memory"
17. : "volatile"
18. );
19. }
20. }
22. #[no_mangle]
23. extern "C" fn rust_main() -> ! {
24. // 在屏幕上输出 "OK\n" ,随后进入死循环
25. console_putchar(b'O');
26. console_putchar(b'K');
27. console_putchar(b'\n');
28. loop {}
29. }
这样,如果我们将内核镜像加载完成后,屏幕上出现了 OK ,就说明我们之前做的事情没有问题。如果想进一步了解上面例子中的内联汇编(“asm!”),请参考 附录:内联汇编 。
现在我们生成内核镜像要通过多条命令来完成,我们通过 Makefile 来简化这一过程。
1. # Makefile
3. target := riscv64imac-unknown-none-elf
4. mode := debug
5. kernel := target/$(target)/$(mode)/os
6. bin := target/$(target)/$(mode)/kernel.bin
8. objdump := rust-objdump --arch-name=riscv64
9. objcopy := rust-objcopy --binary-architecture=riscv64
11. .PHONY: kernel build clean qemu run env
13. env:
14. cargo install cargo-binutils
15. rustup component add llvm-tools-preview rustfmt
16. rustup target add $(target)
18. kernel:
19. cargo build
21. $(bin): kernel
22. $(objcopy) $(kernel) --strip-all -O binary $@
24. asm:
25. $(objdump) -d $(kernel) | less
27. build: $(bin)
29. clean:
30. cargo clean
32. qemu: build
33. qemu-system-riscv64 \
34. -machine virt \
35. -nographic \
36. -bios default \
37. -device loader,file=$(bin),addr=0x80200000
39. run: build qemu
这里我们通过参数 -device 来将内核镜像加载到 Qemu 中,我们指定了内核镜像文件,但这个地址 0x80200000 又是怎么一回事?我们目前先不用在意这些细节,等后面会详细讲解。
于是,我们可以使用 make run 来用 Qemu 加载内核镜像并运行。匆匆翻过一串长长的 OpenSBI 输出,我们看到了 OK !于是历经了千辛万苦我们终于将我们的内核跑起来了!
没有看到 OK ?迄今为止的代码可以在这里找到,请参考。
virt machine硬件配置
扩展内容
也许有同学对qemu-system-riscv64模拟的virt machine计算机的硬件配置感兴趣,那么通过如下命令,可以看到到当前virt machine的硬件配置信息:
1. $ sudo apt install device-tree-compiler #安装device tree编译器/解释器 dtc
2. $ qemu-system-riscv64 -machine virt -machine dumpdtb=riscv64-virt.dtb -bios default #生成virt machine计算机的二进制device tree信息
3. $ dtc -I dtb -O dts -o riscv64-virt.dts riscv64-virt.dtb #转换为文本格式的device tree信息
4. $ more riscv64-virt.dts #显示virt machine计算机的硬件配置信息
如果同学对qemu-system-riscv64模拟的virt machine计算机硬件(包括外设)配置的具体实现代码感兴趣,那么可看看qemu riscv 的 virt machine 实现。
下一节我们实现格式化输出来使得我们后续能够更加方便的通过输出来进行内核调试。
