OBSOLETE

This is no longer the recommended way to get a Rust toolchain for RISCV. Instead, you can clone the riscv-rust/rust fork of Rust and build it as normal:

./x.py build

You can use

make toolchain

to build binutils and openocd for RISCV.

Rust Toolchain for RISCV

Supported boards

hifive (RV32IMAC)

Getting started

Get the source

git clone --recursive https://github.com/riscv-rust/riscv-rust-toolchain
cd riscv-rust-toolchain

Install build dependencies See manifest.scm for a list of the required build dependencies.
Build the toolchain A list of all set environment variables is in build-env.sh, adapt to your distro if necessary.

# Builds llvm openocd binutils rust and xargo
make toolchain

Clone quickstart template

git clone https://github.com/riscv-rust/riscv-rust-quickstart
cd riscv-rust-quickstart

Follow instructions in riscv-rust-quickstart's README.md

RISCV crates

riscv crate provides routines for riscv specific asm instructions and reading/writing csr's.
riscv-rt crate provides startup code, linker script and interrupt handling code.
e310x crate is a svd2rust generated api to Freedom E310 MCU peripherals.
hifive crate is a board support crate for the hifive board.

License

ISC License

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.