| /* | |
| FreeRTOS V8.0.0:rc1 - Copyright (C) 2014 Real Time Engineers Ltd. | |
| All rights reserved | |
| FEATURES AND PORTS ARE ADDED TO FREERTOS ALL THE TIME. PLEASE VISIT | |
| http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. | |
| *************************************************************************** | |
| * * | |
| * FreeRTOS tutorial books are available in pdf and paperback. * | |
| * Complete, revised, and edited pdf reference manuals are also * | |
| * available. * | |
| * * | |
| * Purchasing FreeRTOS documentation will not only help you, by * | |
| * ensuring you get running as quickly as possible and with an * | |
| * in-depth knowledge of how to use FreeRTOS, it will also help * | |
| * the FreeRTOS project to continue with its mission of providing * | |
| * professional grade, cross platform, de facto standard solutions * | |
| * for microcontrollers - completely free of charge! * | |
| * * | |
| * >>> See http://www.FreeRTOS.org/Documentation for details. <<< * | |
| * * | |
| * Thank you for using FreeRTOS, and thank you for your support! * | |
| * * | |
| *************************************************************************** | |
| 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. See the GNU General Public License for more | |
| details. You should have received a copy of the GNU General Public License | |
| and the FreeRTOS license exception along with FreeRTOS; if not itcan be | |
| viewed here: http://www.freertos.org/a00114.html and also obtained by | |
| writing to Real Time Engineers Ltd., contact details for whom are available | |
| on the FreeRTOS WEB site. | |
| 1 tab == 4 spaces! | |
| *************************************************************************** | |
| * * | |
| * Having a problem? Start by reading the FAQ "My application does * | |
| * not run, what could be wrong?" * | |
| * * | |
| * http://www.FreeRTOS.org/FAQHelp.html * | |
| * * | |
| *************************************************************************** | |
| http://www.FreeRTOS.org - Documentation, books, training, latest versions, | |
| license and Real Time Engineers Ltd. contact details. | |
| http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, | |
| including FreeRTOS+Trace - an indispensable productivity tool, and our new | |
| fully thread aware and reentrant UDP/IP stack. | |
| http://www.OpenRTOS.com - Real Time Engineers ltd license FreeRTOS to High | |
| Integrity Systems, who sell the code with commercial support, | |
| indemnification and middleware, under the OpenRTOS brand. | |
| 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. | |
| */ | |
| /****************************************************************************** | |
| * | |
| * See the following URL for information on the commands defined in this file: | |
| * http://www.FreeRTOS.org/FreeRTOS-Plus/FreeRTOS_Plus_UDP/Embedded_Ethernet_Examples/Ethernet_Related_CLI_Commands.shtml | |
| * | |
| ******************************************************************************/ | |
| /* FreeRTOS includes. */ | |
| #include "FreeRTOS.h" | |
| #include "task.h" | |
| /* Standard includes. */ | |
| #include <stdint.h> | |
| #include <stdio.h> | |
| #include <string.h> | |
| /* FreeRTOS+CLI includes. */ | |
| #include "FreeRTOS_CLI.h" | |
| #ifndef configINCLUDE_TRACE_RELATED_CLI_COMMANDS | |
| #define configINCLUDE_TRACE_RELATED_CLI_COMMANDS 0 | |
| #endif | |
| /* | |
| * Implements the run-time-stats command. | |
| */ | |
| static portBASE_TYPE prvTaskStatsCommand( char *pcWriteBuffer, size_t xWriteBufferLen, const char *pcCommandString ); | |
| /* | |
| * Implements the task-stats command. | |
| */ | |
| static portBASE_TYPE prvRunTimeStatsCommand( char *pcWriteBuffer, size_t xWriteBufferLen, const char *pcCommandString ); | |
| /* | |
| * Implements the echo-three-parameters command. | |
| */ | |
| static portBASE_TYPE prvThreeParameterEchoCommand( char *pcWriteBuffer, size_t xWriteBufferLen, const char *pcCommandString ); | |
| /* | |
| * Implements the echo-parameters command. | |
| */ | |
| static portBASE_TYPE prvParameterEchoCommand( char *pcWriteBuffer, size_t xWriteBufferLen, const char *pcCommandString ); | |
| /* | |
| * Implements the "trace start" and "trace stop" commands; | |
| */ | |
| #if configINCLUDE_TRACE_RELATED_CLI_COMMANDS == 1 | |
| static portBASE_TYPE prvStartStopTraceCommand( char *pcWriteBuffer, size_t xWriteBufferLen, const char *pcCommandString ); | |
| #endif | |
| /* Structure that defines the "run-time-stats" command line command. This | |
| generates a table that shows how much run time each task has */ | |
| static const CLI_Command_Definition_t xRunTimeStats = | |
| { | |
| "run-time-stats", /* The command string to type. */ | |
| "\r\nrun-time-stats:\r\n Displays a table showing how much processing time each FreeRTOS task has used\r\n", | |
| prvRunTimeStatsCommand, /* The function to run. */ | |
| 0 /* No parameters are expected. */ | |
| }; | |
| /* Structure that defines the "task-stats" command line command. This generates | |
| a table that gives information on each task in the system. */ | |
| static const CLI_Command_Definition_t xTaskStats = | |
| { | |
| "task-stats", /* The command string to type. */ | |
| "\r\ntask-stats:\r\n Displays a table showing the state of each FreeRTOS task\r\n", | |
| prvTaskStatsCommand, /* The function to run. */ | |
| 0 /* No parameters are expected. */ | |
| }; | |
| /* Structure that defines the "echo_3_parameters" command line command. This | |
| takes exactly three parameters that the command simply echos back one at a | |
| time. */ | |
| static const CLI_Command_Definition_t xThreeParameterEcho = | |
| { | |
| "echo-3-parameters", | |
| "\r\necho-3-parameters <param1> <param2> <param3>:\r\n Expects three parameters, echos each in turn\r\n", | |
| prvThreeParameterEchoCommand, /* The function to run. */ | |
| 3 /* Three parameters are expected, which can take any value. */ | |
| }; | |
| /* Structure that defines the "echo_parameters" command line command. This | |
| takes a variable number of parameters that the command simply echos back one at | |
| a time. */ | |
| static const CLI_Command_Definition_t xParameterEcho = | |
| { | |
| "echo-parameters", | |
| "\r\necho-parameters <...>:\r\n Take variable number of parameters, echos each in turn\r\n", | |
| prvParameterEchoCommand, /* The function to run. */ | |
| -1 /* The user can enter any number of commands. */ | |
| }; | |
| #if configINCLUDE_TRACE_RELATED_CLI_COMMANDS == 1 | |
| /* Structure that defines the "trace" command line command. This takes a single | |
| parameter, which can be either "start" or "stop". */ | |
| static const CLI_Command_Definition_t xStartStopTrace = | |
| { | |
| "trace", | |
| "\r\ntrace [start | stop]:\r\n Starts or stops a trace recording for viewing in FreeRTOS+Trace\r\n", | |
| prvStartStopTraceCommand, /* The function to run. */ | |
| 1 /* One parameter is expected. Valid values are "start" and "stop". */ | |
| }; | |
| #endif /* configINCLUDE_TRACE_RELATED_CLI_COMMANDS */ | |
| /*-----------------------------------------------------------*/ | |
| void vRegisterSampleCLICommands( void ) | |
| { | |
| /* Register all the command line commands defined immediately above. */ | |
| FreeRTOS_CLIRegisterCommand( &xTaskStats ); | |
| FreeRTOS_CLIRegisterCommand( &xRunTimeStats ); | |
| FreeRTOS_CLIRegisterCommand( &xThreeParameterEcho ); | |
| FreeRTOS_CLIRegisterCommand( &xParameterEcho ); | |
| #if( configINCLUDE_TRACE_RELATED_CLI_COMMANDS == 1 ) | |
| { | |
| FreeRTOS_CLIRegisterCommand( & xStartStopTrace ); | |
| } | |
| #endif | |
| } | |
| /*-----------------------------------------------------------*/ | |
| static portBASE_TYPE prvTaskStatsCommand( char *pcWriteBuffer, size_t xWriteBufferLen, const char *pcCommandString ) | |
| { | |
| const char *const pcHeader = "Task State Priority Stack #\r\n************************************************\r\n"; | |
| /* Remove compile time warnings about unused parameters, and check the | |
| write buffer is not NULL. NOTE - for simplicity, this example assumes the | |
| write buffer length is adequate, so does not check for buffer overflows. */ | |
| ( void ) pcCommandString; | |
| ( void ) xWriteBufferLen; | |
| configASSERT( pcWriteBuffer ); | |
| /* Generate a table of task stats. */ | |
| strcpy( pcWriteBuffer, pcHeader ); | |
| vTaskList( pcWriteBuffer + strlen( pcHeader ) ); | |
| /* There is no more data to return after this single string, so return | |
| pdFALSE. */ | |
| return pdFALSE; | |
| } | |
| /*-----------------------------------------------------------*/ | |
| static portBASE_TYPE prvRunTimeStatsCommand( char *pcWriteBuffer, size_t xWriteBufferLen, const char *pcCommandString ) | |
| { | |
| const char * const pcHeader = "Task Abs Time % Time\r\n****************************************\r\n"; | |
| /* Remove compile time warnings about unused parameters, and check the | |
| write buffer is not NULL. NOTE - for simplicity, this example assumes the | |
| write buffer length is adequate, so does not check for buffer overflows. */ | |
| ( void ) pcCommandString; | |
| ( void ) xWriteBufferLen; | |
| configASSERT( pcWriteBuffer ); | |
| /* Generate a table of task stats. */ | |
| strcpy( pcWriteBuffer, pcHeader ); | |
| vTaskGetRunTimeStats( pcWriteBuffer + strlen( pcHeader ) ); | |
| /* There is no more data to return after this single string, so return | |
| pdFALSE. */ | |
| return pdFALSE; | |
| } | |
| /*-----------------------------------------------------------*/ | |
| static portBASE_TYPE prvThreeParameterEchoCommand( char *pcWriteBuffer, size_t xWriteBufferLen, const char *pcCommandString ) | |
| { | |
| const char *pcParameter; | |
| portBASE_TYPE xParameterStringLength, xReturn; | |
| static portBASE_TYPE lParameterNumber = 0; | |
| /* Remove compile time warnings about unused parameters, and check the | |
| write buffer is not NULL. NOTE - for simplicity, this example assumes the | |
| write buffer length is adequate, so does not check for buffer overflows. */ | |
| ( void ) pcCommandString; | |
| ( void ) xWriteBufferLen; | |
| configASSERT( pcWriteBuffer ); | |
| if( lParameterNumber == 0 ) | |
| { | |
| /* The first time the function is called after the command has been | |
| entered just a header string is returned. */ | |
| sprintf( pcWriteBuffer, "The three parameters were:\r\n" ); | |
| /* Next time the function is called the first parameter will be echoed | |
| back. */ | |
| lParameterNumber = 1L; | |
| /* There is more data to be returned as no parameters have been echoed | |
| back yet. */ | |
| xReturn = pdPASS; | |
| } | |
| else | |
| { | |
| /* Obtain the parameter string. */ | |
| pcParameter = FreeRTOS_CLIGetParameter | |
| ( | |
| pcCommandString, /* The command string itself. */ | |
| lParameterNumber, /* Return the next parameter. */ | |
| &xParameterStringLength /* Store the parameter string length. */ | |
| ); | |
| /* Sanity check something was returned. */ | |
| configASSERT( pcParameter ); | |
| /* Return the parameter string. */ | |
| memset( pcWriteBuffer, 0x00, xWriteBufferLen ); | |
| sprintf( pcWriteBuffer, "%d: ", ( int ) lParameterNumber ); | |
| strncat( pcWriteBuffer, pcParameter, xParameterStringLength ); | |
| strncat( pcWriteBuffer, "\r\n", strlen( "\r\n" ) ); | |
| /* If this is the last of the three parameters then there are no more | |
| strings to return after this one. */ | |
| if( lParameterNumber == 3L ) | |
| { | |
| /* If this is the last of the three parameters then there are no more | |
| strings to return after this one. */ | |
| xReturn = pdFALSE; | |
| lParameterNumber = 0L; | |
| } | |
| else | |
| { | |
| /* There are more parameters to return after this one. */ | |
| xReturn = pdTRUE; | |
| lParameterNumber++; | |
| } | |
| } | |
| return xReturn; | |
| } | |
| /*-----------------------------------------------------------*/ | |
| static portBASE_TYPE prvParameterEchoCommand( char *pcWriteBuffer, size_t xWriteBufferLen, const char *pcCommandString ) | |
| { | |
| const char *pcParameter; | |
| portBASE_TYPE xParameterStringLength, xReturn; | |
| static portBASE_TYPE lParameterNumber = 0; | |
| /* Remove compile time warnings about unused parameters, and check the | |
| write buffer is not NULL. NOTE - for simplicity, this example assumes the | |
| write buffer length is adequate, so does not check for buffer overflows. */ | |
| ( void ) pcCommandString; | |
| ( void ) xWriteBufferLen; | |
| configASSERT( pcWriteBuffer ); | |
| if( lParameterNumber == 0 ) | |
| { | |
| /* The first time the function is called after the command has been | |
| entered just a header string is returned. */ | |
| sprintf( pcWriteBuffer, "The parameters were:\r\n" ); | |
| /* Next time the function is called the first parameter will be echoed | |
| back. */ | |
| lParameterNumber = 1L; | |
| /* There is more data to be returned as no parameters have been echoed | |
| back yet. */ | |
| xReturn = pdPASS; | |
| } | |
| else | |
| { | |
| /* Obtain the parameter string. */ | |
| pcParameter = FreeRTOS_CLIGetParameter | |
| ( | |
| pcCommandString, /* The command string itself. */ | |
| lParameterNumber, /* Return the next parameter. */ | |
| &xParameterStringLength /* Store the parameter string length. */ | |
| ); | |
| if( pcParameter != NULL ) | |
| { | |
| /* Return the parameter string. */ | |
| memset( pcWriteBuffer, 0x00, xWriteBufferLen ); | |
| sprintf( pcWriteBuffer, "%d: ", ( int ) lParameterNumber ); | |
| strncat( pcWriteBuffer, pcParameter, xParameterStringLength ); | |
| strncat( pcWriteBuffer, "\r\n", strlen( "\r\n" ) ); | |
| /* There might be more parameters to return after this one. */ | |
| xReturn = pdTRUE; | |
| lParameterNumber++; | |
| } | |
| else | |
| { | |
| /* No more parameters were found. Make sure the write buffer does | |
| not contain a valid string. */ | |
| pcWriteBuffer[ 0 ] = 0x00; | |
| /* No more data to return. */ | |
| xReturn = pdFALSE; | |
| /* Start over the next time this command is executed. */ | |
| lParameterNumber = 0; | |
| } | |
| } | |
| return xReturn; | |
| } | |
| /*-----------------------------------------------------------*/ | |
| #if configINCLUDE_TRACE_RELATED_CLI_COMMANDS == 1 | |
| static portBASE_TYPE prvStartStopTraceCommand( char *pcWriteBuffer, size_t xWriteBufferLen, const char *pcCommandString ) | |
| { | |
| const char *pcParameter; | |
| portBASE_TYPE lParameterStringLength; | |
| /* Remove compile time warnings about unused parameters, and check the | |
| write buffer is not NULL. NOTE - for simplicity, this example assumes the | |
| write buffer length is adequate, so does not check for buffer overflows. */ | |
| ( void ) pcCommandString; | |
| ( void ) xWriteBufferLen; | |
| configASSERT( pcWriteBuffer ); | |
| /* Obtain the parameter string. */ | |
| pcParameter = FreeRTOS_CLIGetParameter | |
| ( | |
| pcCommandString, /* The command string itself. */ | |
| 1, /* Return the first parameter. */ | |
| &lParameterStringLength /* Store the parameter string length. */ | |
| ); | |
| /* Sanity check something was returned. */ | |
| configASSERT( pcParameter ); | |
| /* There are only two valid parameter values. */ | |
| if( strncmp( pcParameter, "start", strlen( "start" ) ) == 0 ) | |
| { | |
| /* Start or restart the trace. */ | |
| vTraceStop(); | |
| vTraceClear(); | |
| vTraceStart(); | |
| sprintf( pcWriteBuffer, "Trace recording (re)started.\r\n" ); | |
| } | |
| else if( strncmp( pcParameter, "stop", strlen( "stop" ) ) == 0 ) | |
| { | |
| /* End the trace, if one is running. */ | |
| vTraceStop(); | |
| sprintf( pcWriteBuffer, "Stopping trace recording.\r\n" ); | |
| } | |
| else | |
| { | |
| sprintf( pcWriteBuffer, "Valid parameters are 'start' and 'stop'.\r\n" ); | |
| } | |
| /* There is no more data to return after this single string, so return | |
| pdFALSE. */ | |
| return pdFALSE; | |
| } | |
| #endif /* configINCLUDE_TRACE_RELATED_CLI_COMMANDS */ |