嵌入式 Linux 与 RTOS / 系统课时
用静态分配消除运行期申请
用静态分配消除运行期申请
动态 API 把对象所需内存交给堆在运行期申请;静态 API 则要求应用提前提供控制块和数据区。本篇会把任务、队列、信号量和软件定时器全部改成显式存储,并说明如何验证系统不再依赖 FreeRTOS 动态分配。
学习目标
- 能为任务、队列、信号量和软件定时器准备静态存储并调用对应静态 API。
- 理解静态分配固定的是对象数量、容量和生命周期,而不是自动减少内存占用。
- 能关闭 FreeRTOS 动态分配并补齐 Idle 和 Timer Service 任务所需的静态存储。
静态分配到底固定了什么
以任务为例,动态创建时,内核需要为 TCB 和任务栈取得内存;静态创建时,这两块存储都由应用提供。队列也类似:既要有队列控制块,又要有保存元素的数据区。信号量底层使用队列机制,但只需要控制块;软件定时器则需要一个定时器控制块。

静态分配的主要收益是创建对象时不再发生堆申请失败,也不会因为这些对象反复创建销毁而造成 FreeRTOS 堆碎片。代价是容量需要提前决定,即使某个对象暂时不用,对应存储也仍然被保留。
| 对象 | 静态 API | 应用提供的主要存储 |
|---|---|---|
| 任务 | xTaskCreateStatic |
StaticTask_t、StackType_t[] |
| 队列 | xQueueCreateStatic |
StaticQueue_t、元素存储数组 |
| 二值信号量 | xSemaphoreCreateBinaryStatic |
StaticSemaphore_t |
| 软件定时器 | xTimerCreateStatic |
StaticTimer_t |
关闭 FreeRTOS 动态分配
要让 FreeRTOS 内核对象完全不走动态堆,可在 FreeRTOSConfig.h 中启用静态分配并关闭动态分配。使用软件定时器时还需要启用 Timer Service。
#define configSUPPORT_STATIC_ALLOCATION 1
#define configSUPPORT_DYNAMIC_ALLOCATION 0
#define configUSE_TIMERS 1这段配置的生效行为是:FreeRTOS 内核对象不能再通过动态创建 API 取得堆内存。验证时应确认工程能够正常编译,并检查代码中没有继续调用 xTaskCreate、xQueueCreate、xTimerCreate 等动态版本。
用静态 API 创建四类对象
下面示例同时创建一个任务、一个队列、一个二值信号量和一个周期软件定时器。示例假设板级工程已经把标准输出重定向到 UART、半主机或其他可见终端。
#include <stdint.h>
#include <stdio.h>
#include "FreeRTOS.h"
#include "task.h"
#include "queue.h"
#include "semphr.h"
#include "timers.h"
#define WORKER_STACK_WORDS 256
#define QUEUE_LENGTH 4
/* 任务、队列、信号量和定时器的全部对象存储都由应用持有。 */
static StaticTask_t xWorkerTCB;
static StackType_t xWorkerStack[WORKER_STACK_WORDS];
static StaticQueue_t xQueueControlBlock;
static uint8_t ucQueueStorage[QUEUE_LENGTH * sizeof(uint32_t)];
static StaticSemaphore_t xSemControlBlock;
static StaticTimer_t xTimerControlBlock;
static QueueHandle_t xQueue;
static SemaphoreHandle_t xSemaphore;
static TimerHandle_t xTimer;
static void vWorkerTask(void *pvParameters)
{
uint32_t value;
(void)pvParameters;
for (;;) {
if (xQueueReceive(xQueue, &value, portMAX_DELAY) == pdPASS) {
if (xSemaphoreTake(xSemaphore, portMAX_DELAY) == pdPASS) {
printf("worker value=%lu\n", (unsigned long)value);
}
}
}
}
static void vTimerCallback(TimerHandle_t xTimerHandle)
{
static uint32_t value = 0;
(void)xTimerHandle;
value++;
/* Timer 回调运行在 Timer Service 任务上下文,可以使用普通任务级 API。 */
(void)xQueueSend(xQueue, &value, 0);
(void)xSemaphoreGive(xSemaphore);
}
/* 关闭动态分配后,内核的 Idle 任务也必须取得静态 TCB 和栈。 */
void vApplicationGetIdleTaskMemory(
StaticTask_t **ppxIdleTaskTCBBuffer,
StackType_t **ppxIdleTaskStackBuffer,
configSTACK_DEPTH_TYPE *pulIdleTaskStackSize)
{
static StaticTask_t xIdleTaskTCB;
static StackType_t xIdleTaskStack[configMINIMAL_STACK_SIZE];
*ppxIdleTaskTCBBuffer = &xIdleTaskTCB;
*ppxIdleTaskStackBuffer = xIdleTaskStack;
*pulIdleTaskStackSize = configMINIMAL_STACK_SIZE;
}
/* 启用软件定时器后,Timer Service 任务同样需要静态存储。 */
void vApplicationGetTimerTaskMemory(
StaticTask_t **ppxTimerTaskTCBBuffer,
StackType_t **ppxTimerTaskStackBuffer,
configSTACK_DEPTH_TYPE *pulTimerTaskStackSize)
{
static StaticTask_t xTimerTaskTCB;
static StackType_t xTimerTaskStack[configTIMER_TASK_STACK_DEPTH];
*ppxTimerTaskTCBBuffer = &xTimerTaskTCB;
*ppxTimerTaskStackBuffer = xTimerTaskStack;
*pulTimerTaskStackSize = configTIMER_TASK_STACK_DEPTH;
}
int main(void)
{
TaskHandle_t xWorker;
xQueue = xQueueCreateStatic(
QUEUE_LENGTH,
sizeof(uint32_t),
ucQueueStorage,
&xQueueControlBlock);
xSemaphore = xSemaphoreCreateBinaryStatic(&xSemControlBlock);
xTimer = xTimerCreateStatic(
"pulse",
pdMS_TO_TICKS(1000),
pdTRUE,
NULL,
vTimerCallback,
&xTimerControlBlock);
xWorker = xTaskCreateStatic(
vWorkerTask,
"worker",
WORKER_STACK_WORDS,
NULL,
tskIDLE_PRIORITY + 1,
xWorkerStack,
&xWorkerTCB);
/* 任一创建失败都不进入调度器,便于启动阶段直接发现容量配置问题。 */
if ((xQueue == NULL) || (xSemaphore == NULL) ||
(xTimer == NULL) || (xWorker == NULL)) {
return 1;
}
if (xTimerStart(xTimer, 0) != pdPASS) {
return 1;
}
vTaskStartScheduler();
for (;;) {
}
}预期输出
worker value=1
worker value=2
worker value=3
...每行大约相隔 1 秒;实际启动时刻取决于硬件初始化和调度器启动时间。vApplicationGetIdleTaskMemory() 为 Idle 任务提供控制块和栈;启用软件定时器后,vApplicationGetTimerTaskMemory() 同样为 Timer Service 任务提供控制块和栈。
静态分配不等于更省内存
静态 API 不会自动减少 TCB、队列缓冲区或任务栈的尺寸。因为所有容量都提前保留,峰值 RAM 往往直接由设计值决定。真正的工程收益是可预测:对象数量、队列长度和任务栈能在设计阶段审查,而不是设备运行后才发现堆耗尽。
如果对象确实需要随业务动态增减,强行全部静态化会让容量设计更僵硬。此时可以保留动态分配,但把长期存在、数量固定且关键的任务与通信对象优先改为静态创建。对于要求运行期零申请的系统,则应关闭 configSUPPORT_DYNAMIC_ALLOCATION,并继续审计 C 库和第三方组件。