Quality RTOS & Embedded Software
About   Contact   Support   FAQ

 Real time embedded FreeRTOS RSS feed 
Real time embedded FreeRTOS mailing list 
Quick Start Supported MCUs Books & Kits Trace Tools Ecosystem FreeRTOS Labs Training




Last site update Oct 5 2014

Embedded TCP/IP stack for RTOS advert

Loading

Patch for portSPRINTF

Posted by Philip Munts on May 30, 2011
Using sprintf() in tasks.c causes floating point libraries to be linked when using ARM gcc/newlib toolchains. The following patch to tasks.c allows substituting the integer only siprintf() if the following macro is defined in FreeRTOSConfig.h:

#define portSPRINTF siprintf

--- tasks.c.original2011-05-30 10:25:51.000000000 +0200
+++ tasks.c.new2011-05-30 10:28:53.000000000 +0200
@@ -74,6 +74,10 @@

#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE

+#ifndef portSPRINTF
+#define portSPRINTF sprintf
+#endif
+
/*
* Macro to define the amount of stack available to the idle task.
*/
@@ -2232,7 +2236,7 @@
}
#endif

-sprintf( pcStatusString, ( char * ) "%s\t\t%c\t%u\t%u\t%u\r\n", pxNextTCB->pcTaskName, cStatus, ( unsigned int ) pxNextTCB->uxPriority, usStackRemaining, ( unsigned int ) pxNextTCB->uxTCBNumber );
+portSPRINTF( pcStatusString, ( char * ) "%s\t\t%c\t%u\t%u\t%u\r\n", pxNextTCB->pcTaskName, cStatus, ( unsigned int ) pxNextTCB->uxPriority, usStackRemaining, ( unsigned int ) pxNextTCB->uxTCBNumber );
strcat( ( char * ) pcWriteBuffer, ( char * ) pcStatusString );

} while( pxNextTCB != pxFirstTCB );
@@ -2262,7 +2266,7 @@
if( pxNextTCB->ulRunTimeCounter == 0 )
{
/* The task has used no CPU time at all. */
-sprintf( pcStatsString, ( char * ) "%s\t\t0\t\t0%%\r\n", pxNextTCB->pcTaskName );
+portSPRINTF( pcStatsString, ( char * ) "%s\t\t0\t\t0%%\r\n", pxNextTCB->pcTaskName );
}
else
{
@@ -2275,13 +2279,13 @@
{
#ifdef portLU_PRINTF_SPECIFIER_REQUIRED
{
-sprintf( pcStatsString, ( char * ) "%s\t\t%lu\t\t%lu%%\r\n", pxNextTCB->pcTaskName, pxNextTCB->ulRunTimeCounter, ulStatsAsPercentage );
+portSPRINTF( pcStatsString, ( char * ) "%s\t\t%lu\t\t%lu%%\r\n", pxNextTCB->pcTaskName, pxNextTCB->ulRunTimeCounter, ulStatsAsPercentage );
}
#else
{
/* sizeof( int ) == sizeof( long ) so a smaller
printf() library can be used. */
-sprintf( pcStatsString, ( char * ) "%s\t\t%u\t\t%u%%\r\n", pxNextTCB->pcTaskName, ( unsigned int ) pxNextTCB->ulRunTimeCounter, ( unsigned int ) ulStatsAsPercentage );
+portSPRINTF( pcStatsString, ( char * ) "%s\t\t%u\t\t%u%%\r\n", pxNextTCB->pcTaskName, ( unsigned int ) pxNextTCB->ulRunTimeCounter, ( unsigned int ) ulStatsAsPercentage );
}
#endif
}
@@ -2291,13 +2295,13 @@
consumed less than 1% of the total run time. */
#ifdef portLU_PRINTF_SPECIFIER_REQUIRED
{
-sprintf( pcStatsString, ( char * ) "%s\t\t%lu\t\t<1%%\r\n", pxNextTCB->pcTaskName, pxNextTCB->ulRunTimeCounter );
+portSPRINTF( pcStatsString, ( char * ) "%s\t\t%lu\t\t<1%%\r\n", pxNextTCB->pcTaskName, pxNextTCB->ulRunTimeCounter );
}
#else
{
/* sizeof( int ) == sizeof( long ) so a smaller
printf() library can be used. */
-sprintf( pcStatsString, ( char * ) "%s\t\t%u\t\t<1%%\r\n", pxNextTCB->pcTaskName, ( unsigned int ) pxNextTCB->ulRunTimeCounter );
+portSPRINTF( pcStatsString, ( char * ) "%s\t\t%u\t\t<1%%\r\n", pxNextTCB->pcTaskName, ( unsigned int ) pxNextTCB->ulRunTimeCounter );
}
#endif
}

RE: Patch for portSPRINTF

Posted by Richard on May 30, 2011
Thanks for the suggestions. These lines of code are very tricky to get universally acceptable because the code is (officially) built with 17 different compilers.

If you don't want floating point support in your sprintf() calls then include the file called printf-stdarg.c in your project. That contains an extremely small implementation that uses very little stack. The file is included in lots of the FreeRTOS/Demo subdirectories.

Regards.

RE: Patch for portSPRINTF

Posted by Richard on May 30, 2011
...not to mention the 8, 16, 20, and 32 bit architectures supported.

Having a port specific macro is probably a better solution that the current code, but will take some effort to refit to the exiting ports.

Regards.

RE: Patch for portSPRINTF

Posted by Philip Munts on May 30, 2011
The

+#ifndef portSPRINTF
+#define portSPRINTF sprintf
+#endif

at the top of my patch ensures that if you don't define portSPRINTF somewhere it will execute exactly as before the patch, with or without printf-stdarg.c.

The thing is, I don't want to replace the sprintf() in newlib with the one in printf-strarg.c. I do want to able to use the integer- only siprintf() in tasks.c to avoid linking in floating point libraries. This patch allows me to do that without any other side effects and I thought I would share it. Interestingly, newlib itself has the same issue, calling sprintf() instead of siprintf in ctime() for instance. I 've submitted a patch to them, too.

I do appreciate the testing effort. I am only supporting 5 boards with 2 toolchains and it is almost too much.


[ Back to the top ]    [ About FreeRTOS ]    [ Sitemap ]    [ ]




Copyright (C) 2004-2010 Richard Barry. Copyright (C) 2010-2013 Real Time Engineers Ltd.
Any and all data, files, source code, html content and documentation included in the FreeRTOSTM distribution or available on this site are the exclusive property of Real Time Engineers Ltd.. See the files license.txt (included in the distribution) and this copyright notice for more information. FreeRTOSTM and FreeRTOS.orgTM are trade marks of Real Time Engineers Ltd.