]> git.sur5r.net Git - freertos/blob - Demo/msp430_CrossWorks/ParTest/ParTest.c
Prepare for V5.3.0 release.
[freertos] / Demo / msp430_CrossWorks / ParTest / ParTest.c
1 /*\r
2         FreeRTOS.org V5.3.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         **NOTE** The exception to the GPL is included to allow you to distribute a\r
10         combined work that includes FreeRTOS.org without being obliged to provide\r
11         the source code for any proprietary components.  Alternative commercial\r
12         license and support terms are also available upon request.  See the \r
13         licensing section of http://www.FreeRTOS.org for full details.\r
14 \r
15         FreeRTOS.org is distributed in the hope that it will be useful, but WITHOUT\r
16         ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or\r
17         FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for\r
18         more details.\r
19 \r
20         You should have received a copy of the GNU General Public License along\r
21         with FreeRTOS.org; if not, write to the Free Software Foundation, Inc., 59\r
22         Temple Place, Suite 330, Boston, MA  02111-1307  USA.\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  * Characters on the LCD are used to simulate LED's.  In this case the 'ParTest'\r
54  * is really operating on the LCD display.\r
55  *-----------------------------------------------------------*/\r
56 \r
57 /*\r
58  * This demo is configured to execute on the ES449 prototyping board from\r
59  * SoftBaugh. The ES449 has a built in LCD display and a single built in user\r
60  * LED.  Therefore, in place of flashing an LED, the 'flash' and 'check' tasks\r
61  * toggle '*' characters on the LCD.  The left most '*' represents LED 0, the\r
62  * next LED 1, etc.\r
63  *\r
64  * There is a single genuine on board LED referenced as LED 10.\r
65  */\r
66 \r
67 \r
68 /* Scheduler includes. */\r
69 #include "FreeRTOS.h"\r
70 #include "task.h"\r
71 \r
72 /* Demo application includes. */\r
73 #include "partest.h"\r
74 \r
75 /* Constants required to setup the LCD. */\r
76 #define LCD_DIV_64 5\r
77 \r
78 /* Constants required to access the "LED's".  The LED segments are turned on\r
79 and off to generate '*' characters. */\r
80 #define partstNUM_LEDS                  ( ( unsigned portCHAR ) 6 )\r
81 #define partstSEGMENTS_ON               ( ( unsigned portCHAR ) 0x0f )\r
82 #define partstSEGMENTS_OFF              ( ( unsigned portCHAR ) 0x00 )\r
83 \r
84 /* The LED number of the real on board LED, rather than a simulated LED. */\r
85 #define partstON_BOARD_LED              ( ( unsigned portBASE_TYPE ) 10 )\r
86 #define mainON_BOARD_LED_BIT    ( ( unsigned portCHAR ) 0x01 )\r
87 \r
88 /* The LCD segments used to generate the '*' characters for LED's 0 to 5. */\r
89 unsigned portCHAR * const ucRHSSegments[ partstNUM_LEDS ] = {   ( unsigned portCHAR * )0xa4, \r
90                                                                                                                                 ( unsigned portCHAR * )0xa2, \r
91                                                                                                                                 ( unsigned portCHAR * )0xa0, \r
92                                                                                                                                 ( unsigned portCHAR * )0x9e,\r
93                                                                                                                                 ( unsigned portCHAR * )0x9c,\r
94                                                                                                                                 ( unsigned portCHAR * )0x9a };\r
95 \r
96 unsigned portCHAR * const ucLHSSegments[ partstNUM_LEDS ] = {   ( unsigned portCHAR * )0xa3, \r
97                                                                                                                                 ( unsigned portCHAR * )0xa1, \r
98                                                                                                                                 ( unsigned portCHAR * )0x9f, \r
99                                                                                                                                 ( unsigned portCHAR * )0x9d,\r
100                                                                                                                                 ( unsigned portCHAR * )0x9b,\r
101                                                                                                                                 ( unsigned portCHAR * )0x99 };\r
102 \r
103 /*\r
104  * Toggle the single genuine built in LED.\r
105  */\r
106 static void prvToggleOnBoardLED( void );\r
107 \r
108 /*-----------------------------------------------------------*/\r
109 \r
110 void vParTestInitialise( void )\r
111 {\r
112         /* Initialise the LCD hardware. */\r
113 \r
114         /* Used for the onboard LED. */\r
115         P1DIR = 0x01;\r
116 \r
117         // Setup Basic Timer for LCD operation\r
118         BTCTL = (LCD_DIV_64+0x23);\r
119 \r
120         // Setup port functions\r
121         P1SEL = 0x32;\r
122         P2SEL = 0x00;\r
123         P3SEL = 0x00;\r
124         P4SEL = 0xFC;\r
125         P5SEL = 0xFF;\r
126         \r
127         /* Initialise all segments to off. */\r
128         LCDM1 = partstSEGMENTS_OFF;     \r
129         LCDM2 = partstSEGMENTS_OFF;     \r
130         LCDM3 = partstSEGMENTS_OFF;     \r
131         LCDM4 = partstSEGMENTS_OFF;     \r
132         LCDM5 = partstSEGMENTS_OFF;     \r
133         LCDM6 = partstSEGMENTS_OFF;     \r
134         LCDM7 = partstSEGMENTS_OFF;     \r
135         LCDM8 = partstSEGMENTS_OFF;     \r
136         LCDM9 = partstSEGMENTS_OFF;     \r
137         LCDM10 = partstSEGMENTS_OFF;    \r
138         LCDM11 = partstSEGMENTS_OFF;    \r
139         LCDM12 = partstSEGMENTS_OFF;    \r
140         LCDM13 = partstSEGMENTS_OFF;    \r
141         LCDM14 = partstSEGMENTS_OFF;    \r
142         LCDM15 = partstSEGMENTS_OFF;    \r
143         LCDM16 = partstSEGMENTS_OFF;    \r
144         LCDM17 = partstSEGMENTS_OFF;    \r
145         LCDM18 = partstSEGMENTS_OFF;    \r
146         LCDM19 = partstSEGMENTS_OFF;    \r
147         LCDM20 = partstSEGMENTS_OFF;    \r
148 \r
149         /* Setup LCD control. */\r
150         LCDCTL = (LCDSG0_7|LCD4MUX|LCDON);\r
151 }\r
152 /*-----------------------------------------------------------*/\r
153 \r
154 void vParTestSetLED( unsigned portBASE_TYPE uxLED, signed portBASE_TYPE xValue )\r
155 {\r
156         /* Set or clear the output [in this case show or hide the '*' character. */\r
157         if( uxLED < ( portBASE_TYPE ) partstNUM_LEDS )\r
158         {\r
159                 vTaskSuspendAll();\r
160                 {\r
161                         if( xValue )\r
162                         {\r
163                                 /* Turn on the segments required to show the '*'. */\r
164                                 *( ucRHSSegments[ uxLED ] ) = partstSEGMENTS_ON;\r
165                                 *( ucLHSSegments[ uxLED ] ) = partstSEGMENTS_ON;\r
166                         }\r
167                         else\r
168                         {\r
169                                 /* Turn off all the segments. */\r
170                                 *( ucRHSSegments[ uxLED ] ) = partstSEGMENTS_OFF;\r
171                                 *( ucLHSSegments[ uxLED ] ) = partstSEGMENTS_OFF;\r
172                         }\r
173                 }\r
174                 xTaskResumeAll();\r
175         }\r
176 }\r
177 /*-----------------------------------------------------------*/\r
178 \r
179 void vParTestToggleLED( unsigned portBASE_TYPE uxLED )\r
180 {\r
181         if( uxLED < ( portBASE_TYPE ) partstNUM_LEDS )\r
182         {\r
183                 vTaskSuspendAll();\r
184                 {\r
185                         /* If the '*' is already showing - hide it.  If it is not already\r
186                         showing then show it. */\r
187                         if( *( ucRHSSegments[ uxLED ] ) )\r
188                         {\r
189                                 *( ucRHSSegments[ uxLED ] ) = partstSEGMENTS_OFF;\r
190                                 *( ucLHSSegments[ uxLED ] ) = partstSEGMENTS_OFF;\r
191                         }\r
192                         else\r
193                         {\r
194                                 *( ucRHSSegments[ uxLED ] ) = partstSEGMENTS_ON;\r
195                                 *( ucLHSSegments[ uxLED ] ) = partstSEGMENTS_ON;\r
196                         }\r
197                 }\r
198                 xTaskResumeAll();\r
199         }\r
200         else\r
201         {\r
202                 if( uxLED == partstON_BOARD_LED )\r
203                 {\r
204                         /* The request related to the genuine on board LED. */\r
205                         prvToggleOnBoardLED();\r
206                 }\r
207         }       \r
208 }\r
209 /*-----------------------------------------------------------*/\r
210 \r
211 static void prvToggleOnBoardLED( void )\r
212 {\r
213 static unsigned portSHORT sState = pdFALSE;\r
214 \r
215         /* Toggle the state of the single genuine on board LED. */\r
216         if( sState )    \r
217         {\r
218                 P1OUT |= mainON_BOARD_LED_BIT;\r
219         }\r
220         else\r
221         {\r
222                 P1OUT &= ~mainON_BOARD_LED_BIT;\r
223         }\r
224 \r
225         sState = !sState;\r
226 }\r
227 /*-----------------------------------------------------------*/\r
228 \r
229 \r