vTaskDelay() for periodic tasks in FreeRTOS

Introduction

vTaskDelay() helps pause a task for a set time. This makes tasks run regularly, like a clock ticking.

When you want a task to run every 1 second to read a sensor.

To blink an LED on and off at a steady rate.

When you need to check a button press every 100 milliseconds.

To send data over a network at fixed intervals.

When you want to save power by pausing a task between actions.

Syntax

FreeRTOS

void vTaskDelay(const TickType_t xTicksToDelay);

xTicksToDelay is the number of tick periods to delay the task.

The tick period depends on your FreeRTOS configuration (usually 1ms or 10ms).

Examples

Delays the task for 1000 milliseconds (1 second).

FreeRTOS

vTaskDelay(1000 / portTICK_PERIOD_MS);

Delays the task for 500 milliseconds using a helper macro.

FreeRTOS

vTaskDelay(pdMS_TO_TICKS(500));

Sample Program

This program creates a task that prints a message every 1 second using vTaskDelay(). The delay makes the task run periodically.

FreeRTOS

#include "FreeRTOS.h"
#include "task.h"
#include <stdio.h>

void vPeriodicTask(void *pvParameters) {
    const TickType_t xDelay = pdMS_TO_TICKS(1000); // 1 second delay
    for (;;) {
        printf("Task running at regular interval\n");
        vTaskDelay(xDelay); // Delay for 1 second
    }
}

int main(void) {
    xTaskCreate(vPeriodicTask, "PeriodicTask", 1000, NULL, 1, NULL);
    vTaskStartScheduler();
    for(;;); // Should never reach here
    return 0;
}

Important Notes

vTaskDelay() delays from the time it is called, so small variations can add up over time.

For precise periodic timing, consider using vTaskDelayUntil() instead.

Always convert milliseconds to ticks using pdMS_TO_TICKS() for portability.

Summary

vTaskDelay() pauses a task for a set number of ticks.

Use it to make tasks run at regular intervals.

Convert milliseconds to ticks with pdMS_TO_TICKS() for accuracy.

Practice

1. What is the primary purpose of vTaskDelay() in FreeRTOS?

easy

A. To pause a task for a specific number of ticks

B. To create a new task

C. To delete a task

D. To send data between tasks

Solution

1. Step 1: Understand the function role

   vTaskDelay() is designed to pause or block a task for a set number of tick counts, allowing other tasks to run.

2. Step 2: Compare with other options

   Creating or deleting tasks and sending data are done by other FreeRTOS functions, not vTaskDelay().

3. Final Answer:

   To pause a task for a specific number of ticks -> Option A

4. Quick Check:

   vTaskDelay() pauses task = A [OK]

Hint: vTaskDelay() always pauses task execution for ticks [OK]

Common Mistakes:

• Confusing vTaskDelay() with task creation functions
• Thinking vTaskDelay() sends data
• Assuming vTaskDelay() deletes tasks

2. Which of the following is the correct way to delay a task for 100 milliseconds using vTaskDelay()?

easy

A. vTaskDelay(100);

B. vTaskDelayMs(100);

C. vTaskDelay(pdMS_TO_TICKS(100));

D. vTaskDelayTicks(100);

Solution

1. Step 1: Understand tick conversion

   FreeRTOS uses ticks, not milliseconds directly. To convert milliseconds to ticks, use pdMS_TO_TICKS().

2. Step 2: Check syntax correctness

   Only vTaskDelay(pdMS_TO_TICKS(100)); correctly converts 100 ms to ticks and delays the task.

3. Final Answer:

   vTaskDelay(pdMS_TO_TICKS(100)); -> Option C

4. Quick Check:

   Use pdMS_TO_TICKS() inside vTaskDelay() [OK]

Hint: Always convert ms to ticks with pdMS_TO_TICKS() [OK]

Common Mistakes:

• Passing milliseconds directly without conversion
• Using non-existent functions like vTaskDelayMs()
• Confusing ticks and milliseconds

3. Given the following code snippet, what will be the approximate delay between each print statement?

void TaskFunction(void *pvParameters) {
    while(1) {
        printf("Tick\n");
        vTaskDelay(pdMS_TO_TICKS(500));
    }
}

medium

A. Approximately 1 second

B. Approximately 500 milliseconds

C. No delay, prints continuously

D. Approximately 50 milliseconds

Solution

1. Step 1: Analyze vTaskDelay parameter

   The delay is set to pdMS_TO_TICKS(500), which converts 500 milliseconds to ticks.

2. Step 2: Understand loop timing

   Each loop iteration prints "Tick" then delays for about 500 ms, so prints occur roughly every 500 ms.

3. Final Answer:

   Approximately 500 milliseconds -> Option B

4. Quick Check:

   vTaskDelay(pdMS_TO_TICKS(500)) = 500 ms delay [OK]

Hint: vTaskDelay(pdMS_TO_TICKS(x)) delays about x milliseconds [OK]

Common Mistakes:

• Ignoring pdMS_TO_TICKS conversion
• Assuming no delay in loop
• Confusing milliseconds with ticks

4. Identify the error in this code snippet intended to delay a task for 200 milliseconds:

void Task(void *params) {
    while(1) {
        doWork();
        vTaskDelay(200);
    }
}

medium

A. vTaskDelay cannot be used inside a while loop

B. doWork() must be called after vTaskDelay()

C. The task function must return a value

D. vTaskDelay should use pdMS_TO_TICKS(200) to convert milliseconds

Solution

1. Step 1: Check vTaskDelay argument

   The argument 200 is treated as ticks, not milliseconds. To delay 200 ms, convert using pdMS_TO_TICKS(200).

2. Step 2: Verify other code parts

   Calling doWork() before delay is valid. The task function returns void, which is correct.

3. Final Answer:

   vTaskDelay should use pdMS_TO_TICKS(200) to convert milliseconds -> Option D

4. Quick Check:

   Convert ms to ticks with pdMS_TO_TICKS() [OK]

Hint: Always convert ms to ticks before passing to vTaskDelay() [OK]

Common Mistakes:

• Passing milliseconds directly to vTaskDelay()
• Thinking vTaskDelay can't be in loops
• Expecting task functions to return values

5. You want a task to run exactly every 1 second, but your system tick rate is 1000 Hz (1 tick = 1 ms). Which is the best way to implement this periodic delay using vTaskDelay()?

hard

A. Use vTaskDelayUntil() instead of vTaskDelay() for precise periodic timing

B. Call vTaskDelay(pdMS_TO_TICKS(1000)); inside the task loop

C. Call vTaskDelay(pdMS_TO_TICKS(1000)); and then call vTaskDelay(0);

D. Call vTaskDelay(1000); inside the task loop

Solution

1. Step 1: Understand vTaskDelay limitations

   vTaskDelay() delays relative to current time, so small variations accumulate causing drift in periodic tasks.

2. Step 2: Identify precise periodic method

   vTaskDelayUntil() uses an absolute wake time, preventing drift and ensuring exact periodic execution.

3. Final Answer:

   Use vTaskDelayUntil() instead of vTaskDelay() for precise periodic timing -> Option A

4. Quick Check:

   vTaskDelayUntil() prevents drift in periodic tasks [OK]

Hint: Use vTaskDelayUntil() for exact periodic task timing [OK]

Common Mistakes:

• Using vTaskDelay() causes timing drift
• Assuming tick count matches ms without conversion
• Adding extra delays unnecessarily