anton/EMBARK
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
57 Commits 1 Branch 1 Tag 555 KiB
C 67.8%
Python 17.8%
Assembly 10%
Makefile 3.8%
Shell 0.6%
426a6508d1
Go to file
Anton Lydike 426a6508d1 removed trailing whitespaces
2021-08-22 19:04:15 +02:00
kinclude removed trailing whitespaces 2021-08-22 19:04:15 +02:00
programs added various (bad) example programs 2021-08-21 21:24:21 +02:00
.gitignore added .img files to gitignore 2021-08-18 13:19:03 +02:00
kernel.c kernel.(c|h) moved debugging code into if (DEBUGGING) section and cleaned up whitespace 2021-08-22 19:03:16 +02:00
kernel.h kernel.(c|h) moved debugging code into if (DEBUGGING) section and cleaned up whitespace 2021-08-22 19:03:16 +02:00
LICENSE initial commit 2021-06-21 11:12:33 +02:00
linker.ld various imrpovements and implementations on the kernel 2021-08-21 21:18:03 +02:00
Makefile bundled all types into ktypes.h and added optionals 2021-08-21 12:17:04 +02:00
package.py added end of config comment to package.py 2021-08-21 21:27:27 +02:00
README.md updated readme 2021-08-21 21:27:11 +02:00

README.md

EMBARK: An Educational and Modifiable BAsic RISC-V Kernel

EMBARK is a small kernel, designed for educational projects. It has very limited scope and is designed to be extensible.

The toolchain:

I am using the riscv-gnu-toolchain, configured with --with-arch=rv32im --disable-linux --disable-gdb --disable-multilib and built using make -j <number of threads>.

The Makefile:

You can build the kernel using make kernel. Make sure the toolchain is in your path!

Packaging a kernel image with user programs

You can use the package.py script to package a kernel and multiple user binaries into a single img file.

Debugging information is also emitted, it's a json formatted file called <name>.img.dbg.

To generate such an image, run python3 package.py out/kernel <user bin 1> <usr bin 2> ... output/path/memory.img. You can edit the script to change various variables. They somewhat well documented.