git.sur5r.net Git - freertos/blob - Demo/PIC18_MPLAB/main2.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 /*\r
  53  * Instead of the normal single demo application, the PIC18F demo is split \r
  54  * into several smaller programs of which this is the second.  This enables the \r
  55  * demo's to be executed on the RAM limited 40 pin devices.  The 64 and 80 pin \r
  56  * devices require a more costly development platform and are not so readily \r
  57  * available.\r
  58  *\r
  59  * The RTOSDemo2 project is configured for a PIC18F452 device.  Main2.c starts  \r
  60  * 5 tasks (including the idle task).\r
  61  * \r
  62  * The first, second and third tasks do nothing but flash an LED.  This gives\r
  63  * visual feedback that everything is executing as expected.  One task flashes\r
  64  * an LED every 333ms (i.e. on and off every 333/2 ms), then next every 666ms\r
  65  * and the last every 999ms.\r
  66  *\r
  67  * The last task runs at the idle priority.  It repeatedly performs a 32bit \r
  68  * calculation and checks it's result against the expected value.  This checks \r
  69  * that the temporary storage utilised by the compiler to hold intermediate \r
  70  * results does not get corrupted when the task gets switched in and out.\r
  71  * should the calculation ever provide an incorrect result the final LED is\r
  72  * turned on.\r
  73  *\r
  74  * On entry to main() an 'X' is transmitted.  Monitoring the serial port using a\r
  75  * dumb terminal allows for verification that the device is not continuously \r
  76  * being reset (no more than one 'X' should be transmitted).\r
  77  *\r
  78  * http://www.FreeRTOS.org contains important information on the use of the \r
  79  * PIC18F port.\r
  80  */\r
  81 \r
  82 /*\r
  83 Changes from V2.0.0\r
  84 \r
  85         + Delay periods are now specified using variables and constants of\r
  86           portTickType rather than unsigned portLONG.\r
  87 */\r
  88 \r
  89 /* Scheduler include files. */\r
  90 #include "FreeRTOS.h"\r
  91 #include "task.h"\r
  92 \r
  93 /* Demo app include files. */\r
  94 #include "flash.h"\r
  95 #include "partest.h"\r
  96 #include "serial.h"\r
  97 \r
  98 /* Priority definitions for the LED tasks.  Other tasks just use the idle\r
  99 priority. */\r
 100 #define mainLED_FLASH_PRIORITY                  ( tskIDLE_PRIORITY + ( unsigned portBASE_TYPE ) 1 )\r
 101 \r
 102 /* The LED that is lit when should the calculation fail. */\r
 103 #define mainCHECK_TASK_LED                              ( ( unsigned portBASE_TYPE ) 3 )\r
 104 \r
 105 /* Constants required for the communications.  Only one character is ever \r
 106 transmitted. */\r
 107 #define mainCOMMS_QUEUE_LENGTH                  ( ( unsigned portBASE_TYPE ) 5 )\r
 108 #define mainNO_BLOCK                                    ( ( portTickType ) 0 )\r
 109 #define mainBAUD_RATE                                   ( ( unsigned portLONG ) 9600 )\r
 110 \r
 111 /*\r
 112  * The task that performs the 32 bit calculation at the idle priority.\r
 113  */\r
 114 static void vCalculationTask( void *pvParameters );\r
 115 \r
 116 /*-----------------------------------------------------------*/\r
 117 \r
 118 /* Creates the tasks, then starts the scheduler. */\r
 119 void main( void )\r
 120 {\r
 121         /* Initialise the required hardware. */\r
 122         vParTestInitialise();\r
 123         vPortInitialiseBlocks();\r
 124 \r
 125         /* Send a character so we have some visible feedback of a reset. */\r
 126         xSerialPortInitMinimal( mainBAUD_RATE, mainCOMMS_QUEUE_LENGTH );\r
 127         xSerialPutChar( NULL, 'X', mainNO_BLOCK );\r
 128 \r
 129         /* Start the standard LED flash tasks as defined in demo/common/minimal. */\r
 130         vStartLEDFlashTasks( mainLED_FLASH_PRIORITY );\r
 131 \r
 132         /* Start the check task defined in this file. */\r
 133         xTaskCreate( vCalculationTask, ( const portCHAR * const ) "Check", configMINIMAL_STACK_SIZE, NULL, tskIDLE_PRIORITY, NULL );\r
 134 \r
 135         /* Start the scheduler. */\r
 136         vTaskStartScheduler();\r
 137 }\r
 138 /*-----------------------------------------------------------*/\r
 139 \r
 140 static void vCalculationTask( void *pvParameters )\r
 141 {\r
 142 volatile unsigned long ulCalculatedValue; /* Volatile to ensure optimisation is minimal. */\r
 143 \r
 144         /* Continuously perform a calculation.  If the calculation result is ever\r
 145         incorrect turn the LED on. */\r
 146         for( ;; )\r
 147         {\r
 148                 /* A good optimising compiler would just remove all this! */\r
 149                 ulCalculatedValue = 1234UL;\r
 150                 ulCalculatedValue *= 99UL;\r
 151 \r
 152                 if( ulCalculatedValue != 122166UL )\r
 153                 {\r
 154                         vParTestSetLED( mainCHECK_TASK_LED, pdTRUE );\r
 155                 }\r
 156 \r
 157                 ulCalculatedValue *= 9876UL;\r
 158 \r
 159                 if( ulCalculatedValue != 1206511416UL )\r
 160                 {\r
 161                         vParTestSetLED( mainCHECK_TASK_LED, pdTRUE );\r
 162                 }\r
 163 \r
 164                 ulCalculatedValue /= 15UL;\r
 165 \r
 166                 if( ulCalculatedValue != 80434094UL )\r
 167                 {\r
 168                         vParTestSetLED( mainCHECK_TASK_LED, pdTRUE );\r
 169                 }\r
 170 \r
 171                 ulCalculatedValue += 918273UL;\r
 172 \r
 173                 if( ulCalculatedValue != 81352367UL )\r
 174                 {\r
 175                         vParTestSetLED( mainCHECK_TASK_LED, pdTRUE );\r
 176                 }\r
 177         }\r
 178 }\r
 179 /*-----------------------------------------------------------*/\r
 180 \r