pub fn init_heap(profile: HeapProfile)Expand description
Register the global heap’s DRAM regions for profile, using the
HIL-proven per-board sizes. Call once, right after crate::board::init /
Board::split and before any allocation.
This is the single place a binary sets up the DRAM heap — it never calls
esp_alloc::heap_allocator! itself. This never touches PSRAM: see
psram_map / psram_split for that, called separately (and
optionally) afterward. esp-alloc’s global heap holds at most three
regions; each profile registers at most the reclaimed-ROM region and the
plain-DRAM region, leaving room for psram_split’s external region — a
4th add_region panics silently.