Quality RTOS & Embedded Software

 Real time embedded FreeRTOS RSS feed 
Quick Start Supported MCUs PDF Books Trace Tools Ecosystem


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 ]    [ Privacy ]    [ Sitemap ]    [ ]


Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.

Latest News

NXP tweet showing LPC5500 (ARMv8-M Cortex-M33) running FreeRTOS.

Meet Richard Barry and learn about running FreeRTOS on RISC-V at FOSDEM 2019

Version 10.1.1 of the FreeRTOS kernel is available for immediate download. MIT licensed.

View a recording of the "OTA Update Security and Reliability" webinar, presented by TI and AWS.


Careers

FreeRTOS and other embedded software careers at AWS.



FreeRTOS Partners

ARM Connected RTOS partner for all ARM microcontroller cores

Espressif ESP32

IAR Partner

Microchip Premier RTOS Partner

RTOS partner of NXP for all NXP ARM microcontrollers

Renesas

STMicro RTOS partner supporting ARM7, ARM Cortex-M3, ARM Cortex-M4 and ARM Cortex-M0

Texas Instruments MCU Developer Network RTOS partner for ARM and MSP430 microcontrollers

OpenRTOS and SafeRTOS

Xilinx Microblaze and Zynq partner