mirror of
https://github.com/espressif/esp-idf.git
synced 2024-09-20 00:36:01 -04:00
82ad04e3ba
Following the upgrade to FreeRTOS kernel v10.5.1, this commit updates the version numbers, licenses, and SBOM files of FreeRTOS files to reflect v10.5.1. Note: - Updated licenses as v10.5.1 now uses SPDX format - Removed CVE-2021-43997 as it was fixed post v10.4.5
100 lines
3.3 KiB
C
100 lines
3.3 KiB
C
/*
|
|
* SPDX-FileCopyrightText: 2023 Espressif Systems (Shanghai) CO LTD
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
#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 )
|
|
#error This file must not be used if configSUPPORT_DYNAMIC_ALLOCATION is 0
|
|
#endif
|
|
|
|
#include "esp_heap_caps.h"
|
|
|
|
#if !CONFIG_IDF_TARGET_LINUX
|
|
/* Memory util functions are not implemented in the Linux simulator */
|
|
#include "esp_memory_utils.h"
|
|
#endif /* CONFIG_IDF_TARGET_LINUX */
|
|
|
|
#define portFREERTOS_HEAP_CAPS ( MALLOC_CAP_INTERNAL | MALLOC_CAP_8BIT )
|
|
|
|
/*-----------------------------------------------------------*/
|
|
|
|
void * pvPortMalloc( size_t xWantedSize )
|
|
{
|
|
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). */
|
|
pvReturn = heap_caps_malloc( xWantedSize, portFREERTOS_HEAP_CAPS );
|
|
|
|
return pvReturn;
|
|
}
|
|
/*-----------------------------------------------------------*/
|
|
|
|
void vPortFree( void * pv )
|
|
{
|
|
heap_caps_free( pv );
|
|
}
|
|
/*-----------------------------------------------------------*/
|
|
|
|
size_t xPortGetFreeHeapSize( void )
|
|
{
|
|
return heap_caps_get_free_size( portFREERTOS_HEAP_CAPS );
|
|
}
|
|
/*-----------------------------------------------------------*/
|
|
|
|
size_t xPortGetMinimumEverFreeHeapSize( void )
|
|
{
|
|
return heap_caps_get_minimum_free_size( portFREERTOS_HEAP_CAPS );
|
|
}
|
|
/*-----------------------------------------------------------*/
|
|
|
|
bool xPortCheckValidTCBMem( const void * ptr )
|
|
{
|
|
#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 */
|
|
}
|
|
|
|
bool xPortcheckValidStackMem( const void * ptr )
|
|
{
|
|
#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 */
|
|
}
|