michaelh/zephyr
1
0
Fork 0
Code Releases Activity

kernel: kheap: introduce K_HEAP_DEFINE_NOCACHE()

Browse source 
This allows a kheap to be defined in the uncached memory.
For example, this can be used for DMA transfer buffers.

Signed-off-by: Daniel Leung <daniel.leung@intel.com>
This commit is contained in:
Daniel Leung 2021-08-30 10:36:59 -07:00 • committed by Anas Nashif
commit 10490387b4
1 changed files with 46 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

55
include/kernel.h
View file

@ -5023,6 +5023,33 @@ void k_heap_free(struct k_heap *h, void *mem);
*/ */
#define Z_HEAP_MIN_SIZE (sizeof(void *) > 4 ? 56 : 44) #define Z_HEAP_MIN_SIZE (sizeof(void *) > 4 ? 56 : 44)
/**
* @brief Define a static k_heap in the specified linker section
*
* This macro defines and initializes a static memory region and
* k_heap of the requested size in the specified linker section.
* After kernel start, &name can be used as if k_heap_init() had
* been called.
*
* Note that this macro enforces a minimum size on the memory region
* to accommodate metadata requirements. Very small heaps will be
* padded to fit.
*
* @param name Symbol name for the struct k_heap object
* @param bytes Size of memory region, in bytes
* @param in_section __attribute__((section(name))
*/
#define Z_HEAP_DEFINE_IN_SECT(name, bytes, in_section) \
char in_section \
__aligned(8) /* CHUNK_UNIT */ \
kheap_##name[MAX(bytes, Z_HEAP_MIN_SIZE)]; \
STRUCT_SECTION_ITERABLE(k_heap, name) = { \
.heap = { \
.init_mem = kheap_##name, \
.init_bytes = MAX(bytes, Z_HEAP_MIN_SIZE), \
}, \
}
/** /**
* @brief Define a static k_heap * @brief Define a static k_heap
* *
@ -5038,15 +5065,25 @@ void k_heap_free(struct k_heap *h, void *mem);
* @param bytes Size of memory region, in bytes * @param bytes Size of memory region, in bytes
*/ */
#define K_HEAP_DEFINE(name, bytes) \ #define K_HEAP_DEFINE(name, bytes) \
char __noinit_named(kheap_buf_##name) \ Z_HEAP_DEFINE_IN_SECT(name, bytes, \
__aligned(8) /* CHUNK_UNIT */ \ __noinit_named(kheap_buf_##name))
kheap_##name[MAX(bytes, Z_HEAP_MIN_SIZE)]; \
STRUCT_SECTION_ITERABLE(k_heap, name) = { \ /**
.heap = { \ * @brief Define a static k_heap in uncached memory
.init_mem = kheap_##name, \ *
.init_bytes = MAX(bytes, Z_HEAP_MIN_SIZE), \ * This macro defines and initializes a static memory region and
}, \ * k_heap of the requested size in uncache memory. After kernel
} * start, &name can be used as if k_heap_init() had been called.
*
* Note that this macro enforces a minimum size on the memory region
* to accommodate metadata requirements. Very small heaps will be
* padded to fit.
*
* @param name Symbol name for the struct k_heap object
* @param bytes Size of memory region, in bytes
*/
#define K_HEAP_DEFINE_NOCACHE(name, bytes) \
Z_HEAP_DEFINE_IN_SECT(name, bytes, __nocache)
/** /**
* @} * @}