2.2 搭建实验环境
2.2.1 实验2-1:输出“Welcome to RISC-V!”
1.实验目的
了解并熟悉如何在NEMU和QEMU模拟器上运行最简单的BenOS程序。
2.实验详解
在Linux主机中安装相关工具。
$ sudo apt-get install qemu-system-misc libncurses5-dev gcc-riscv64-linux-gnu build-essential git bison flex libssl-dev
(1)在QEMU上运行BenOS
在Linux主机上使用make命令编译BenOS[1]。
[1]请参考“本书约定”一章获取下载配套参考代码的方法。
$ cd riscv_programming_practice/chapter_2/benos
$ export board=qemu
$ make clean
$ make
CC build_src/uart_c.o
CC build_src/kernel_c.o
AS build_src/boot_s.o
LD build_src/benos.elf
OBJCOPY benos.bin
CC build_sbi/sbi_main_c.o
AS build_sbi/sbi_boot_s.o
AS build_sbi/sbi_payload_s.o
LD build_sbi/mysbi.elf
OBJCOPY mysbi.bin
LD build_sbi/benos_payload.elf
OBJCOPY benos_payload.bin
要想编译能在QEMU模拟器[2]上运行的可执行二进制文件,需要先设置board=qemu。
[2]本书使用的QEMU版本默认为Ubuntu 20.04自带的版本(4.2.1),如读者使用高版本QEMU时遇到问题,请参考本章实验代码中的说明文件:riscv_programming_practice/chapter_2/必读.txt。
直接输入make run命令并运行。
rlk@master:benos$ make run
qemu-system-riscv64 -nographic -machine virt -m 128M -bios mysbi.bin -kernel benos.elf
Welcome RISC-V!
QEMU输出“Welcome RISC-V!”。要关闭QEMU,可以先按 “Ctrl +A”键,松开,再快速按 “X”键。
(2)在NEMU上运行BenOS
在Linux主机上使用make命令编译BenOS。
$ cd riscv_programming_practice/chapter_2/benos
$ export board=nemu
$ make clean
$ make
CC build_src/uart_c.o
CC build_src/kernel_c.o
AS build_src/boot_s.o
LD build_src/benos.elf
OBJCOPY benos.bin
CC build_sbi/sbi_main_c.o
AS build_sbi/sbi_boot_s.o
AS build_sbi/sbi_payload_s.o
LD build_sbi/mysbi.elf
OBJCOPY mysbi.bin
LD build_sbi/benos_payload.elf
OBJCOPY benos_payload.bin
要想编译能在NEMU模拟器上运行的可执行二进制文件,需要先设置board=nemu。如果想查看更多编译日志,可以使用make V=1命令。编译完成之后会生成以下5个文件。
● benos.bin:BenOS可执行文件。
● benos.elf:BenOS带调试信息的可执行与可链接格式(Executable and Linkable Format,ELF)文件。
● mysbi.bin:MySBI固件的可执行文件。
● mysbi.elf:MySBI带调试信息的ELF文件。
● benos_payload.bin:把benos.bin和mysbi.bin整合到一个可执行二进制文件中。
直接输入make run命令并运行。
rlk@master:benos$ make run
riscv64-nemu-interpreter -b benos_payload.bin
Welcome to riscv64-NEMU!
For help, type "help"
Welcome RISC-V!
NEMU输出“Welcome RISC-V!”,如图2.1所示。
图2.1 NEMU的输出结果
2.2.2 实验2-2:单步调试BenOS和MySBI
本小节提供两种单步调试BenOS和MySBI的方法。一种是使用QEMU与GDB工具,另一种是使用NEMU内置的单步调试功能。
1.使用QEMU与GDB工具
以实验2-1为例,使用make debug命令在终端启动QEMU虚拟机的gdbserver。
$ cd riscv_programming_practice/chapter_2/benos
$ make debug
或者直接使用如下命令启动gdbserver。
$ qemu-system-riscv64 -nographic -machine virt -m 128M -bios mysbi.bin -kernel benos.elf -S -s
在另一个终端使用如下命令启动GDB工具。
$ gdb-multiarch --tui benos.elf
在GDB命令行中执行如下命令。
(gdb) target remote localhost:1234
(gdb) b _start
Breakpoint 1 at 0x80200000: file src/boot.S, line 6.
(gdb) c
此时,使用GDB工具单步调试BenOS,如图2.2所示。
图2.2 使用GDB工具单步调试BenOS
另外,也可以通过GDB工具调试MySBI固件。为了在终端启动QEMU虚拟机的gdbserver,使用make debug命令。
$ cd riscv_programming_practice/chapter_2/benos
$ make debug
在另一个终端使用如下命令启动GDB工具,这时候需要加载MySBI固件的ELF文件。
$ gdb-multiarch --tui mysbi.elf
在GDB命令行中执行如下命令。
(gdb) target remote localhost:1234
(gdb) b _start
Breakpoint 1 at 0x80000000: file sbi/sbi_boot.S, line 6.
(gdb) c
此时,使用GDB工具进行单步调试,如图2.3所示。
图2.3 单步调试
2.NEMU内置的单步调试功能
NEMU内置了简易调试器(Simple Debugger,SDB)。SDB是NEMU中一个非常重要的基础设施,可以获取程序的执行信息,以协助调试。SDB支持的命令如表2.4所示。
表2.4 SDB支持的命令
在Linux主机终端,使用make debug命令启动SDB。
$ cd riscv_programming_practice/chapter_2/benos
$ make debug
riscv64-nemu-interpreter benos_payload.bin
Welcome to riscv64-NEMU!
For help, type "help"
(nemu)
在SDB命令行中输入“help”,查看帮助信息,如图2.4所示。
图2.4 查看帮助信息
输入“si”,进行单步调试,如图2.5所示。
图2.5 进行单步调试
另外,还可以通过监视点命令设置断点,不过目前只支持为地址设置断点。例如,在0x8020 0000地址处设置断点。
$ make debug
(nemu) w $pc==0x80200000 //设置断点
Set watchpoint #0
(nemu) c //继续执行,此时NEMU停在断点处
Hint watchpoint 0 at address 0x00000000800000a8, expr = $pc==0x80200000
old value = 0x0000000000000000
new value = 0x0000000000000001
(nemu) si //单步执行
0x0000000080200000: 73 10 40 10 csrrw $0,0x104,$0
Hint watchpoint 0 at address 0x0000000080200000, expr = $pc==0x80200000
old value = 0x0000000000000001
new value = 0x0000000000000000