2023-03-01 06:06:10 -05:00
|
|
|
/*
|
2024-01-26 09:07:54 -05:00
|
|
|
* SPDX-FileCopyrightText: 2023-2024 Espressif Systems (Shanghai) CO LTD
|
2023-03-01 06:06:10 -05:00
|
|
|
*
|
2023-10-08 15:30:04 -04:00
|
|
|
* SPDX-License-Identifier: Apache-2.0
|
2023-03-01 06:06:10 -05:00
|
|
|
*/
|
|
|
|
|
|
|
|
#include "sdkconfig.h"
|
|
|
|
|
|
|
|
/* This file implements the heap related functions that are called by FreeRTOS.
|
|
|
|
* ESP-IDF provides its own heap containing memory with different capabilities
|
|
|
|
* (see esp_heap_caps.h). Thus, this file maps a subset of the ESP-IDF heap to
|
|
|
|
* act as the FreeRTOS heap.
|
|
|
|
*
|
|
|
|
* All dynamic allocation done by FreeRTOS should be placed in internal 8-bit
|
|
|
|
* accessible RAM (i.e., using the MALLOC_CAP_INTERNAL|MALLOC_CAP_8BIT flags).
|
|
|
|
* This is due to the fact that FreeRTOS objects (e.g., task stacks, TCBs,
|
|
|
|
* queues etc) must be accessible even if the cache is disabled. Therefore, the
|
|
|
|
* heap that is made available to FreeRTOS for dynamic allocation is a subset of
|
|
|
|
* the ESP-IDF heap (where all MALLOC_CAP_INTERNAL|MALLOC_CAP_8BIT memory is
|
|
|
|
* made available to FreeRTOS for dynamic allocation).
|
|
|
|
*/
|
|
|
|
|
|
|
|
/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining
|
|
|
|
* all the API functions to use the MPU wrappers. That should only be done when
|
|
|
|
* task.h is included from an application file. */
|
|
|
|
#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE
|
|
|
|
|
|
|
|
#include "FreeRTOS.h"
|
|
|
|
|
|
|
|
#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE
|
|
|
|
|
|
|
|
#if ( configSUPPORT_DYNAMIC_ALLOCATION == 0 )
|
2024-01-26 09:07:54 -05:00
|
|
|
#error This file must not be used if configSUPPORT_DYNAMIC_ALLOCATION is 0
|
2023-03-01 06:06:10 -05:00
|
|
|
#endif
|
|
|
|
|
|
|
|
#include "esp_heap_caps.h"
|
|
|
|
|
|
|
|
#if !CONFIG_IDF_TARGET_LINUX
|
2024-01-26 09:07:54 -05:00
|
|
|
/* Memory util functions are not implemented in the Linux simulator */
|
|
|
|
#include "esp_memory_utils.h"
|
2023-03-01 06:06:10 -05:00
|
|
|
#endif /* CONFIG_IDF_TARGET_LINUX */
|
|
|
|
|
|
|
|
#define portFREERTOS_HEAP_CAPS ( MALLOC_CAP_INTERNAL | MALLOC_CAP_8BIT )
|
|
|
|
|
|
|
|
/*-----------------------------------------------------------*/
|
|
|
|
|
2024-01-26 09:07:54 -05:00
|
|
|
void * pvPortMalloc(size_t xWantedSize)
|
2023-03-01 06:06:10 -05:00
|
|
|
{
|
|
|
|
void * pvReturn = NULL;
|
|
|
|
|
|
|
|
/* All dynamic allocation done by FreeRTOS goes through this function. If
|
|
|
|
* users need to allocate FreeRTOS objects into external RAM, they should
|
|
|
|
* use the "static" equivalents of FreeRTOS API to create FreeRTOS objects
|
|
|
|
* (e.g., queues). */
|
2024-01-26 09:07:54 -05:00
|
|
|
pvReturn = heap_caps_malloc(xWantedSize, portFREERTOS_HEAP_CAPS);
|
2023-03-01 06:06:10 -05:00
|
|
|
|
|
|
|
return pvReturn;
|
|
|
|
}
|
|
|
|
/*-----------------------------------------------------------*/
|
|
|
|
|
2024-01-26 09:07:54 -05:00
|
|
|
void vPortFree(void * pv)
|
2023-03-01 06:06:10 -05:00
|
|
|
{
|
2024-01-26 09:07:54 -05:00
|
|
|
heap_caps_free(pv);
|
2023-03-01 06:06:10 -05:00
|
|
|
}
|
|
|
|
/*-----------------------------------------------------------*/
|
|
|
|
|
2024-01-26 09:07:54 -05:00
|
|
|
size_t xPortGetFreeHeapSize(void)
|
2023-03-01 06:06:10 -05:00
|
|
|
{
|
2024-01-26 09:07:54 -05:00
|
|
|
return heap_caps_get_free_size(portFREERTOS_HEAP_CAPS);
|
2023-03-01 06:06:10 -05:00
|
|
|
}
|
|
|
|
/*-----------------------------------------------------------*/
|
|
|
|
|
2024-01-26 09:07:54 -05:00
|
|
|
size_t xPortGetMinimumEverFreeHeapSize(void)
|
2023-03-01 06:06:10 -05:00
|
|
|
{
|
2024-01-26 09:07:54 -05:00
|
|
|
return heap_caps_get_minimum_free_size(portFREERTOS_HEAP_CAPS);
|
2023-03-01 06:06:10 -05:00
|
|
|
}
|
|
|
|
/*-----------------------------------------------------------*/
|
|
|
|
|
2024-01-26 09:07:54 -05:00
|
|
|
bool xPortCheckValidListMem(const void * ptr)
|
2023-12-24 15:37:45 -05:00
|
|
|
{
|
2024-01-26 09:07:54 -05:00
|
|
|
#if CONFIG_IDF_TARGET_LINUX
|
|
|
|
return true;
|
|
|
|
#else /* CONFIG_IDF_TARGET_LINUX */
|
|
|
|
return esp_ptr_internal(ptr) && esp_ptr_byte_accessible(ptr);
|
|
|
|
#endif /* CONFIG_IDF_TARGET_LINUX */
|
2023-12-24 15:37:45 -05:00
|
|
|
}
|
|
|
|
|
2024-01-26 09:07:54 -05:00
|
|
|
bool xPortCheckValidTCBMem(const void * ptr)
|
2023-03-01 06:06:10 -05:00
|
|
|
{
|
2024-01-26 09:07:54 -05:00
|
|
|
#if CONFIG_IDF_TARGET_LINUX
|
|
|
|
return true;
|
|
|
|
#else /* CONFIG_IDF_TARGET_LINUX */
|
|
|
|
return esp_ptr_internal(ptr) && esp_ptr_byte_accessible(ptr);
|
|
|
|
#endif /* CONFIG_IDF_TARGET_LINUX */
|
2023-03-01 06:06:10 -05:00
|
|
|
}
|
|
|
|
|
2024-01-26 09:07:54 -05:00
|
|
|
bool xPortcheckValidStackMem(const void * ptr)
|
2023-03-01 06:06:10 -05:00
|
|
|
{
|
2024-01-26 09:07:54 -05:00
|
|
|
#if CONFIG_IDF_TARGET_LINUX
|
|
|
|
return true;
|
|
|
|
#else /* CONFIG_IDF_TARGET_LINUX */
|
|
|
|
#ifdef CONFIG_SPIRAM_ALLOW_STACK_EXTERNAL_MEMORY
|
|
|
|
return esp_ptr_byte_accessible(ptr);
|
|
|
|
#else
|
|
|
|
return esp_ptr_internal(ptr) && esp_ptr_byte_accessible(ptr);
|
|
|
|
#endif
|
|
|
|
#endif /* CONFIG_IDF_TARGET_LINUX */
|
2023-03-01 06:06:10 -05:00
|
|
|
}
|