Quality RTOS & Embedded Software

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


Retrieving task names from TCB

Posted by Alex Lennon on May 28, 2010
Hi there,

I'm using FreeRTOS with an ATMega1280 based project. I'm trying to optimise heap and stack usage as the device is fairly memory constrained.

So I'm making use of uxTaskGetStackHighWaterMark(xTaskHandle). I don't really want to use more RAM to store the task names, but it would be helpful to log the names rather than the handle IDs. The names are in the TCB of course but I can't see a function to retrieve them.

Could somebody point me to a function, if it exists, or is there an architectural reason that one couldn't/shouldn't be added?



RE: Retrieving task names from TCB

Posted by Dave on May 28, 2010
The handle ID is a pointer to the task control block, in which the name is stored. You could add a function to tasks.c like

char *pcGetTaskName(void *handle)
return ((tskTCB*)handle)->pcTaskName;

I have not actually tested this code, but you see the idea.

RE: Retrieving task names from TCB

Posted by Alex Lennon on May 28, 2010
Hi Dave,

Thanks for the response.

I had put something similar in place, but using (const char *) for the return.

My question was more to do with why the there are no accessor functions in place already in FreeRTOS as this seems a sensible idea. I wondered if there is an architectural reason not to expose fields of the TCBs in this way...


RE: Retrieving task names from TCB

Posted by Richard on May 28, 2010
All the kernel data structures use data hiding in this way. Inside the files that define the structures the structure members are fully visible. Outside the files the structures are defined as void* to keep their members hidden - and access can only be obtained through access functions.

There is no particular reason why a function to return the name has never been included. I have added it to the todo list so it will be there in the next release.


RE: Retrieving task names from TCB

Posted by Alex Lennon on May 29, 2010


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

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

Latest News

Version 10.1.0 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