Xous SDK (pinned for betrusted transpilation)
Find a file
Sam Blenny 803f6d496f fix passphrase length limit to match WF200 API
Signed-off-by: samblenny
2021-07-21 09:06:12 +00:00
.cargo
.vscode
devkey beginnings of image signing 2021-07-06 17:31:09 +08:00
docs Update flash.md 2021-07-21 00:03:29 +08:00
emulation update renode svd 2021-07-18 18:52:07 +08:00
imports
kernel kernel: riscv: ensure stack is 16-byte aligned 2021-07-07 14:34:05 +08:00
LICENSES
loader Merge branch 'main' of github.com:betrusted-io/xous-core into main 2021-07-13 22:42:57 +08:00
macros
precursors pivot spinor implementation 2021-07-15 23:00:50 +08:00
services fix passphrase length limit to match WF200 API 2021-07-21 09:06:12 +00:00
svd2repl trying to merge...what are all these changes? 2021-07-18 12:31:29 +08:00
svd2utra
tools add explicit .iter() for arrays so we still work with Rust 1.51 2021-07-18 16:04:22 +08:00
utralib
xous-ipc
xous-rs Merge branch 'main' into bunnie-dev 2021-07-18 12:33:16 +08:00
xtask Merge branch 'main' into bunnie-dev 2021-07-18 12:33:16 +08:00
.gitattributes
.gitignore
buildpush.bat button up after debugging the ed25519 issue 2021-06-29 23:46:15 +08:00
buildpush.sh
Cargo.lock Merge branch 'main' into bunnie-dev 2021-07-18 12:33:16 +08:00
Cargo.toml stash commit to fix a bootloader issue 2021-07-13 22:28:46 +08:00
CODE_OF_CONDUCT.md
CONTRIBUTING.md
README.md update with some hints that hopefully make installation easier 2021-07-11 17:00:38 +08:00
RELEASE-v0.8.md
start-gdb.sh
wb-gdb.sh

Xous Core

Core files for the Xous microkernel operating system.

You might find this collection of Xous documentation handy.

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

Dependencies

There's some Python scripts to help deal with firmware signing. Ensure the following python packages are available in your environment: pycryptodome (signing - PEM read), cryptography (signing - x509 read), pynacl (signing - ed25519 signatures). If you plan on doing USB firmware updates, you'll also need progressbar2 (updates), pyusb (updates).

Quickstart using Hosted Mode

You can try out Xous in a "hosted mode" wherein programs are compiled for your native platform and are run locally as processes within your current operating system. System calls are replaced with network calls to a kernel that simply shuffles messages around.

Xous uses the xtask convention, where various complex build commands are stored under cargo xtask. This allows for us to create arbitrarily complex build sequences without resorting to make (which is platform-dependent), sh (which requires a lot of external tooling), or another build system.

To build a set of sample programs and run them all using the kernel for communication, clone this repository and run:

cargo xtask run

This will build several servers and a "shell" program to control them all. Most notably, a graphics-server will appear and kernel messages will begin scrolling in your terminal.

Quickstart using an emulator

Xous uses Renode as the preferred emulator, because it is easy to extend the hardware peripherals without recompiling the entire emulator.

Download Renode and ensure it is in your path. Then, build Xous:

rustup target add riscv32imac-unknown-none-elf
cargo xtask renode-image

This will compile everything in release mode for RISC-V, compile the tools require to package it all up, then create an image file.

Finally, run Renode and specify the xous-release.resc REnode SCript:

renode emulation/xous-release.resc

Renode will start emulation automatically, and will run the same set of programs as in "Hosted mode".

Generating a hardware image

To build for real hardware, you must specify an .svd file. This file is generated by the SoC build process and describes a single Betrusted core. These addresses will change as hardware is modified, so if you distribute a modified Betrusted core, you should be sure to distribute the .svd file.

An example file may be found under svd2utra/, but this is probably out of date and won't work with your device.

Pass this .svd file to the hw-image xtask command:

cargo xtask hw-image svd2utra/examples/soc.svd

This will compile all runtime packages for riscv32imac-unknown-none-elf, and will generate a release image under the target/ directory, which will be printed on the output.

The image should be written to location 0x2050_0000 (SPI ROM offset 0x50_0000), using the provision-xous.sh script inside betrusted-scripts running on a Betrusted provisioning harness, that is a Raspberry Pi 4 with the appropriate debug hat attached, and the Precursor hardware plugged into the debug hat. You can also check out the dvt-hardware branch for the WIP integration of all the above commands.