]> git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/msp430_GCC/ParTest/ParTest.c
Update version number in readiness for V10.3.0 release. Sync SVN with reviewed releas...
[freertos] / FreeRTOS / Demo / msp430_GCC / ParTest / ParTest.c
1 /*\r
2  * FreeRTOS Kernel V10.3.0\r
3  * Copyright (C) 2020 Amazon.com, Inc. or its affiliates.  All Rights Reserved.\r
4  *\r
5  * Permission is hereby granted, free of charge, to any person obtaining a copy of\r
6  * this software and associated documentation files (the "Software"), to deal in\r
7  * the Software without restriction, including without limitation the rights to\r
8  * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\r
9  * the Software, and to permit persons to whom the Software is furnished to do so,\r
10  * subject to the following conditions:\r
11  *\r
12  * The above copyright notice and this permission notice shall be included in all\r
13  * copies or substantial portions of the Software.\r
14  *\r
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r
16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\r
17  * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\r
18  * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\r
19  * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\r
20  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\r
21  *\r
22  * http://www.FreeRTOS.org\r
23  * http://aws.amazon.com/freertos\r
24  *\r
25  * 1 tab == 4 spaces!\r
26  */\r
27 \r
28 /*-----------------------------------------------------------\r
29  * Characters on the LCD are used to simulate LED's.  In this case the 'ParTest'\r
30  * is really operating on the LCD display.\r
31  *-----------------------------------------------------------*/\r
32 \r
33 /*\r
34  * This demo is configured to execute on the ES449 prototyping board from\r
35  * SoftBaugh. The ES449 has a built in LCD display and a single built in user\r
36  * LED.  Therefore, in place of flashing an LED, the 'flash' and 'check' tasks\r
37  * toggle '*' characters on the LCD.  The left most '*' represents LED 0, the\r
38  * next LED 1, etc.\r
39  *\r
40  * There is a single genuine on board LED referenced as LED 10.\r
41  */\r
42 \r
43 /* Standard includes. */\r
44 #include <signal.h>\r
45 \r
46 /* Scheduler includes. */\r
47 #include "FreeRTOS.h"\r
48 #include "task.h"\r
49 \r
50 /* Demo application includes. */\r
51 #include "partest.h"\r
52 \r
53 /* Constants required to setup the LCD. */\r
54 #define LCD_DIV_64 5\r
55 \r
56 /* Constants required to access the "LED's".  The LED segments are turned on\r
57 and off to generate '*' characters. */\r
58 #define partstNUM_LEDS                  ( ( unsigned char ) 6 )\r
59 #define partstSEGMENTS_ON               ( ( unsigned char ) 0x0f )\r
60 #define partstSEGMENTS_OFF              ( ( unsigned char ) 0x00 )\r
61 \r
62 /* The LED number of the real on board LED, rather than a simulated LED. */\r
63 #define partstON_BOARD_LED              ( ( unsigned portBASE_TYPE ) 10 )\r
64 #define mainON_BOARD_LED_BIT    ( ( unsigned char ) 0x01 )\r
65 \r
66 /* The LCD segments used to generate the '*' characters for LED's 0 to 5. */\r
67 unsigned char * const ucRHSSegments[ partstNUM_LEDS ] = {       ( unsigned char * )0xa4, \r
68                                                                                                                                 ( unsigned char * )0xa2, \r
69                                                                                                                                 ( unsigned char * )0xa0, \r
70                                                                                                                                 ( unsigned char * )0x9e,\r
71                                                                                                                                 ( unsigned char * )0x9c,\r
72                                                                                                                                 ( unsigned char * )0x9a };\r
73 \r
74 unsigned char * const ucLHSSegments[ partstNUM_LEDS ] = {       ( unsigned char * )0xa3, \r
75                                                                                                                                 ( unsigned char * )0xa1, \r
76                                                                                                                                 ( unsigned char * )0x9f, \r
77                                                                                                                                 ( unsigned char * )0x9d,\r
78                                                                                                                                 ( unsigned char * )0x9b,\r
79                                                                                                                                 ( unsigned char * )0x99 };\r
80 \r
81 /*\r
82  * Toggle the single genuine built in LED.\r
83  */\r
84 static void prvToggleOnBoardLED( void );\r
85 \r
86 /*-----------------------------------------------------------*/\r
87 \r
88 void vParTestInitialise( void )\r
89 {\r
90         /* Initialise the LCD hardware. */\r
91 \r
92         /* Used for the onboard LED. */\r
93         P1DIR = 0x01;\r
94 \r
95         // Setup Basic Timer for LCD operation\r
96         BTCTL = (LCD_DIV_64+0x23);\r
97 \r
98         // Setup port functions\r
99         P1SEL = 0x32;\r
100         P2SEL = 0x00;\r
101         P3SEL = 0x00;\r
102         P4SEL = 0xFC;\r
103         P5SEL = 0xFF;\r
104         \r
105         /* Initialise all segments to off. */\r
106         LCDM1 = partstSEGMENTS_OFF;     \r
107         LCDM2 = partstSEGMENTS_OFF;     \r
108         LCDM3 = partstSEGMENTS_OFF;     \r
109         LCDM4 = partstSEGMENTS_OFF;     \r
110         LCDM5 = partstSEGMENTS_OFF;     \r
111         LCDM6 = partstSEGMENTS_OFF;     \r
112         LCDM7 = partstSEGMENTS_OFF;     \r
113         LCDM8 = partstSEGMENTS_OFF;     \r
114         LCDM9 = partstSEGMENTS_OFF;     \r
115         LCDM10 = partstSEGMENTS_OFF;    \r
116         LCDM11 = partstSEGMENTS_OFF;    \r
117         LCDM12 = partstSEGMENTS_OFF;    \r
118         LCDM13 = partstSEGMENTS_OFF;    \r
119         LCDM14 = partstSEGMENTS_OFF;    \r
120         LCDM15 = partstSEGMENTS_OFF;    \r
121         LCDM16 = partstSEGMENTS_OFF;    \r
122         LCDM17 = partstSEGMENTS_OFF;    \r
123         LCDM18 = partstSEGMENTS_OFF;    \r
124         LCDM19 = partstSEGMENTS_OFF;    \r
125         LCDM20 = partstSEGMENTS_OFF;    \r
126 \r
127         /* Setup LCD control. */\r
128         LCDCTL = (LCDSG0_7|LCD4MUX|LCDON);\r
129 }\r
130 /*-----------------------------------------------------------*/\r
131 \r
132 void vParTestSetLED( unsigned portBASE_TYPE uxLED, signed portBASE_TYPE xValue )\r
133 {\r
134         /* Set or clear the output [in this case show or hide the '*' character. */\r
135         if( uxLED < ( portBASE_TYPE ) partstNUM_LEDS )\r
136         {\r
137                 vTaskSuspendAll();\r
138                 {\r
139                         if( xValue )\r
140                         {\r
141                                 /* Turn on the segments required to show the '*'. */\r
142                                 *( ucRHSSegments[ uxLED ] ) = partstSEGMENTS_ON;\r
143                                 *( ucLHSSegments[ uxLED ] ) = partstSEGMENTS_ON;\r
144                         }\r
145                         else\r
146                         {\r
147                                 /* Turn off all the segments. */\r
148                                 *( ucRHSSegments[ uxLED ] ) = partstSEGMENTS_OFF;\r
149                                 *( ucLHSSegments[ uxLED ] ) = partstSEGMENTS_OFF;\r
150                         }\r
151                 }\r
152                 xTaskResumeAll();\r
153         }\r
154 }\r
155 /*-----------------------------------------------------------*/\r
156 \r
157 void vParTestToggleLED( unsigned portBASE_TYPE uxLED )\r
158 {\r
159         if( uxLED < ( portBASE_TYPE ) partstNUM_LEDS )\r
160         {\r
161                 vTaskSuspendAll();\r
162                 {\r
163                         /* If the '*' is already showing - hide it.  If it is not already\r
164                         showing then show it. */\r
165                         if( *( ucRHSSegments[ uxLED ] ) )\r
166                         {\r
167                                 *( ucRHSSegments[ uxLED ] ) = partstSEGMENTS_OFF;\r
168                                 *( ucLHSSegments[ uxLED ] ) = partstSEGMENTS_OFF;\r
169                         }\r
170                         else\r
171                         {\r
172                                 *( ucRHSSegments[ uxLED ] ) = partstSEGMENTS_ON;\r
173                                 *( ucLHSSegments[ uxLED ] ) = partstSEGMENTS_ON;\r
174                         }\r
175                 }\r
176                 xTaskResumeAll();\r
177         }\r
178         else\r
179         {\r
180                 if( uxLED == partstON_BOARD_LED )\r
181                 {\r
182                         /* The request related to the genuine on board LED. */\r
183                         prvToggleOnBoardLED();\r
184                 }\r
185         }       \r
186 }\r
187 /*-----------------------------------------------------------*/\r
188 \r
189 static void prvToggleOnBoardLED( void )\r
190 {\r
191 static unsigned short sState = pdFALSE;\r
192 \r
193         /* Toggle the state of the single genuine on board LED. */\r
194         if( sState )    \r
195         {\r
196                 P1OUT |= mainON_BOARD_LED_BIT;\r
197         }\r
198         else\r
199         {\r
200                 P1OUT &= ~mainON_BOARD_LED_BIT;\r
201         }\r
202 \r
203         sState = !sState;\r
204 }\r
205 /*-----------------------------------------------------------*/\r
206 \r
207 \r