Crates.io | embedded-alloc |
lib.rs | embedded-alloc |
version | 0.5.1 |
source | src |
created_at | 2022-12-06 19:25:08.66973 |
updated_at | 2023-11-05 00:24:20.822193 |
description | A heap allocator for embedded systems |
homepage | |
repository | https://github.com/rust-embedded/embedded-alloc |
max_upload_size | |
id | 731384 |
size | 41,975 |
embedded-alloc
A heap allocator for embedded systems.
Note that using this as your global allocator requires Rust 1.68 or later.
(With earlier versions, you need the unstable feature #![feature(default_alloc_error_handler)]
)
This project is developed and maintained by the libs team.
Starting with Rust 1.68, this crate can be used as a global allocator on stable Rust:
#![no_std]
#![no_main]
extern crate alloc;
use cortex_m_rt::entry;
use embedded_alloc::Heap;
#[global_allocator]
static HEAP: Heap = Heap::empty();
#[entry]
fn main() -> ! {
// Initialize the allocator BEFORE you use it
{
use core::mem::MaybeUninit;
const HEAP_SIZE: usize = 1024;
static mut HEAP_MEM: [MaybeUninit<u8>; HEAP_SIZE] = [MaybeUninit::uninit(); HEAP_SIZE];
unsafe { HEAP.init(HEAP_MEM.as_ptr() as usize, HEAP_SIZE) }
}
// now the allocator is ready types like Box, Vec can be used.
loop { /* .. */ }
}
For a full usage example, see examples/global_alloc.rs
.
For this to work, an implementation of critical-section
must be provided.
For simple use cases you may enable the critical-section-single-core
feature in the cortex-m crate.
Please refer to the documentation of critical-section
for further guidance.
Licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Contribution to this crate is organized under the terms of the Rust Code of Conduct, the maintainer of this crate, the libs team, promises to intervene to uphold that code of conduct.