嵌入式 Linux 与 RTOS / 系统课时

用静态分配消除运行期申请

用静态分配消除运行期申请

动态 API 把对象所需内存交给堆在运行期申请;静态 API 则要求应用提前提供控制块和数据区。本篇会把任务、队列、信号量和软件定时器全部改成显式存储,并说明如何验证系统不再依赖 FreeRTOS 动态分配。

学习目标

  • 能为任务、队列、信号量和软件定时器准备静态存储并调用对应静态 API。
  • 理解静态分配固定的是对象数量、容量和生命周期,而不是自动减少内存占用。
  • 能关闭 FreeRTOS 动态分配并补齐 Idle 和 Timer Service 任务所需的静态存储。

静态分配到底固定了什么

以任务为例,动态创建时,内核需要为 TCB 和任务栈取得内存;静态创建时,这两块存储都由应用提供。队列也类似:既要有队列控制块,又要有保存元素的数据区。信号量底层使用队列机制,但只需要控制块;软件定时器则需要一个定时器控制块。

静态 API 与显式存储的对应关系

静态分配的主要收益是创建对象时不再发生堆申请失败,也不会因为这些对象反复创建销毁而造成 FreeRTOS 堆碎片。代价是容量需要提前决定,即使某个对象暂时不用,对应存储也仍然被保留。

对象 静态 API 应用提供的主要存储
任务 xTaskCreateStatic StaticTask_t、StackType_t[]
队列 xQueueCreateStatic StaticQueue_t、元素存储数组
二值信号量 xSemaphoreCreateBinaryStatic StaticSemaphore_t
软件定时器 xTimerCreateStatic StaticTimer_t

关闭 FreeRTOS 动态分配

要让 FreeRTOS 内核对象完全不走动态堆,可在 FreeRTOSConfig.h 中启用静态分配并关闭动态分配。使用软件定时器时还需要启用 Timer Service。

c
#define configSUPPORT_STATIC_ALLOCATION 1
#define configSUPPORT_DYNAMIC_ALLOCATION 0
#define configUSE_TIMERS 1

这段配置的生效行为是:FreeRTOS 内核对象不能再通过动态创建 API 取得堆内存。验证时应确认工程能够正常编译,并检查代码中没有继续调用 xTaskCreate、xQueueCreate、xTimerCreate 等动态版本。

用静态 API 创建四类对象

下面示例同时创建一个任务、一个队列、一个二值信号量和一个周期软件定时器。示例假设板级工程已经把标准输出重定向到 UART、半主机或其他可见终端。

c
#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 (;;) {
    }
}

预期输出

text
worker value=1
worker value=2
worker value=3
...

每行大约相隔 1 秒;实际启动时刻取决于硬件初始化和调度器启动时间。vApplicationGetIdleTaskMemory() 为 Idle 任务提供控制块和栈;启用软件定时器后,vApplicationGetTimerTaskMemory() 同样为 Timer Service 任务提供控制块和栈。

静态分配不等于更省内存

静态 API 不会自动减少 TCB、队列缓冲区或任务栈的尺寸。因为所有容量都提前保留,峰值 RAM 往往直接由设计值决定。真正的工程收益是可预测:对象数量、队列长度和任务栈能在设计阶段审查,而不是设备运行后才发现堆耗尽。

如果对象确实需要随业务动态增减,强行全部静态化会让容量设计更僵硬。此时可以保留动态分配,但把长期存在、数量固定且关键的任务与通信对象优先改为静态创建。对于要求运行期零申请的系统,则应关闭 configSUPPORT_DYNAMIC_ALLOCATION,并继续审计 C 库和第三方组件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用静态分配消除运行期申请

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通