portmacro.h 4.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
  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. #include <machine.h>
  31. #ifdef __cplusplus
  32. extern "C" {
  33. #endif
  34. /*-----------------------------------------------------------
  35. * Port specific definitions.
  36. *
  37. * The settings in this file configure FreeRTOS correctly for the
  38. * given hardware and compiler.
  39. *
  40. * These settings should not be altered.
  41. *-----------------------------------------------------------
  42. */
  43. /* Type definitions - these are a bit legacy and not really used now, other than
  44. portSTACK_TYPE and portBASE_TYPE. */
  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( configUSE_16_BIT_TICKS == 1 )
  56. typedef uint16_t TickType_t;
  57. #define portMAX_DELAY ( TickType_t ) 0xffff
  58. #else
  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. #endif
  65. /*-----------------------------------------------------------*/
  66. /* Hardware specifics. */
  67. #define portBYTE_ALIGNMENT 8
  68. #define portSTACK_GROWTH -1
  69. #define portTICK_PERIOD_MS ( ( TickType_t ) 1000 / configTICK_RATE_HZ )
  70. #define portNOP() nop()
  71. #define portSTART_SCHEDULER_TRAP_NO ( 32 )
  72. #define portYIELD_TRAP_NO ( 33 )
  73. #define portKERNEL_INTERRUPT_PRIORITY ( 1 )
  74. void vPortYield( void );
  75. #define portYIELD() vPortYield()
  76. extern void vTaskSwitchContext( void );
  77. #define portYIELD_FROM_ISR( x ) do { if( x != pdFALSE ) vTaskSwitchContext(); } while( 0 )
  78. /*
  79. * This function tells the kernel that the task referenced by xTask is going to
  80. * use the floating point registers and therefore requires the floating point
  81. * registers saved as part of its context.
  82. */
  83. BaseType_t xPortUsesFloatingPoint( void* xTask );
  84. /*
  85. * The flop save and restore functions are defined in portasm.src and called by
  86. * the trace "task switched in" and "trace task switched out" macros.
  87. */
  88. void vPortSaveFlopRegisters( void *pulBuffer );
  89. void vPortRestoreFlopRegisters( void *pulBuffer );
  90. /*
  91. * pxTaskTag is used to point to the buffer into which the floating point
  92. * context should be saved. If pxTaskTag is NULL then the task does not use
  93. * a floating point context.
  94. */
  95. #define traceTASK_SWITCHED_OUT() do { if( pxCurrentTCB->pxTaskTag != NULL ) vPortSaveFlopRegisters( pxCurrentTCB->pxTaskTag ); } while( 0 )
  96. #define traceTASK_SWITCHED_IN() do { if( pxCurrentTCB->pxTaskTag != NULL ) vPortRestoreFlopRegisters( pxCurrentTCB->pxTaskTag ); } while( 0 )
  97. /*
  98. * These macros should be called directly, but through the taskENTER_CRITICAL()
  99. * and taskEXIT_CRITICAL() macros.
  100. */
  101. #define portENABLE_INTERRUPTS() set_imask( 0x00 )
  102. #define portDISABLE_INTERRUPTS() set_imask( portKERNEL_INTERRUPT_PRIORITY )
  103. /* Critical nesting counts are stored in the TCB. */
  104. #define portCRITICAL_NESTING_IN_TCB ( 1 )
  105. /* The critical nesting functions defined within tasks.c. */
  106. extern void vTaskEnterCritical( void );
  107. extern void vTaskExitCritical( void );
  108. #define portENTER_CRITICAL() vTaskEnterCritical();
  109. #define portEXIT_CRITICAL() vTaskExitCritical();
  110. /*-----------------------------------------------------------*/
  111. /* Task function macros as described on the FreeRTOS.org WEB site. */
  112. #define portTASK_FUNCTION_PROTO( vFunction, pvParameters ) void vFunction( void *pvParameters )
  113. #define portTASK_FUNCTION( vFunction, pvParameters ) void vFunction( void *pvParameters )
  114. #ifdef __cplusplus
  115. }
  116. #endif
  117. #endif /* PORTMACRO_H */