regions_mm.h

Go to the documentation of this file.

/* SPDX-License-Identifier: BSD-3-Clause */
/*
 * Copyright(c) 2022 - 2023 Intel Corporation. All rights reserved.
 *
 * Author: Jakub Dabek <jakub.dabek@intel.com>
 */
 
#ifndef ZEPHYR_LIB_REGIONS_MM_H_
#define ZEPHYR_LIB_REGIONS_MM_H_
 
#include <adsp_memory.h>
#include <adsp_memory_regions.h>
#include <ipc/topology.h>
#include <rtos/alloc.h>
#include <sof/list.h>
#include <zephyr/drivers/mm/system_mm.h>
#include <zephyr/init.h>
#include <zephyr/sys/mem_blocks.h>
 
#define VIRTUAL_REGION_SHARED_HEAP_ATTR 1U
#define VIRTUAL_REGION_LLEXT_LIBRARIES_ATTR 2U
#define VIRTUAL_REGION_VPAGES_ATTR 3U
 
#define MAX_MEMORY_ALLOCATORS_COUNT 10
 
#define DEFAULT_CONFIG_ALOCATORS_COUNT 5
 
struct vmh_block_bundle_descriptor {
    size_t block_size; 
    size_t number_of_blocks; 
};
 
/*
 * Maybe this heap config should have small bundles first going up to max
 * size or there should be a sorting mechanism for those ?
 * Should we assume that bundles are given from smallest to biggest ?
 */
 
struct vmh_heap_config {
    struct vmh_block_bundle_descriptor block_bundles_table[MAX_MEMORY_ALLOCATORS_COUNT];
};
 
struct vmh_heap *vmh_init_heap(const struct vmh_heap_config *cfg, bool allocating_continuously);
 
void *vmh_alloc(struct vmh_heap *heap, uint32_t alloc_size);
 
int vmh_free_heap(struct vmh_heap *heap);
 
int vmh_free(struct vmh_heap *heap, void *ptr);
 
void vmh_get_default_heap_config(const struct sys_mm_drv_region *region,
        struct vmh_heap_config *cfg);
#ifdef CONFIG_SYS_MEM_BLOCKS_RUNTIME_STATS
void vmh_log_stats(struct vmh_heap *heap);
 
void vmh_log_alloc_stats(struct vmh_heap *heap);
#endif
static inline bool vmh_is_ptr_in_memory_range(uintptr_t ptr, uintptr_t range_start,
    size_t range_size)
{
    return ptr >= range_start && ptr < range_start + range_size;
}
 
#endif /* ZEPHYR_LIB_REGIONS_MM_H_ */