pvPortMalloc and vPortFree in FreeRTOS - Mini Project: Build & Apply

Using pvPortMalloc and vPortFree in FreeRTOS

📖 Scenario: You are working on an embedded system using FreeRTOS. You need to dynamically allocate and free memory safely within your tasks.

🎯 Goal: Learn how to use pvPortMalloc to allocate memory and vPortFree to free that memory in FreeRTOS.

📋 What You'll Learn

Create a pointer variable to hold allocated memory

Define the size of memory to allocate

Use pvPortMalloc to allocate memory

Use vPortFree to free the allocated memory

Print messages to confirm allocation and freeing

💡 Why This Matters

🌍 Real World

Embedded systems often need dynamic memory allocation for buffers or data structures during runtime. Using FreeRTOS memory functions ensures thread safety and proper memory management.

💼 Career

Embedded developers must manage memory carefully to avoid leaks and crashes. Knowing how to use FreeRTOS memory allocation functions is essential for writing reliable multitasking applications.

1

Create a pointer variable for memory allocation

Create a pointer variable called buffer of type char * and initialize it to NULL.

FreeRTOS

char *buffer = NULL;  // Your code here

Hint

Use char *buffer = NULL; to declare a pointer that will hold the allocated memory address.

2

Define the size of memory to allocate

Create a variable called size of type size_t and set it to 100 to represent the number of bytes to allocate.

FreeRTOS

char *buffer = NULL;
size_t size = 0;  // Your code here

Hint

Use size_t size = 100; to define the memory size you want to allocate.

3

Allocate memory using pvPortMalloc

Use pvPortMalloc to allocate memory of size bytes and assign the result to buffer. Use a cast to char *.

FreeRTOS

char *buffer = NULL;
size_t size = 100;
// Your code here

Hint

Call pvPortMalloc(size) and cast it to char * before assigning to buffer.

4

Free the allocated memory and print confirmation

Use vPortFree to free the memory pointed to by buffer. Then print "Memory freed" using printf.

FreeRTOS

char *buffer = NULL;
size_t size = 100;
buffer = (char *)pvPortMalloc(size);
// Your code here

Hint

Call vPortFree(buffer); to free the memory, then printf("Memory freed\n"); to show confirmation.

Practice

1. What is the primary purpose of pvPortMalloc in FreeRTOS?

easy

A. To suspend a running task temporarily

B. To free allocated memory back to the system

C. To create a new task in FreeRTOS

D. To allocate memory safely for tasks and resources

Solution

1. Step 1: Understand the role of pvPortMalloc

   pvPortMalloc is designed to allocate memory safely in FreeRTOS, especially in multitasking environments.

2. Step 2: Differentiate from other functions

   Functions like vPortFree free memory, and task creation or suspension are unrelated to memory allocation.

3. Final Answer:

   To allocate memory safely for tasks and resources -> Option D

4. Quick Check:

   pvPortMalloc = allocate memory [OK]

Hint: pvPortMalloc always allocates memory safely [OK]

Common Mistakes:

• Confusing pvPortMalloc with vPortFree
• Thinking pvPortMalloc creates tasks
• Assuming it suspends tasks

2. Which of the following is the correct syntax to free memory allocated by pvPortMalloc?

easy

A. vPortFree(pointer);

B. pvPortMalloc(pointer);

C. free(pointer);

D. vPortMalloc(pointer);

Solution

1. Step 1: Identify the function to free memory

   Memory allocated by pvPortMalloc must be freed using vPortFree to avoid memory leaks.

2. Step 2: Check syntax correctness

   The correct syntax is vPortFree(pointer);. Other options either allocate memory or use standard C free, which is not recommended in FreeRTOS.

3. Final Answer:

   vPortFree(pointer); -> Option A

4. Quick Check:

   Free memory with vPortFree [OK]

Hint: Use vPortFree to release memory allocated by pvPortMalloc [OK]

Common Mistakes:

• Using free() instead of vPortFree()
• Calling pvPortMalloc to free memory
• Incorrect function names like vPortMalloc

3. Consider the following FreeRTOS code snippet:

void *ptr = pvPortMalloc(100);
if(ptr != NULL) {
    vPortFree(ptr);
    ptr = NULL;
}
printf("%p", ptr);

What will be the output of the printf statement?

medium

A. A memory address (non-NULL pointer)

B. Compilation error

C. NULL (0x0 or equivalent)

D. Random garbage value

Solution

1. Step 1: Analyze memory allocation and freeing

   pvPortMalloc(100) allocates memory and returns a pointer. Then vPortFree(ptr) frees it, and ptr is set to NULL.

2. Step 2: Understand the printf output

   Since ptr is explicitly set to NULL, printf will print 0x0 or equivalent NULL pointer representation.

3. Final Answer:

   NULL (0x0 or equivalent) -> Option C

4. Quick Check:

   Pointer set to NULL after free = NULL output [OK]

Hint: Pointer set to NULL after free prints NULL [OK]

Common Mistakes:

• Assuming pointer still holds address after free
• Expecting compilation error due to free
• Thinking printf prints garbage

4. Identify the error in the following FreeRTOS code snippet:

void *ptr = pvPortMalloc(50);
// Some code using ptr
vPortFree(ptr);
vPortFree(ptr);

medium

A. Double free of the same pointer

B. Missing check if pvPortMalloc returned NULL

C. Incorrect function name vPortFree

D. Memory leak due to not freeing ptr

Solution

1. Step 1: Review memory allocation and freeing

   pvPortMalloc(50) allocates memory and returns a pointer stored in ptr. The first vPortFree(ptr) frees this memory.

2. Step 2: Identify the problem with second free

   The second vPortFree(ptr) attempts to free the same memory again, causing a double free error which can crash or corrupt memory.

3. Final Answer:

   Double free of the same pointer -> Option A

4. Quick Check:

   Freeing pointer twice causes error [OK]

Hint: Never free the same pointer twice without resetting it [OK]

Common Mistakes:

• Ignoring double free risks
• Not checking for NULL after malloc
• Confusing function names

5. You want to allocate memory for an array of 10 integers using FreeRTOS memory management. Which code snippet correctly allocates and frees this memory?

hard

A. int *arr = (int *)pvPortMalloc(sizeof(int));
if(arr != NULL) {
// use arr
vPortFree(arr);
}

B. int *arr = (int *)pvPortMalloc(10 * sizeof(int));
if(arr != NULL) {
// use arr
vPortFree(arr);
}

C. int *arr = (int *)malloc(10 * sizeof(int));
if(arr != NULL) {
// use arr
free(arr);
}

D. int *arr = (int *)vPortFree(10 * sizeof(int));
if(arr != NULL) {
// use arr
pvPortMalloc(arr);
}

Solution

1. Step 1: Allocate correct memory size with pvPortMalloc

   To store 10 integers, allocate 10 times the size of int using pvPortMalloc(10 * sizeof(int)). This ensures enough space.

2. Step 2: Free memory properly with vPortFree

   After using the array, free the memory with vPortFree(arr). Also, check if allocation succeeded by verifying arr != NULL.

3. Final Answer:

   Correct allocation and freeing using pvPortMalloc and vPortFree -> Option B

4. Quick Check:

   Allocate 10 ints with pvPortMalloc, free with vPortFree [OK]

Hint: Multiply size by count in pvPortMalloc, free with vPortFree [OK]

Common Mistakes:

• Allocating only size of one int instead of 10
• Using standard malloc/free instead of pvPortMalloc/vPortFree
• Confusing allocation and free function calls