133 lines
5.1 KiB
C
133 lines
5.1 KiB
C
/*
|
||
* 模块名称：UI Task
|
||
* 模块功能：UI 主任务，等待网络就绪后初始化显示/菜单/推流并周期刷新
|
||
* 适用平台：STM32F407 系列（LVGL + CH395F 以太网）
|
||
* 作者：王建锋
|
||
* 创建日期：2026-08-30
|
||
* 修改记录：
|
||
* v1.1 2026-09-14 王建锋 新增待机显示页初始化（ui_standby_init，空闲 60s 切入）
|
||
*/
|
||
#include "ui_task.h"
|
||
|
||
#include <string.h>
|
||
|
||
#include "cmsis_os.h"
|
||
#include "sys_events.h"
|
||
|
||
#include "ui_port.h"
|
||
#include "ui_menu.h"
|
||
#include "ui_net_sink.h"
|
||
#include "ui_standby.h"
|
||
#include "sys_clock.h"
|
||
#include "test_config.h" /* TEST_LATENCY_PROBE（链路时延探针编译开关） */
|
||
#include "net_latency_test.h" /* M3 探针：ui_loop（生产循环实测周期） */
|
||
#include "task_watchdog.h"
|
||
|
||
/*
|
||
* 函数功能：待机屏底部时钟提供回调（平台差异：MCU = sys_clock_get_str）
|
||
* 入口参数：buf - 时间串输出缓冲 char *
|
||
* len - buf 容量 size_t
|
||
* 返回值：无
|
||
*/
|
||
static void ui_task_time_cb(char *buf, size_t len) {
|
||
if (sys_clock_get_str(buf, len) == NULL && len > 0u) {
|
||
buf[0] = '\0'; /* 墙钟无效：空串（待机屏时钟行留白） */
|
||
}
|
||
}
|
||
|
||
#define DBG_TAG "[UI_TASK]"
|
||
#include "dbg_log.h"
|
||
|
||
/*
|
||
* 函数功能：等待网络就绪事件
|
||
* 入口参数：无
|
||
* 返回值：无
|
||
* 限定条件：sys_evtHandle 为 NULL 时直接返回
|
||
* 函数说明：无限期等待 SYS_EVT_NET_READY 标志
|
||
*/
|
||
static void ui_task_wait_net_ready(void) {
|
||
if (sys_evtHandle != NULL) {
|
||
/* osFlagsNoClear：就绪位是状态，不能被本任务消费掉（否则其它等待者永不唤醒）。
|
||
* 2026-10-02 台架修复：等待改 100ms 分片 + 每片喂心跳（与 timeSync/netTask/
|
||
* ftpTask 入口同模式）——IWDG 必需掩码含 UI 位，原 osWaitForever 无心跳：
|
||
* IWDG 启动（存储就绪）时网络未必就绪 → 掩码 800ms 不可达 → 停喂 → 复位循环。
|
||
* 100ms 分片 = 抽样窗，纯任务睡眠零队列开销。 */
|
||
for (;;) {
|
||
uint32_t r = osEventFlagsWait(sys_evtHandle, SYS_EVT_NET_READY,
|
||
osFlagsWaitAny | osFlagsNoClear, 100u);
|
||
if ((r & osFlagsError) == 0u) {
|
||
break; /* NET_READY 已置位（状态位，未被消费） */
|
||
}
|
||
task_wd_beat(TASK_WD_UI); /* 看门狗：分片喂心跳（屏障等待态） */
|
||
}
|
||
}
|
||
}
|
||
|
||
/*
|
||
* 函数功能：UI 主任务入口，初始化显示/菜单/推流并进入刷新主循环
|
||
* 入口参数：argument - FreeRTOS 任务参数（未使用） void *
|
||
* 返回值：无
|
||
* 限定条件：FreeRTOS 已启动
|
||
* 函数说明：1. 等待 SYS_EVT_NET_READY 后依次初始化 ui_port/ui_menu/ui_net_sink
|
||
* 2. 主循环周期调用 ui_port_step 与 ui_net_sink_poll 刷新界面
|
||
*/
|
||
void ui_task_func(void *argument) {
|
||
(void)argument;
|
||
|
||
task_wd_bind(TASK_WD_UI); /* FTL 心跳路由：登记本任务句柄（入口一次） */
|
||
|
||
/* 等待网络就绪期间不可能喂狗：本任务此时尚未进入主循环，而就绪位由 netTask 置位。
|
||
* 该段若长期不成立，看门狗会复位——这是期望行为（网络 bring-up 卡死须暴露）。
|
||
* 注意本任务在 required_mask 内，主循环跑起来后须保证每 100ms 窗口内至少喂一次。 */
|
||
DBG_INFO("UI task: started, wait net ready");
|
||
ui_task_wait_net_ready();
|
||
DBG_INFO("UI task: net ready, init port");
|
||
|
||
DBG_INFO("UI task: ui_port_init enter");
|
||
if (ui_port_init() != 0) {
|
||
DBG_ERROR("UI port init: FAIL");
|
||
for (;;) { osDelay(1000); }
|
||
}
|
||
DBG_INFO("UI port init: OK");
|
||
DBG_INFO("UI task: ui_menu_init enter");
|
||
if (ui_menu_init() != 0) {
|
||
DBG_ERROR("UI menu init: FAIL");
|
||
for (;;) { osDelay(1000); }
|
||
}
|
||
DBG_INFO("UI menu init: OK");
|
||
if (ui_standby_init(60000u, ui_task_time_cb) != 0) {
|
||
DBG_ERROR("UI standby init: FAIL");
|
||
} else {
|
||
DBG_INFO("UI standby: ready (idle=60s)");
|
||
}
|
||
if (ui_net_sink_start(UI_NET_SINK_PORT) != 0) {
|
||
DBG_ERROR("UI net sink: start FAIL");
|
||
} else {
|
||
DBG_INFO("UI net sink: started (port %u)", (unsigned)UI_NET_SINK_PORT);
|
||
}
|
||
|
||
#if defined(TEST_LATENCY_PROBE)
|
||
/* M3 探针 ui_loop：主循环实测周期（= LVGL 渲染 + 推流轮询 + osDelay(10)）。
|
||
* 每轮开头先结算"上一轮到此轮"的间隔，再重置标记 → 得到真实循环周期。
|
||
* 单写者（本任务）/单读者（testTask），样本经 lat_probe_add 落静态缓冲。 */
|
||
lat_tmark_t tm_loop;
|
||
uint8_t tm_loop_valid = 0U;
|
||
#endif
|
||
|
||
while (1) {
|
||
#if defined(TEST_LATENCY_PROBE)
|
||
if (tm_loop_valid != 0U) {
|
||
lat_probe_add_seg("ui_loop", lat_mark_us(&tm_loop));
|
||
}
|
||
lat_mark(&tm_loop);
|
||
tm_loop_valid = 1U;
|
||
#endif
|
||
ui_port_step(10);
|
||
ui_net_sink_poll();
|
||
/* 心跳：ui_port_step 内含 LVGL 渲染，单轮耗时可能逼近 10ms 量级；
|
||
* 100ms 抽样窗内可容纳多轮，此埋点足够 */
|
||
task_wd_beat(TASK_WD_UI);
|
||
osDelay(10);
|
||
}
|
||
}
|