]> git.sur5r.net Git - freertos/blobdiff - FreeRTOS/Source/portable/MPLAB/PIC32MZ/port.c
Update version number ready for next release.
[freertos] / FreeRTOS / Source / portable / MPLAB / PIC32MZ / port.c
index 4e62b77d296671c9668004c7547e68afe9fc9629..3e1f6552ef5c74d1ee5422e2d4c48397316556a9 100644 (file)
@@ -1,74 +1,40 @@
 /*\r
-    FreeRTOS V7.6.0 - Copyright (C) 2013 Real Time Engineers Ltd.\r
-    All rights reserved\r
-\r
-    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.\r
-\r
-    ***************************************************************************\r
-     *                                                                       *\r
-     *    FreeRTOS provides completely free yet professionally developed,    *\r
-     *    robust, strictly quality controlled, supported, and cross          *\r
-     *    platform software that has become a de facto standard.             *\r
-     *                                                                       *\r
-     *    Help yourself get started quickly and support the FreeRTOS         *\r
-     *    project by purchasing a FreeRTOS tutorial book, reference          *\r
-     *    manual, or both from: http://www.FreeRTOS.org/Documentation        *\r
-     *                                                                       *\r
-     *    Thank you!                                                         *\r
-     *                                                                       *\r
-    ***************************************************************************\r
-\r
-    This file is part of the FreeRTOS distribution.\r
-\r
-    FreeRTOS is free software; you can redistribute it and/or modify it under\r
-    the terms of the GNU General Public License (version 2) as published by the\r
-    Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception.\r
-\r
-    >>! NOTE: The modification to the GPL is included to allow you to distribute\r
-    >>! a combined work that includes FreeRTOS without being obliged to provide\r
-    >>! the source code for proprietary components outside of the FreeRTOS\r
-    >>! kernel.\r
-\r
-    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY\r
-    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS\r
-    FOR A PARTICULAR PURPOSE.  Full license text is available from the following\r
-    link: http://www.freertos.org/a00114.html\r
-\r
-    1 tab == 4 spaces!\r
-\r
-    ***************************************************************************\r
-     *                                                                       *\r
-     *    Having a problem?  Start by reading the FAQ "My application does   *\r
-     *    not run, what could be wrong?"                                     *\r
-     *                                                                       *\r
-     *    http://www.FreeRTOS.org/FAQHelp.html                               *\r
-     *                                                                       *\r
-    ***************************************************************************\r
-\r
-    http://www.FreeRTOS.org - Documentation, books, training, latest versions,\r
-    license and Real Time Engineers Ltd. contact details.\r
-\r
-    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,\r
-    including FreeRTOS+Trace - an indispensable productivity tool, a DOS\r
-    compatible FAT file system, and our tiny thread aware UDP/IP stack.\r
-\r
-    http://www.OpenRTOS.com - Real Time Engineers ltd license FreeRTOS to High\r
-    Integrity Systems to sell under the OpenRTOS brand.  Low cost OpenRTOS\r
-    licenses offer ticketed support, indemnification and middleware.\r
-\r
-    http://www.SafeRTOS.com - High Integrity Systems also provide a safety\r
-    engineered and independently SIL3 certified version for use in safety and\r
-    mission critical applications that require provable dependability.\r
-\r
-    1 tab == 4 spaces!\r
-*/\r
+ * FreeRTOS Kernel V10.2.1\r
+ * Copyright (C) 2019 Amazon.com, Inc. or its affiliates.  All Rights Reserved.\r
+ *\r
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of\r
+ * this software and associated documentation files (the "Software"), to deal in\r
+ * the Software without restriction, including without limitation the rights to\r
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\r
+ * the Software, and to permit persons to whom the Software is furnished to do so,\r
+ * subject to the following conditions:\r
+ *\r
+ * The above copyright notice and this permission notice shall be included in all\r
+ * copies or substantial portions of the Software.\r
+ *\r
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\r
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\r
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\r
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\r
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\r
+ *\r
+ * http://www.FreeRTOS.org\r
+ * http://aws.amazon.com/freertos\r
+ *\r
+ * 1 tab == 4 spaces!\r
+ */\r
 \r
 /*-----------------------------------------------------------\r
  * Implementation of functions defined in portable.h for the PIC32MZ port.\r
   *----------------------------------------------------------*/\r
 \r
+/* Microchip specific headers. */\r
 #include <xc.h>\r
 \r
+/* Standard headers. */\r
+#include <string.h>\r
+\r
 /* Scheduler include files. */\r
 #include "FreeRTOS.h"\r
 #include "task.h"\r
@@ -89,6 +55,8 @@
 #define portIE_BIT                                     ( 0x00000001 )\r
 #define portEXL_BIT                                    ( 0x00000002 )\r
 #define portMX_BIT                                     ( 0x01000000 ) /* Allow access to DSP instructions. */\r
+#define portCU1_BIT                                    ( 0x20000000 ) /* enable CP1 for parts with hardware. */\r
+#define portFR_BIT                                     ( 0x04000000 ) /* Enable 64 bit floating point registers. */\r
 \r
 /* Bits within the CAUSE register. */\r
 #define portCORE_SW_0                          ( 0x00000100 )\r
 \r
 /* The EXL bit is set to ensure interrupts do not occur while the context of\r
 the first task is being restored. */\r
-#define portINITIAL_SR                         ( portIE_BIT | portEXL_BIT | portMX_BIT )\r
+#if ( __mips_hard_float == 1 )\r
+    #define portINITIAL_SR                     ( portIE_BIT | portEXL_BIT | portMX_BIT | portFR_BIT | portCU1_BIT )\r
+#else\r
+    #define portINITIAL_SR                     ( portIE_BIT | portEXL_BIT | portMX_BIT )\r
+#endif\r
+\r
+/* The initial value to store into the FPU status and control register. This is\r
+ only used on parts that support a hardware FPU. */\r
+#define portINITIAL_FPSCR                      (0x1000000) /* High perf on denormal ops */\r
+\r
 \r
 /*\r
 By default port.c generates its tick interrupt from TIMER1.  The user can\r
@@ -125,7 +102,7 @@ override this behaviour by:
 #endif\r
 \r
 /* Let the user override the pre-loading of the initial RA with the address of\r
-prvTaskExitError() in case is messes up unwinding of the stack in the\r
+prvTaskExitError() in case it messes up unwinding of the stack in the\r
 debugger - in which case configTASK_RETURN_ADDRESS can be defined as 0 (NULL). */\r
 #ifdef configTASK_RETURN_ADDRESS\r
        #define portTASK_RETURN_ADDRESS configTASK_RETURN_ADDRESS\r
@@ -144,7 +121,7 @@ task stack, not the ISR stack). */
        the ISR stack. */\r
        #define portISR_STACK_FILL_BYTE 0xee\r
 \r
-       static const unsigned char ucExpectedStackBytes[] = {\r
+       static const uint8_t ucExpectedStackBytes[] = {\r
                                                                        portISR_STACK_FILL_BYTE, portISR_STACK_FILL_BYTE, portISR_STACK_FILL_BYTE, portISR_STACK_FILL_BYTE,             \\r
                                                                        portISR_STACK_FILL_BYTE, portISR_STACK_FILL_BYTE, portISR_STACK_FILL_BYTE, portISR_STACK_FILL_BYTE,             \\r
                                                                        portISR_STACK_FILL_BYTE, portISR_STACK_FILL_BYTE, portISR_STACK_FILL_BYTE, portISR_STACK_FILL_BYTE,             \\r
@@ -159,22 +136,6 @@ task stack, not the ISR stack). */
 \r
 /*-----------------------------------------------------------*/\r
 \r
-/*\r
- * Place the prototype here to ensure the interrupt vector is correctly installed.\r
- * Note that because the interrupt is written in assembly, the IPL setting in the\r
- * following line of code has no effect.  The interrupt priority is set by the\r
- * call to ConfigIntTimer1() in vApplicationSetupTickTimerInterrupt().\r
- */\r
-extern void __attribute__( (interrupt(ipl1), vector( configTICK_INTERRUPT_VECTOR ))) vPortTickInterruptHandler( void );\r
-\r
-/*\r
- * The software interrupt handler that performs the yield.  Note that, because\r
- * the interrupt is written in assembly, the IPL setting in the following line of\r
- * code has no effect.  The interrupt priority is set by the call to\r
- * mConfigIntCoreSW0() in xPortStartScheduler().\r
- */\r
-void __attribute__( (interrupt(ipl1), vector(_CORE_SOFTWARE_0_VECTOR))) vPortYieldISR( void );\r
-\r
 /*\r
  * Used to catch tasks that attempt to return from their implementing function.\r
  */\r
@@ -184,52 +145,63 @@ static void prvTaskExitError( void );
 \r
 /* Records the interrupt nesting depth.  This is initialised to one as it is\r
 decremented to 0 when the first task starts. */\r
-volatile unsigned portBASE_TYPE uxInterruptNesting = 0x01;\r
+volatile UBaseType_t uxInterruptNesting = 0x01;\r
 \r
 /* Stores the task stack pointer when a switch is made to use the system stack. */\r
-unsigned portBASE_TYPE uxSavedTaskStackPointer = 0;\r
+UBaseType_t uxSavedTaskStackPointer = 0;\r
 \r
 /* The stack used by interrupt service routines that cause a context switch. */\r
-portSTACK_TYPE xISRStack[ configISR_STACK_SIZE ] = { 0 };\r
+__attribute__ ((aligned(8))) StackType_t xISRStack[ configISR_STACK_SIZE ] = { 0 };\r
 \r
 /* The top of stack value ensures there is enough space to store 6 registers on\r
-the callers stack, as some functions seem to want to do this. */\r
-const portSTACK_TYPE * const xISRStackTop = &( xISRStack[ configISR_STACK_SIZE - 7 ] );\r
+the callers stack, as some functions seem to want to do this.  8 byte alignment\r
+is required to allow double word floating point stack pushes generated by the\r
+compiler. */\r
+const StackType_t * const xISRStackTop = &( xISRStack[ ( configISR_STACK_SIZE & ~portBYTE_ALIGNMENT_MASK ) - 8 ] );\r
+\r
+/* Saved as part of the task context. Set to pdFALSE if the task does not\r
+ require an FPU context. */\r
+#if ( __mips_hard_float == 1 ) && ( configUSE_TASK_FPU_SUPPORT == 1 )\r
+       uint32_t ulTaskHasFPUContext = 0;\r
+#endif\r
 \r
 /*-----------------------------------------------------------*/\r
 \r
 /*\r
  * See header file for description.\r
  */\r
-portSTACK_TYPE *pxPortInitialiseStack( portSTACK_TYPE *pxTopOfStack, pdTASK_CODE pxCode, void *pvParameters )\r
+StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters )\r
 {\r
-       /* Ensure byte alignment is maintained when leaving this function. */\r
+       /* Ensure byte alignment is maintained when leaving this function. */\r
        pxTopOfStack--;\r
-\r
-       *pxTopOfStack = (portSTACK_TYPE) 0xDEADBEEF;\r
        pxTopOfStack--;\r
 \r
-       *pxTopOfStack = (portSTACK_TYPE) 0x12345678;    /* Word to which the stack pointer will be left pointing after context restore. */\r
+       *pxTopOfStack = (StackType_t) 0xDEADBEEF;\r
        pxTopOfStack--;\r
 \r
-       *pxTopOfStack = (portSTACK_TYPE) _CP0_GET_CAUSE();\r
+       *pxTopOfStack = (StackType_t) 0x12345678;       /* Word to which the stack pointer will be left pointing after context restore. */\r
        pxTopOfStack--;\r
 \r
-       *pxTopOfStack = (portSTACK_TYPE) portINITIAL_SR;/* CP0_STATUS */\r
+       *pxTopOfStack = (StackType_t) _CP0_GET_CAUSE();\r
        pxTopOfStack--;\r
 \r
-       *pxTopOfStack = (portSTACK_TYPE) pxCode;                /* CP0_EPC */\r
-       pxTopOfStack -= 7;                                                      /* Includes space for AC1 - AC3. */\r
+       *pxTopOfStack = (StackType_t) portINITIAL_SR;/* CP0_STATUS */\r
+       pxTopOfStack--;\r
 \r
-       *pxTopOfStack = (portSTACK_TYPE) 0x00000000;    /* DSPControl */\r
+       *pxTopOfStack = (StackType_t) pxCode;           /* CP0_EPC */\r
        pxTopOfStack--;\r
 \r
-       *pxTopOfStack = (portSTACK_TYPE) portTASK_RETURN_ADDRESS;       /* ra */\r
+       *pxTopOfStack = (StackType_t) 0x00000000;       /* DSPControl */\r
+       pxTopOfStack -= 7;                                              /* Includes space for AC1 - AC3. */\r
+\r
+       *pxTopOfStack = (StackType_t) portTASK_RETURN_ADDRESS;  /* ra */\r
        pxTopOfStack -= 15;\r
 \r
-       *pxTopOfStack = (portSTACK_TYPE) pvParameters; /* Parameters to pass in. */\r
+       *pxTopOfStack = (StackType_t) pvParameters; /* Parameters to pass in. */\r
        pxTopOfStack -= 15;\r
 \r
+       *pxTopOfStack = (StackType_t) pdFALSE; /*by default disable FPU context save on parts with FPU */\r
+\r
        return pxTopOfStack;\r
 }\r
 /*-----------------------------------------------------------*/\r
@@ -259,7 +231,7 @@ static void prvTaskExitError( void )
  */\r
 __attribute__(( weak )) void vApplicationSetupTickTimerInterrupt( void )\r
 {\r
-const unsigned long ulCompareMatch = ( (configPERIPHERAL_CLOCK_HZ / portTIMER_PRESCALE) / configTICK_RATE_HZ ) - 1;\r
+const uint32_t ulCompareMatch = ( (configPERIPHERAL_CLOCK_HZ / portTIMER_PRESCALE) / configTICK_RATE_HZ ) - 1UL;\r
 \r
        T1CON = 0x0000;\r
        T1CONbits.TCKPS = portPRESCALE_BITS;\r
@@ -279,14 +251,13 @@ const unsigned long ulCompareMatch = ( (configPERIPHERAL_CLOCK_HZ / portTIMER_PR
 \r
 void vPortEndScheduler(void)\r
 {\r
-       /* It is unlikely that the scheduler for the PIC port will get stopped\r
-       once running.  If required disable the tick interrupt here, then return\r
-       to xPortStartScheduler(). */\r
-       for( ;; );\r
+       /* Not implemented in ports where there is nothing to return to.\r
+       Artificially force an assert. */\r
+       configASSERT( uxInterruptNesting == 1000UL );\r
 }\r
 /*-----------------------------------------------------------*/\r
 \r
-portBASE_TYPE xPortStartScheduler( void )\r
+BaseType_t xPortStartScheduler( void )\r
 {\r
 extern void vPortStartFirstTask( void );\r
 extern void *pxCurrentTCB;\r
@@ -315,7 +286,7 @@ extern void *pxCurrentTCB;
 \r
        /* Kick off the highest priority task that has been created so far.\r
        Its stack location is loaded into uxSavedTaskStackPointer. */\r
-       uxSavedTaskStackPointer = *( unsigned portBASE_TYPE * ) pxCurrentTCB;\r
+       uxSavedTaskStackPointer = *( UBaseType_t * ) pxCurrentTCB;\r
        vPortStartFirstTask();\r
 \r
        /* Should never get here as the tasks will now be executing!  Call the task\r
@@ -330,7 +301,7 @@ extern void *pxCurrentTCB;
 \r
 void vPortIncrementTick( void )\r
 {\r
-unsigned portBASE_TYPE uxSavedStatus;\r
+UBaseType_t uxSavedStatus;\r
 \r
        uxSavedStatus = uxPortSetInterruptMaskFromISR();\r
        {\r
@@ -350,9 +321,9 @@ unsigned portBASE_TYPE uxSavedStatus;
 }\r
 /*-----------------------------------------------------------*/\r
 \r
-unsigned portBASE_TYPE uxPortSetInterruptMaskFromISR( void )\r
+UBaseType_t uxPortSetInterruptMaskFromISR( void )\r
 {\r
-unsigned portBASE_TYPE uxSavedStatusRegister;\r
+UBaseType_t uxSavedStatusRegister;\r
 \r
        __builtin_disable_interrupts();\r
        uxSavedStatusRegister = _CP0_GET_STATUS() | 0x01;\r
@@ -368,12 +339,33 @@ unsigned portBASE_TYPE uxSavedStatusRegister;
 }\r
 /*-----------------------------------------------------------*/\r
 \r
-void vPortClearInterruptMaskFromISR( unsigned portBASE_TYPE uxSavedStatusRegister )\r
+void vPortClearInterruptMaskFromISR( UBaseType_t uxSavedStatusRegister )\r
 {\r
        _CP0_SET_STATUS( uxSavedStatusRegister );\r
 }\r
 /*-----------------------------------------------------------*/\r
 \r
+#if ( __mips_hard_float == 1 ) && ( configUSE_TASK_FPU_SUPPORT == 1 )\r
+\r
+       void vPortTaskUsesFPU(void)\r
+       {\r
+       extern void vPortInitialiseFPSCR( uint32_t uxFPSCRInit );\r
+\r
+               portENTER_CRITICAL();\r
+\r
+               /* Initialise the floating point status register. */\r
+               vPortInitialiseFPSCR(portINITIAL_FPSCR);\r
+\r
+               /* A task is registering the fact that it needs a FPU context. Set the\r
+               FPU flag (saved as part of the task context). */\r
+               ulTaskHasFPUContext = pdTRUE;\r
+\r
+               portEXIT_CRITICAL();\r
+       }\r
+\r
+#endif /* __mips_hard_float == 1 */\r
+\r
+/*-----------------------------------------------------------*/\r
 \r
 \r
 \r