Additional Linux README updates

This commit is contained in:
Jordan Carlin 2024-08-08 00:00:52 -07:00
parent 76eef03fe4
commit 94e923ef46
No known key found for this signature in database
2 changed files with 18 additions and 14 deletions

View File

@ -76,8 +76,6 @@ $(RISCV):
@ echo "and sourced setup.sh" @ echo "and sourced setup.sh"
# Disassembly rules --------------------------------------------------- # Disassembly rules ---------------------------------------------------
disassemble: disassemble:
rm -rf $(BUILDROOT)/output/images/disassembly rm -rf $(BUILDROOT)/output/images/disassembly
find $(BUILDROOT)/output/build/linux-* -maxdepth 1 -name "vmlinux" | xargs cp -t $(BUILDROOT)/output/images/ find $(BUILDROOT)/output/build/linux-* -maxdepth 1 -name "vmlinux" | xargs cp -t $(BUILDROOT)/output/images/
@ -106,7 +104,6 @@ $(IMAGES)/busybox:
cp $$busyboxDir/busybox $@ ;\ cp $$busyboxDir/busybox $@ ;\
# Generating new Buildroot directories -------------------------------- # Generating new Buildroot directories --------------------------------
download: $(WALLYBOARD) download: $(WALLYBOARD)
cp $(WALLYBOARD)/main.config $(BUILDROOT)/.config cp $(WALLYBOARD)/main.config $(BUILDROOT)/.config
@echo "Buildroot successfully download." @echo "Buildroot successfully download."

View File

@ -5,7 +5,8 @@
1. [Setting up Buildroot](#buildroot) 1. [Setting up Buildroot](#buildroot)
2. [Generating Device Tree Binaries](#devicetree) 2. [Generating Device Tree Binaries](#devicetree)
3. [Disassembling the Binaries for Debugging](#disassembly) 3. [Disassembling the Binaries for Debugging](#disassembly)
4. [Creating a Bootable SD Card](#sdcard) 4. [Generating test-vectors for regression](#testvectors)
5. [Creating a Bootable SD Card](#sdcard)
## Setting up Buildroot <a name="buildroot"></a> ## Setting up Buildroot <a name="buildroot"></a>
@ -15,9 +16,9 @@ To set up a Buildroot directory, configuration files for Buildroot, Linux, and B
$ make $ make
This installs to the `$RISCV` directory. This installs to the `$RISCV` directory. Buildroot itself is installed to `$RISCV/buildroot` and the test-vectors are installed to `$RISCV/linux-testvectors`.
Optionally, you can override the `BUILDROOT` variable to use a different buildroot source directory. Optionally, you can override the `BUILDROOT` variable to install a different buildroot source directory.
$ make install BUILDROOT=path/to/buildroot $ make install BUILDROOT=path/to/buildroot
@ -41,6 +42,12 @@ The disassembled binaries are built automatically using the main `make` command.
You'll find the resulting disassembled files in `<BUILDROOT>/output/images/disassembly`. You'll find the resulting disassembled files in `<BUILDROOT>/output/images/disassembly`.
## Generate Memory Files for Linux Boot <a name="testvectors"></a>
Running a linux boot simulation uses a preloaded bootrom and ram memory. We use QEMU to generate these preloaded memory files. The files are output to $RISCV/linux-testvectors. The memory files are generated automatically when using the main `make` command. Alternatively, they can be generated by running
make dumptvs
## Creating a Bootable SD Card <a name="sdcard"></a> ## Creating a Bootable SD Card <a name="sdcard"></a>
To flash a bootable sd card for Wally's bootloader, use the `flash-sd.sh` script located in `<WALLY>/linux/sdcard`. The script allows you to specify which buildroot directory you would like to use and to specify the device tree. By default it is set up for the default location of buildroot in `$RISCV` and uses the vcu108 device tree. To use the script with your own buildroot directory and device tree, type: To flash a bootable sd card for Wally's bootloader, use the `flash-sd.sh` script located in `<WALLY>/linux/sdcard`. The script allows you to specify which buildroot directory you would like to use and to specify the device tree. By default it is set up for the default location of buildroot in `$RISCV` and uses the vcu108 device tree. To use the script with your own buildroot directory and device tree, type: