saymrwulf/xous-core
1
0
Fork 0
mirror of https://github.com/saymrwulf/xous-core.git synced 2026-11-08 04:56:43 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Xous SDK (pinned for betrusted transpilation)
44 commits 1 branch 0 tags 404 MiB
Rust 93.7%
Python 3%
C# 2.2%
C 0.6%
Assembly 0.2%
Other 0.1%
Find a file
Sean Cross fcdc0da19f kernel: use upstream riscv crate 
Now that this is published upstream, we can remove our dependency on a
particular git version.

Signed-off-by: Sean Cross <sean@xobs.io>
2020-03-16 08:42:32 +08:00
docs arguments: use byte-sized granularity for IniE 2020-03-12 15:28:28 +08:00
emulation emulation: add initial files for lcd and keyboard 2020-03-14 15:44:44 +08:00
examples log: call create_server syscall 2020-03-14 15:58:22 +08:00
kernel kernel: use upstream riscv crate 2020-03-16 08:42:32 +08:00
loader loader: implement byte-addressing for init elf files 2020-03-12 15:29:10 +08:00
tools tools: generate byte addresses for mini elf files 2020-03-12 15:29:26 +08:00
xous-rs xous-rs: implement create_server syscall 2020-03-14 15:57:58 +08:00
.gitattributes initial commit 2020-03-10 12:13:05 +08:00
.gitignore initial commit 2020-03-10 12:13:05 +08:00
Cargo.lock log: add log example 2020-03-13 20:32:44 +08:00
Cargo.toml log: add log example 2020-03-13 20:32:44 +08:00
CODE_OF_CONDUCT.md initial commit 2020-03-10 12:13:05 +08:00
CONTRIBUTING.md initial commit 2020-03-10 12:13:05 +08:00
README.md README: update info on running renode 2020-03-12 13:33:37 +08:00

README.md

Xous Core

Core files for the Xous microkernel operating system.

This repository contains everything necessary to build the Xous kernel from source. It consists of the following projects:

  • kernel: core memory manager, irq manager, and syscallhandler
  • loader: initial loader used to start the kernel
  • tools: programs used to construct a final boot image
  • docs: documentation on various aspects of Xous
  • emulation: Renode scripts used to emulate Xous
  • xous-rs: userspace library

Generating an image

You can build all Xous packages by running:

$ rustup target add riscv32imac-unknown-none-elf
$ cargo build --target riscv32imac-unknown-none-elf
$ cd kernel
$ cargo build -p kernel --target riscv32imac-unknown-none-elf
$ cd ..
$ cd loader
$ cargo build -p loader --target riscv32imac-unknown-none-elf
$ cd ..

This will compile all runtime packages for riscv32imac-unknown-none-elf. Note that the kernel and loader must currently be built separately, due to the fact that they have custom linker scripts.

These need to be packaged into a loadable binary. You can generate such a binary by running the following:

$ cargo run -p tools --bin create-image -- \
        --csv emulation/csr.csv \
        --kernel target/riscv32imac-unknown-none-elf/debug/kernel \
        --init target/riscv32imac-unknown-none-elf/debug/shell \
        target/args.bin

$