/* | |
FreeRTOS V9.0.1 - Copyright (C) 2017 Real Time Engineers Ltd. | |
All rights reserved | |
VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. | |
This file is part of the FreeRTOS distribution. | |
FreeRTOS is free software; you can redistribute it and/or modify it under | |
the terms of the GNU General Public License (version 2) as published by the | |
Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. | |
*************************************************************************** | |
>>! NOTE: The modification to the GPL is included to allow you to !<< | |
>>! distribute a combined work that includes FreeRTOS without being !<< | |
>>! obliged to provide the source code for proprietary components !<< | |
>>! outside of the FreeRTOS kernel. !<< | |
*************************************************************************** | |
FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY | |
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS | |
FOR A PARTICULAR PURPOSE. Full license text is available on the following | |
link: http://www.freertos.org/a00114.html | |
*************************************************************************** | |
* * | |
* FreeRTOS provides completely free yet professionally developed, * | |
* robust, strictly quality controlled, supported, and cross * | |
* platform software that is more than just the market leader, it * | |
* is the industry's de facto standard. * | |
* * | |
* Help yourself get started quickly while simultaneously helping * | |
* to support the FreeRTOS project by purchasing a FreeRTOS * | |
* tutorial book, reference manual, or both: * | |
* http://www.FreeRTOS.org/Documentation * | |
* * | |
*************************************************************************** | |
http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading | |
the FAQ page "My application does not run, what could be wrong?". Have you | |
defined configASSERT()? | |
http://www.FreeRTOS.org/support - In return for receiving this top quality | |
embedded software for free we request you assist our global community by | |
participating in the support forum. | |
http://www.FreeRTOS.org/training - Investing in training allows your team to | |
be as productive as possible as early as possible. Now you can receive | |
FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers | |
Ltd, and the world's leading authority on the world's leading RTOS. | |
http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, | |
including FreeRTOS+Trace - an indispensable productivity tool, a DOS | |
compatible FAT file system, and our tiny thread aware UDP/IP stack. | |
http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. | |
Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. | |
http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High | |
Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS | |
licenses offer ticketed support, indemnification and commercial middleware. | |
http://www.SafeRTOS.com - High Integrity Systems also provide a safety | |
engineered and independently SIL3 certified version for use in safety and | |
mission critical applications that require provable dependability. | |
1 tab == 4 spaces! | |
*/ | |
/** | |
* Manages a queue of strings that are waiting to be displayed. This is used to | |
* ensure mutual exclusion of console output. | |
* | |
* A task wishing to display a message will call vPrintDisplayMessage (), with a | |
* pointer to the string as the parameter. The pointer is posted onto the | |
* xPrintQueue queue. | |
* | |
* The task spawned in main. c blocks on xPrintQueue. When a message becomes | |
* available it calls pcPrintGetNextMessage () to obtain a pointer to the next | |
* string, then uses the functions defined in the portable layer FileIO. c to | |
* display the message. | |
* | |
* <b>NOTE:</b> | |
* Using console IO can disrupt real time performance - depending on the port. | |
* Standard C IO routines are not designed for real time applications. While | |
* standard IO is useful for demonstration and debugging an alternative method | |
* should be used if you actually require console IO as part of your application. | |
* | |
* \page PrintC print.c | |
* \ingroup DemoFiles | |
* <HR> | |
*/ | |
/* | |
Changes from V2.0.0 | |
+ Delay periods are now specified using variables and constants of | |
TickType_t rather than unsigned long. | |
*/ | |
#include <stdlib.h> | |
/* Scheduler include files. */ | |
#include "FreeRTOS.h" | |
#include "queue.h" | |
/* Demo program include files. */ | |
#include "print.h" | |
static QueueHandle_t xPrintQueue; | |
/*-----------------------------------------------------------*/ | |
void vPrintInitialise( void ) | |
{ | |
const unsigned portBASE_TYPE uxQueueSize = 20; | |
/* Create the queue on which errors will be reported. */ | |
xPrintQueue = xQueueCreate( uxQueueSize, ( unsigned portBASE_TYPE ) sizeof( char * ) ); | |
} | |
/*-----------------------------------------------------------*/ | |
void vPrintDisplayMessage( const char * const * ppcMessageToSend ) | |
{ | |
#ifdef USE_STDIO | |
xQueueSend( xPrintQueue, ( void * ) ppcMessageToSend, ( TickType_t ) 0 ); | |
#else | |
/* Stop warnings. */ | |
( void ) ppcMessageToSend; | |
#endif | |
} | |
/*-----------------------------------------------------------*/ | |
const char *pcPrintGetNextMessage( TickType_t xPrintRate ) | |
{ | |
char *pcMessage; | |
if( xQueueReceive( xPrintQueue, &pcMessage, xPrintRate ) == pdPASS ) | |
{ | |
return pcMessage; | |
} | |
else | |
{ | |
return NULL; | |
} | |
} | |