Quality RTOS & Embedded Software

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


Task function macro for timer task

Posted by blacknine on February 21, 2014

Why isn't portTASK_FUNCTION been used for the timerTask? The macro is used for the idleTask.

Task function macro for timer task

Posted by rtel on February 21, 2014

Those macros are not really used in practice. It seemed like a good idea at the time, but after the (probably hundreds) of combinations of compiler and architecture ports we found they were only actually needed on one occasions - and that was for something somewhat obscure.


Task function macro for timer task

Posted by blacknine on February 24, 2014

I used the macro to implement the IAR extension keyword __task.

IAR help: This keyword allows functions to relax the rules for preserving registers. Typically, the keyword is used on the start function for a task in an RTOS. By default, functions save the contents of used preserved registers on the stack upon entry, and restore them at exit. Functions that are declared __task do not save all registers, and therefore require less stack space. Because a function declared __task can corrupt registers that are needed by the calling function, you should only use __task on functions that do not return or call such a function from assembler code. The function main can be declared __task, unless it is explicitly called from the application. In real-time applications with more than one task, the root function of each task can be declared __task.

For the implementation I add a define in projdefs.h and portableIARMSP430Xportmacro.h.

projdefs.h: #define TASKEXTENSIONKEYWORD _task /* * Defines the prototype to which task functions must conform. Defined in this * file to ensure the type is known before portable.h is included. */ typedef TASKEXTENSIONKEYWORD void (*TaskFunctiont)( void * );

portmacro.h: /* Task function macros as described on the FreeRTOS.org WEB site. */ #define portTASKFUNCTIONPROTO( vFunction, pvParameters ) TASKEXTENSIONKEYWORD void vFunction( void *pvParameters ) #define portTASKFUNCTION( vFunction, pvParameters ) TASKEXTENSION_KEYWORD void vFunction( void *pvParameters )

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

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

Latest News

Meet us at Embedded World. Hall 3A-525.

Hear from Richard Barry at Embedded World. Feb 28, 16:00, Hall 4-428.

Video: Watch James Gosling & Richard Barry at re:Invent, Las Vegas 2017.

FreeRTOS kernel V10.0.1 is available for immediate download. Now MIT licensed.

FreeRTOS Partners

ARM Connected RTOS partner for all ARM microcontroller cores

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