Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.
Boot crate for the RusPiRo kernel
This crate provides basic boot code that - when build into a kernel crate - will be executed as soon as the Raspberry Pi powers up. Building and finally linking this crate into the kernel image depends on several linker symbols to be present. Therfore, it is recommended to use the linker script provided when bulding the kernel.
Hint
The usage of this crate does only make sense when building a Raspberry Pi 3 bare metal kernel. The baremetal bootstrapping provided by this crate can be build for either Aarch32 or Aarch64 target architectures. It has been verified to cross compile from a Windows host machine successfully for both architectures and the execution is tested on a Raspberry Pi 3 B+.
Features
Feature | Purpose |
---|---|
multicore |
Compiles the multi-core version of the crate, kicking off all 4 cores of the Raspberry Pi. |
Usage
To use this crate simply add the following lines to your Cargo.toml
file:
[]
= "0.5.1"
In the main rust file refer to this crate with this:
extern crate ruspiro_boot;
The usage of extern crate
is mandatory to ensure the boot strapping is properly linked into the
final binary.
To successfully build a bare metal binary using this crate for the boot strapping part it is highly recomended to use the linker script link64.ld provided by this crate. To conviniently refer to the linker script contained in this crate it's recommended to use a specific build script in your project that copies the required file to your current project folder and could then be referred to with the RUSTFLAG
-C link-arg=-T./link64.ld
.
The build script is a simple build.rs
rust file in your project root with the following contents:
use ;
To get started you may want to check out the template projects provided here
License
Licensed under Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0) or MIT (LICENSE-MIT or http://opensource.org/licenses/MIT)) at your choice.