portmacro.h 7.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227
  1. /*
  2. * FreeRTOS Kernel V10.4.6
  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. #ifndef PORTMACRO_H
  29. #define PORTMACRO_H
  30. #ifdef __cplusplus
  31. extern "C" {
  32. #endif
  33. /*-----------------------------------------------------------
  34. * Port specific definitions.
  35. *
  36. * The settings in this file configure FreeRTOS correctly for the
  37. * given hardware and compiler.
  38. *
  39. * These settings should not be altered.
  40. *-----------------------------------------------------------
  41. */
  42. /* Type definitions. */
  43. #define portCHAR char
  44. #define portFLOAT float
  45. #define portDOUBLE double
  46. #define portLONG long
  47. #define portSHORT short
  48. #define portSTACK_TYPE uint32_t
  49. #define portBASE_TYPE portLONG
  50. typedef portSTACK_TYPE StackType_t;
  51. typedef long BaseType_t;
  52. typedef unsigned long UBaseType_t;
  53. #if( configUSE_16_BIT_TICKS == 1 )
  54. typedef uint16_t TickType_t;
  55. #define portMAX_DELAY ( TickType_t ) 0xffff
  56. #else
  57. typedef uint32_t TickType_t;
  58. #define portMAX_DELAY ( TickType_t ) 0xffffffffUL
  59. #endif
  60. /*-----------------------------------------------------------*/
  61. /* Architecture specifics. */
  62. #define portSTACK_GROWTH ( -1 )
  63. #define portTICK_PERIOD_MS ( ( TickType_t ) 1000 / configTICK_RATE_HZ )
  64. #define portBYTE_ALIGNMENT 8
  65. #define portNOP() __asm volatile ( "NOP" );
  66. /*-----------------------------------------------------------*/
  67. /* Scheduler utilities. */
  68. /*
  69. * portRESTORE_CONTEXT, portRESTORE_CONTEXT, portENTER_SWITCHING_ISR
  70. * and portEXIT_SWITCHING_ISR can only be called from ARM mode, but
  71. * are included here for efficiency. An attempt to call one from
  72. * THUMB mode code will result in a compile time error.
  73. */
  74. #define portRESTORE_CONTEXT() \
  75. { \
  76. extern volatile void * volatile pxCurrentTCB; \
  77. extern volatile uint32_t ulCriticalNesting; \
  78. \
  79. /* Set the LR to the task stack. */ \
  80. __asm volatile ( \
  81. "LDR R0, =pxCurrentTCB \n\t" \
  82. "LDR R0, [R0] \n\t" \
  83. "LDR LR, [R0] \n\t" \
  84. \
  85. /* The critical nesting depth is the first item on the stack. */ \
  86. /* Load it into the ulCriticalNesting variable. */ \
  87. "LDR R0, =ulCriticalNesting \n\t" \
  88. "LDMFD LR!, {R1} \n\t" \
  89. "STR R1, [R0] \n\t" \
  90. \
  91. /* Get the SPSR from the stack. */ \
  92. "LDMFD LR!, {R0} \n\t" \
  93. "MSR SPSR, R0 \n\t" \
  94. \
  95. /* Restore all system mode registers for the task. */ \
  96. "LDMFD LR, {R0-R14}^ \n\t" \
  97. "NOP \n\t" \
  98. \
  99. /* Restore the return address. */ \
  100. "LDR LR, [LR, #+60] \n\t" \
  101. \
  102. /* And return - correcting the offset in the LR to obtain the */ \
  103. /* correct address. */ \
  104. "SUBS PC, LR, #4 \n\t" \
  105. ); \
  106. ( void ) ulCriticalNesting; \
  107. ( void ) pxCurrentTCB; \
  108. }
  109. /*-----------------------------------------------------------*/
  110. #define portSAVE_CONTEXT() \
  111. { \
  112. extern volatile void * volatile pxCurrentTCB; \
  113. extern volatile uint32_t ulCriticalNesting; \
  114. \
  115. /* Push R0 as we are going to use the register. */ \
  116. __asm volatile ( \
  117. "STMDB SP!, {R0} \n\t" \
  118. \
  119. /* Set R0 to point to the task stack pointer. */ \
  120. "STMDB SP,{SP}^ \n\t" \
  121. "NOP \n\t" \
  122. "SUB SP, SP, #4 \n\t" \
  123. "LDMIA SP!,{R0} \n\t" \
  124. \
  125. /* Push the return address onto the stack. */ \
  126. "STMDB R0!, {LR} \n\t" \
  127. \
  128. /* Now we have saved LR we can use it instead of R0. */ \
  129. "MOV LR, R0 \n\t" \
  130. \
  131. /* Pop R0 so we can save it onto the system mode stack. */ \
  132. "LDMIA SP!, {R0} \n\t" \
  133. \
  134. /* Push all the system mode registers onto the task stack. */ \
  135. "STMDB LR,{R0-LR}^ \n\t" \
  136. "NOP \n\t" \
  137. "SUB LR, LR, #60 \n\t" \
  138. \
  139. /* Push the SPSR onto the task stack. */ \
  140. "MRS R0, SPSR \n\t" \
  141. "STMDB LR!, {R0} \n\t" \
  142. \
  143. "LDR R0, =ulCriticalNesting \n\t" \
  144. "LDR R0, [R0] \n\t" \
  145. "STMDB LR!, {R0} \n\t" \
  146. \
  147. /* Store the new top of stack for the task. */ \
  148. "LDR R0, =pxCurrentTCB \n\t" \
  149. "LDR R0, [R0] \n\t" \
  150. "STR LR, [R0] \n\t" \
  151. ); \
  152. ( void ) ulCriticalNesting; \
  153. ( void ) pxCurrentTCB; \
  154. }
  155. extern void vTaskSwitchContext( void );
  156. #define portYIELD_FROM_ISR() vTaskSwitchContext()
  157. #define portYIELD() __asm volatile ( "SWI 0" )
  158. /*-----------------------------------------------------------*/
  159. /* Critical section management. */
  160. /*
  161. * The interrupt management utilities can only be called from ARM mode. When
  162. * THUMB_INTERWORK is defined the utilities are defined as functions in
  163. * portISR.c to ensure a switch to ARM mode. When THUMB_INTERWORK is not
  164. * defined then the utilities are defined as macros here - as per other ports.
  165. */
  166. #ifdef THUMB_INTERWORK
  167. extern void vPortDisableInterruptsFromThumb( void ) __attribute__ ((naked));
  168. extern void vPortEnableInterruptsFromThumb( void ) __attribute__ ((naked));
  169. #define portDISABLE_INTERRUPTS() vPortDisableInterruptsFromThumb()
  170. #define portENABLE_INTERRUPTS() vPortEnableInterruptsFromThumb()
  171. #else
  172. #define portDISABLE_INTERRUPTS() \
  173. __asm volatile ( \
  174. "STMDB SP!, {R0} \n\t" /* Push R0. */ \
  175. "MRS R0, CPSR \n\t" /* Get CPSR. */ \
  176. "ORR R0, R0, #0xC0 \n\t" /* Disable IRQ, FIQ. */ \
  177. "MSR CPSR, R0 \n\t" /* Write back modified value. */ \
  178. "LDMIA SP!, {R0} " ) /* Pop R0. */
  179. #define portENABLE_INTERRUPTS() \
  180. __asm volatile ( \
  181. "STMDB SP!, {R0} \n\t" /* Push R0. */ \
  182. "MRS R0, CPSR \n\t" /* Get CPSR. */ \
  183. "BIC R0, R0, #0xC0 \n\t" /* Enable IRQ, FIQ. */ \
  184. "MSR CPSR, R0 \n\t" /* Write back modified value. */ \
  185. "LDMIA SP!, {R0} " ) /* Pop R0. */
  186. #endif /* THUMB_INTERWORK */
  187. extern void vPortEnterCritical( void );
  188. extern void vPortExitCritical( void );
  189. #define portENTER_CRITICAL() vPortEnterCritical();
  190. #define portEXIT_CRITICAL() vPortExitCritical();
  191. /*-----------------------------------------------------------*/
  192. /* Task function macros as described on the FreeRTOS.org WEB site. */
  193. #define portTASK_FUNCTION_PROTO( vFunction, pvParameters ) void vFunction( void *pvParameters )
  194. #define portTASK_FUNCTION( vFunction, pvParameters ) void vFunction( void *pvParameters )
  195. #ifdef __cplusplus
  196. }
  197. #endif
  198. #endif /* PORTMACRO_H */