feat(屏板): 帧 B 组帧 + 中断起发 TX DMA + 按键队列 + 离线判定（批 2）
批 2 五项全部落地（docs/任务规划/屏板链路.md §3）： - 2-1 sb_link_frame_update()：uiTask 渲染后按需组帧，不留 3200 B 影子 副本，直接拿活显存与帧内点阵段 memcmp；组完自校验，过了才置 ready。 静态 4208 B 帧缓冲实测落 RW_IRAM1（0x20006d98），不在 CCM。 - 2-2 空闲中断校完 6 B 召唤帧直接点 TX DMA（sb_tx_kick），不排队不攒批； busy 期间再来的召唤丢帧并计数，绝不叠发（屏板收帧一次 IDLE 一包）。 - 2-3 按键走环形队列（中断入、任务出），uiTask 按 §4.3 表映射 UI_KEY_* 后调 ui_port_queue_key；9/10（RESET/FACTORY）按决策四先丢弃并留痕。 - 2-4 HAL_UART_TxCpltCallback 在 rs485.c 加第三行转发（三个全局回调 落点收一处，防日后重复定义）；busy 冻结帧缓冲，错误中断按 gState 收拾被打断的 TX，防残留 busy 把链路永久锁死。 - 2-5 连续 >=10 s 无有效召唤帧才判离线（不按 500 ms——屏板约 5000 s 自复位有 1 s 空窗），恢复即清标志；CRC 错帧静默丢弃并计数。 实测：台架 40 s（PC 顶替屏板，--key-fixed 2 持续改画面）rx=143 ok=143 keys=143 crc=0 / tx=143 done=143 drop=0 abor=0 fb=144 bad=0；脚本一停 10 s 准点出 OFFLINE。组帧耗时 509 µs 典型 / 709 µs 峰值——原 0.3 ms 判据系估算，已按实测在规划文档改口为 1 ms 并给出压降路径（未做）。 附带：rs485_on_rx 补 CODE-RULE-09 文档块（本轮改 rs485.c 触发整文件 重扫被拦）；CRC 循环计数改 32 位（消掉 ARMCC 每轮 UXTH）；bench 脚本 加 --reply/--key-fixed/--dump，并写明 CH340 收不了 700 kbaud 连续流、 --reply 收不全 4208 B 不是固件问题。 主机单测 146/146 PASSED（+65）；Keil 0 错误 0 警告；ci_local 全绿 （SKIP=nested-comment，worktree 限制，主树脚本另查 0 新发）。 Code=238,936 B / RW_IRAM1 65.5 % / RW_CCM 87.9 %。
This commit is contained in:
+65
-3
@@ -58,7 +58,7 @@
|
||||
#include "net_latency_test.h" /* M3 探针：ui_loop（生产循环实测周期） */
|
||||
#include "task_watchdog.h"
|
||||
#include "task_prof.h" /* P2 常开探针：循环周期 / 工作耗时 / 推流往返 */
|
||||
#include "sb_link.h" /* 屏板链路：sb_link_poll()（批 1 只上报统计，批 2 在此组帧） */
|
||||
#include "sb_link.h" /* 屏板链路：帧 B 组帧 / 按键出队 / 统计与离线判定（批 2） */
|
||||
|
||||
/*
|
||||
* 函数功能：待机屏底部时钟提供回调（平台差异：MCU = sys_clock_get_str）
|
||||
@@ -396,6 +396,33 @@ static void ui_task_wait_net_ready(void) {
|
||||
}
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能：把屏板键号映射为 UI 键码
|
||||
* 入口参数：board_key - 屏板帧 A 的 key 字节（1~10，语义见 docs/任务规划/屏板链路.md §4.3）
|
||||
* 返回值：UI_KEY_* 之一；0 = 不映射（无键 / RESET / FACTORY / 屏板无物理入口的 5、6）
|
||||
* 限定条件：只在 uiTask 上下文调用（ui_port_queue_key 的契约是输入子系统已初始化）
|
||||
* 函数说明：1. 屏板 key_configs[] 只有 **7 项**，可达值仅 1/2/3/4/7/8/9——别按屏板 readme
|
||||
* 的 8 键表实现（5/6 = ADD/DEC 在实物上没有入口，永远收不到）。
|
||||
* 2. 9（RESET）/10（FACTORY）属决策四待裁定项：**先丢弃并留痕**，不要擅自
|
||||
* 映射成参考机的 F1 / F1+ENT——否则现场按一下"复位"会把菜单弹到未知页面，
|
||||
* 而且那种误映射极难从现象反推回映射表。
|
||||
*/
|
||||
static uint8_t ui_task_board_key_map(uint8_t board_key) {
|
||||
switch (board_key) {
|
||||
case 1u: return UI_KEY_ENTER;
|
||||
case 2u: return UI_KEY_UP;
|
||||
case 3u: return UI_KEY_DOWN;
|
||||
case 4u: return UI_KEY_ESC;
|
||||
case 7u: return UI_KEY_LEFT;
|
||||
case 8u: return UI_KEY_RIGHT;
|
||||
default: return 0u;
|
||||
}
|
||||
}
|
||||
|
||||
/* 组帧失败只留痕一次：组帧每 10 ms 一次，每拍打一行会把控制台冲爆（120 s 就 1.2 万行），
|
||||
* 而 BSP_ERR_PARAM/BSP_ERR_STATE 是配置类错误，出现一次就是一直出现，一行足够定位。 */
|
||||
static uint8_t s_sb_frame_err_logged;
|
||||
|
||||
/*
|
||||
* 函数功能：UI 主任务入口，初始化显示/菜单/推流并进入刷新主循环
|
||||
* 入口参数：argument - FreeRTOS 任务参数（未使用） void *
|
||||
@@ -494,6 +521,40 @@ void ui_task_func(void *argument) {
|
||||
* （UI_数据供给设计说明.md §5.1 单写者同上下文的前提就在这儿） */
|
||||
ui_data_feed_tick();
|
||||
ui_port_step(UI_TASK_TICK_MS);
|
||||
|
||||
/* ---- 屏板链路（批 2）：帧 B 组帧 + 按键上行，全在任务上下文 ----
|
||||
* 组帧紧跟渲染：本轮画出来的就是本轮组进去的那一帧。
|
||||
* 排在推流往返**之前**，是因为那个往返最坏能等 ≈4 s（LCDMEM 应答 3204 B），
|
||||
* 排在它后面会让屏板画面跟着网络一起卡（同一份显存、两个出口，出口不能互相拖）。
|
||||
* 显存直接取活帧缓冲：不留 3200 B 影子副本，sb_link 内部与帧里的点阵段 memcmp。
|
||||
* LED 掩码暂传 0（批 3 才落状态灯映射表），故 info[0..3] 现恒为 0。 */
|
||||
{
|
||||
bsp_err_t sb_ret = sb_link_frame_update(ui_port_get_framebuffer(), 0u);
|
||||
uint8_t board_key;
|
||||
|
||||
/* BSP_ERR_BUSY 是常态（上一帧还在 59.6 ms 的发送窗口里），不必留痕；
|
||||
* 其余失败打一行即可（见 s_sb_frame_err_logged 的说明）。 */
|
||||
if ((sb_ret != BSP_OK) && (sb_ret != BSP_ERR_BUSY) &&
|
||||
(s_sb_frame_err_logged == 0u)) {
|
||||
s_sb_frame_err_logged = 1u;
|
||||
DBG_ERROR("screenlink frame update ret=%d", sb_ret);
|
||||
}
|
||||
|
||||
/* 逐键必到：一次取一个，直到队列空。9/10 不映射（决策四待定），丢弃并留痕。
|
||||
* 走 ui_port_queue_key 而不是 ui_net_sink_inject_key：后者只是 7003 后端
|
||||
* 对同一个函数的转发（见 ui_net_sink_backend_mcu.c），多绕一层还得让
|
||||
* App 去 include 推流后端头，没必要。两条入口最终进的是同一个输入队列。 */
|
||||
while ((board_key = sb_link_key_take()) != 0u) {
|
||||
uint8_t ui_key = ui_task_board_key_map(board_key);
|
||||
if (ui_key != 0u) {
|
||||
ui_port_queue_key(ui_key);
|
||||
} else {
|
||||
DBG_INFO("board key %u unmapped (RESET/FACTORY pending decision)",
|
||||
(unsigned)board_key);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/* 心跳**先于**推流往返发出（判读口径 docs/子系统设计/看门狗设计说明.md §11.3）：UI 心跳测的是
|
||||
* "UI 自身被调度到了"，而非"netTask 回执快慢"。原写法心跳在 sink 之后，
|
||||
* 致实测 uiw≈uis≈50ms（心跳被 netTask 往返主导）。提到往返之前后，
|
||||
@@ -511,9 +572,10 @@ void ui_task_func(void *argument) {
|
||||
ui_net_sink_poll();
|
||||
task_prof_exit(TASK_PROF_UI_SINK);
|
||||
|
||||
/* 屏板链路统计上报（内部自分频，5 s 一次、只在计数有变化时打一行）。
|
||||
/* 屏板链路统计上报与离线判定（内部自分频，5 s 一次、只在计数有变化时打一行）。
|
||||
* 放在推流段之后：它只是读一份快照 + 偶尔一行日志，不进推流往返的耗时统计。
|
||||
* 批 2 的 2-1 会把帧 B 组帧接到这里（显存/LED 变化时组帧），届时仍在 `uiTask` 上下文。 */
|
||||
* 组帧与注键在渲染之后就做完了（见上），这里只剩"看一眼"——离线判定要求每拍都看，
|
||||
* 所以它不跟着 5 s 的上报周期走。 */
|
||||
sb_link_poll(osKernelGetTickCount());
|
||||
|
||||
/* 单轮工作耗时（不含 osDelay）：与循环周期对比即得"调度延迟" */
|
||||
|
||||
Reference in New Issue
Block a user