Feature flags of esp-rtos crate // Lib.rs

Cargo Features

esp-rtos has no features set by default.

[dependencies]
esp-rtos = { version = "0.2.0", features = ["embassy", "esp-radio", "alloc", "esp-alloc", "rtos-trace", "esp32", "esp32c2", "esp32c3", "esp32c6", "esp32h2", "esp32s2", "esp32s3", "log-04", "defmt"] }

embassy

Enable embassy integration (time driver and executors).

Enables embassy-executor, embassy-time-driver, and embassy-time-queue-utils

embassy-time-driver:
Optional dependencies that enable ecosystem support.

Affects esp-rtos::embassy…

esp-radio = alloc

Enable esp-radio support.

Enables esp-radio-rtos-driver

alloc esp-alloc? esp-radio?

Not documented because we don't currently expose anything that requires alloc, but isn't related to esp-radio.
TODO: make this public once we actually have alloc-based APIs.

Enables allocator-api2 ^0.3.0 and esp-radio-rtos-driver

allocator-api2:
Unstable dependencies that are not (strictly) part of the public API

esp-alloc = alloc

Enable the use of the esp-alloc crate for dynamic memory allocation.

Memory allocation is required by esp-radio. If you choose to not enable this feature, you need to provide implementations for the following functions:

pub extern "C" fn malloc_internal(size: usize) -> *mut u8

pub extern "C" fn free_internal(ptr: *mut u8)

Note that the untyped nature of the allocator functions means that esp-alloc is likely the more memory efficient option.