mirror of
https://github.com/lvgl/lvgl.git
synced 2025-01-21 06:53:01 +08:00
142 lines
2.9 KiB
C
142 lines
2.9 KiB
C
/**
|
|
* @file lv_mem.h
|
|
*
|
|
*/
|
|
|
|
#ifndef LV_MEM_H
|
|
#define LV_MEM_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*********************
|
|
* INCLUDES
|
|
*********************/
|
|
#include "../lv_conf_internal.h"
|
|
|
|
#include <stdint.h>
|
|
#include <stddef.h>
|
|
#include "lv_log.h"
|
|
#include "lv_types.h"
|
|
|
|
/*********************
|
|
* DEFINES
|
|
*********************/
|
|
|
|
#ifndef LV_MEM_BUF_MAX_NUM
|
|
#define LV_MEM_BUF_MAX_NUM 16
|
|
#endif
|
|
|
|
/**********************
|
|
* TYPEDEFS
|
|
**********************/
|
|
|
|
/**
|
|
* Heap information structure.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint32_t total_size; /**< Total heap size */
|
|
uint32_t free_cnt;
|
|
uint32_t free_size; /**< Size of available memory */
|
|
uint32_t free_biggest_size;
|
|
uint32_t used_cnt;
|
|
uint8_t used_pct; /**< Percentage used */
|
|
uint8_t frag_pct; /**< Amount of fragmentation */
|
|
} lv_mem_monitor_t;
|
|
|
|
typedef struct {
|
|
void * p;
|
|
uint16_t size;
|
|
uint8_t used :1;
|
|
}lv_mem_buf_t;
|
|
|
|
typedef lv_mem_buf_t lv_mem_buf_arr_t[LV_MEM_BUF_MAX_NUM];
|
|
extern lv_mem_buf_arr_t _lv_mem_buf;
|
|
|
|
/**********************
|
|
* GLOBAL PROTOTYPES
|
|
**********************/
|
|
|
|
/**
|
|
* Initiaize the dyn_mem module (work memory and other variables)
|
|
*/
|
|
void lv_mem_init(void);
|
|
|
|
/**
|
|
* Clean up the memory buffer which frees all the allocated memories.
|
|
* @note It work only if `LV_MEM_CUSTOM == 0`
|
|
*/
|
|
void lv_mem_deinit(void);
|
|
|
|
/**
|
|
* Allocate a memory dynamically
|
|
* @param size size of the memory to allocate in bytes
|
|
* @return pointer to the allocated memory
|
|
*/
|
|
void * lv_mem_alloc(size_t size);
|
|
|
|
/**
|
|
* Free an allocated data
|
|
* @param data pointer to an allocated memory
|
|
*/
|
|
void lv_mem_free(const void * data);
|
|
|
|
/**
|
|
* Reallocate a memory with a new size. The old content will be kept.
|
|
* @param data pointer to an allocated memory.
|
|
* Its content will be copied to the new memory block and freed
|
|
* @param new_size the desired new size in byte
|
|
* @return pointer to the new memory
|
|
*/
|
|
void * lv_mem_realloc(void * data_p, size_t new_size);
|
|
|
|
/**
|
|
* Join the adjacent free memory blocks
|
|
*/
|
|
void lv_mem_defrag(void);
|
|
|
|
lv_res_t lv_mem_test(void);
|
|
|
|
/**
|
|
* Give information about the work memory of dynamic allocation
|
|
* @param mon_p pointer to a dm_mon_p variable,
|
|
* the result of the analysis will be stored here
|
|
*/
|
|
void lv_mem_monitor(lv_mem_monitor_t * mon_p);
|
|
|
|
/**
|
|
* Give the size of an allocated memory
|
|
* @param data pointer to an allocated memory
|
|
* @return the size of data memory in bytes
|
|
*/
|
|
uint32_t lv_mem_get_size(const void * data);
|
|
|
|
/**
|
|
* Get a temporal buffer with the given size.
|
|
* @param size the required size
|
|
*/
|
|
void * lv_mem_buf_get(uint32_t size);
|
|
|
|
/**
|
|
* Release a memory buffer
|
|
* @param p buffer to release
|
|
*/
|
|
void lv_mem_buf_release(void * p);
|
|
|
|
/**
|
|
* Free all memory buffers
|
|
*/
|
|
void lv_mem_buf_free_all(void);
|
|
|
|
/**********************
|
|
* MACROS
|
|
**********************/
|
|
|
|
#ifdef __cplusplus
|
|
} /* extern "C" */
|
|
#endif
|
|
|
|
#endif /*LV_MEM_H*/
|