嵌入式 Linux 与 RTOS / 系统课时

完成可观测实时控制项目

完成可观测实时控制项目

这节课把周期采样、DMA、任务通信、互斥、超时、统计和低功耗组合成一个最小实时控制项目,并通过 CPU、栈、堆、响应时延和错误计数观测点完成压力与故障验收。

学习目标

  • 组织采样、处理、输出和监控任务之间的数据流与同步关系。
  • 为 CPU、栈、堆、时延和错误建立可持续采集的观测点。
  • 用压力测试和故障测试判断系统是否满足预先定义的实时预算。

先确定最小系统结构

项目采用一个典型闭环:定时器触发 ADC DMA 采样,DMA 完成中断只负责交付缓冲区;处理任务计算结果后通过队列发送给控制任务;控制任务使用互斥量访问共享外设;监控任务周期统计资源和错误;空闲路径负责进入低功耗。

可观测实时控制项目数据流

这套结构有两个关键边界:ISR 只做最短路径的数据交付;共享外设只允许通过一个明确的互斥或单一拥有者访问。这样才能同时控制中断延迟和并发访问风险。

建立任务与通信骨架

下面是片段示例,展示项目核心对象和任务间通信关系。它依赖具体 MCU 的 ADC、DMA、SPI 和低功耗驱动,但 FreeRTOS 对象与调度关系可以直接复用。

c
#include "FreeRTOS.h"
#include "task.h"
#include "queue.h"
#include "semphr.h"
#include <stdint.h>
#include <stdio.h>

typedef struct {
    uint16_t sample;
    TickType_t capture_tick;
} SampleMsg;

typedef struct {
    int32_t output;
    TickType_t capture_tick;
} ControlMsg;

static TaskHandle_t g_sample_task;
static QueueHandle_t g_sample_queue;
static QueueHandle_t g_control_queue;
static SemaphoreHandle_t g_spi_mutex;
static volatile uint16_t g_dma_sample;
static volatile uint32_t g_queue_drop_count;
static volatile uint32_t g_peripheral_error_count;
static volatile TickType_t g_max_latency_ticks;

void adc_dma_complete_isr(uint16_t sample)
{
    BaseType_t high_priority_woken = pdFALSE;

    /* ISR 只保存 DMA 结果并唤醒任务,不在中断里做控制计算。 */
    g_dma_sample = sample;
    vTaskNotifyGiveFromISR(g_sample_task, &high_priority_woken);
    portYIELD_FROM_ISR(high_priority_woken);
}

static void sample_task(void *arg)
{
    (void)arg;
    for (;;) {
        ulTaskNotifyTake(pdTRUE, portMAX_DELAY);

        SampleMsg msg = {
            .sample = g_dma_sample,
            .capture_tick = xTaskGetTickCount()
        };

        if (xQueueSend(g_sample_queue, &msg, 0) != pdPASS) {
            ++g_queue_drop_count;
        }
    }
}

static void processing_task(void *arg)
{
    (void)arg;
    SampleMsg in;
    for (;;) {
        if (xQueueReceive(g_sample_queue, &in, portMAX_DELAY) == pdPASS) {
            ControlMsg out = {
                .output = (int32_t)in.sample - 2048,
                .capture_tick = in.capture_tick
            };
            xQueueSend(g_control_queue, &out, portMAX_DELAY);
        }
    }
}

预期结果

text
DMA completion -> sampling task notified
sample message -> processing queue
control message -> control queue

这不是串口必须打印出的固定日志,而是代码运行时应出现的数据路径。实际样本值、任务切换时刻和队列深度会随硬件与负载变化。

把控制链路的时延量出来

实时系统不能只验证“结果对不对”,还要验证结果是否在截止时间前到达。最简单的方法是在采样时记录 TickType_t,控制任务完成外设写入后计算端到端延迟,并维护最大值。

下面是片段示例,依赖上一段的 ControlMsg、g_control_queue、g_spi_mutex 和统计变量;真实项目把注释位置替换为实际 SPI 驱动调用。

c
static void control_task(void *arg)
{
    (void)arg;
    ControlMsg msg;

    for (;;) {
        if (xQueueReceive(g_control_queue, &msg, portMAX_DELAY) != pdPASS) {
            continue;
        }

        if (xSemaphoreTake(g_spi_mutex, pdMS_TO_TICKS(5)) != pdPASS) {
            ++g_peripheral_error_count;
            continue;
        }

        /* 这里替换为真实 SPI 写入,并确保驱动自身也有超时。 */
        xSemaphoreGive(g_spi_mutex);

        TickType_t latency = xTaskGetTickCount() - msg.capture_tick;
        if (latency > g_max_latency_ticks) {
            g_max_latency_ticks = latency;
        }
    }
}

预期结果

text
max_latency_ticks increases only when a slower end-to-end sample appears
queue_drop_count remains 0 under nominal load

如果 configTICK_RATE_HZ 为 1000,则 1 tick 约等于 1 ms;如果使用更粗的 tick,亚毫秒预算应改用 DWT cycle counter、GPT timer 或芯片高精度计时器,不能用 RTOS tick 代替。

周期采集 CPU、栈与堆

监控任务不应高频运行,它只需要以较低优先级周期采样。CPU 占用可以来自 FreeRTOS run-time stats;栈余量使用 uxTaskGetStackHighWaterMark();堆余量使用 xPortGetFreeHeapSize(),并同时观察 xPortGetMinimumEverFreeHeapSize()。

下面是片段示例,假设已经启用 FreeRTOS run-time stats,并为 vTaskGetRunTimeStats() 提供了运行时间计数源。

c
static void monitor_task(void *arg)
{
    (void)arg;
    char stats[512];

    for (;;) {
        vTaskGetRunTimeStats(stats);

        printf("heap_free=%u heap_min=%u max_latency=%lu drops=%lu periph_err=%lu\n",
               (unsigned)xPortGetFreeHeapSize(),
               (unsigned)xPortGetMinimumEverFreeHeapSize(),
               (unsigned long)g_max_latency_ticks,
               (unsigned long)g_queue_drop_count,
               (unsigned long)g_peripheral_error_count);

        printf("%s\n", stats);
        vTaskDelay(pdMS_TO_TICKS(1000));
    }
}

预期输出

text
heap_free=<HEAP_BYTES> heap_min=<MIN_HEAP_BYTES> max_latency=<TICKS> drops=0 periph_err=0
<TaskName> <RunTimeCounter> <CPUPercent>

<HEAP_BYTES>、<MIN_HEAP_BYTES>、<TICKS> 和 run-time stats 数值取决于工程配置与实际负载。栈高水位应针对关键任务单独采集,因为总堆余量正常并不能证明某个任务没有逼近栈溢出。

给项目设定可验收预算

观测数据只有和预算比较才有意义。可以为项目先定义一组明确门槛,例如:

指标 示例预算 验证方法
控制端到端最大时延 小于 10 ms 记录最大采样到输出延迟
控制任务栈余量 至少 25% 检查 high-water mark
最低历史剩余堆 大于 4 KB xPortGetMinimumEverFreeHeapSize()
正常负载队列丢包 0 观察 g_queue_drop_count
外设超时 0 或低于允许阈值 错误计数器
CPU 持续占用 低于设定上限 run-time stats

预算数字应来自实际控制周期、芯片资源和安全要求,而不是照抄示例。最重要的是在压力前就确定通过条件,否则测试结束后很容易用结果反向修改标准。

做压力与故障验收

压力测试应逐步提高负载,而不是一开始就把所有路径压满。先提高采样频率,再增加通信量和外设访问冲突,持续观察最大时延、队列丢包、栈余量和最低堆余量。如果某个指标开始逼近预算,就记录对应负载点。

故障测试则主动制造 DMA 超时、SPI 无响应、消费者任务短时阻塞和队列拥塞,确认错误计数上升、局部恢复执行、关键任务仍保持调度。如果故障升级到复位,启动后必须能读取上一次复位原因。

低功耗也要纳入验收。仅在没有更高优先级任务就绪、下一次唤醒时间已知且外设状态允许时进入 sleep;唤醒后重新观察控制时延,确认低功耗切换没有把第一笔采样推迟到预算之外。

项目达到可交付状态的标志,不只是功能跑通,而是正常负载下关键预算有余量,压力增加时能看到指标如何恶化,故障发生时能看到保护路径如何动作,并且每次异常都能留下足够的诊断数据。

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

目录与阅读设置

阅读设置

17

记录一个想法

完成可观测实时控制项目

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

登录哪都通