xous-core/kernel
Sean Cross bb17038bfe kernel: rename "xous" to "xous-kernel" in import
Cargo appears to cache packages in the workspace when multiple packages
use the same crate. Unfortunately, Xous uses different features
depending on whether it's running in the kernel or in userspace.

Pull the kernel version of "xous" in under a different namespace in
order to force it to use a different build.

Signed-off-by: Sean Cross <sean@xobs.io>
2020-08-17 18:37:40 +08:00
..
.cargo kernel: begin re-porting xous to baremetal 2020-08-07 18:57:55 +08:00
.vscode kernel: remove more warnings 2020-08-09 21:52:28 +08:00
bin kernel: move to allow hosted init 2020-06-03 18:28:22 +08:00
src kernel: rename "xous" to "xous-kernel" in import 2020-08-17 18:37:40 +08:00
assemble.ps1 initial commit 2020-03-10 12:13:05 +08:00
assemble.sh initial commit 2020-03-10 12:13:05 +08:00
build.rs kernel: begin actor refactor 2020-06-03 15:34:55 +08:00
Cargo.toml kernel: rename "xous" to "xous-kernel" in import 2020-08-17 18:37:40 +08:00
LICENSE initial commit 2020-03-10 12:13:05 +08:00
link.x initial commit 2020-03-10 12:13:05 +08:00
README.md initial commit 2020-03-10 12:13:05 +08:00

Xous Kernel

This contains the core kernel for Xous. It requires a stage 1 loader in order to start up, as it assumes the system is already running in Supervisor mode.

Building

To build the kernel, you will need a riscv32 target for Rust. Possible targets include riscv32i-unknown-none-elf, riscv32imac-unknown-none-elf, or riscv32imac-unknown-xous-elf.

  1. Decide what target you want. For simple, embedded systems this could be riscv32i-unknown-none-elf, and for more complex systems with compressed instructions you could use riscv32imac-unknown-none-elf.
  2. Get Rust. Go to https://rustup.rs/ and follow its instructions.
  3. Install the proper toolchain: rustup target add ${target_arch}
  4. Build the kernel: cargo build --release --target ${target_arch}

Using

To use the kernel, you must package it up into an arguments binary with xous-tools.

Testing

TBD

Contribution Guidelines

Contributor Covenant

Please see CONTRIBUTING for details on how to make a contribution.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide its terms.

License

Copyright © 2020

Licensed under the Apache License 2.0 LICENSE