/**
 * @file memmgr_heap.h
 * Furi: heap memory management API and allocator
 */

#pragma once

#include <stdint.h>
#include <core/thread.h>

#ifdef __cplusplus
extern "C" {
#endif

#define MEMMGR_HEAP_UNKNOWN 0xFFFFFFFF

/** Memmgr heap enable thread allocation tracking
 *
 * @param      thread_id  - thread id to track
 */
void memmgr_heap_enable_thread_trace(FuriThreadId thread_id);

/** Memmgr heap disable thread allocation tracking
 *
 * @param      thread_id  - thread id to track
 */
void memmgr_heap_disable_thread_trace(FuriThreadId thread_id);

/** Memmgr heap get allocatred thread memory
 *
 * @param      thread_id  - thread id to track
 *
 * @return     bytes allocated right now
 */
size_t memmgr_heap_get_thread_memory(FuriThreadId thread_id);

/** Memmgr heap get the max contiguous block size on the heap
 *
 * @return     size_t max contiguous block size
 */
size_t memmgr_heap_get_max_free_block(void);

typedef bool (*BlockWalker)(void* pointer, size_t size, bool used, void* context);

/**
 * @brief Walk through all heap blocks
 * @warning This function will lock memory manager and may cause deadlocks if any malloc/free is called inside the callback.
 *          Also, printf and furi_log contains malloc calls, so do not use them.
 * 
 * @param walker 
 * @param context 
 */
void memmgr_heap_walk_blocks(BlockWalker walker, void* context);

#ifdef __cplusplus
}
#endif