Cortex-M4 裸机固件分频时间片调度与模块化重构方案

static void Sched_Run(void)
{
    uint32_t currentTick = PlatformTime_GetMs();

    /* Level 0: 1 ms 高频输入检测 */
    if ((uint32_t)(currentTick - s_lastTick1ms) >= 1U)
    {
        s_lastTick1ms = currentTick;
        AppButtons_Process();
        AppController_Process();
    }

    /* Level 1: 10 ms 测控解算与报警节拍 */
    if ((uint32_t)(currentTick - s_lastTick10ms) >= 10U)
    {
        s_lastTick10ms = currentTick;
        AppAd7190_Process();
        AppTest_Process();
        Buzzer_Process();
    }

    /* Level 2: 100 ms 慢速状态采集 */
    if ((uint32_t)(currentTick - s_lastTick100ms) >= 100U)
    {
        s_lastTick100ms = currentTick;
        BatteryAdc_Process();
        DirAdc_Process();
        AppState_Process();
    }

    /* Level 3: 非阻塞背景分片推进（LCD 条带 DMA 收尾/提交 + Flash 状态轮询） */
    LcdSt7789_Process();
    AppUi_Process();
    AppRecordStore_Process();

    /* 主循环唯一安全喂狗点 */
    Iwdg_Feed();
}

typedef struct
{
    void (*OnEnter)(void);                                      /* 进入页面时初始化局部状态 */
    bool (*OnEvent)(const AppEvent *event);                     /* 处理按键/系统事件，返回 true 表示已消费 */
    void (*OnDrawStrip)(uint16_t stripY, uint16_t stripHeight); /* 绘制当前 8 行条带内的页面内容 */
    void (*OnExit)(void);                                       /* 离开页面时清理或触发保存 */
} UiPageInterface;

static const UiPageInterface *s_currentPage = NULL;
static bool s_waitReleaseLatch = false;

void UiRouter_Switch(const UiPageInterface *newPage)
{
    if ((newPage == NULL) || (newPage == s_currentPage))
    {
        return;
    }
    if (s_currentPage != NULL && s_currentPage->OnExit != NULL)
    {
        s_currentPage->OnExit();
    }
    s_currentPage = newPage;
    /* 跨页防误触锁存：切页后必须等待所有物理按键松开，才允许新页面响应下一次按键 */
    s_waitReleaseLatch = true;
    if (s_currentPage->OnEnter != NULL)
    {
        s_currentPage->OnEnter();
    }
}

typedef enum
{
    MENU_TYPE_SUBPAGE = 0,   /* 子菜单跳转入口 */
    MENU_TYPE_INT_RANGE,     /* 整数范围步进调节（如背光亮度、归零时间） */
    MENU_TYPE_ENUM_CYCLE,    /* 枚举列表循环切换（如单位、测试模式、语言） */
    MENU_TYPE_ACTION_CONFIRM /* 动作二次确认弹窗（如恢复默认设置） */
} MenuItemType;

typedef struct
{
    const char   *label;           /* 菜单项标签（或三语词条 ID） */
    MenuItemType  type;            /* 控件类型 */
    void         *boundValue;      /* 绑定的设置变量指针 */
    int32_t       minValue;        /* 最小值 */
    int32_t       maxValue;        /* 最大值 */
    int32_t       stepValue;       /* 步进值 */
    const char  **enumDisplayList; /* 枚举显示文本表 */
    void        (*onChanged)(void);/* 修改即时生效回调 */
} MenuItemConfig;

void Menu_DrawStrip(const MenuItemConfig *items, uint8_t count, uint8_t focusIndex,
                    uint16_t stripY, uint16_t stripHeight)
{
    for (uint8_t i = 0; i < count; i++)
    {
        int16_t itemY = (int16_t)(MENU_TOP_OFFSET + i * MENU_ITEM_HEIGHT);
        /* 条带裁剪：仅当菜单项垂直区间落在当前条带内时才执行绘制 */
        if ((itemY + MENU_ITEM_HEIGHT <= (int16_t)stripY) ||
            (itemY >= (int16_t)(stripY + stripHeight)))
        {
            continue;
        }
        bool isFocus = (i == focusIndex);
        /* 在条带画布中渲染菜单文本、反色高亮框与当前绑定数值 */
        Canvas_DrawMenuItem(items[i].label, itemY, isFocus);
    }
}

typedef enum
{
    EVT_NONE = 0,
    EVT_KEY_CLICK,       /* 参数: KeyID */
    EVT_KEY_LONG_PRESS,  /* 参数: KeyID */
    EVT_KEY_RELEASE_ALL, /* 全部按键物理松开 */
    EVT_DATA_ALARM,      /* 参数: 告警方向与数值 */
    EVT_RECORD_SAVED,    /* 参数: 记录槽位或状态码 */
    EVT_BATTERY_LOW,     /* 参数: 剩余电量百分比 */
    EVT_CALIB_DONE       /* 参数: 标定结果状态码 */
} AppEventId;

typedef struct
{
    AppEventId id;
    uint16_t   param1;
    uint32_t   param2;
} AppEvent;

#define EVENT_QUEUE_CAPACITY (16U)

typedef struct
{
    AppEvent buffer[EVENT_QUEUE_CAPACITY];
    uint8_t  head;
    uint8_t  tail;
    uint8_t  count;
} EventQueue;

static EventQueue s_eventQueue;

bool AppEvent_Post(AppEventId id, uint16_t param1, uint32_t param2)
{
    if (s_eventQueue.count >= EVENT_QUEUE_CAPACITY)
    {
        return false; /* 队列满，丢弃并报警 */
    }
    s_eventQueue.buffer[s_eventQueue.tail].id = id;
    s_eventQueue.buffer[s_eventQueue.tail].param1 = param1;
    s_eventQueue.buffer[s_eventQueue.tail].param2 = param2;
    s_eventQueue.tail = (uint8_t)((s_eventQueue.tail + 1U) % EVENT_QUEUE_CAPACITY);
    s_eventQueue.count++;
    return true;
}

bool AppEvent_Poll(AppEvent *outEvent)
{
    if ((s_eventQueue.count == 0U) || (outEvent == NULL))
    {
        return false;
    }
    *outEvent = s_eventQueue.buffer[s_eventQueue.head];
    s_eventQueue.head = (uint8_t)((s_eventQueue.head + 1U) % EVENT_QUEUE_CAPACITY);
    s_eventQueue.count--;
    return true;
}