FreeRTOSConfig.h 36 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658
  1. /*
  2. * FreeRTOS Kernel <DEVELOPMENT BRANCH>
  3. * Copyright (C) 2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  4. *
  5. * SPDX-License-Identifier: MIT
  6. *
  7. * Permission is hereby granted, free of charge, to any person obtaining a copy of
  8. * this software and associated documentation files (the "Software"), to deal in
  9. * the Software without restriction, including without limitation the rights to
  10. * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
  11. * the Software, and to permit persons to whom the Software is furnished to do so,
  12. * subject to the following conditions:
  13. *
  14. * The above copyright notice and this permission notice shall be included in all
  15. * copies or substantial portions of the Software.
  16. *
  17. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  18. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
  19. * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
  20. * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
  21. * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  22. * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  23. *
  24. * https://www.FreeRTOS.org
  25. * https://github.com/FreeRTOS
  26. *
  27. */
  28. /*******************************************************************************
  29. * This file provides an example FreeRTOSConfig.h header file, inclusive of an
  30. * abbreviated explanation of each configuration item. Online and reference
  31. * documentation provides more information.
  32. * https://www.freertos.org/a00110.html
  33. *
  34. * Constant values enclosed in square brackets ('[' and ']') must be completed
  35. * before this file will build.
  36. *
  37. * Use the FreeRTOSConfig.h supplied with the RTOS port in use rather than this
  38. * generic file, if one is available.
  39. ******************************************************************************/
  40. #ifndef FREERTOS_CONFIG_H
  41. #define FREERTOS_CONFIG_H
  42. #include "nuclei_sdk_soc.h"
  43. /******************************************************************************/
  44. /* Hardware description related definitions. **********************************/
  45. /******************************************************************************/
  46. /* In most cases, configCPU_CLOCK_HZ must be set to the frequency of the clock
  47. * that drives the peripheral used to generate the kernels periodic tick interrupt.
  48. * The default value is set to 20MHz and matches the QEMU demo settings. Your
  49. * application will certainly need a different value so set this correctly.
  50. * This is very often, but not always, equal to the main system clock frequency. */
  51. #define configCPU_CLOCK_HZ ( SystemCoreClock )
  52. #define configRTC_CLOCK_HZ 32768
  53. /* configSYSTICK_CLOCK_HZ is an optional parameter for ARM Cortex-M ports only.
  54. *
  55. * By default ARM Cortex-M ports generate the RTOS tick interrupt from the
  56. * Cortex-M SysTick timer. Most Cortex-M MCUs run the SysTick timer at the same
  57. * frequency as the MCU itself - when that is the case configSYSTICK_CLOCK_HZ is
  58. * not needed and should be left undefined. If the SysTick timer is clocked at a
  59. * different frequency to the MCU core then set configCPU_CLOCK_HZ to the MCU clock
  60. * frequency, as normal, and configSYSTICK_CLOCK_HZ to the SysTick clock
  61. * frequency. Not used if left undefined.
  62. * The default value is undefined (commented out). If you need this value bring it
  63. * back and set it to a suitable value. */
  64. /*
  65. #define configSYSTICK_CLOCK_HZ [Platform specific]
  66. */
  67. /******************************************************************************/
  68. /* Scheduling behaviour related definitions. **********************************/
  69. /******************************************************************************/
  70. /* configTICK_RATE_HZ sets frequency of the tick interrupt in Hz, normally
  71. * calculated from the configCPU_CLOCK_HZ value. */
  72. #define configTICK_RATE_HZ 100
  73. /* Set configUSE_PREEMPTION to 1 to use pre-emptive scheduling. Set
  74. * configUSE_PREEMPTION to 0 to use co-operative scheduling.
  75. * See https://www.freertos.org/single-core-amp-smp-rtos-scheduling.html. */
  76. #define configUSE_PREEMPTION 1
  77. /* Set configUSE_TIME_SLICING to 1 to have the scheduler switch between Ready
  78. * state tasks of equal priority on every tick interrupt. Set
  79. * configUSE_TIME_SLICING to 0 to prevent the scheduler switching between Ready
  80. * state tasks just because there was a tick interrupt. See
  81. * https://freertos.org/single-core-amp-smp-rtos-scheduling.html. */
  82. #define configUSE_TIME_SLICING 0
  83. /* Set configUSE_PORT_OPTIMISED_TASK_SELECTION to 1 to select the next task to
  84. * run using an algorithm optimised to the instruction set of the target hardware -
  85. * normally using a count leading zeros assembly instruction. Set to 0 to select
  86. * the next task to run using a generic C algorithm that works for all FreeRTOS
  87. * ports. Not all FreeRTOS ports have this option. Defaults to 0 if left
  88. * undefined. */
  89. #define configUSE_PORT_OPTIMISED_TASK_SELECTION 0
  90. /* Set configUSE_TICKLESS_IDLE to 1 to use the low power tickless mode. Set to
  91. * 0 to keep the tick interrupt running at all times. Not all FreeRTOS ports
  92. * support tickless mode. See https://www.freertos.org/low-power-tickless-rtos.html
  93. * Defaults to 0 if left undefined. */
  94. #define configUSE_TICKLESS_IDLE 0
  95. /* configMAX_PRIORITIES Sets the number of available task priorities. Tasks can
  96. * be assigned priorities of 0 to (configMAX_PRIORITIES - 1). Zero is the lowest
  97. * priority. */
  98. #define configMAX_PRIORITIES 5
  99. /* configMINIMAL_STACK_SIZE defines the size of the stack used by the Idle task
  100. * (in words, not in bytes!). The kernel does not use this constant for any other
  101. * purpose. Demo applications use the constant to make the demos somewhat portable
  102. * across hardware architectures. */
  103. #define configMINIMAL_STACK_SIZE 256
  104. /* configMAX_TASK_NAME_LEN sets the maximum length (in characters) of a task's
  105. * human readable name. Includes the NULL terminator. */
  106. #define configMAX_TASK_NAME_LEN 16
  107. /* Time is measured in 'ticks' - which is the number of times the tick interrupt
  108. * has executed since the RTOS kernel was started.
  109. * The tick count is held in a variable of type TickType_t.
  110. *
  111. * configTICK_TYPE_WIDTH_IN_BITS controls the type (and therefore bit-width) of TickType_t:
  112. *
  113. * Defining configTICK_TYPE_WIDTH_IN_BITS as TICK_TYPE_WIDTH_16_BITS causes
  114. * TickType_t to be defined (typedef'ed) as an unsigned 16-bit type.
  115. *
  116. * Defining configTICK_TYPE_WIDTH_IN_BITS as TICK_TYPE_WIDTH_32_BITS causes
  117. * TickType_t to be defined (typedef'ed) as an unsigned 32-bit type.
  118. *
  119. * Defining configTICK_TYPE_WIDTH_IN_BITS as TICK_TYPE_WIDTH_64_BITS causes
  120. * TickType_t to be defined (typedef'ed) as an unsigned 64-bit type. */
  121. #define configTICK_TYPE_WIDTH_IN_BITS TICK_TYPE_WIDTH_64_BITS
  122. /* Set configIDLE_SHOULD_YIELD to 1 to have the Idle task yield to an
  123. * application task if there is an Idle priority (priority 0) application task that
  124. * can run. Set to 0 to have the Idle task use all of its timeslice. Default to 1
  125. * if left undefined. */
  126. #define configIDLE_SHOULD_YIELD 0
  127. /* Each task has an array of task notifications.
  128. * configTASK_NOTIFICATION_ARRAY_ENTRIES sets the number of indexes in the array.
  129. * See https://www.freertos.org/RTOS-task-notifications.html Defaults to 1 if
  130. * left undefined. */
  131. #define configTASK_NOTIFICATION_ARRAY_ENTRIES 1
  132. /* configQUEUE_REGISTRY_SIZE sets the maximum number of queues and semaphores
  133. * that can be referenced from the queue registry. Only required when using a
  134. * kernel aware debugger. Defaults to 0 if left undefined. */
  135. #define configQUEUE_REGISTRY_SIZE 0
  136. /* Set configENABLE_BACKWARD_COMPATIBILITY to 1 to map function names and
  137. * datatypes from old version of FreeRTOS to their latest equivalent. Defaults to
  138. * 1 if left undefined. */
  139. #define configENABLE_BACKWARD_COMPATIBILITY 0
  140. /* Each task has its own array of pointers that can be used as thread local
  141. * storage. configNUM_THREAD_LOCAL_STORAGE_POINTERS set the number of indexes in
  142. * the array. See https://www.freertos.org/thread-local-storage-pointers.html
  143. * Defaults to 0 if left undefined. */
  144. #define configNUM_THREAD_LOCAL_STORAGE_POINTERS 0
  145. /* When configUSE_MINI_LIST_ITEM is set to 0, MiniListItem_t and ListItem_t are
  146. * both the same. When configUSE_MINI_LIST_ITEM is set to 1, MiniListItem_t contains
  147. * 3 fewer fields than ListItem_t which saves some RAM at the cost of violating
  148. * strict aliasing rules which some compilers depend on for optimization. Defaults
  149. * to 1 if left undefined. */
  150. #define configUSE_MINI_LIST_ITEM 1
  151. /* Sets the type used by the parameter to xTaskCreate() that specifies the stack
  152. * size of the task being created. The same type is used to return information
  153. * about stack usage in various other API calls. Defaults to size_t if left
  154. * undefined. */
  155. #define configSTACK_DEPTH_TYPE size_t
  156. /* configMESSAGE_BUFFER_LENGTH_TYPE sets the type used to store the length of
  157. * each message written to a FreeRTOS message buffer (the length is also written to
  158. * the message buffer. Defaults to size_t if left undefined - but that may waste
  159. * space if messages never go above a length that could be held in a uint8_t. */
  160. #define configMESSAGE_BUFFER_LENGTH_TYPE size_t
  161. /* If configHEAP_CLEAR_MEMORY_ON_FREE is set to 1, then blocks of memory allocated
  162. * using pvPortMalloc() will be cleared (i.e. set to zero) when freed using
  163. * vPortFree(). Defaults to 0 if left undefined. */
  164. #define configHEAP_CLEAR_MEMORY_ON_FREE 1
  165. /* vTaskList and vTaskGetRunTimeStats APIs take a buffer as a parameter and assume
  166. * that the length of the buffer is configSTATS_BUFFER_MAX_LENGTH. Defaults to
  167. * 0xFFFF if left undefined.
  168. * New applications are recommended to use vTaskListTasks and
  169. * vTaskGetRunTimeStatistics APIs instead and supply the length of the buffer
  170. * explicitly to avoid memory corruption. */
  171. #define configSTATS_BUFFER_MAX_LENGTH 0xFFFF
  172. /* Set configUSE_NEWLIB_REENTRANT to 1 to have a newlib reent structure
  173. * allocated for each task. Set to 0 to not support newlib reent structures.
  174. * Default to 0 if left undefined.
  175. *
  176. * Note Newlib support has been included by popular demand, but is not used or
  177. * tested by the FreeRTOS maintainers themselves. FreeRTOS is not responsible for
  178. * resulting newlib operation. User must be familiar with newlib and must provide
  179. * system-wide implementations of the necessary stubs. Note that (at the time of
  180. * writing) the current newlib design implements a system-wide malloc() that must
  181. * be provided with locks. */
  182. #define configUSE_NEWLIB_REENTRANT 0
  183. /******************************************************************************/
  184. /* Software timer related definitions. ****************************************/
  185. /******************************************************************************/
  186. /* Set configUSE_TIMERS to 1 to include software timer functionality in the
  187. * build. Set to 0 to exclude software timer functionality from the build. The
  188. * FreeRTOS/source/timers.c source file must be included in the build if
  189. * configUSE_TIMERS is set to 1. Default to 0 if left undefined. See
  190. * https://www.freertos.org/RTOS-software-timer.html. */
  191. #define configUSE_TIMERS 1
  192. /* configTIMER_TASK_PRIORITY sets the priority used by the timer task. Only
  193. * used if configUSE_TIMERS is set to 1. The timer task is a standard FreeRTOS
  194. * task, so its priority is set like any other task. See
  195. * https://www.freertos.org/RTOS-software-timer-service-daemon-task.html Only used
  196. * if configUSE_TIMERS is set to 1. */
  197. #define configTIMER_TASK_PRIORITY ( configMAX_PRIORITIES - 1 )
  198. /* configTIMER_TASK_STACK_DEPTH sets the size of the stack allocated to the
  199. * timer task (in words, not in bytes!). The timer task is a standard FreeRTOS
  200. * task. See https://www.freertos.org/RTOS-software-timer-service-daemon-task.html
  201. * Only used if configUSE_TIMERS is set to 1. */
  202. #define configTIMER_TASK_STACK_DEPTH 512
  203. /* configTIMER_QUEUE_LENGTH sets the length of the queue (the number of discrete
  204. * items the queue can hold) used to send commands to the timer task. See
  205. * https://www.freertos.org/RTOS-software-timer-service-daemon-task.html Only used
  206. * if configUSE_TIMERS is set to 1. */
  207. #define configTIMER_QUEUE_LENGTH 10
  208. /******************************************************************************/
  209. /* Event Group related definitions. *******************************************/
  210. /******************************************************************************/
  211. /* Set configUSE_EVENT_GROUPS to 1 to include event group functionality in the
  212. * build. Set to 0 to exclude event group functionality from the build. The
  213. * FreeRTOS/source/event_groups.c source file must be included in the build if
  214. * configUSE_EVENT_GROUPS is set to 1. Defaults to 1 if left undefined. */
  215. #define configUSE_EVENT_GROUPS 1
  216. /******************************************************************************/
  217. /* Stream Buffer related definitions. *****************************************/
  218. /******************************************************************************/
  219. /* Set configUSE_STREAM_BUFFERS to 1 to include stream buffer functionality in
  220. * the build. Set to 0 to exclude event group functionality from the build. The
  221. * FreeRTOS/source/stream_buffer.c source file must be included in the build if
  222. * configUSE_STREAM_BUFFERS is set to 1. Defaults to 1 if left undefined. */
  223. #define configUSE_STREAM_BUFFERS 1
  224. /******************************************************************************/
  225. /* Memory allocation related definitions. *************************************/
  226. /******************************************************************************/
  227. /* Set configSUPPORT_STATIC_ALLOCATION to 1 to include FreeRTOS API functions
  228. * that create FreeRTOS objects (tasks, queues, etc.) using statically allocated
  229. * memory in the build. Set to 0 to exclude the ability to create statically
  230. * allocated objects from the build. Defaults to 0 if left undefined. See
  231. * https://www.freertos.org/Static_Vs_Dynamic_Memory_Allocation.html. */
  232. #define configSUPPORT_STATIC_ALLOCATION 1
  233. /* Set configSUPPORT_DYNAMIC_ALLOCATION to 1 to include FreeRTOS API functions
  234. * that create FreeRTOS objects (tasks, queues, etc.) using dynamically allocated
  235. * memory in the build. Set to 0 to exclude the ability to create dynamically
  236. * allocated objects from the build. Defaults to 1 if left undefined. See
  237. * https://www.freertos.org/Static_Vs_Dynamic_Memory_Allocation.html. */
  238. #define configSUPPORT_DYNAMIC_ALLOCATION 1
  239. /* Sets the total size of the FreeRTOS heap, in bytes, when heap_1.c, heap_2.c
  240. * or heap_4.c are included in the build. This value is defaulted to 4096 bytes but
  241. * it must be tailored to each application. Note the heap will appear in the .bss
  242. * section. See https://www.freertos.org/a00111.html. */
  243. #define configTOTAL_HEAP_SIZE 20*1024
  244. /* Set configAPPLICATION_ALLOCATED_HEAP to 1 to have the application allocate
  245. * the array used as the FreeRTOS heap. Set to 0 to have the linker allocate the
  246. * array used as the FreeRTOS heap. Defaults to 0 if left undefined. */
  247. #define configAPPLICATION_ALLOCATED_HEAP 0
  248. /* Set configSTACK_ALLOCATION_FROM_SEPARATE_HEAP to 1 to have task stacks
  249. * allocated from somewhere other than the FreeRTOS heap. This is useful if you
  250. * want to ensure stacks are held in fast memory. Set to 0 to have task stacks
  251. * come from the standard FreeRTOS heap. The application writer must provide
  252. * implementations for pvPortMallocStack() and vPortFreeStack() if set to 1.
  253. * Defaults to 0 if left undefined. */
  254. #define configSTACK_ALLOCATION_FROM_SEPARATE_HEAP 0
  255. /* Set configENABLE_HEAP_PROTECTOR to 1 to enable bounds checking and obfuscation
  256. * to internal heap block pointers in heap_4.c and heap_5.c to help catch pointer
  257. * corruptions. Defaults to 0 if left undefined. */
  258. #define configENABLE_HEAP_PROTECTOR 0
  259. /******************************************************************************/
  260. /* Interrupt nesting behaviour configuration. *********************************/
  261. /******************************************************************************/
  262. /* configKERNEL_INTERRUPT_PRIORITY sets the priority of the tick and context
  263. * switch performing interrupts. Not supported by all FreeRTOS ports. See
  264. * https://www.freertos.org/RTOS-Cortex-M3-M4.html for information specific to
  265. * ARM Cortex-M devices. */
  266. /* Please dont change this, our timer tick and software irq must be lowest priority interrupt handler */
  267. #define configKERNEL_INTERRUPT_PRIORITY 0
  268. /* configMAX_SYSCALL_INTERRUPT_PRIORITY sets the interrupt priority above which
  269. * FreeRTOS API calls must not be made. Interrupts above this priority are never
  270. * disabled, so never delayed by RTOS activity. The default value is set to the
  271. * highest interrupt priority (0). Not supported by all FreeRTOS ports.
  272. * See https://www.freertos.org/RTOS-Cortex-M3-M4.html for information specific to
  273. * ARM Cortex-M devices. */
  274. /* TODO and NOTE:
  275. * - When configMAX_SYSCALL_INTERRUPT_PRIORITY >= 255, it will use mstatus.mie to disable/enable interrupt
  276. * - When configMAX_SYSCALL_INTERRUPT_PRIORITY < 255, it will use eclic.mth to mask interrupt lower than configMAX_SYSCALL_INTERRUPT_PRIORITY
  277. * - If you want to let all interrupts be masked when FreeRTOS kernel enter to critical section, please set configMAX_SYSCALL_INTERRUPT_PRIORITY to 255
  278. * For details, please see our portable code comments
  279. */
  280. #define configMAX_SYSCALL_INTERRUPT_PRIORITY 255
  281. /* Another name for configMAX_SYSCALL_INTERRUPT_PRIORITY - the name used depends
  282. * on the FreeRTOS port. */
  283. #define configMAX_API_CALL_INTERRUPT_PRIORITY 0
  284. /******************************************************************************/
  285. /* Hook and callback function related definitions. ****************************/
  286. /******************************************************************************/
  287. /* Set the following configUSE_* constants to 1 to include the named hook
  288. * functionality in the build. Set to 0 to exclude the hook functionality from the
  289. * build. The application writer is responsible for providing the hook function
  290. * for any set to 1. See https://www.freertos.org/a00016.html. */
  291. #define configUSE_IDLE_HOOK 1
  292. #define configUSE_TICK_HOOK 0
  293. #define configUSE_MALLOC_FAILED_HOOK 0
  294. #define configUSE_DAEMON_TASK_STARTUP_HOOK 0
  295. /* Set configUSE_SB_COMPLETED_CALLBACK to 1 to have send and receive completed
  296. * callbacks for each instance of a stream buffer or message buffer. When the
  297. * option is set to 1, APIs xStreamBufferCreateWithCallback() and
  298. * xStreamBufferCreateStaticWithCallback() (and likewise APIs for message
  299. * buffer) can be used to create a stream buffer or message buffer instance
  300. * with application provided callbacks. Defaults to 0 if left undefined. */
  301. #define configUSE_SB_COMPLETED_CALLBACK 0
  302. /* Set configCHECK_FOR_STACK_OVERFLOW to 1 or 2 for FreeRTOS to check for a
  303. * stack overflow at the time of a context switch. Set to 0 to not look for a
  304. * stack overflow. If configCHECK_FOR_STACK_OVERFLOW is 1 then the check only
  305. * looks for the stack pointer being out of bounds when a task's context is saved
  306. * to its stack - this is fast but somewhat ineffective. If
  307. * configCHECK_FOR_STACK_OVERFLOW is 2 then the check looks for a pattern written
  308. * to the end of a task's stack having been overwritten. This is slower, but will
  309. * catch most (but not all) stack overflows. The application writer must provide
  310. * the stack overflow callback when configCHECK_FOR_STACK_OVERFLOW is set to 1.
  311. * See https://www.freertos.org/Stacks-and-stack-overflow-checking.html Defaults
  312. * to 0 if left undefined. */
  313. #define configCHECK_FOR_STACK_OVERFLOW 2
  314. /******************************************************************************/
  315. /* Run time and task stats gathering related definitions. *********************/
  316. /******************************************************************************/
  317. /* Set configGENERATE_RUN_TIME_STATS to 1 to have FreeRTOS collect data on the
  318. * processing time used by each task. Set to 0 to not collect the data. The
  319. * application writer needs to provide a clock source if set to 1. Defaults to 0
  320. * if left undefined. See https://www.freertos.org/rtos-run-time-stats.html. */
  321. #define configGENERATE_RUN_TIME_STATS 0
  322. /* Set configUSE_TRACE_FACILITY to include additional task structure members
  323. * are used by trace and visualisation functions and tools. Set to 0 to exclude
  324. * the additional information from the structures. Defaults to 0 if left
  325. * undefined. */
  326. #define configUSE_TRACE_FACILITY 0
  327. /* Set to 1 to include the vTaskList() and vTaskGetRunTimeStats() functions in
  328. * the build. Set to 0 to exclude these functions from the build. These two
  329. * functions introduce a dependency on string formatting functions that would
  330. * otherwise not exist - hence they are kept separate. Defaults to 0 if left
  331. * undefined. */
  332. #define configUSE_STATS_FORMATTING_FUNCTIONS 0
  333. /******************************************************************************/
  334. /* Co-routine related definitions. ********************************************/
  335. /******************************************************************************/
  336. /* Set configUSE_CO_ROUTINES to 1 to include co-routine functionality in the
  337. * build, or 0 to omit co-routine functionality from the build. To include
  338. * co-routines, croutine.c must be included in the project. Defaults to 0 if left
  339. * undefined. */
  340. #define configUSE_CO_ROUTINES 0
  341. /* configMAX_CO_ROUTINE_PRIORITIES defines the number of priorities available
  342. * to the application co-routines. Any number of co-routines can share the same
  343. * priority. Defaults to 0 if left undefined. */
  344. #define configMAX_CO_ROUTINE_PRIORITIES 1
  345. /******************************************************************************/
  346. /* Debugging assistance. ******************************************************/
  347. /******************************************************************************/
  348. /* configASSERT() has the same semantics as the standard C assert(). It can
  349. * either be defined to take an action when the assertion fails, or not defined
  350. * at all (i.e. comment out or delete the definitions) to completely remove
  351. * assertions. configASSERT() can be defined to anything you want, for example
  352. * you can call a function if an assert fails that passes the filename and line
  353. * number of the failing assert (for example, "vAssertCalled( __FILE__, __LINE__ )"
  354. * or it can simple disable interrupts and sit in a loop to halt all execution
  355. * on the failing line for viewing in a debugger. */
  356. #define configASSERT( x ) \
  357. if( ( x ) == 0 ) \
  358. { \
  359. portDISABLE_INTERRUPTS(); \
  360. for( ; ; ) \
  361. ; \
  362. }
  363. /******************************************************************************/
  364. /* FreeRTOS MPU specific definitions. *****************************************/
  365. /******************************************************************************/
  366. /* If configINCLUDE_APPLICATION_DEFINED_PRIVILEGED_FUNCTIONS is set to 1 then
  367. * the application writer can provide functions that execute in privileged mode.
  368. * See: https://www.freertos.org/a00110.html#configINCLUDE_APPLICATION_DEFINED_PRIVILEGED_FUNCTIONS
  369. * Defaults to 0 if left undefined. Only used by the FreeRTOS Cortex-M MPU ports,
  370. * not the standard ARMv7-M Cortex-M port. */
  371. #define configINCLUDE_APPLICATION_DEFINED_PRIVILEGED_FUNCTIONS 0
  372. /* Set configTOTAL_MPU_REGIONS to the number of MPU regions implemented on your
  373. * target hardware. Normally 8 or 16. Only used by the FreeRTOS Cortex-M MPU
  374. * ports, not the standard ARMv7-M Cortex-M port. Defaults to 8 if left
  375. * undefined. */
  376. #define configTOTAL_MPU_REGIONS 8
  377. /* configTEX_S_C_B_FLASH allows application writers to override the default
  378. * values for the for TEX, Shareable (S), Cacheable (C) and Bufferable (B) bits for
  379. * the MPU region covering Flash. Defaults to 0x07UL (which means TEX=000, S=1,
  380. * C=1, B=1) if left undefined. Only used by the FreeRTOS Cortex-M MPU ports, not
  381. * the standard ARMv7-M Cortex-M port. */
  382. #define configTEX_S_C_B_FLASH 0x07UL
  383. /* configTEX_S_C_B_SRAM allows application writers to override the default
  384. * values for the for TEX, Shareable (S), Cacheable (C) and Bufferable (B) bits for
  385. * the MPU region covering RAM. Defaults to 0x07UL (which means TEX=000, S=1, C=1,
  386. * B=1) if left undefined. Only used by the FreeRTOS Cortex-M MPU ports, not
  387. * the standard ARMv7-M Cortex-M port. */
  388. #define configTEX_S_C_B_SRAM 0x07UL
  389. /* Set configENFORCE_SYSTEM_CALLS_FROM_KERNEL_ONLY to 0 to prevent any privilege
  390. * escalations originating from outside of the kernel code itself. Set to 1 to
  391. * allow application tasks to raise privilege. Defaults to 1 if left undefined.
  392. * Only used by the FreeRTOS Cortex-M MPU ports, not the standard ARMv7-M Cortex-M
  393. * port. */
  394. #define configENFORCE_SYSTEM_CALLS_FROM_KERNEL_ONLY 1
  395. /* Set configALLOW_UNPRIVILEGED_CRITICAL_SECTIONS to 1 to allow unprivileged
  396. * tasks enter critical sections (effectively mask interrupts). Set to 0 to
  397. * prevent unprivileged tasks entering critical sections. Defaults to 1 if left
  398. * undefined. Only used by the FreeRTOS Cortex-M MPU ports, not the standard
  399. * ARMv7-M Cortex-M port. */
  400. #define configALLOW_UNPRIVILEGED_CRITICAL_SECTIONS 0
  401. /* FreeRTOS Kernel version 10.6.0 introduced a new v2 MPU wrapper, namely
  402. * mpu_wrappers_v2.c. Set configUSE_MPU_WRAPPERS_V1 to 0 to use the new v2 MPU
  403. * wrapper. Set configUSE_MPU_WRAPPERS_V1 to 1 to use the old v1 MPU wrapper
  404. * (mpu_wrappers.c). Defaults to 0 if left undefined. */
  405. #define configUSE_MPU_WRAPPERS_V1 0
  406. /* When using the v2 MPU wrapper, set configPROTECTED_KERNEL_OBJECT_POOL_SIZE to
  407. * the total number of kernel objects, which includes tasks, queues, semaphores,
  408. * mutexes, event groups, timers, stream buffers and message buffers, in your
  409. * application. The application will not be able to have more than
  410. * configPROTECTED_KERNEL_OBJECT_POOL_SIZE kernel objects at any point of
  411. * time. */
  412. #define configPROTECTED_KERNEL_OBJECT_POOL_SIZE 10
  413. /* When using the v2 MPU wrapper, set configSYSTEM_CALL_STACK_SIZE to the size
  414. * of the system call stack in words. Each task has a statically allocated
  415. * memory buffer of this size which is used as the stack to execute system
  416. * calls. For example, if configSYSTEM_CALL_STACK_SIZE is defined as 128 and
  417. * there are 10 tasks in the application, the total amount of memory used for
  418. * system call stacks is 128 * 10 = 1280 words. */
  419. #define configSYSTEM_CALL_STACK_SIZE 128
  420. /* When using the v2 MPU wrapper, set configENABLE_ACCESS_CONTROL_LIST to 1 to
  421. * enable Access Control List (ACL) feature. When ACL is enabled, an
  422. * unprivileged task by default does not have access to any kernel object other
  423. * than itself. The application writer needs to explicitly grant the
  424. * unprivileged task access to the kernel objects it needs using the APIs
  425. * provided for the same. Defaults to 0 if left undefined. */
  426. #define configENABLE_ACCESS_CONTROL_LIST 1
  427. /******************************************************************************/
  428. /* SMP( Symmetric MultiProcessing ) Specific Configuration definitions. *******/
  429. /******************************************************************************/
  430. /* Set configNUMBER_OF_CORES to the number of available processor cores. Defaults
  431. * to 1 if left undefined. */
  432. /*
  433. #define configNUMBER_OF_CORES [Num of available cores]
  434. */
  435. /* When using SMP (i.e. configNUMBER_OF_CORES is greater than one), set
  436. * configRUN_MULTIPLE_PRIORITIES to 0 to allow multiple tasks to run
  437. * simultaneously only if they do not have equal priority, thereby maintaining
  438. * the paradigm of a lower priority task never running if a higher priority task
  439. * is able to run. If configRUN_MULTIPLE_PRIORITIES is set to 1, multiple tasks
  440. * with different priorities may run simultaneously - so a higher and lower
  441. * priority task may run on different cores at the same time. */
  442. #define configRUN_MULTIPLE_PRIORITIES 1
  443. /* When using SMP (i.e. configNUMBER_OF_CORES is greater than one), set
  444. * configUSE_CORE_AFFINITY to 1 to enable core affinity feature. When core
  445. * affinity feature is enabled, the vTaskCoreAffinitySet and vTaskCoreAffinityGet
  446. * APIs can be used to set and retrieve which cores a task can run on. If
  447. * configUSE_CORE_AFFINITY is set to 0 then the FreeRTOS scheduler is free to
  448. * run any task on any available core. */
  449. #define configUSE_CORE_AFFINITY 0
  450. /* When using SMP with core affinity feature enabled, set
  451. * configTASK_DEFAULT_CORE_AFFINITY to change the default core affinity mask for
  452. * tasks created without an affinity mask specified. Setting the define to 1 would
  453. * make such tasks run on core 0 and setting it to (1 << portGET_CORE_ID()) would
  454. * make such tasks run on the current core. This config value is useful, if
  455. * swapping tasks between cores is not supported (e.g. Tricore) or if legacy code
  456. * should be controlled. Defaults to tskNO_AFFINITY if left undefined. */
  457. #define configTASK_DEFAULT_CORE_AFFINITY tskNO_AFFINITY
  458. /* When using SMP (i.e. configNUMBER_OF_CORES is greater than one), if
  459. * configUSE_TASK_PREEMPTION_DISABLE is set to 1, individual tasks can be set to
  460. * either pre-emptive or co-operative mode using the vTaskPreemptionDisable and
  461. * vTaskPreemptionEnable APIs. */
  462. #define configUSE_TASK_PREEMPTION_DISABLE 0
  463. /* When using SMP (i.e. configNUMBER_OF_CORES is greater than one), set
  464. * configUSE_PASSIVE_IDLE_HOOK to 1 to allow the application writer to use
  465. * the passive idle task hook to add background functionality without the overhead
  466. * of a separate task. Defaults to 0 if left undefined. */
  467. #define configUSE_PASSIVE_IDLE_HOOK 1
  468. /* When using SMP (i.e. configNUMBER_OF_CORES is greater than one),
  469. * configTIMER_SERVICE_TASK_CORE_AFFINITY allows the application writer to set
  470. * the core affinity of the RTOS Daemon/Timer Service task. Defaults to
  471. * tskNO_AFFINITY if left undefined. */
  472. #define configTIMER_SERVICE_TASK_CORE_AFFINITY tskNO_AFFINITY
  473. /******************************************************************************/
  474. /* ARMv8-M secure side port related definitions. ******************************/
  475. /******************************************************************************/
  476. /* secureconfigMAX_SECURE_CONTEXTS define the maximum number of tasks that can
  477. * call into the secure side of an ARMv8-M chip. Not used by any other ports. */
  478. #define secureconfigMAX_SECURE_CONTEXTS 5
  479. /* Defines the kernel provided implementation of
  480. * vApplicationGetIdleTaskMemory() and vApplicationGetTimerTaskMemory()
  481. * to provide the memory that is used by the Idle task and Timer task respectively.
  482. * The application can provide it's own implementation of
  483. * vApplicationGetIdleTaskMemory() and vApplicationGetTimerTaskMemory() by
  484. * setting configKERNEL_PROVIDED_STATIC_MEMORY to 0 or leaving it undefined. */
  485. #define configKERNEL_PROVIDED_STATIC_MEMORY 1
  486. /******************************************************************************/
  487. /* ARMv8-M port Specific Configuration definitions. ***************************/
  488. /******************************************************************************/
  489. /* Set configENABLE_TRUSTZONE to 1 when running FreeRTOS on the non-secure side
  490. * to enable the TrustZone support in FreeRTOS ARMv8-M ports which allows the
  491. * non-secure FreeRTOS tasks to call the (non-secure callable) functions
  492. * exported from secure side. */
  493. #define configENABLE_TRUSTZONE 1
  494. /* If the application writer does not want to use TrustZone, but the hardware does
  495. * not support disabling TrustZone then the entire application (including the FreeRTOS
  496. * scheduler) can run on the secure side without ever branching to the non-secure side.
  497. * To do that, in addition to setting configENABLE_TRUSTZONE to 0, also set
  498. * configRUN_FREERTOS_SECURE_ONLY to 1. */
  499. #define configRUN_FREERTOS_SECURE_ONLY 1
  500. /* Set configENABLE_MPU to 1 to enable the Memory Protection Unit (MPU), or 0
  501. * to leave the Memory Protection Unit disabled. */
  502. #define configENABLE_MPU 1
  503. /* Set configENABLE_FPU to 1 to enable the Floating Point Unit (FPU), or 0
  504. * to leave the Floating Point Unit disabled. */
  505. #define configENABLE_FPU 1
  506. /* Set configENABLE_MVE to 1 to enable the M-Profile Vector Extension (MVE) support,
  507. * or 0 to leave the MVE support disabled. This option is only applicable to Cortex-M55
  508. * and Cortex-M85 ports as M-Profile Vector Extension (MVE) is available only on
  509. * these architectures. configENABLE_MVE must be left undefined, or defined to 0
  510. * for the Cortex-M23,Cortex-M33 and Cortex-M35P ports. */
  511. #define configENABLE_MVE 1
  512. /******************************************************************************/
  513. /* ARMv7-M and ARMv8-M port Specific Configuration definitions. ***************/
  514. /******************************************************************************/
  515. /* Set configCHECK_HANDLER_INSTALLATION to 1 to enable additional asserts to verify
  516. * that the application has correctly installed FreeRTOS interrupt handlers.
  517. *
  518. * An application can install FreeRTOS interrupt handlers in one of the following ways:
  519. * 1. Direct Routing - Install the functions vPortSVCHandler and xPortPendSVHandler
  520. * for SVC call and PendSV interrupts respectively.
  521. * 2. Indirect Routing - Install separate handlers for SVC call and PendSV
  522. * interrupts and route program control from those handlers
  523. * to vPortSVCHandler and xPortPendSVHandler functions.
  524. * The applications that use Indirect Routing must set configCHECK_HANDLER_INSTALLATION to 0.
  525. *
  526. * Defaults to 1 if left undefined. */
  527. #define configCHECK_HANDLER_INSTALLATION 1
  528. /******************************************************************************/
  529. /* Definitions that include or exclude functionality. *************************/
  530. /******************************************************************************/
  531. /* Set the following configUSE_* constants to 1 to include the named feature in
  532. * the build, or 0 to exclude the named feature from the build. */
  533. #define configUSE_TASK_NOTIFICATIONS 1
  534. #define configUSE_MUTEXES 1
  535. #define configUSE_RECURSIVE_MUTEXES 1
  536. #define configUSE_COUNTING_SEMAPHORES 1
  537. #define configUSE_QUEUE_SETS 0
  538. #define configUSE_APPLICATION_TASK_TAG 0
  539. /* Set the following INCLUDE_* constants to 1 to incldue the named API function,
  540. * or 0 to exclude the named API function. Most linkers will remove unused
  541. * functions even when the constant is 1. */
  542. #define INCLUDE_vTaskPrioritySet 1
  543. #define INCLUDE_uxTaskPriorityGet 1
  544. #define INCLUDE_vTaskDelete 1
  545. #define INCLUDE_vTaskSuspend 1
  546. #define INCLUDE_xResumeFromISR 1
  547. #define INCLUDE_vTaskDelayUntil 1
  548. #define INCLUDE_vTaskDelay 1
  549. #define INCLUDE_xTaskGetSchedulerState 1
  550. #define INCLUDE_xTaskGetCurrentTaskHandle 1
  551. #define INCLUDE_uxTaskGetStackHighWaterMark 0
  552. #define INCLUDE_xTaskGetIdleTaskHandle 0
  553. #define INCLUDE_eTaskGetState 0
  554. #define INCLUDE_xEventGroupSetBitFromISR 1
  555. #define INCLUDE_xTimerPendFunctionCall 0
  556. #define INCLUDE_xTaskAbortDelay 0
  557. #define INCLUDE_xTaskGetHandle 0
  558. #define INCLUDE_xTaskResumeFromISR 1
  559. #endif /* FREERTOS_CONFIG_H */