git.sur5r.net Git - freertos/blob - Demo/PIC18_MPLAB/main2.c

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