ui_net_sink 拆分为协议层与平台后端，新增 RemoDispBus 设计文档

2026-09-11 21:25:02 +08:00
parent 2429955d1a
commit d150810587
20 changed files with 1600 additions and 408 deletions
@@ -0,0 +1,52 @@
+/*
+ * 模块名称：UI Network Sink Backend (MCU 实现)
+ * 模块功能：RemoDispBus 服务端在 MCU 端的平台相关操作——
+ *          读取 LVGL 帧缓冲（LCDMEM 数据源）与经 ui_port 注入远端按键
+ * 适用平台：STM32F407ZGTx
+ * 作者：王建锋
+ * 创建日期：2026-09-10
+ * 修改记录：
+ *     2026-09-10  王建锋  创建初始版本（双端共用 ui_net_sink 的平台后端）
+ */
+#include "ui_net_sink_backend.h"
+
+#include <string.h>
+
+#include "ui_port.h"
+
+/*
+ * 函数功能：读取 LVGL 帧缓冲为 1bpp 位图（LCDMEM 数据源）
+ * 入口参数：out      - 输出缓冲（≥ UI_NET_SINK_MONO_SIZE 字节）
+ *          out_size - out 容量（字节）
+ * 返回值：0 - 成功，-1 - 参数或帧缓冲无效
+ * 限定条件：ui_port_init() 已成功
+ * 函数说明：帧缓冲本就是 1bpp（布局与协议一致），直接整帧拷贝
+ */
+int ui_net_sink_get_lcdmem(uint8_t *out, uint32_t out_size)
+{
+    const uint8_t *fb;
+
+    if (out == NULL || out_size < UI_NET_SINK_MONO_SIZE) {
+        return -1;
+    }
+
+    fb = ui_port_get_framebuffer();
+    if (fb == NULL) {
+        return -1;
+    }
+
+    memcpy(out, fb, UI_NET_SINK_MONO_SIZE);
+    return 0;
+}
+
+/*
+ * 函数功能：向 UI 输入队列注入一个远端按键
+ * 入口参数：remo_key - 远端按键码（UI_KEY_* 之一）
+ * 返回值：无
+ * 限定条件：无
+ * 函数说明：缓存后由 keypad 读取回调在下次轮询上报（键码映射在 ui_port 内完成）
+ */
+void ui_net_sink_inject_key(uint8_t remo_key)
+{
+    ui_port_queue_key(remo_key);
+}