2 FreeRTOS.org V5.0.0 - Copyright (C) 2003-2008 Richard Barry.
\r
4 This file is part of the FreeRTOS.org distribution.
\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
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
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
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
26 ***************************************************************************
\r
27 ***************************************************************************
\r
29 * SAVE TIME AND MONEY! We can port FreeRTOS.org to your own hardware, *
\r
30 * and even write all or part of your application on your behalf. *
\r
31 * See http://www.OpenRTOS.com for details of the services we provide to *
\r
32 * expedite your project. *
\r
34 ***************************************************************************
\r
35 ***************************************************************************
\r
37 Please ensure to read the configuration and relevant port sections of the
\r
38 online documentation.
\r
40 http://www.FreeRTOS.org - Documentation, latest information, license and
\r
43 http://www.SafeRTOS.com - A version that is certified for use in safety
\r
46 http://www.OpenRTOS.com - Commercial support, development, porting,
\r
47 licensing and training services.
\r
51 * This version of PollQ. c is for use on systems that have limited stack
\r
52 * space and no display facilities. The complete version can be found in
\r
53 * the Demo/Common/Full directory.
\r
55 * Creates two tasks that communicate over a single queue. One task acts as a
\r
56 * producer, the other a consumer.
\r
58 * The producer loops for three iteration, posting an incrementing number onto the
\r
59 * queue each cycle. It then delays for a fixed period before doing exactly the
\r
62 * The consumer loops emptying the queue. Each item removed from the queue is
\r
63 * checked to ensure it contains the expected value. When the queue is empty it
\r
64 * blocks for a fixed period, then does the same again.
\r
66 * All queue access is performed without blocking. The consumer completely empties
\r
67 * the queue each time it runs so the producer should never find the queue full.
\r
69 * An error is flagged if the consumer obtains an unexpected value or the producer
\r
70 * find the queue is full.
\r
76 + Delay periods are now specified using variables and constants of
\r
77 portTickType rather than unsigned portLONG.
\r
82 /* Scheduler include files. */
\r
83 #include "FreeRTOS.h"
\r
87 /* Demo program include files. */
\r
90 #define pollqSTACK_SIZE configMINIMAL_STACK_SIZE
\r
91 #define pollqQUEUE_SIZE ( 10 )
\r
92 #define pollqPRODUCER_DELAY ( ( portTickType ) 200 / portTICK_RATE_MS )
\r
93 #define pollqCONSUMER_DELAY ( pollqPRODUCER_DELAY - ( portTickType ) ( 20 / portTICK_RATE_MS ) )
\r
94 #define pollqNO_DELAY ( ( portTickType ) 0 )
\r
95 #define pollqVALUES_TO_PRODUCE ( ( signed portBASE_TYPE ) 3 )
\r
96 #define pollqINITIAL_VALUE ( ( signed portBASE_TYPE ) 0 )
\r
98 /* The task that posts the incrementing number onto the queue. */
\r
99 static portTASK_FUNCTION_PROTO( vPolledQueueProducer, pvParameters );
\r
101 /* The task that empties the queue. */
\r
102 static portTASK_FUNCTION_PROTO( vPolledQueueConsumer, pvParameters );
\r
104 /* Variables that are used to check that the tasks are still running with no
\r
106 static volatile signed portBASE_TYPE xPollingConsumerCount = pollqINITIAL_VALUE, xPollingProducerCount = pollqINITIAL_VALUE;
\r
108 /*-----------------------------------------------------------*/
\r
110 void vStartPolledQueueTasks( unsigned portBASE_TYPE uxPriority )
\r
112 static xQueueHandle xPolledQueue;
\r
114 /* Create the queue used by the producer and consumer. */
\r
115 xPolledQueue = xQueueCreate( pollqQUEUE_SIZE, ( unsigned portBASE_TYPE ) sizeof( unsigned portSHORT ) );
\r
117 /* Spawn the producer and consumer. */
\r
118 xTaskCreate( vPolledQueueConsumer, ( signed portCHAR * ) "QConsNB", pollqSTACK_SIZE, ( void * ) &xPolledQueue, uxPriority, ( xTaskHandle * ) NULL );
\r
119 xTaskCreate( vPolledQueueProducer, ( signed portCHAR * ) "QProdNB", pollqSTACK_SIZE, ( void * ) &xPolledQueue, uxPriority, ( xTaskHandle * ) NULL );
\r
121 /*-----------------------------------------------------------*/
\r
123 static portTASK_FUNCTION( vPolledQueueProducer, pvParameters )
\r
125 unsigned portSHORT usValue = ( unsigned portSHORT ) 0;
\r
126 signed portBASE_TYPE xError = pdFALSE, xLoop;
\r
130 for( xLoop = 0; xLoop < pollqVALUES_TO_PRODUCE; xLoop++ )
\r
132 /* Send an incrementing number on the queue without blocking. */
\r
133 if( xQueueSend( *( ( xQueueHandle * ) pvParameters ), ( void * ) &usValue, pollqNO_DELAY ) != pdPASS )
\r
135 /* We should never find the queue full so if we get here there
\r
136 has been an error. */
\r
141 if( xError == pdFALSE )
\r
143 /* If an error has ever been recorded we stop incrementing the
\r
145 portENTER_CRITICAL();
\r
146 xPollingProducerCount++;
\r
147 portEXIT_CRITICAL();
\r
150 /* Update the value we are going to post next time around. */
\r
155 /* Wait before we start posting again to ensure the consumer runs and
\r
156 empties the queue. */
\r
157 vTaskDelay( pollqPRODUCER_DELAY );
\r
159 } /*lint !e818 Function prototype must conform to API. */
\r
160 /*-----------------------------------------------------------*/
\r
162 static portTASK_FUNCTION( vPolledQueueConsumer, pvParameters )
\r
164 unsigned portSHORT usData, usExpectedValue = ( unsigned portSHORT ) 0;
\r
165 signed portBASE_TYPE xError = pdFALSE;
\r
169 /* Loop until the queue is empty. */
\r
170 while( uxQueueMessagesWaiting( *( ( xQueueHandle * ) pvParameters ) ) )
\r
172 if( xQueueReceive( *( ( xQueueHandle * ) pvParameters ), &usData, pollqNO_DELAY ) == pdPASS )
\r
174 if( usData != usExpectedValue )
\r
176 /* This is not what we expected to receive so an error has
\r
180 /* Catch-up to the value we received so our next expected
\r
181 value should again be correct. */
\r
182 usExpectedValue = usData;
\r
186 if( xError == pdFALSE )
\r
188 /* Only increment the check variable if no errors have
\r
190 portENTER_CRITICAL();
\r
191 xPollingConsumerCount++;
\r
192 portEXIT_CRITICAL();
\r
196 /* Next time round we would expect the number to be one higher. */
\r
201 /* Now the queue is empty we block, allowing the producer to place more
\r
202 items in the queue. */
\r
203 vTaskDelay( pollqCONSUMER_DELAY );
\r
205 } /*lint !e818 Function prototype must conform to API. */
\r
206 /*-----------------------------------------------------------*/
\r
208 /* This is called to check that all the created tasks are still running with no errors. */
\r
209 portBASE_TYPE xArePollingQueuesStillRunning( void )
\r
211 portBASE_TYPE xReturn;
\r
213 /* Check both the consumer and producer poll count to check they have both
\r
214 been changed since out last trip round. We do not need a critical section
\r
215 around the check variables as this is called from a higher priority than
\r
216 the other tasks that access the same variables. */
\r
217 if( ( xPollingConsumerCount == pollqINITIAL_VALUE ) ||
\r
218 ( xPollingProducerCount == pollqINITIAL_VALUE )
\r
228 /* Set the check variables back down so we know if they have been
\r
229 incremented the next time around. */
\r
230 xPollingConsumerCount = pollqINITIAL_VALUE;
\r
231 xPollingProducerCount = pollqINITIAL_VALUE;
\r