ruspiro-allocator 0.3.1

Simple and lightweight heap memory allocator for Raspberry Pi baremetal environments.
Documentation

Custom Allocator RusPiRo crate

This crate provides a custom allocator for heap memory. If any baremetal crate uses functions and structures from the alloc crate an allocator need to be provided as well. However, this crate does not export any public API to be used. It only encapsulates the memory allocator that shall be linked into the binary.

Travis-CI Status Latest Version Documentation License

Pre-Requisits

This crate requires to be buil with nightly as it uses the feature alloc_error_handler which is not stable yet.

Usage

To use the crate just add the following dependency to your Cargo.toml file:

[dependencies]
ruspiro-allocator = "0.3"

Once done the access to the custom allocator is available and will be linked with your project if you add the usage to your main crate rust file:

extern crate ruspiro_allocator;

Wherever you define the usage of the ruspiro-allocator crate the dynamic structures requiring heap memory allocations from the alloc crate could be used like so:

#[macro_use]
extern crate alloc;
use alloc::vec::*;
use alloc::boxed::*;

fn demo() {
    let mut v: Vec<u32> = vec![10, 20];
    let b: Box<u16> = Box::new(10);
    v.push(12);
}

License

Licensed under Apache License, Version 2.0, (LICENSE or http://www.apache.org/licenses/LICENSE-2.0)