begriffs open source - freertos/blob - Source/portable/MPLAB/PIC32MX/portmacro.h

   1 /*\r
   2         FreeRTOS.org V5.0.0 - Copyright (C) 2003-2008 Richard Barry.\r
   3 \r
   4         This file is part of the FreeRTOS.org distribution.\r
   5 \r
   6         FreeRTOS.org is free software; you can redistribute it and/or modify\r
   7         it under the terms of the GNU General Public License as published by\r
   8         the Free Software Foundation; either version 2 of the License, or\r
   9         (at your option) any later version.\r
  10 \r
  11         FreeRTOS.org is distributed in the hope that it will be useful,\r
  12         but WITHOUT ANY WARRANTY; without even the implied warranty of\r
  13         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\r
  14         GNU General Public License for more details.\r
  15 \r
  16         You should have received a copy of the GNU General Public License\r
  17         along with FreeRTOS.org; if not, write to the Free Software\r
  18         Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA\r
  19 \r
  20         A special exception to the GPL can be applied should you wish to distribute\r
  21         a combined work that includes FreeRTOS.org, without being obliged to provide\r
  22         the source code for any proprietary components.  See the licensing section \r
  23         of http://www.FreeRTOS.org for full details of how and when the exception\r
  24         can be applied.\r
  25 \r
  26     ***************************************************************************\r
  27     ***************************************************************************\r
  28     *                                                                         *\r
  29     * SAVE TIME AND MONEY!  We can port FreeRTOS.org to your own hardware,    *\r
  30     * and even write all or part of your application on your behalf.          *\r
  31     * See http://www.OpenRTOS.com for details of the services we provide to   *\r
  32     * expedite your project.                                                  *\r
  33     *                                                                         *\r
  34     ***************************************************************************\r
  35     ***************************************************************************\r
  36 \r
  37         Please ensure to read the configuration and relevant port sections of the\r
  38         online documentation.\r
  39 \r
  40         http://www.FreeRTOS.org - Documentation, latest information, license and \r
  41         contact details.\r
  42 \r
  43         http://www.SafeRTOS.com - A version that is certified for use in safety \r
  44         critical systems.\r
  45 \r
  46         http://www.OpenRTOS.com - Commercial support, development, porting, \r
  47         licensing and training services.\r
  48 */\r
  49 \r
  50 #ifndef PORTMACRO_H\r
  51 #define PORTMACRO_H\r
  52 \r
  53 /* System include files */\r
  54 #include <plib.h>\r
  55 \r
  56 #ifdef __cplusplus\r
  57 extern "C" {\r
  58 #endif\r
  59 \r
  60 /*-----------------------------------------------------------\r
  61  * Port specific definitions.  \r
  62  *\r
  63  * The settings in this file configure FreeRTOS correctly for the\r
  64  * given hardware and compiler.\r
  65  *\r
  66  * These settings should not be altered.\r
  67  *-----------------------------------------------------------\r
  68  */\r
  69 \r
  70 /* Type definitions. */\r
  71 #define portCHAR                char\r
  72 #define portFLOAT               float\r
  73 #define portDOUBLE              double\r
  74 #define portLONG                long\r
  75 #define portSHORT               short\r
  76 #define portSTACK_TYPE  unsigned long\r
  77 #define portBASE_TYPE   long\r
  78 \r
  79 #if( configUSE_16_BIT_TICKS == 1 )\r
  80         typedef unsigned portSHORT portTickType;\r
  81         #define portMAX_DELAY ( portTickType ) 0xffff\r
  82 #else\r
  83         typedef unsigned portLONG portTickType;\r
  84         #define portMAX_DELAY ( portTickType ) 0xffffffff\r
  85 #endif\r
  86 /*-----------------------------------------------------------*/\r
  87 \r
  88 /* Hardware specifics. */\r
  89 #define portBYTE_ALIGNMENT                      4\r
  90 #define portSTACK_GROWTH                        -4\r
  91 #define portTICK_RATE_MS                        ( ( portTickType ) 1000 / configTICK_RATE_HZ )          \r
  92 /*-----------------------------------------------------------*/\r
  93 \r
  94 /* Critical section management. */\r
  95 #define portIPL_SHIFT                           ( 10 )\r
  96 #define portALL_IPL_BITS                        ( 0x3f << portIPL_SHIFT )\r
  97 \r
  98 #define portDISABLE_INTERRUPTS()                                                                                        \\r
  99 {                                                                                                                                                       \\r
 100 unsigned portLONG ulStatus;                                                                                                     \\r
 101                                                                                                                                                         \\r
 102         /* Mask interrupts at and below the kernel interrupt priority. */               \\r
 103         ulStatus = _CP0_GET_STATUS();                                                                                   \\r
 104         ulStatus |= ( configMAX_SYSCALL_INTERRUPT_PRIORITY << portIPL_SHIFT );  \\r
 105         _CP0_SET_STATUS( ulStatus );                                                                                    \\r
 106 }\r
 107 \r
 108 #define portENABLE_INTERRUPTS()                                                                                         \\r
 109 {                                                                                                                                                       \\r
 110 unsigned portLONG ulStatus;                                                                                                     \\r
 111                                                                                                                                                         \\r
 112         /* Unmask all interrupts. */                                                                                    \\r
 113         ulStatus = _CP0_GET_STATUS();                                                                                   \\r
 114         ulStatus &= ~portALL_IPL_BITS;                                                                                  \\r
 115         _CP0_SET_STATUS( ulStatus );                                                                                    \\r
 116 }\r
 117 \r
 118 \r
 119 extern void vTaskEnterCritical( void );\r
 120 extern void vTaskExitCritical( void );\r
 121 #define portCRITICAL_NESTING_IN_TCB     1\r
 122 #define portENTER_CRITICAL()            vTaskEnterCritical()\r
 123 #define portEXIT_CRITICAL()                     vTaskExitCritical()\r
 124 \r
 125 extern unsigned portBASE_TYPE uxPortSetInterruptMaskFromISR();\r
 126 extern void vPortClearInterruptMaskFromISR( unsigned portBASE_TYPE );\r
 127 #define portSET_INTERRUPT_MASK_FROM_ISR() uxPortSetInterruptMaskFromISR()\r
 128 #define portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedStatusRegister ) vPortClearInterruptMaskFromISR( uxSavedStatusRegister )\r
 129 \r
 130 /*-----------------------------------------------------------*/\r
 131 \r
 132 /* Task utilities. */\r
 133 extern void vPortYield( void );\r
 134 #define portYIELD()     vPortYield()\r
 135 \r
 136 #define portNOP()                               asm volatile (  "nop" )\r
 137 \r
 138 /*-----------------------------------------------------------*/\r
 139 \r
 140 /* Task function macros as described on the FreeRTOS.org WEB site. */\r
 141 #define portTASK_FUNCTION_PROTO( vFunction, pvParameters ) void vFunction( void *pvParameters ) __attribute__((noreturn))\r
 142 #define portTASK_FUNCTION( vFunction, pvParameters ) void vFunction( void *pvParameters )\r
 143 /*-----------------------------------------------------------*/\r
 144 \r
 145 #define portEND_SWITCHING_ISR( vSwitchRequired ) if( vSwitchRequired ) SetCoreSW0()\r
 146 \r
 147 #ifdef __cplusplus\r
 148 }\r
 149 #endif\r
 150 \r
 151 #endif /* PORTMACRO_H */\r
 152 \r