One-shot vs auto-reload timers in FreeRTOS - When to Use Which

The Big Idea

What if your program could handle waiting and repeating tasks all by itself, perfectly timed every time?

The Scenario

Imagine you want to turn on a light for exactly 5 seconds and then turn it off automatically. You try to do this by checking the time repeatedly in your program and turning the light off when 5 seconds pass.

The Problem

This manual way means your program is busy checking the time all the time. It wastes effort and can miss other important tasks. Also, if you want the light to turn on and off repeatedly every 5 seconds, you have to write extra code to reset the timer again and again, which is easy to mess up.

The Solution

One-shot and auto-reload timers in FreeRTOS handle this for you. A one-shot timer runs once and stops, perfect for single delays. An auto-reload timer runs repeatedly at set intervals without extra code. This frees your program to do other things while the timer works in the background.

Before vs After

✗ Before

start_time = get_time()
while (get_time() - start_time < 5000) {
  // wait
}
turn_off_light();

✓ After

TimerHandle_t timer = xTimerCreate("OneShot", pdMS_TO_TICKS(5000), pdFALSE, 0, turnOffLightCallback);
xTimerStart(timer, 0);

What It Enables

Timers let your program handle delays and repeated actions easily and reliably, without wasting effort or missing other tasks.

Real Life Example

In a smart home, you can use a one-shot timer to turn off a heater after 10 minutes, or an auto-reload timer to check the temperature every minute automatically.

Key Takeaways

Manual timing wastes effort and can miss tasks.

One-shot timers run once; auto-reload timers run repeatedly.

Timers free your program to do more while waiting.

Practice

1. What is the main difference between a one-shot timer and an auto-reload timer in FreeRTOS?

easy

A. One-shot timers run once after a delay; auto-reload timers run repeatedly at fixed intervals.

B. One-shot timers run repeatedly; auto-reload timers run only once.

C. One-shot timers are faster than auto-reload timers.

D. Auto-reload timers cannot be stopped once started.

Solution

1. Step 1: Understand timer behavior

   One-shot timers execute their callback function only once after the specified delay.

2. Step 2: Compare with auto-reload timers

   Auto-reload timers automatically restart after each expiration, running repeatedly at fixed intervals.

3. Final Answer:

   One-shot timers run once after a delay; auto-reload timers run repeatedly at fixed intervals. -> Option A

4. Quick Check:

   One-shot = single run, Auto-reload = repeated runs [OK]

Hint: One-shot = once, Auto-reload = repeat [OK]

Common Mistakes:

• Confusing which timer runs repeatedly
• Thinking one-shot timers repeat automatically
• Assuming auto-reload timers cannot be stopped

2. Which of the following is the correct way to create an auto-reload timer in FreeRTOS using xTimerCreate?

easy

A. xTimerCreate("Timer", pdMS_TO_TICKS(1000), pdFALSE, NULL, TimerCallback);

B. xTimerCreate("Timer", 1000, pdTRUE, NULL, TimerCallback);

C. xTimerCreate("Timer", 1000, pdFALSE, NULL, TimerCallback);

D. xTimerCreate("Timer", pdMS_TO_TICKS(1000), pdTRUE, NULL, TimerCallback);

Solution

1. Step 1: Identify auto-reload parameter

   The third parameter of xTimerCreate is uxAutoReload, which should be pdTRUE for auto-reload timers.

2. Step 2: Check time parameter format

   Use pdMS_TO_TICKS(1000) to convert milliseconds to ticks correctly.

3. Final Answer:

   xTimerCreate("Timer", pdMS_TO_TICKS(1000), pdTRUE, NULL, TimerCallback); -> Option D

4. Quick Check:

   Auto-reload needs pdTRUE and tick conversion [OK]

Hint: Auto-reload = pdTRUE, use pdMS_TO_TICKS for time [OK]

Common Mistakes:

• Using pdFALSE for auto-reload timers
• Passing raw milliseconds instead of ticks
• Confusing parameter order

3. Consider this FreeRTOS timer code snippet:

TimerHandle_t timer = xTimerCreate("MyTimer", pdMS_TO_TICKS(500), pdFALSE, NULL, TimerCallback);
xTimerStart(timer, 0);

What will happen when this timer expires?

medium

A. The TimerCallback function will be called once after 500 ms.

B. The TimerCallback function will be called repeatedly every 500 ms.

C. The timer will never start because pdFALSE is invalid.

D. The TimerCallback function will be called immediately and repeatedly.

Solution

1. Step 1: Analyze timer creation parameters

   The timer is created with pdFALSE for auto-reload, meaning it is a one-shot timer.

2. Step 2: Understand timer start and expiration

   After starting, the timer waits 500 ms, then calls TimerCallback once and stops.

3. Final Answer:

   The TimerCallback function will be called once after 500 ms. -> Option A

4. Quick Check:

   pdFALSE means one-shot = single callback [OK]

Hint: pdFALSE means one-shot, callback runs once [OK]

Common Mistakes:

• Thinking pdFALSE means repeated calls
• Assuming timer starts immediately
• Confusing pdFALSE with invalid parameter

4. You wrote this code to create an auto-reload timer but it only runs once:

TimerHandle_t timer = xTimerCreate("Timer", pdMS_TO_TICKS(1000), pdFALSE, NULL, TimerCallback);
xTimerStart(timer, 0);

What is the likely error?

medium

A. The timer period is too short to see repeated calls.

B. xTimerStart was called with zero block time.

C. The auto-reload parameter is set to pdFALSE instead of pdTRUE.

D. The timer callback function is missing.

Solution

1. Step 1: Check auto-reload parameter

   The timer was created with pdFALSE, which means it is a one-shot timer.

2. Step 2: Understand effect on timer behavior

   Because of pdFALSE, the timer runs only once and does not auto-reload.

3. Final Answer:

   The auto-reload parameter is set to pdFALSE instead of pdTRUE. -> Option C

4. Quick Check:

   pdFALSE disables auto-reload, causing single run [OK]

Hint: Auto-reload needs pdTRUE, not pdFALSE [OK]

Common Mistakes:

• Ignoring auto-reload parameter
• Thinking block time affects reload
• Assuming callback absence causes single run

5. You want to toggle an LED every 2 seconds indefinitely using a FreeRTOS timer. Which timer type and setup should you use?

hard

A. Create a one-shot timer with 2000 ms period and restart it manually each time.

B. Create an auto-reload timer with 2000 ms period to toggle LED automatically.

C. Create a one-shot timer with 1000 ms period and toggle LED twice per cycle.

D. Create an auto-reload timer with 1000 ms period and toggle LED every 2 cycles.

Solution

1. Step 1: Identify requirement for repeated action

   Toggling LED every 2 seconds indefinitely means the action repeats automatically.

2. Step 2: Choose timer type and period

   An auto-reload timer with 2000 ms period will call the toggle function every 2 seconds without manual restart.

3. Final Answer:

   Create an auto-reload timer with 2000 ms period to toggle LED automatically. -> Option B

4. Quick Check:

   Repeated action = auto-reload timer with correct period [OK]

Hint: Repeated tasks use auto-reload timers with correct period [OK]

Common Mistakes:

• Using one-shot timer and forgetting to restart
• Setting wrong timer period
• Confusing toggle frequency with timer period