2016-08-17 15:08:22 +00:00
/*
FreeRTOS V8 .2 .0 - Copyright ( C ) 2015 Real Time Engineers Ltd .
All rights reserved
VISIT http : //www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* *
* FreeRTOS provides completely free yet professionally developed , *
* robust , strictly quality controlled , supported , and cross *
* platform software that has become a de facto standard . *
* *
* Help yourself get started quickly and support the FreeRTOS *
* project by purchasing a FreeRTOS tutorial book , reference *
* manual , or both from : http : //www.FreeRTOS.org/Documentation *
* *
* Thank you ! *
* *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
This file is part of the FreeRTOS distribution .
FreeRTOS is free software ; you can redistribute it and / or modify it under
the terms of the GNU General Public License ( version 2 ) as published by the
Free Software Foundation > > ! AND MODIFIED BY ! < < the FreeRTOS exception .
> > ! NOTE : The modification to the GPL is included to allow you to ! < <
> > ! distribute a combined work that includes FreeRTOS without being ! < <
> > ! obliged to provide the source code for proprietary components ! < <
> > ! outside of the FreeRTOS kernel . ! < <
FreeRTOS is distributed in the hope that it will be useful , but WITHOUT ANY
WARRANTY ; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE . Full license text is available from the following
link : http : //www.freertos.org/a00114.html
1 tab = = 4 spaces !
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* *
* Having a problem ? Start by reading the FAQ " My application does *
* not run , what could be wrong ? " *
* *
* http : //www.FreeRTOS.org/FAQHelp.html *
* *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
http : //www.FreeRTOS.org - Documentation, books, training, latest versions,
license and Real Time Engineers Ltd . contact details .
http : //www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
including FreeRTOS + Trace - an indispensable productivity tool , a DOS
compatible FAT file system , and our tiny thread aware UDP / IP stack .
http : //www.OpenRTOS.com - Real Time Engineers ltd license FreeRTOS to High
Integrity Systems to sell under the OpenRTOS brand . Low cost OpenRTOS
licenses offer ticketed support , indemnification and middleware .
http : //www.SafeRTOS.com - High Integrity Systems also provide a safety
engineered and independently SIL3 certified version for use in safety and
mission critical applications that require provable dependability .
1 tab = = 4 spaces !
*/
# ifndef PORTMACRO_H
# define PORTMACRO_H
# ifdef __cplusplus
extern " C " {
# endif
# ifndef __ASSEMBLER__
# include <stdint.h>
global: move the soc component out of the common list
This MR removes the common dependency from every IDF components to the SOC component.
Currently, in the ``idf_functions.cmake`` script, we include the header path of SOC component by default for all components.
But for better code organization (or maybe also benifits to the compiling speed), we may remove the dependency to SOC components for most components except the driver and kernel related components.
In CMAKE, we have two kinds of header visibilities (set by include path visibility):
(Assume component A --(depends on)--> B, B is the current component)
1. public (``COMPONENT_ADD_INCLUDEDIRS``): means this path is visible to other depending components (A) (visible to A and B)
2. private (``COMPONENT_PRIV_INCLUDEDIRS``): means this path is only visible to source files inside the component (visible to B only)
and we have two kinds of depending ways:
(Assume component A --(depends on)--> B --(depends on)--> C, B is the current component)
1. public (```COMPONENT_REQUIRES```): means B can access to public include path of C. All other components rely on you (A) will also be available for the public headers. (visible to A, B)
2. private (``COMPONENT_PRIV_REQUIRES``): means B can access to public include path of C, but don't propagate this relation to other components (A). (visible to B)
1. remove the common requirement in ``idf_functions.cmake``, this makes the SOC components invisible to all other components by default.
2. if a component (for example, DRIVER) really needs the dependency to SOC, add a private dependency to SOC for it.
3. some other components that don't really depends on the SOC may still meet some errors saying "can't find header soc/...", this is because it's depended component (DRIVER) incorrectly include the header of SOC in its public headers. Moving all this kind of #include into source files, or private headers
4. Fix the include requirements for some file which miss sufficient #include directives. (Previously they include some headers by the long long long header include link)
This is a breaking change. Previous code may depends on the long include chain.
You may need to include the following headers for some files after this commit:
- soc/soc.h
- soc/soc_memory_layout.h
- driver/gpio.h
- esp_sleep.h
The major broken include chain includes:
1. esp_system.h no longer includes esp_sleep.h. The latter includes driver/gpio.h and driver/touch_pad.h.
2. ets_sys.h no longer includes soc/soc.h
3. freertos/portmacro.h no longer includes soc/soc_memory_layout.h
some peripheral headers no longer includes their hw related headers, e.g. rom/gpio.h no longer includes soc/gpio_pins.h and soc/gpio_reg.h
BREAKING CHANGE
2019-04-03 05:17:38 +00:00
# include <stdlib.h>
# include <stdbool.h>
2016-08-17 15:08:22 +00:00
# include <xtensa/hal.h>
# include <xtensa/config/core.h>
# include <xtensa/config/system.h> /* required for XSHAL_CLIB */
# include <xtensa/xtruntime.h>
2019-03-15 09:44:27 +00:00
# include "esp_private/crosscore_int.h"
2017-10-30 08:03:56 +00:00
# include "esp_timer.h" /* required for FreeRTOS run time stats */
2017-03-16 03:07:50 +00:00
2016-08-17 15:08:22 +00:00
2017-09-22 08:02:39 +00:00
# include <esp_heap_caps.h>
global: move the soc component out of the common list
This MR removes the common dependency from every IDF components to the SOC component.
Currently, in the ``idf_functions.cmake`` script, we include the header path of SOC component by default for all components.
But for better code organization (or maybe also benifits to the compiling speed), we may remove the dependency to SOC components for most components except the driver and kernel related components.
In CMAKE, we have two kinds of header visibilities (set by include path visibility):
(Assume component A --(depends on)--> B, B is the current component)
1. public (``COMPONENT_ADD_INCLUDEDIRS``): means this path is visible to other depending components (A) (visible to A and B)
2. private (``COMPONENT_PRIV_INCLUDEDIRS``): means this path is only visible to source files inside the component (visible to B only)
and we have two kinds of depending ways:
(Assume component A --(depends on)--> B --(depends on)--> C, B is the current component)
1. public (```COMPONENT_REQUIRES```): means B can access to public include path of C. All other components rely on you (A) will also be available for the public headers. (visible to A, B)
2. private (``COMPONENT_PRIV_REQUIRES``): means B can access to public include path of C, but don't propagate this relation to other components (A). (visible to B)
1. remove the common requirement in ``idf_functions.cmake``, this makes the SOC components invisible to all other components by default.
2. if a component (for example, DRIVER) really needs the dependency to SOC, add a private dependency to SOC for it.
3. some other components that don't really depends on the SOC may still meet some errors saying "can't find header soc/...", this is because it's depended component (DRIVER) incorrectly include the header of SOC in its public headers. Moving all this kind of #include into source files, or private headers
4. Fix the include requirements for some file which miss sufficient #include directives. (Previously they include some headers by the long long long header include link)
This is a breaking change. Previous code may depends on the long include chain.
You may need to include the following headers for some files after this commit:
- soc/soc.h
- soc/soc_memory_layout.h
- driver/gpio.h
- esp_sleep.h
The major broken include chain includes:
1. esp_system.h no longer includes esp_sleep.h. The latter includes driver/gpio.h and driver/touch_pad.h.
2. ets_sys.h no longer includes soc/soc.h
3. freertos/portmacro.h no longer includes soc/soc_memory_layout.h
some peripheral headers no longer includes their hw related headers, e.g. rom/gpio.h no longer includes soc/gpio_pins.h and soc/gpio_reg.h
BREAKING CHANGE
2019-04-03 05:17:38 +00:00
# include "sdkconfig.h"
# ifdef CONFIG_LEGACY_INCLUDE_COMMON_HEADERS
2017-09-22 08:02:39 +00:00
# include "soc/soc_memory_layout.h"
global: move the soc component out of the common list
This MR removes the common dependency from every IDF components to the SOC component.
Currently, in the ``idf_functions.cmake`` script, we include the header path of SOC component by default for all components.
But for better code organization (or maybe also benifits to the compiling speed), we may remove the dependency to SOC components for most components except the driver and kernel related components.
In CMAKE, we have two kinds of header visibilities (set by include path visibility):
(Assume component A --(depends on)--> B, B is the current component)
1. public (``COMPONENT_ADD_INCLUDEDIRS``): means this path is visible to other depending components (A) (visible to A and B)
2. private (``COMPONENT_PRIV_INCLUDEDIRS``): means this path is only visible to source files inside the component (visible to B only)
and we have two kinds of depending ways:
(Assume component A --(depends on)--> B --(depends on)--> C, B is the current component)
1. public (```COMPONENT_REQUIRES```): means B can access to public include path of C. All other components rely on you (A) will also be available for the public headers. (visible to A, B)
2. private (``COMPONENT_PRIV_REQUIRES``): means B can access to public include path of C, but don't propagate this relation to other components (A). (visible to B)
1. remove the common requirement in ``idf_functions.cmake``, this makes the SOC components invisible to all other components by default.
2. if a component (for example, DRIVER) really needs the dependency to SOC, add a private dependency to SOC for it.
3. some other components that don't really depends on the SOC may still meet some errors saying "can't find header soc/...", this is because it's depended component (DRIVER) incorrectly include the header of SOC in its public headers. Moving all this kind of #include into source files, or private headers
4. Fix the include requirements for some file which miss sufficient #include directives. (Previously they include some headers by the long long long header include link)
This is a breaking change. Previous code may depends on the long include chain.
You may need to include the following headers for some files after this commit:
- soc/soc.h
- soc/soc_memory_layout.h
- driver/gpio.h
- esp_sleep.h
The major broken include chain includes:
1. esp_system.h no longer includes esp_sleep.h. The latter includes driver/gpio.h and driver/touch_pad.h.
2. ets_sys.h no longer includes soc/soc.h
3. freertos/portmacro.h no longer includes soc/soc_memory_layout.h
some peripheral headers no longer includes their hw related headers, e.g. rom/gpio.h no longer includes soc/gpio_pins.h and soc/gpio_reg.h
BREAKING CHANGE
2019-04-03 05:17:38 +00:00
# endif
2017-09-22 08:02:39 +00:00
2016-08-17 15:08:22 +00:00
//#include "xtensa_context.h"
/*-----------------------------------------------------------
* Port specific definitions .
*
* The settings in this file configure FreeRTOS correctly for the
* given hardware and compiler .
*
* These settings should not be altered .
* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
*/
/* Type definitions. */
# define portCHAR int8_t
# define portFLOAT float
# define portDOUBLE double
# define portLONG int32_t
# define portSHORT int16_t
# define portSTACK_TYPE uint8_t
# define portBASE_TYPE int
typedef portSTACK_TYPE StackType_t ;
typedef portBASE_TYPE BaseType_t ;
typedef unsigned portBASE_TYPE UBaseType_t ;
# if( configUSE_16_BIT_TICKS == 1 )
typedef uint16_t TickType_t ;
# define portMAX_DELAY ( TickType_t ) 0xffff
# else
typedef uint32_t TickType_t ;
# define portMAX_DELAY ( TickType_t ) 0xffffffffUL
# endif
/*-----------------------------------------------------------*/
// portbenchmark
# include "portbenchmark.h"
2016-08-24 04:23:58 +00:00
# include "sdkconfig.h"
2017-08-29 00:25:41 +00:00
# include "esp_attr.h"
2016-08-17 15:08:22 +00:00
2017-10-20 03:15:19 +00:00
/* "mux" data structure (spinlock) */
2016-08-17 15:08:22 +00:00
typedef struct {
2017-10-20 03:15:19 +00:00
/* owner field values:
2019-07-31 03:07:23 +00:00
* 0 - Uninitialized ( invalid )
2017-10-20 03:15:19 +00:00
* portMUX_FREE_VAL - Mux is free , can be locked by either CPU
2019-08-12 01:12:34 +00:00
* CORE_ID_REGVAL_PRO / CORE_ID_REGVAL_APP - Mux is locked to the particular core
2017-10-20 03:15:19 +00:00
*
2019-07-31 03:07:23 +00:00
* Note that for performance reasons we use the full Xtensa CORE ID values
2019-08-12 01:12:34 +00:00
* ( CORE_ID_REGVAL_PRO , CORE_ID_REGVAL_APP ) and not the 0 , 1 values which are used in most
2019-07-31 03:07:23 +00:00
* other FreeRTOS code .
*
2019-08-12 01:12:34 +00:00
* Any value other than portMUX_FREE_VAL , CORE_ID_REGVAL_PRO , CORE_ID_REGVAL_APP indicates corruption
2017-10-20 03:15:19 +00:00
*/
2017-02-16 05:03:02 +00:00
uint32_t owner ;
2017-10-20 03:15:19 +00:00
/* count field:
* If mux is unlocked , count should be zero .
* If mux is locked , count is non - zero & represents the number of recursive locks on the mux .
*/
2017-02-13 03:46:37 +00:00
uint32_t count ;
2016-08-25 08:30:47 +00:00
# ifdef CONFIG_FREERTOS_PORTMUX_DEBUG
2016-08-17 15:08:22 +00:00
const char * lastLockedFn ;
int lastLockedLine ;
# endif
} portMUX_TYPE ;
# define portMUX_FREE_VAL 0xB33FFFFF
2017-07-20 06:34:45 +00:00
/* Special constants for vPortCPUAcquireMutexTimeout() */
# define portMUX_NO_TIMEOUT (-1) /* When passed for 'timeout_cycles', spin forever if necessary */
# define portMUX_TRY_LOCK 0 /* Try to acquire the spinlock a single time only */
2017-10-20 03:15:19 +00:00
// Keep this in sync with the portMUX_TYPE struct definition please.
2016-08-25 08:30:47 +00:00
# ifndef CONFIG_FREERTOS_PORTMUX_DEBUG
2017-02-13 03:46:37 +00:00
# define portMUX_INITIALIZER_UNLOCKED { \
. owner = portMUX_FREE_VAL , \
. count = 0 , \
2016-08-22 09:45:46 +00:00
}
2016-08-22 09:36:32 +00:00
# else
2017-02-13 03:46:37 +00:00
# define portMUX_INITIALIZER_UNLOCKED { \
. owner = portMUX_FREE_VAL , \
. count = 0 , \
. lastLockedFn = " (never locked) " , \
2016-08-22 09:45:46 +00:00
. lastLockedLine = - 1 \
}
2016-08-22 09:36:32 +00:00
# endif
2016-08-17 15:08:22 +00:00
2016-09-05 04:30:57 +00:00
# define portASSERT_IF_IN_ISR() vPortAssertIfInISR()
2019-07-16 09:33:30 +00:00
void vPortAssertIfInISR ( void ) ;
2016-09-05 04:30:57 +00:00
2017-02-13 03:46:37 +00:00
# define portCRITICAL_NESTING_IN_TCB 1
2016-08-17 15:08:22 +00:00
/*
2017-10-20 03:15:19 +00:00
Modifications to portENTER_CRITICAL .
For an introduction , see " Critical Sections & Disabling Interrupts " in docs / api - guides / freertos - smp . rst
2016-08-17 15:08:22 +00:00
2017-10-20 03:15:19 +00:00
The original portENTER_CRITICAL only disabled the ISRs . This is enough for single - CPU operation : by
2016-08-17 15:08:22 +00:00
disabling the interrupts , there is no task switch so no other tasks can meddle in the data , and because
interrupts are disabled , ISRs can ' t corrupt data structures either .
For multiprocessing , things get a bit more hairy . First of all , disabling the interrupts doesn ' t stop
the tasks or ISRs on the other processors meddling with our CPU . For tasks , this is solved by adding
a spinlock to the portENTER_CRITICAL macro . A task running on the other CPU accessing the same data will
spinlock in the portENTER_CRITICAL code until the first CPU is done .
For ISRs , we now also need muxes : while portENTER_CRITICAL disabling interrupts will stop ISRs on the same
CPU from meddling with the data , it does not stop interrupts on the other cores from interfering with the
data . For this , we also use a spinlock in the routines called by the ISR , but these spinlocks
do not disable the interrupts ( because they already are ) .
2017-10-20 03:15:19 +00:00
This all assumes that interrupts are either entirely disabled or enabled . Interrupt priority levels
2016-08-17 15:08:22 +00:00
will break this scheme .
2017-06-05 07:54:50 +00:00
Remark : For the ESP32 , portENTER_CRITICAL and portENTER_CRITICAL_ISR both alias vTaskEnterCritical , meaning
global: move the soc component out of the common list
This MR removes the common dependency from every IDF components to the SOC component.
Currently, in the ``idf_functions.cmake`` script, we include the header path of SOC component by default for all components.
But for better code organization (or maybe also benifits to the compiling speed), we may remove the dependency to SOC components for most components except the driver and kernel related components.
In CMAKE, we have two kinds of header visibilities (set by include path visibility):
(Assume component A --(depends on)--> B, B is the current component)
1. public (``COMPONENT_ADD_INCLUDEDIRS``): means this path is visible to other depending components (A) (visible to A and B)
2. private (``COMPONENT_PRIV_INCLUDEDIRS``): means this path is only visible to source files inside the component (visible to B only)
and we have two kinds of depending ways:
(Assume component A --(depends on)--> B --(depends on)--> C, B is the current component)
1. public (```COMPONENT_REQUIRES```): means B can access to public include path of C. All other components rely on you (A) will also be available for the public headers. (visible to A, B)
2. private (``COMPONENT_PRIV_REQUIRES``): means B can access to public include path of C, but don't propagate this relation to other components (A). (visible to B)
1. remove the common requirement in ``idf_functions.cmake``, this makes the SOC components invisible to all other components by default.
2. if a component (for example, DRIVER) really needs the dependency to SOC, add a private dependency to SOC for it.
3. some other components that don't really depends on the SOC may still meet some errors saying "can't find header soc/...", this is because it's depended component (DRIVER) incorrectly include the header of SOC in its public headers. Moving all this kind of #include into source files, or private headers
4. Fix the include requirements for some file which miss sufficient #include directives. (Previously they include some headers by the long long long header include link)
This is a breaking change. Previous code may depends on the long include chain.
You may need to include the following headers for some files after this commit:
- soc/soc.h
- soc/soc_memory_layout.h
- driver/gpio.h
- esp_sleep.h
The major broken include chain includes:
1. esp_system.h no longer includes esp_sleep.h. The latter includes driver/gpio.h and driver/touch_pad.h.
2. ets_sys.h no longer includes soc/soc.h
3. freertos/portmacro.h no longer includes soc/soc_memory_layout.h
some peripheral headers no longer includes their hw related headers, e.g. rom/gpio.h no longer includes soc/gpio_pins.h and soc/gpio_reg.h
BREAKING CHANGE
2019-04-03 05:17:38 +00:00
that either function can be called both from ISR as well as task context . This is not standard FreeRTOS
2017-06-05 07:54:50 +00:00
behaviour ; please keep this in mind if you need any compatibility with other FreeRTOS implementations .
2016-08-17 15:08:22 +00:00
*/
void vPortCPUInitializeMutex ( portMUX_TYPE * mux ) ;
2016-08-25 08:30:47 +00:00
# ifdef CONFIG_FREERTOS_PORTMUX_DEBUG
2016-08-17 15:08:22 +00:00
void vPortCPUAcquireMutex ( portMUX_TYPE * mux , const char * function , int line ) ;
2017-07-20 06:34:45 +00:00
bool vPortCPUAcquireMutexTimeout ( portMUX_TYPE * mux , int timeout_cycles , const char * function , int line ) ;
2017-10-13 00:33:57 +00:00
void vPortCPUReleaseMutex ( portMUX_TYPE * mux , const char * function , int line ) ;
2017-07-20 06:34:45 +00:00
2016-08-17 15:08:22 +00:00
void vTaskEnterCritical ( portMUX_TYPE * mux , const char * function , int line ) ;
void vTaskExitCritical ( portMUX_TYPE * mux , const char * function , int line ) ;
2019-03-25 10:25:57 +00:00
# ifdef CONFIG_FREERTOS_CHECK_PORT_CRITICAL_COMPLIANCE
/* Calling port*_CRITICAL from ISR context would cause an assert failure.
* If the parent function is called from both ISR and Non - ISR context then call port * _CRITICAL_SAFE
2019-03-25 10:45:02 +00:00
*/
# define portENTER_CRITICAL(mux) do { \
if ( ! xPortInIsrContext ( ) ) { \
vTaskEnterCritical ( mux , __FUNCTION__ , __LINE__ ) ; \
} else { \
ets_printf ( " %s:%d (%s)- port*_CRITICAL called from ISR context! \n " , __FILE__ , __LINE__ , \
__FUNCTION__ ) ; \
abort ( ) ; \
} \
2019-03-25 10:25:57 +00:00
} while ( 0 )
2019-03-25 10:45:02 +00:00
# define portEXIT_CRITICAL(mux) do { \
if ( ! xPortInIsrContext ( ) ) { \
vTaskExitCritical ( mux , __FUNCTION__ , __LINE__ ) ; \
} else { \
ets_printf ( " %s:%d (%s)- port*_CRITICAL called from ISR context! \n " , __FILE__ , __LINE__ , \
__FUNCTION__ ) ; \
abort ( ) ; \
} \
2019-03-25 10:25:57 +00:00
} while ( 0 )
# else
2016-08-17 15:08:22 +00:00
# define portENTER_CRITICAL(mux) vTaskEnterCritical(mux, __FUNCTION__, __LINE__)
# define portEXIT_CRITICAL(mux) vTaskExitCritical(mux, __FUNCTION__, __LINE__)
2019-03-25 10:25:57 +00:00
# endif
2017-06-05 07:54:50 +00:00
# define portENTER_CRITICAL_ISR(mux) vTaskEnterCritical(mux, __FUNCTION__, __LINE__)
# define portEXIT_CRITICAL_ISR(mux) vTaskExitCritical(mux, __FUNCTION__, __LINE__)
2016-08-17 15:08:22 +00:00
# else
void vTaskExitCritical ( portMUX_TYPE * mux ) ;
void vTaskEnterCritical ( portMUX_TYPE * mux ) ;
void vPortCPUAcquireMutex ( portMUX_TYPE * mux ) ;
2017-07-20 06:34:45 +00:00
/** @brief Acquire a portmux spinlock with a timeout
*
* @ param mux Pointer to portmux to acquire .
* @ param timeout_cycles Timeout to spin , in CPU cycles . Pass portMUX_NO_TIMEOUT to wait forever ,
* portMUX_TRY_LOCK to try a single time to acquire the lock .
*
* @ return true if mutex is successfully acquired , false on timeout .
*/
bool vPortCPUAcquireMutexTimeout ( portMUX_TYPE * mux , int timeout_cycles ) ;
2017-02-16 05:03:02 +00:00
void vPortCPUReleaseMutex ( portMUX_TYPE * mux ) ;
2017-02-13 03:46:37 +00:00
2019-03-25 10:25:57 +00:00
# ifdef CONFIG_FREERTOS_CHECK_PORT_CRITICAL_COMPLIANCE
/* Calling port*_CRITICAL from ISR context would cause an assert failure.
* If the parent function is called from both ISR and Non - ISR context then call port * _CRITICAL_SAFE
2019-03-25 10:45:02 +00:00
*/
# define portENTER_CRITICAL(mux) do { \
if ( ! xPortInIsrContext ( ) ) { \
vTaskEnterCritical ( mux ) ; \
} else { \
ets_printf ( " %s:%d (%s)- port*_CRITICAL called from ISR context! \n " , __FILE__ , __LINE__ , \
__FUNCTION__ ) ; \
abort ( ) ; \
} \
2019-03-25 10:25:57 +00:00
} while ( 0 )
2019-03-25 10:45:02 +00:00
# define portEXIT_CRITICAL(mux) do { \
if ( ! xPortInIsrContext ( ) ) { \
vTaskExitCritical ( mux ) ; \
} else { \
ets_printf ( " %s:%d (%s)- port*_CRITICAL called from ISR context! \n " , __FILE__ , __LINE__ , \
__FUNCTION__ ) ; \
abort ( ) ; \
} \
2019-03-25 10:25:57 +00:00
} while ( 0 )
# else
2016-08-17 15:08:22 +00:00
# define portENTER_CRITICAL(mux) vTaskEnterCritical(mux)
# define portEXIT_CRITICAL(mux) vTaskExitCritical(mux)
2019-03-25 10:25:57 +00:00
# endif
2017-06-05 07:54:50 +00:00
# define portENTER_CRITICAL_ISR(mux) vTaskEnterCritical(mux)
# define portEXIT_CRITICAL_ISR(mux) vTaskExitCritical(mux)
2016-08-17 15:08:22 +00:00
# endif
2019-03-25 10:25:57 +00:00
# define portENTER_CRITICAL_SAFE(mux) do { \
if ( xPortInIsrContext ( ) ) { \
portENTER_CRITICAL_ISR ( mux ) ; \
} else { \
portENTER_CRITICAL ( mux ) ; \
} \
} while ( 0 )
# define portEXIT_CRITICAL_SAFE(mux) do { \
if ( xPortInIsrContext ( ) ) { \
portEXIT_CRITICAL_ISR ( mux ) ; \
} else { \
portEXIT_CRITICAL ( mux ) ; \
} \
} while ( 0 )
2017-10-20 03:15:19 +00:00
// Critical section management. NW-TODO: replace XTOS_SET_INTLEVEL with more efficient version, if any?
// These cannot be nested. They should be used with a lot of care and cannot be called from interrupt level.
//
// Only applies to one CPU. See notes above & below for reasons not to use these.
# define portDISABLE_INTERRUPTS() do { XTOS_SET_INTLEVEL(XCHAL_EXCM_LEVEL); portbenchmarkINTERRUPT_DISABLE(); } while (0)
# define portENABLE_INTERRUPTS() do { portbenchmarkINTERRUPT_RESTORE(0); XTOS_SET_INTLEVEL(0); } while (0)
// Cleaner solution allows nested interrupts disabling and restoring via local registers or stack.
2016-08-17 15:08:22 +00:00
// They can be called from interrupts too.
2017-10-20 03:15:19 +00:00
// WARNING: Only applies to current CPU. See notes above.
2019-07-16 09:33:30 +00:00
static inline unsigned portENTER_CRITICAL_NESTED ( void ) {
2017-10-20 03:15:19 +00:00
unsigned state = XTOS_SET_INTLEVEL ( XCHAL_EXCM_LEVEL ) ;
portbenchmarkINTERRUPT_DISABLE ( ) ;
return state ;
}
2016-08-17 15:08:22 +00:00
# define portEXIT_CRITICAL_NESTED(state) do { portbenchmarkINTERRUPT_RESTORE(state); XTOS_RESTORE_JUST_INTLEVEL(state); } while (0)
// These FreeRTOS versions are similar to the nested versions above
# define portSET_INTERRUPT_MASK_FROM_ISR() portENTER_CRITICAL_NESTED()
# define portCLEAR_INTERRUPT_MASK_FROM_ISR(state) portEXIT_CRITICAL_NESTED(state)
2017-09-22 08:02:39 +00:00
//Because the ROM routines don't necessarily handle a stack in external RAM correctly, we force
//the stack memory to always be internal.
2018-08-20 06:11:35 +00:00
# define portTcbMemoryCaps (MALLOC_CAP_INTERNAL|MALLOC_CAP_8BIT)
# define portStackMemoryCaps (MALLOC_CAP_INTERNAL|MALLOC_CAP_8BIT)
# define pvPortMallocTcbMem(size) heap_caps_malloc(size, portTcbMemoryCaps)
# define pvPortMallocStackMem(size) heap_caps_malloc(size, portStackMemoryCaps)
2017-09-22 08:02:39 +00:00
2016-10-20 03:23:59 +00:00
/*
* Wrapper for the Xtensa compare - and - set instruction . This subroutine will atomically compare
2017-10-20 03:15:19 +00:00
* * addr to ' compare ' . If * addr = = compare , * addr is set to * set . * set is updated with the previous
* value of * addr ( either ' compare ' or some other value . )
2016-10-20 03:23:59 +00:00
*
* Warning : From the ISA docs : in some ( unspecified ) cases , the s32c1i instruction may return the
* * bitwise inverse * of the old mem if the mem wasn ' t written . This doesn ' t seem to happen on the
2017-10-20 03:15:19 +00:00
* ESP32 ( portMUX assertions would fail ) .
2016-10-20 03:23:59 +00:00
*/
2016-10-27 01:15:43 +00:00
static inline void uxPortCompareSet ( volatile uint32_t * addr , uint32_t compare , uint32_t * set ) {
2019-08-20 07:12:09 +00:00
# if XCHAL_HAVE_S32C1I
2017-02-13 03:46:37 +00:00
__asm__ __volatile__ (
2016-10-20 03:23:59 +00:00
" WSR %2,SCOMPARE1 \n "
" S32C1I %0, %1, 0 \n "
: " =r " ( * set )
: " r " ( addr ) , " r " ( compare ) , " 0 " ( * set )
) ;
2019-08-20 07:12:09 +00:00
# else
// No S32C1I, so do this by disabling and re-enabling interrupts (slower)
uint32_t intlevel , old_value ;
__asm__ __volatile__ ( " rsil %0, " XTSTR ( XCHAL_EXCM_LEVEL ) " \n "
: " =r " ( intlevel ) ) ;
old_value = * addr ;
if ( old_value = = compare ) {
* addr = * set ;
}
__asm__ __volatile__ ( " memw \n "
" wsr %0, ps \n "
: : " r " ( intlevel ) ) ;
* set = old_value ;
2019-06-06 02:57:29 +00:00
# endif
2016-10-20 03:23:59 +00:00
}
2016-08-17 15:08:22 +00:00
/*-----------------------------------------------------------*/
/* Architecture specifics. */
# define portSTACK_GROWTH ( -1 )
# define portTICK_PERIOD_MS ( ( TickType_t ) 1000 / configTICK_RATE_HZ )
# define portBYTE_ALIGNMENT 4
# define portNOP() XT_NOP()
/*-----------------------------------------------------------*/
/* Fine resolution time */
# define portGET_RUN_TIME_COUNTER_VALUE() xthal_get_ccount()
2017-10-30 08:03:56 +00:00
//ccount or esp_timer are initialized elsewhere
# define portCONFIGURE_TIMER_FOR_RUN_TIME_STATS()
# ifdef CONFIG_FREERTOS_RUN_TIME_STATS_USING_ESP_TIMER
/* Coarse resolution time (us) */
# define portALT_GET_RUN_TIME_COUNTER_VALUE(x) x = (uint32_t)esp_timer_get_time()
# endif
2016-08-17 15:08:22 +00:00
/* Kernel utilities. */
void vPortYield ( void ) ;
void _frxt_setup_switch ( void ) ;
# define portYIELD() vPortYield()
2017-03-22 03:07:37 +00:00
# define portYIELD_FROM_ISR() {traceISR_EXIT_TO_SCHEDULER(); _frxt_setup_switch();}
2017-03-16 03:07:50 +00:00
2019-07-16 09:33:30 +00:00
static inline uint32_t xPortGetCoreID ( void ) ;
2017-03-16 03:07:50 +00:00
/* Yielding within an API call (when interrupts are off), means the yield should be delayed
until interrupts are re - enabled .
To do this , we use the " cross-core " interrupt as a trigger to yield on this core when interrupts are re - enabled . This
is the same interrupt & code path which is used to trigger a yield between CPUs , although in this case the yield is
happening on the same CPU .
*/
# define portYIELD_WITHIN_API() esp_crosscore_int_send_yield(xPortGetCoreID())
2016-08-17 15:08:22 +00:00
/*-----------------------------------------------------------*/
/* Task function macros as described on the FreeRTOS.org WEB site. */
# define portTASK_FUNCTION_PROTO( vFunction, pvParameters ) void vFunction( void *pvParameters )
# define portTASK_FUNCTION( vFunction, pvParameters ) void vFunction( void *pvParameters )
// When coprocessors are defined, we to maintain a pointer to coprocessors area.
// We currently use a hack: redefine field xMPU_SETTINGS in TCB block as a structure that can hold:
// MPU wrappers, coprocessor area pointer, trace code structure, and more if needed.
// The field is normally used for memory protection. FreeRTOS should create another general purpose field.
typedef struct {
# if XCHAL_CP_NUM > 0
volatile StackType_t * coproc_area ; // Pointer to coprocessor save area; MUST BE FIRST
# endif
# if portUSING_MPU_WRAPPERS
// Define here mpu_settings, which is port dependent
int mpu_setting ; // Just a dummy example here; MPU not ported to Xtensa yet
# endif
# if configUSE_TRACE_FACILITY_2
struct {
// Cf. porttraceStamp()
int taskstamp ; /* Stamp from inside task to see where we are */
int taskstampcount ; /* A counter usually incremented when we restart the task's loop */
} porttrace ;
# endif
} xMPU_SETTINGS ;
// Main hack to use MPU_wrappers even when no MPU is defined (warning: mpu_setting should not be accessed; otherwise move this above xMPU_SETTINGS)
# if (XCHAL_CP_NUM > 0 || configUSE_TRACE_FACILITY_2) && !portUSING_MPU_WRAPPERS // If MPU wrappers not used, we still need to allocate coproc area
# undef portUSING_MPU_WRAPPERS
# define portUSING_MPU_WRAPPERS 1 // Enable it to allocate coproc area
# define MPU_WRAPPERS_H // Override mpu_wrapper.h to disable unwanted code
# define PRIVILEGED_FUNCTION
# define PRIVILEGED_DATA
# endif
2018-04-12 10:18:45 +00:00
extern void esp_vApplicationIdleHook ( void ) ;
2018-08-31 09:48:09 +00:00
extern void esp_vApplicationTickHook ( void ) ;
# ifndef CONFIG_FREERTOS_LEGACY_HOOKS
# define vApplicationIdleHook esp_vApplicationIdleHook
# define vApplicationTickHook esp_vApplicationTickHook
# endif /* !CONFIG_FREERTOS_LEGACY_HOOKS */
2017-05-31 09:20:29 +00:00
void _xt_coproc_release ( volatile void * coproc_sa_base ) ;
2018-08-31 09:48:09 +00:00
void vApplicationSleep ( TickType_t xExpectedIdleTime ) ;
2017-05-31 09:20:29 +00:00
2018-04-12 10:18:45 +00:00
# define portSUPPRESS_TICKS_AND_SLEEP( idleTime ) vApplicationSleep( idleTime )
2017-05-31 09:20:29 +00:00
2019-11-06 07:08:24 +00:00
/*-----------------------------------------------------------*/
/* Architecture specific optimisations. */
# if configUSE_PORT_OPTIMISED_TASK_SELECTION == 1
/* Check the configuration. */
# if( configMAX_PRIORITIES > 32 )
2019-11-11 01:54:15 +00:00
# error configUSE_PORT_OPTIMISED_TASK_SELECTION can only be set to 1 when configMAX_PRIORITIES is less than or equal to 32. It is very rare that a system requires more than 10 to 15 different priorities as tasks that share a priority will time slice.
2019-11-06 07:08:24 +00:00
# endif
/* Store/clear the ready priorities in a bit map. */
# define portRECORD_READY_PRIORITY( uxPriority, uxReadyPriorities ) ( uxReadyPriorities ) |= ( 1UL << ( uxPriority ) )
# define portRESET_READY_PRIORITY( uxPriority, uxReadyPriorities ) ( uxReadyPriorities ) &= ~( 1UL << ( uxPriority ) )
/*-----------------------------------------------------------*/
# define portGET_HIGHEST_PRIORITY( uxTopPriority, uxReadyPriorities ) uxTopPriority = ( 31 - __builtin_clz( ( uxReadyPriorities ) ) )
# endif /* configUSE_PORT_OPTIMISED_TASK_SELECTION */
/*-----------------------------------------------------------*/
2016-08-17 15:08:22 +00:00
// porttrace
# if configUSE_TRACE_FACILITY_2
# include "porttrace.h"
# endif
// configASSERT_2 if requested
# if configASSERT_2
# include <stdio.h>
void exit ( int ) ;
# define configASSERT( x ) if (!(x)) { porttracePrint(-1); printf("\nAssertion failed in %s:%d\n", __FILE__, __LINE__); exit(-1); }
# endif
# endif // __ASSEMBLER__
# ifdef __cplusplus
}
# endif
# endif /* PORTMACRO_H */
