Quality RTOS & Embedded Software

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


pcTaskGetName question

Posted by mitsoyba on April 5, 2017

FreeRTOS v9.0.0, tm4c123gh6pm MCU

Hi All,

I am trying to get a tasks name by using the pcTaskGetName function.

I tried from within the task with NULL as parameter and also from elsewhere with the tasks handle as a parameter, but i always get back a pointer to "main".

i use the following define as well:

INCLUDE_pcGetTaskName 1

Am i missing something?

Thanks in advance for your help.

Best regards, Dim

pcTaskGetName question

Posted by rtel on April 5, 2017

What do you mean you get a pointer to "main"? The string "main", or the main() function? Do you have task that is called "main"?

Are you calling this after the scheduler has been started?

The code for pcTaskGetName() is very simple, as below, step into it in the debugger to see what it is doing.

char *pcTaskGetName( TaskHandle_t xTaskToQuery )
TCB_t *pxTCB;

     /* If null is passed in here then the name of the calling task is being
     queried. */
     pxTCB = prvGetTCBFromHandle( xTaskToQuery );
     configASSERT( pxTCB );
     return &( pxTCB->pcTaskName[ 0 ] );

pcTaskGetName question

Posted by mitsoyba on April 5, 2017


Sorry for not being clear about the pointer, its not the function but the string.

I call the function after the scheduler has started.

Offcourse i havent made another "main" function ;)

I will debug the project asap and let you know.

Thanks for the quick response.

Best regards, Dim

pcTaskGetName question

Posted by mitsoyba on April 6, 2017


I did a debug session as you suggested and it seems that whatever handle i provide for the pcTaskGetName, i always get back the "main" string.

Currently, i call pcTaskGetName from within a task after the task scheduler has started.

Please see attached images.

Best regards, Dim


img1.png (88839 bytes)
img2.png (96804 bytes)

pcTaskGetName question

Posted by heinbali01 on April 6, 2017

pcTaskGetName( NULL ) will return the name of the task that is currently active. So if you call pcTaskGetName( NULL ) from a task whose name is "main", it is logical that it returns that string.

Didn't you create your task with xTaskCreate( pvFunction, "main", xxx) ?

If the idle-task would call pcTaskGetName( NULL ), it would see "IDLE"

Or if your task would call pcTaskGetName( xIdleTaskHandle ), it would also receive the string "IDLE"

( NB. TaskHandle_t xIdleTaskHandle is declared static in tasks.c, so you can not easily try that )

Does that answer your question?

pcTaskGetName question

Posted by mitsoyba on April 6, 2017

Hi Hein,

Thanks for your quick response and help.

Actaully i found out that i was passing the wrong pointer to a function hence the problem.

Sorry for wasting your time!

Best regards, Dim

[ 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.

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.


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


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