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

   1 /*\r
   2         FreeRTOS.org V5.2.0 - 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 it \r
   7         under the terms of the GNU General Public License (version 2) as published\r
   8         by the Free Software Foundation and modified by the FreeRTOS exception.\r
   9 \r
  10         FreeRTOS.org is distributed in the hope that it will be useful, but WITHOUT\r
  11         ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or \r
  12         FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for \r
  13         more details.\r
  14 \r
  15         You should have received a copy of the GNU General Public License along \r
  16         with FreeRTOS.org; if not, write to the Free Software Foundation, Inc., 59 \r
  17         Temple Place, Suite 330, Boston, MA  02111-1307  USA.\r
  18 \r
  19         A special exception to the GPL is included to allow you to distribute a \r
  20         combined work that includes FreeRTOS.org without being obliged to provide\r
  21         the source code for any proprietary components.  See the licensing section\r
  22         of http://www.FreeRTOS.org for full details.\r
  23 \r
  24 \r
  25         ***************************************************************************\r
  26         *                                                                         *\r
  27         * Get the FreeRTOS eBook!  See http://www.FreeRTOS.org/Documentation      *\r
  28         *                                                                         *\r
  29         * This is a concise, step by step, 'hands on' guide that describes both   *\r
  30         * general multitasking concepts and FreeRTOS specifics. It presents and   *\r
  31         * explains numerous examples that are written using the FreeRTOS API.     *\r
  32         * Full source code for all the examples is provided in an accompanying    *\r
  33         * .zip file.                                                              *\r
  34         *                                                                         *\r
  35         ***************************************************************************\r
  36 \r
  37         1 tab == 4 spaces!\r
  38 \r
  39         Please ensure to read the configuration and relevant port sections of the\r
  40         online documentation.\r
  41 \r
  42         http://www.FreeRTOS.org - Documentation, latest information, license and\r
  43         contact details.\r
  44 \r
  45         http://www.SafeRTOS.com - A version that is certified for use in safety\r
  46         critical systems.\r
  47 \r
  48         http://www.OpenRTOS.com - Commercial support, development, porting,\r
  49         licensing and training services.\r
  50 */\r
  51 \r
  52 #include "FreeRTOS.h"\r
  53 #include "task.h"\r
  54 \r
  55 /* Constants used to configure the interrupts. */\r
  56 #define portPRESCALE_VALUE                      64\r
  57 #define portPRESCALE_REG_SETTING        ( 5 << 8 )\r
  58 #define portPIT_INTERRUPT_ENABLED       ( 0x08 )\r
  59 #define configPIT0_INTERRUPT_VECTOR     ( 55 )\r
  60 \r
  61 /*\r
  62  * FreeRTOS.org requires two interrupts - a tick interrupt generated from a\r
  63  * timer source, and a spare interrupt vector used for context switching.\r
  64  * The configuration below uses PIT0 for the former, and vector 16 for the\r
  65  * latter.  **IF YOUR APPLICATION HAS BOTH OF THESE INTERRUPTS FREE THEN YOU DO\r
  66  * NOT NEED TO CHANGE ANY OF THIS CODE** - otherwise instructions are provided\r
  67  * here for using alternative interrupt sources.\r
  68  *\r
  69  * To change the tick interrupt source:\r
  70  *\r
  71  *      1) Modify vApplicationSetupInterrupts() below to be correct for whichever\r
  72  *      peripheral is to be used to generate the tick interrupt.\r
  73  *\r
  74  *      2) Change the name of the function __cs3_isr_interrupt_119() defined within\r
  75  *      this file to be correct for the interrupt vector used by the timer peripheral.\r
  76  *      The name of the function should contain the vector number, so by default vector\r
  77  *      number 119 is being used.\r
  78  *\r
  79  *      3) Make sure the tick interrupt is cleared within the interrupt handler function.\r
  80  *  Currently __cs3_isr_interrupt_119() clears the PIT0 interrupt.\r
  81  *\r
  82  * To change the spare interrupt source:\r
  83  *\r
  84  *  1) Modify vApplicationSetupInterrupts() below to be correct for whichever\r
  85  *  interrupt vector is to be used.  Make sure you use a spare interrupt on interrupt\r
  86  *  controller 0, otherwise the register used to request context switches will also\r
  87  *  require modification.  By default vector 16 is used which is free on most MCF52xxx\r
  88  *  devices.\r
  89  *\r
  90  *  2) Change the definition of configYIELD_INTERRUPT_VECTOR within FreeRTOSConfig.h\r
  91  *  to be correct for your chosen interrupt vector.\r
  92  *\r
  93  *  3) Change the name of the function __cs3_isr_interrupt_80() within portasm.S\r
  94  *  to be correct for whichever vector number is being used.  By default interrupt\r
  95  *  controller 0 vector number 16 is used, which corresponds to vector number 80.\r
  96  */\r
  97 void vApplicationSetupInterrupts( void )\r
  98 {\r
  99 const unsigned portSHORT usCompareMatchValue = ( ( configCPU_CLOCK_HZ / portPRESCALE_VALUE ) / configTICK_RATE_HZ );\r
 100 \r
 101     /* Configure interrupt priority and level and unmask interrupt for PIT0. */\r
 102     MCF_INTC0_ICR55 = ( 1 | ( configKERNEL_INTERRUPT_PRIORITY << 3 ) );\r
 103     MCF_INTC0_IMRH &= ~( MCF_INTC_IMRH_INT_MASK55 );\r
 104 \r
 105     /* Do the same for vector 16 (interrupt controller 0).  I don't think the\r
 106     write to MCF_INTC0_IMRH is actually required here but is included for\r
 107     completeness. */\r
 108     MCF_INTC0_ICR16 = ( 0 | ( configKERNEL_INTERRUPT_PRIORITY << 3 ) );\r
 109     MCF_INTC0_IMRH &= ~( MCF_INTC_IPRL_INT16 );\r
 110 \r
 111     /* Configure PIT0 to generate the RTOS tick. */\r
 112     MCF_PIT0_PCSR |= MCF_PIT_PCSR_PIF;\r
 113     MCF_PIT0_PCSR = ( portPRESCALE_REG_SETTING | MCF_PIT_PCSR_PIE | MCF_PIT_PCSR_RLD | MCF_PIT_PCSR_EN );\r
 114         MCF_PIT0_PMR = usCompareMatchValue;\r
 115 }\r
 116 /*-----------------------------------------------------------*/\r
 117 \r
 118 void __attribute__ ((interrupt)) __cs3_isr_interrupt_119( void )\r
 119 {\r
 120 unsigned portLONG ulSavedInterruptMask;\r
 121 \r
 122         /* Clear the PIT0 interrupt. */\r
 123         MCF_PIT0_PCSR |= MCF_PIT_PCSR_PIF;\r
 124 \r
 125         /* Increment the RTOS tick. */\r
 126         ulSavedInterruptMask = portSET_INTERRUPT_MASK_FROM_ISR();\r
 127                 vTaskIncrementTick();\r
 128         portCLEAR_INTERRUPT_MASK_FROM_ISR( ulSavedInterruptMask );\r
 129 \r
 130         /* If we are using the pre-emptive scheduler then also request a\r
 131         context switch as incrementing the tick could have unblocked a task. */\r
 132         #if configUSE_PREEMPTION == 1\r
 133         {\r
 134                 taskYIELD();\r
 135         }\r
 136         #endif\r
 137 }\r