esp-idf-alloc 0.1.0

Allocator for ESP-IDF
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

# Rust allocator backed by ESP-IDF


This is a memory allocator for Rust, backed by the [ESP-IDF](https://docs.espressif.com/projects/esp-idf/en/latest/).


This is intended to be used on an ESP32, linked against the ESP-IDF. For more information see:

* https://github.com/ctron/rust-esp-container/
* https://github.com/ctron/rust-esp-template
* https://github.com/MabezDev/rust-xtensa.git
* https://quickhack.net/nom/blog/2019-05-14-build-rust-environment-for-esp32.html

## Usage


Add the following to your main, application project:

~~~rust
extern crate esp_idf_alloc;

#[global_allocator]

static A: esp_idf_alloc::EspIdfAllocator = esp_idf_alloc::EspIdfAllocator;
~~~

### Error handler


If you use a custom global allocator in your application, you will also need an error handler.

The following code will use the ESP-IDF `abort()` method to handle the error:

~~~rust
#![feature(alloc_error_handler)]


use core::alloc::Layout;

extern "C" {
    fn abort() -> !;
}

#[alloc_error_handler]

fn alloc_error(_layout: Layout) -> ! {
    unsafe {
        abort();
    }
}
~~~

## Using with `alloc`


Also be sure to link in the `alloc` create, as you might want this. Add the following to your `Xargo.toml`:

~~~toml
[target.xtensa-esp32-none-elf.dependencies]
alloc={}
~~~