From f153d362a4047fa75205020ca8a0a4f89682c09a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E4=B8=8D=E7=9F=A5=E9=81=93=E5=8F=AB=E4=BB=80=E4=B9=88?= =?UTF-8?q?=E9=98=9F?= <t202411117993191@eduxiji.net> Date: Sun, 26 May 2024 03:29:06 +0000 Subject: [PATCH] Delete README.md --- xv6-k210/README.md | 122 --------------------------------------------- 1 file changed, 122 deletions(-) delete mode 100644 xv6-k210/README.md diff --git a/xv6-k210/README.md b/xv6-k210/README.md deleted file mode 100644 index 4e1803f..0000000 --- a/xv6-k210/README.md +++ /dev/null @@ -1,122 +0,0 @@ -# XV6-RISCV On K210 -Run xv6-riscv on k210 board -[English](./README.md) | [䏿–‡](./README_cn.md) - -``` - (`-') (`-') <-.(`-') - (OO )_.-> _(OO ) __( OO) - (_| \_)--.,--.(_/,-.\ ,--. (`-') '-'. ,--. .----. .--. .----. - \ `.' / \ \ / (_/ / .' ( OO).-> | .' / \_,-. | /_ | / .. \ - \ .') \ / / . / -. (,------. | /) .' .' | | | / \ . - .' \ _ \ /_)' .-. \ `------' | . ' .' /_ | | ' \ / ' - / .'. \ \-'\ / \ `-' / | |\ \ | | | | \ `' / -`--' '--' `-' `----' `--' '--' `------' `--' `---'' -``` - - - -## Dependencies -+ `k210 board` or `qemu-system-riscv64` -+ RISC-V Toolchain: [riscv-gnu-toolchain](https://github.com/riscv/riscv-gnu-toolchain.git) - -## Installation -```bash -git clone https://github.com/HUST-OS/xv6-k210 -``` - -## Run on k210 board -First you need to connect your k210 board to your PC. -And check the `USB serial port` (In my situation it will be `ttyUSB0`): -```bash -ls /dev/ | grep USB -``` -Build the kernel and user program: - -```bash -cd xv6-k210 -make build -``` -Instead of the original file system, xv6-k210 runs with FAT32. You might need an SD card with FAT32 format. -Your SD card should NOT keep a partition table. To start `shell` and other user programs, you need to copy them into your SD card. -First, connect and mount your SD card (SD card reader required). -```bash -ls /dev/ # To check your SD device -mount <your SD device name> <mount point> -make sdcard dst="SD card mount point" -umount <mount point> -``` -Then, insert the SD card to your k210 board and run: -```bash -make run -``` -Sometimes you should change the `USB serial port`: -```bash -make run k210-serialport=`Your-USB-port`(default by ttyUSB0) -``` -Ps: Most of the k210-port in Linux is ttyUSB0, if you use Windows or Mac OS, this doc -may help you: [maixpy-doc](https://maixpy.sipeed.com/zh/get_started/env_install_driver.html#) - -## Run on qemu-system-riscv64 -First, make sure `qemu-system-riscv64` is installed on your system. -Second, make a disk image file with FAT32 file system. -```bash -make fs -``` -It will generate a disk image file `fs.img`, and compile some user programs like `shell` then copy them into the `fs.img`. -As long as the `fs.img` exists, you don't need to do this every time before running, unless you want to update it. - -Finally, start running. -```bash -make run platform=qemu -``` - -Ps: Press Ctrl + A then X to quit qemu. - -## About shell - -The shell commands are user programs, too. Those program should be put in a "/bin" directory in your SD card or the `fs.img`. -Now we support a few useful commands, such as `cd`, `ls`, `cat` and so on. - -In addition, `shell` supports some shortcut keys as below: - -- Ctrl-H -- backspace -- Ctrl-U -- kill a line -- Ctrl-D -- end of file (EOF) -- Ctrl-P -- print process list - -## Add my programs on xv6-k210 -1. Make a new C source file in `xv6-user/` like `myprog.c`, and put your codes; -2. You can include `user.h` to use the functions declared in it, such as `open`, `gets` and `printf`; -3. Add a line "`$U/_myprog\`" in `Makefile` as below: - ```Makefile - UPROGS=\ - $U/_init\ - $U/_sh\ - $U/_cat\ - ... - $U/_myprog\ # Don't ignore the leading '_' - ``` -4. Then make: - ```bash - make userprogs - ``` - Now you might see `_myprog` in `xv6-user/` if no error detected. Finally you need to copy it into your SD (see [here](#run-on-k210-board)) - or FS image (see [here](#run-on-qemu-system-riscv64)). - -## Progress -- [x] Multicore boot -- [x] Bare-metal printf -- [x] Memory alloc -- [x] Page Table -- [x] Timer interrupt -- [x] S mode extern interrupt -- [x] Receive uarths message -- [x] SD card driver -- [x] Process management -- [x] File system -- [x] User program -- [X] Steady keyboard input(k210) - -## TODO -Fix the bugs of U-mode exception on k210. - -- GitLab