]> git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/msp430_IAR/ParTest/ParTest.c
Update version number in readiness for V10.3.0 release. Sync SVN with reviewed releas...
[freertos] / FreeRTOS / Demo / msp430_IAR / 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 \r
44 /* Scheduler includes. */\r
45 #include "FreeRTOS.h"\r
46 #include "task.h"\r
47 \r
48 /* Demo application includes. */\r
49 #include "partest.h"\r
50 \r
51 /* Constants required to setup the LCD. */\r
52 #define LCD_DIV_64 5\r
53 \r
54 /* Constants required to access the "LED's".  The LED segments are turned on\r
55 and off to generate '*' characters. */\r
56 #define partstNUM_LEDS                  ( ( unsigned char ) 6 )\r
57 #define partstSEGMENTS_ON               ( ( unsigned char ) 0x0f )\r
58 #define partstSEGMENTS_OFF              ( ( unsigned char ) 0x00 )\r
59 \r
60 /* The LED number of the real on board LED, rather than a simulated LED. */\r
61 #define partstON_BOARD_LED              ( ( unsigned portBASE_TYPE ) 10 )\r
62 #define mainON_BOARD_LED_BIT    ( ( unsigned char ) 0x01 )\r
63 \r
64 /* The LCD segments used to generate the '*' characters for LED's 0 to 5. */\r
65 unsigned char * const ucRHSSegments[ partstNUM_LEDS ] = {       ( unsigned char * )0xa4, \r
66                                                                                                                                 ( unsigned char * )0xa2, \r
67                                                                                                                                 ( unsigned char * )0xa0, \r
68                                                                                                                                 ( unsigned char * )0x9e,\r
69                                                                                                                                 ( unsigned char * )0x9c,\r
70                                                                                                                                 ( unsigned char * )0x9a };\r
71 \r
72 unsigned char * const ucLHSSegments[ partstNUM_LEDS ] = {       ( unsigned char * )0xa3, \r
73                                                                                                                                 ( unsigned char * )0xa1, \r
74                                                                                                                                 ( unsigned char * )0x9f, \r
75                                                                                                                                 ( unsigned char * )0x9d,\r
76                                                                                                                                 ( unsigned char * )0x9b,\r
77                                                                                                                                 ( unsigned char * )0x99 };\r
78 \r
79 /*\r
80  * Toggle the single genuine built in LED.\r
81  */\r
82 static void prvToggleOnBoardLED( void );\r
83 \r
84 /*-----------------------------------------------------------*/\r
85 \r
86 void vParTestInitialise( void )\r
87 {\r
88         /* Initialise the LCD hardware. */\r
89 \r
90         /* Used for the onboard LED. */\r
91         P1DIR = 0x01;\r
92 \r
93         // Setup Basic Timer for LCD operation\r
94         BTCTL = (LCD_DIV_64+0x23);\r
95 \r
96         // Setup port functions\r
97         P1SEL = 0x32;\r
98         P2SEL = 0x00;\r
99         P3SEL = 0x00;\r
100         P4SEL = 0xFC;\r
101         P5SEL = 0xFF;\r
102         \r
103         /* Initialise all segments to off. */\r
104         LCDM1 = partstSEGMENTS_OFF;     \r
105         LCDM2 = partstSEGMENTS_OFF;     \r
106         LCDM3 = partstSEGMENTS_OFF;     \r
107         LCDM4 = partstSEGMENTS_OFF;     \r
108         LCDM5 = partstSEGMENTS_OFF;     \r
109         LCDM6 = partstSEGMENTS_OFF;     \r
110         LCDM7 = partstSEGMENTS_OFF;     \r
111         LCDM8 = partstSEGMENTS_OFF;     \r
112         LCDM9 = partstSEGMENTS_OFF;     \r
113         LCDM10 = partstSEGMENTS_OFF;    \r
114         LCDM11 = partstSEGMENTS_OFF;    \r
115         LCDM12 = partstSEGMENTS_OFF;    \r
116         LCDM13 = partstSEGMENTS_OFF;    \r
117         LCDM14 = partstSEGMENTS_OFF;    \r
118         LCDM15 = partstSEGMENTS_OFF;    \r
119         LCDM16 = partstSEGMENTS_OFF;    \r
120         LCDM17 = partstSEGMENTS_OFF;    \r
121         LCDM18 = partstSEGMENTS_OFF;    \r
122         LCDM19 = partstSEGMENTS_OFF;    \r
123         LCDM20 = partstSEGMENTS_OFF;    \r
124 \r
125         /* Setup LCD control. */\r
126         LCDCTL = (LCDSG0_7|LCD4MUX|LCDON);\r
127 }\r
128 /*-----------------------------------------------------------*/\r
129 \r
130 void vParTestSetLED( unsigned portBASE_TYPE uxLED, signed portBASE_TYPE xValue )\r
131 {\r
132         /* Set or clear the output [in this case show or hide the '*' character. */\r
133         if( uxLED < ( portBASE_TYPE ) partstNUM_LEDS )\r
134         {\r
135                 vTaskSuspendAll();\r
136                 {\r
137                         if( xValue )\r
138                         {\r
139                                 /* Turn on the segments required to show the '*'. */\r
140                                 *( ucRHSSegments[ uxLED ] ) = partstSEGMENTS_ON;\r
141                                 *( ucLHSSegments[ uxLED ] ) = partstSEGMENTS_ON;\r
142                         }\r
143                         else\r
144                         {\r
145                                 /* Turn off all the segments. */\r
146                                 *( ucRHSSegments[ uxLED ] ) = partstSEGMENTS_OFF;\r
147                                 *( ucLHSSegments[ uxLED ] ) = partstSEGMENTS_OFF;\r
148                         }\r
149                 }\r
150                 xTaskResumeAll();\r
151         }\r
152 }\r
153 /*-----------------------------------------------------------*/\r
154 \r
155 void vParTestToggleLED( unsigned portBASE_TYPE uxLED )\r
156 {\r
157         if( uxLED < ( portBASE_TYPE ) partstNUM_LEDS )\r
158         {\r
159                 vTaskSuspendAll();\r
160                 {\r
161                         /* If the '*' is already showing - hide it.  If it is not already\r
162                         showing then show it. */\r
163                         if( *( ucRHSSegments[ uxLED ] ) )\r
164                         {\r
165                                 *( ucRHSSegments[ uxLED ] ) = partstSEGMENTS_OFF;\r
166                                 *( ucLHSSegments[ uxLED ] ) = partstSEGMENTS_OFF;\r
167                         }\r
168                         else\r
169                         {\r
170                                 *( ucRHSSegments[ uxLED ] ) = partstSEGMENTS_ON;\r
171                                 *( ucLHSSegments[ uxLED ] ) = partstSEGMENTS_ON;\r
172                         }\r
173                 }\r
174                 xTaskResumeAll();\r
175         }\r
176         else\r
177         {\r
178                 if( uxLED == partstON_BOARD_LED )\r
179                 {\r
180                         /* The request related to the genuine on board LED. */\r
181                         prvToggleOnBoardLED();\r
182                 }\r
183         }       \r
184 }\r
185 /*-----------------------------------------------------------*/\r
186 \r
187 static void prvToggleOnBoardLED( void )\r
188 {\r
189 static unsigned short sState = pdFALSE;\r
190 \r
191         /* Toggle the state of the single genuine on board LED. */\r
192         if( sState )    \r
193         {\r
194                 P1OUT |= mainON_BOARD_LED_BIT;\r
195         }\r
196         else\r
197         {\r
198                 P1OUT &= ~mainON_BOARD_LED_BIT;\r
199         }\r
200 \r
201         sState = !sState;\r
202 }\r
203 /*-----------------------------------------------------------*/\r
204 \r
205 \r