3d757607fe
Now we have a programming environment and we have a small game for amusement :). Signed-off-by: Chen Wang <wangchen20@iscas.ac.cn>
从零开始为 RISC-V 构建一个 Linux 系统
1. 简介
本仓库包含课程《从零开始为 RISC-V 构建一个 Linux 系统》的配套课件和构建脚本代码。该课程用于教学演示如何从零开始为 RISC-V 平台构建一个 Linux 系统。采用 GPL v2 许可证发布（具体请阅读本仓库根目录下的 LICENSE 文件）。
本仓库目录文件介绍：
- package: 目录，用于存放每个软件包的构建素材（譬如补丁文件）和构建脚本。
- slides: 目录，用于存放本课程对应的课件（pdf）。
- support：目录，用于存放构建中会用到的一些辅助脚本和素材文件。
- .gitignore: Git 配置文件，用于指定哪些文件或目录应该被 Git 忽略，不纳入版本控制。
- build.sh: 执行
make时会执行的脚本文件。 - LICENSE: 本仓库的发布许可证文件。
- Makefile: make 文件。
- README.md: 本文件。
- source.sh: 执行
make source时会执行的脚本文件。
执行构建过程中还会创建以下目录，但不作为本仓库的一部分。
- dl: 目录，用于存放网络下载的软件包源码压缩包。
- output: 目录，用于存放构建的输出，即本课程定义的
${OUTPUT_DIR}。
注意：由于本仓库代码出于演示 Step by Step 的修改过程的目的，main 分支的 commit 仅用于演示步骤而不反应实际 git 提交历史，所以在同步本地仓库时不支持简单的 pull。建议每次同步本地时直接采用完整的 clone 方式。
2. 运行环境
本仓库提供了对应课程内容的参考构建脚本，构建脚本在 Ubuntu 22.04 LTS 和 Ubuntu 24.04 LTS 上验证通过。有关运行环境的具体要求可以参考课件 “第 3 章 构建 Linux 系统之前的准备工作” 的 02 部分：“构建环境准备” 的介绍。
也欢迎大家在其他 Linux 发行版上尝试，原理上本仓库的参考构建脚本并不局限于 Ubuntu 系统。
3. 构建和使用说明
本节运行命令时假设都在 ${PROJECT_DIR}，即本仓库所在路径下运行，不再赘述。
本仓库的构建命令无需 root 权限。
3.1. 批量下载软件包源码压缩包
批量下载软件包源码压缩包的命令如下。注意：中途可能失败，多半是因为网络超时所致，可以多试几次以下命令，直到全部成功。
$ make source
如果仍然无法完整下载软件包，也可以去 oerv 仓库克隆一份（确保在 ${PROJECT_DIR} 下），执行如下命令：
$ git clone --depth 1 --branch main https://git.oerv.ac.cn/openRuyi-tutorials/packages-for-build-linux-system-from-scratch.git dl
3.2. 构建
本仓库的主分支 main 上有 6 个 commit，分别对应以下步骤：
Step6: add python and snake.
Step5: add vim.
Step4: enhanced shell with bash.
Step3: enhanced with coreutiles.
Step2: enhanced with sysvinit
Step1: build with busybox.
学习者可以 checkout 到任意一个 commit 并运行以下命令进行构建。注意：本仓库的构建脚本不支持增量构建，只支持从零开始一次性构建（实际上执行 make 内部也会默认先执行 make clean）。
$ make clean
$ make
3.3. 运行
构建成功后可以进入 ${IMAGES_DIR} 执行脚本，运行 QEMU 模拟器并加载我们制作的 Linux 系统。
$ cd output/images/
$ ./start-qemu.sh
登录系统的用户名是 root，无密码。
关机可以在登录系统后在控制台中输入 poweroff 命令，或者直接 "Ctrl+A X" 强制退出 QEMU（所谓 "Ctrl+A X" 是指同时按下 Ctrl 和 A，同时松开后再按 X）。
4. 致谢
本仓库的构建脚本参考了 Buildroot (2025.08.1)。在此表示衷心感谢！