portmacro.h 5.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152
  1. /*
  2. * FreeRTOS Kernel V11.3.0
  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. /* *INDENT-OFF* */
  31. #ifdef __cplusplus
  32. extern "C" {
  33. #endif
  34. /* *INDENT-ON* */
  35. /*-----------------------------------------------------------
  36. * Port specific definitions.
  37. *
  38. * The settings in this file configure FreeRTOS correctly for the
  39. * given hardware and compiler.
  40. *
  41. * These settings should not be altered.
  42. *-----------------------------------------------------------
  43. */
  44. /* Type definitions. */
  45. #define portCHAR char
  46. #define portFLOAT float
  47. #define portDOUBLE double
  48. #define portLONG long
  49. #define portSHORT short
  50. #define portSTACK_TYPE uint32_t
  51. #define portBASE_TYPE long
  52. typedef portSTACK_TYPE StackType_t;
  53. typedef long BaseType_t;
  54. typedef unsigned long UBaseType_t;
  55. #if ( configTICK_TYPE_WIDTH_IN_BITS == TICK_TYPE_WIDTH_16_BITS )
  56. typedef uint16_t TickType_t;
  57. #define portMAX_DELAY ( TickType_t ) 0xffff
  58. #elif ( configTICK_TYPE_WIDTH_IN_BITS == TICK_TYPE_WIDTH_32_BITS )
  59. typedef uint32_t TickType_t;
  60. #define portMAX_DELAY ( TickType_t ) 0xffffffffUL
  61. /* 32-bit tick type on a 32-bit architecture, so reads of the tick count do
  62. * not need to be guarded with a critical section. */
  63. #define portTICK_TYPE_IS_ATOMIC 1
  64. #else
  65. #error configTICK_TYPE_WIDTH_IN_BITS set to unsupported tick type width.
  66. #endif
  67. /*-----------------------------------------------------------*/
  68. /* Architecture specifics. */
  69. #define portSTACK_GROWTH ( -1 )
  70. #define portTICK_PERIOD_MS ( ( TickType_t ) 1000 / configTICK_RATE_HZ )
  71. #define portBYTE_ALIGNMENT 8
  72. /*-----------------------------------------------------------*/
  73. /* Scheduler utilities. */
  74. extern void vPortYield( void );
  75. #define portNVIC_INT_CTRL ( ( volatile uint32_t * ) 0xe000ed04 )
  76. #define portNVIC_PENDSVSET 0x10000000
  77. #define portYIELD() vPortYield()
  78. #define portEND_SWITCHING_ISR( xSwitchRequired ) \
  79. do \
  80. { \
  81. if( xSwitchRequired != pdFALSE ) \
  82. { \
  83. traceISR_EXIT_TO_SCHEDULER(); \
  84. *( portNVIC_INT_CTRL ) = portNVIC_PENDSVSET; \
  85. } \
  86. else \
  87. { \
  88. traceISR_EXIT(); \
  89. } \
  90. } while( 0 )
  91. #define portYIELD_FROM_ISR( x ) portEND_SWITCHING_ISR( x )
  92. /*-----------------------------------------------------------*/
  93. /* Critical section management. */
  94. /*
  95. * Set basepri to portMAX_SYSCALL_INTERRUPT_PRIORITY without effecting other
  96. * registers. r0 is clobbered.
  97. */
  98. #define portSET_INTERRUPT_MASK() __set_BASEPRI( configMAX_SYSCALL_INTERRUPT_PRIORITY )
  99. /*
  100. * Set basepri back to 0 without effective other registers.
  101. * r0 is clobbered. FAQ: Setting BASEPRI to 0 is not a bug. Please see
  102. * https://www.FreeRTOS.org/RTOS-Cortex-M3-M4.html before disagreeing.
  103. */
  104. #define portCLEAR_INTERRUPT_MASK() __set_BASEPRI( 0 )
  105. extern uint32_t ulPortSetInterruptMask( void );
  106. extern void vPortClearInterruptMask( uint32_t ulNewMask );
  107. #define portSET_INTERRUPT_MASK_FROM_ISR() ulPortSetInterruptMask()
  108. #define portCLEAR_INTERRUPT_MASK_FROM_ISR( x ) vPortClearInterruptMask( x )
  109. extern void vPortEnterCritical( void );
  110. extern void vPortExitCritical( void );
  111. #define portDISABLE_INTERRUPTS() portSET_INTERRUPT_MASK()
  112. #define portENABLE_INTERRUPTS() portCLEAR_INTERRUPT_MASK()
  113. #define portENTER_CRITICAL() vPortEnterCritical()
  114. #define portEXIT_CRITICAL() vPortExitCritical()
  115. /*-----------------------------------------------------------*/
  116. /* Task function macros as described on the FreeRTOS.org WEB site. */
  117. #define portTASK_FUNCTION_PROTO( vFunction, pvParameters ) void vFunction( void * pvParameters )
  118. #define portTASK_FUNCTION( vFunction, pvParameters ) void vFunction( void * pvParameters )
  119. #define portNOP()
  120. /* *INDENT-OFF* */
  121. #ifdef __cplusplus
  122. }
  123. #endif
  124. /* *INDENT-ON* */
  125. #endif /* PORTMACRO_H */