git.sur5r.net Git - freertos/blob - Demo/ColdFire_MCF52259_CodeWarrior/FreeRTOS_Tick_Setup.c

   1 /*\r
   2         FreeRTOS.org V5.1.2 - Copyright (C) 2003-2009 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     * Get the FreeRTOS eBook!  See http://www.FreeRTOS.org/Documentation      *\r
  30         *                                                                         *\r
  31         * This is a concise, step by step, 'hands on' guide that describes both   *\r
  32         * general multitasking concepts and FreeRTOS specifics. It presents and   *\r
  33         * explains numerous examples that are written using the FreeRTOS API.     *\r
  34         * Full source code for all the examples is provided in an accompanying    *\r
  35         * .zip file.                                                              *\r
  36     *                                                                         *\r
  37     ***************************************************************************\r
  38     ***************************************************************************\r
  39 \r
  40         Please ensure to read the configuration and relevant port sections of the\r
  41         online documentation.\r
  42 \r
  43         http://www.FreeRTOS.org - Documentation, latest information, license and\r
  44         contact details.\r
  45 \r
  46         http://www.SafeRTOS.com - A version that is certified for use in safety\r
  47         critical systems.\r
  48 \r
  49         http://www.OpenRTOS.com - Commercial support, development, porting,\r
  50         licensing and training services.\r
  51 */\r
  52 \r
  53 #include "FreeRTOS.h"\r
  54 #include "task.h"\r
  55 \r
  56 __declspec(interrupt:0) void vPIT0InterruptHandler( void );\r
  57 \r
  58 /* Constants used to configure the interrupts. */\r
  59 #define portPRESCALE_VALUE                      64\r
  60 #define portPRESCALE_REG_SETTING        ( 5 << 8 )\r
  61 #define portPIT_INTERRUPT_ENABLED       ( 0x08 )\r
  62 #define configPIT0_INTERRUPT_VECTOR     ( 55 )\r
  63 \r
  64 /*\r
  65  * FreeRTOS.org requires two interrupts - a tick interrupt generated from a\r
  66  * timer source, and a spare interrupt vector used for context switching.\r
  67  * The configuration below uses PIT0 for the former, and vector 16 for the\r
  68  * latter.  **IF YOUR APPLICATION HAS BOTH OF THESE INTERRUPTS FREE THEN YOU DO\r
  69  * NOT NEED TO CHANGE ANY OF THIS CODE** - otherwise instructions are provided\r
  70  * here for using alternative interrupt sources.\r
  71  *\r
  72  * To change the tick interrupt source:\r
  73  *\r
  74  *      1) Modify vApplicationSetupInterrupts() below to be correct for whichever\r
  75  *      peripheral is to be used to generate the tick interrupt.  The name of the\r
  76  *  handler function (currently vPIT0InterruptHandler()) should also be updated\r
  77  *  to indicate which peripheral is generating the interrupt.\r
  78  *\r
  79  *      2) Make sure the interrupt source is cleared within the interrupt handler function.\r
  80  *  Currently vPIT0InterruptHandler() clears the PIT0 interrupt.\r
  81  *\r
  82  *  3) Update the vector table within mcf5225x_vectors.s to install the tick\r
  83  *  interrupt handler in the correct vector position.\r
  84  *\r
  85  * To change the spare interrupt source:\r
  86  *\r
  87  *  1) Modify vApplicationSetupInterrupts() below to be correct for whichever\r
  88  *  interrupt vector is to be used.  Make sure you use a spare interrupt on interrupt\r
  89  *  controller 0, otherwise the register used to request context switches will also\r
  90  *  require modification.\r
  91  *\r
  92  *  2) Change the definition of configYIELD_INTERRUPT_VECTOR within FreeRTOSConfig.h\r
  93  *  to be correct for your chosen interrupt vector.\r
  94  *\r
  95  *  3) Update the vector table within mcf5225x_vectors.s to install the handler\r
  96  *  _vPortYieldISR() in the correct vector position (by default vector number 16 is\r
  97  *  used).\r
  98  */\r
  99 void vApplicationSetupInterrupts( void )\r
 100 {\r
 101 const unsigned portSHORT usCompareMatchValue = ( ( configCPU_CLOCK_HZ / portPRESCALE_VALUE ) / configTICK_RATE_HZ );\r
 102 \r
 103     /* Configure interrupt priority and level and unmask interrupt for PIT0. */\r
 104     MCF_INTC0_ICR55 = ( 1 | ( configKERNEL_INTERRUPT_PRIORITY << 3 ) );\r
 105     MCF_INTC0_IMRH &= ~( MCF_INTC_IMRH_INT_MASK55 );\r
 106 \r
 107     /* Do the same for vector 63 (interrupt controller 0.  I don't think the\r
 108     write to MCF_INTC0_IMRH is actually required here but is included for\r
 109     completeness. */\r
 110     MCF_INTC0_ICR16 = ( 0 | configKERNEL_INTERRUPT_PRIORITY << 3 );\r
 111     MCF_INTC0_IMRL &= ~( MCF_INTC_IMRL_INT_MASK16 | 0x01 );\r
 112 \r
 113     /* Configure PIT0 to generate the RTOS tick. */\r
 114     MCF_PIT0_PCSR |= MCF_PIT_PCSR_PIF;\r
 115     MCF_PIT0_PCSR = ( portPRESCALE_REG_SETTING | MCF_PIT_PCSR_PIE | MCF_PIT_PCSR_RLD | MCF_PIT_PCSR_EN );\r
 116         MCF_PIT0_PMR = usCompareMatchValue;\r
 117 }\r
 118 /*-----------------------------------------------------------*/\r
 119 \r
 120 __declspec(interrupt:0) void vPIT0InterruptHandler( void )\r
 121 {\r
 122 unsigned portLONG ulSavedInterruptMask;\r
 123 \r
 124         /* Clear the PIT0 interrupt. */\r
 125         MCF_PIT0_PCSR |= MCF_PIT_PCSR_PIF;\r
 126 \r
 127         /* Increment the RTOS tick. */\r
 128         ulSavedInterruptMask = portSET_INTERRUPT_MASK_FROM_ISR();\r
 129                 vTaskIncrementTick();\r
 130         portCLEAR_INTERRUPT_MASK_FROM_ISR( ulSavedInterruptMask );\r
 131 \r
 132         /* If we are using the pre-emptive scheduler then also request a\r
 133         context switch as incrementing the tick could have unblocked a task. */\r
 134         #if configUSE_PREEMPTION == 1\r
 135         {\r
 136                 taskYIELD();\r
 137         }\r
 138         #endif\r
 139 }\r