Go to file

Shao-Ce SUN b1e9438406 增加ppt		2022-10-23 16:08:06 +08:00
.vscode	Update launch.json	2022-08-03 22:07:22 +08:00
ppt	增加ppt	2022-10-23 16:08:06 +08:00
README.md	Update README.md	2022-10-05 17:52:35 +08:00
contributors.md	增加贡献者ZhaoSQ-CH	2022-10-08 23:17:25 +08:00
install-riscv-1.sh	更新文档	2022-07-30 22:36:44 +08:00
install-riscv-2.sh	Update install-riscv-2.sh (#16 )	2022-10-13 21:02:48 +08:00
jump.sh	更新jump注释	2022-07-29 19:29:11 +08:00
术语表.md	增加术语	2022-09-22 10:11:37 +08:00

README.md

rvcc-course

这里是RVCC课程的相关仓库，存放了课程相关的材料。

课程对应的代码仓库位于：https://github.com/sunshaoce/rvcc
课程对应的视频课程位于：https://space.bilibili.com/296494084/channel/collectiondetail?sid=571708
课程对应的QQ群号为：752911871
课程对应的微信群：请添加微信号 fangzhang1024 ，备注rvcc进群

欢迎利用PR来对本仓库进行补充。

【1】这个课程都需要准备什么东西？

Linux的运行环境，推荐Ubuntu 20.04。
RISC-V的实验环境（需要编译器和模拟器），如何安装参考问题【2】。
下载RVCC的仓库，即git clone https://github.com/sunshaoce/rvcc。

【2】如何安装RISCV的实验环境

三种方式，自由选择，新手推荐方式1.

方式一（推荐）：解压预先编译好的RISCV环境（基于Ubuntu 20.04）

运行仓库的install-riscv-1.sh即可。

方式二：源代码编译RISCV环境（较难）。

这里我们编译出编译器gcc和模拟器qemu。使用本课程的install-riscv-2.sh脚本（请勿直接运行），使用方法参考视频：RISCV环境快速配置。

方式三：使用配置好的Docker环境

详情可以参考：https://github.com/ksco/rvcc-env-docker

【3】如何对RVCC中的项目使用`make test`进行测试

首先，你需要找到你RISCV实验环境的路径，方式一、二的路径为：~/riscv。

其次，你需要将test.sh或Makefile中的下面几行代码，选择为你对应的编译器和模拟器，例子（默认为gcc和qemu）如下方所示。

最后运行RISCV=~/riscv make test，注意这里的~/riscv必须是你RISCV实验环境的路径。

第1课～第22课

修改前：

  # 运行程序，传入期待值，将生成结果写入tmp.s汇编文件。
  # 如果运行不成功，则会执行exit退出。成功时会短路exit操作
  ./rvcc "$input" > tmp.s || exit
  # 编译rvcc产生的汇编文件
  clang -o tmp tmp.s
  # $RISCV/bin/riscv64-unknown-linux-gnu-gcc -static -o tmp tmp.s

  # 运行生成出来目标文件
  ./tmp
  # $RISCV/bin/qemu-riscv64 -L $RISCV/sysroot ./tmp
  # $RISCV/bin/spike --isa=rv64gc $RISCV/riscv64-unknown-linux-gnu/bin/pk ./tmp

修改后：

  # 运行程序，传入期待值，将生成结果写入tmp.s汇编文件。
  # 如果运行不成功，则会执行exit退出。成功时会短路exit操作
  ./rvcc "$input" > tmp.s || exit
  # 编译rvcc产生的汇编文件
  # clang -o tmp tmp.s
  $RISCV/bin/riscv64-unknown-linux-gnu-gcc -static -o tmp tmp.s

  # 运行生成出来目标文件
  # ./tmp
  $RISCV/bin/qemu-riscv64 -L $RISCV/sysroot ./tmp
  # $RISCV/bin/spike --isa=rv64gc $RISCV/riscv64-unknown-linux-gnu/bin/pk ./tmp

第23课～第44课

在第1课～第22课的基础上，再将

# 将下列代码编译为tmp2.o，"-xc"强制以c语言进行编译
# cat <<EOF | $RISCV/bin/riscv64-unknown-linux-gnu-gcc -xc -c -o tmp2.o -
cat <<EOF | clang -xc -c -o tmp2.o -
int ret3() { return 3; }
int ret5() { return 5; }
EOF

改为（注意此处删去了一行，不是注释掉）：

# 将下列代码编译为tmp2.o，"-xc"强制以c语言进行编译
cat <<EOF | $RISCV/bin/riscv64-unknown-linux-gnu-gcc -xc -c -o tmp2.o -
int ret3() { return 3; }
int ret5() { return 5; }
EOF

第45课～第316课

这个时候已经没有了test.sh，我们直接修改Makefile。

# 测试标签，运行测试
test/%.exe: rvcc test/%.c
	$(CC) -o- -E -P -C test/$*.c | ./rvcc -o test/$*.s -
#	$(RISCV)/bin/riscv64-unknown-linux-gnu-gcc -o- -E -P -C test/$*.c | ./rvcc -o test/$*.s -
	$(CC) -static -o $@ test/$*.s -xc test/common
#	$(RISCV)/bin/riscv64-unknown-linux-gnu-gcc -static -o $@ test/$*.s -xc test/common

test: $(TESTS)
	for i in $^; do echo $$i; ./$$i || exit 1; echo; done
#	for i in $^; do echo $$i; $(RISCV)/bin/qemu-riscv64 -L $(RISCV)/sysroot ./$$i || exit 1; echo; done
#	for i in $^; do echo $$i; $(RISCV)/bin/spike --isa=rv64gc $(RISCV)/riscv64-unknown-linux-gnu/bin/pk ./$$i || exit 1; echo; done
	test/driver.sh

改为（注意需要删去几行，而非注释掉）：

# 测试标签，运行测试
test/%.exe: rvcc test/%.c
	$(RISCV)/bin/riscv64-unknown-linux-gnu-gcc -o- -E -P -C test/$*.c | ./rvcc -o test/$*.s -
	$(RISCV)/bin/riscv64-unknown-linux-gnu-gcc -static -o $@ test/$*.s -xc test/common

test: $(TESTS)
	for i in $^; do echo $$i; $(RISCV)/bin/qemu-riscv64 -L $(RISCV)/sysroot ./$$i || exit 1; echo; done
#	for i in $^; do echo $$i; $(RISCV)/bin/spike --isa=rv64gc $(RISCV)/riscv64-unknown-linux-gnu/bin/pk ./$$i || exit 1; echo; done
	test/driver.sh

【4】跳转脚本（可选）

感谢 @daquexian。

用法是把它复制到 rvcc 项目目录之后：

./jump.sh n 跳转到下一节课程 commit
./jump.sh p 跳转到上一节课程的 commit
./jump.sh <number> 跳转到第 number 节课程的 commit

不想污染 rvcc 目录的话也可以不复制，只要在 rvcc 目录下用正确的脚本路径运行就行。

README.md Unescape Escape