Quality RTOS & Embedded Software

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


What does portTICK_RATE_MS stand for?

Posted by Nobody/Anonymous on December 22, 2006
In most platforms portTICK_RATE_MS is defined as "( ( portTickType ) 1000 / configTICK_RATE_HZ )", while configTICK_RATE_HZ is defined as 1000 also. So portTICK_RATE_MS value is 1. What is this? 1 ms per tick? 1 tick per ms?

In the help file I saw:
"// We are to delay for 200ms.
static const xTickType xDelayTime = 200 / portTICK_RATE_MS;"
But I don't understand this. so delay 200/1=200 ticks means delay 200ms? Thanks for any response!

RE: What does portTICK_RATE_MS stand for?

Posted by Richard on December 22, 2006
portTICK_RATE_MS is only used by the demo applications. It is the "tick rate in milliseconds" which is a bad description for the number of milliseconds between each tick. Therefore with a tick frequency of 1000Hz the tick rate in milliseconds is 1 - there is a tick interrupt every 1 ms. With a tick frequency of 100Hz the tick rate in milliseconds is 10 - there is one tick interrupt every 10 ms.

It was intended to allow the demo applications to execute and behave the same at any tick frequency. Therefore in the demo application tasks any delay times are calculated referencing portTICK_RATE_MS. As you change the tick frequency using the application defined configTICK_RATE_HZ the delay periods used by the demo applications would automatically adjust.

I agree it is not clear and it has problems of resolution (does not work at all if the tick frequency is greater than 1000Hz?). It does not however effect the kernel itself, just the demo apps.


RE: What does portTICK_RATE_MS stand for?

Posted by Nobody/Anonymous on December 22, 2006
Got it. Thank you! And add a comment in the source code may make it better.

[ 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