wandering1
c936441c83
本轮把"自研代码落在门禁之外"的口子收掉，同时落地 LVGL 特性裁剪与 L3 保护定值/元件框架。 门禁（.pre-commit-config.yaml，26 个钩子） - 新增 scripts/check_lv_conf_sync.py + 钩子 lv-conf-sync：比对两份 lv_conf.h 的**生效值**（未定义则取 lv_conf_internal.h 兜底默认）， 抓 MISMATCH / LVGL 不认的宏名 / 同文件重复定义 - 顶层 exclude 删掉 simulator/：其下 21 个 tracked 文件全是本项目自研 代码，生成物（build/、SDL2/、tests/ref/、shot*）已在 .gitignore； doc-links 的 exclude 同步删除 - lv-conf-sync 的 files: 覆盖两端配置 → 只改 simulator/lv_conf.h 也触发 （pre-commit 4.x 已移除 always: true，实测只告警并跳过，无兜底开关） - 新增 prot-set-unit-test / prot-elm-unit-test 两个主机侧单测钩子 - S11(2.3.5) 判定细化：禁的是"用路径找文件"，尖括号系统头带子目录 （如 <sys/stat.h>）不再误报；全仓库复核仅 2 处项目代码判定变化 模拟器代码整改（纳入钩子后暴露，全部修代码而非豁免） - cppcheck 4 处：sim_syslog.c 判空分支内解引用 p_epoch（真实 bug）、 2 处 struct tm 未初始化、1 处指针可加 const - coding-standard 61 处：44 处函数左大括号并到右括号同行、8 处补函数 注释、3 处补文件头注释块、2 处 __ 前缀保护宏改 XXX_H、2 处 sprintf 改 snprintf（写入字节数与原来完全一致） LVGL 特性裁剪（F-1/F-2/F-3） - 两端 lv_conf.h 对齐同一特性子集：删 26 个 LVGL 9.3 不存在的选项名、 3 处重复定义，10 项靠默认值隐式生效的改为显式固化 - 实测对镜像体积中性；价值在防漂移，且模拟器 golden 回归跑的正是固件 实际编译的配置 L3 软件侧 - App/algo/prot_set.* Q10 定值模型（范围校验 / 整表 all-or-nothing / 校验和封存-自检-闭锁）+ prot_elm.* 通用"滞回+定时限"元件框架 7 实例 - test/host/prot_set、test/host/prot_elm 主机侧单测；uvprojx 挂载两处 文档同步 - pre-commit使用说明：§2.8 S11 口径、§2.15 lv-conf-sync 详解、新增 §5.5 复盘（教训：exclude 只写真正不该进钩子的路径） - AGENTS.md、UI_设计架构 §1.4 第 10 条、RAM 分析、审查报告刷新与销项 验证 - @build BUILD_OK 0/0（Code=194276 RO=15872 RW=876 ZI=139892） - 模拟器重建：菜单 8 状态像素逐字节一致（池 5368 B）、11 内容页黄金参考 全过（往返 5448 B）、remo sink 0/25600 位差异、--logtest/--cfgtest PASS - 全仓库 cppcheck / coding-standard / no-mojibake --all-files 全过 - check_doc_links --all 129/0；check_mem_numbers --check 内存数字一致 - 端到端：往 simulator/lv_conf.h 注入一行漂移 → 钩子 FAIL（exit 1）
51 lines
1.7 KiB
C
51 lines
1.7 KiB
C
/*
|
||
* 模块名称：Simulator Display Port (SDL2 模拟器端口)
|
||
* 模块功能：为 PC 模拟器提供 LVGL SDL2 显示与键盘输入端口
|
||
* 适用平台：Windows / Linux / macOS (SDL2)
|
||
* 说明：替代 MCU 端的 ui_port.c，用于 PC 上 UI 开发与调试
|
||
*/
|
||
#ifndef SIM_PORT_H
|
||
#define SIM_PORT_H
|
||
|
||
#include <stdint.h>
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/*
|
||
* 函数功能：初始化 SDL2 显示窗口与键盘输入设备
|
||
* 入口参数：hor_res - 水平分辨率 int32_t
|
||
* ver_res - 垂直分辨率 int32_t
|
||
* 返回值：0 - 成功，-1 - 失败
|
||
* 限定条件：lv_init() 已调用
|
||
* 函数说明：创建 SDL 窗口、键盘输入设备及默认输入组
|
||
*/
|
||
int sim_port_init(int32_t hor_res, int32_t ver_res);
|
||
|
||
/*
|
||
* 函数功能：获取 SDL 显示设备句柄
|
||
* 入口参数：无
|
||
* 返回值：显示设备指针 lv_display_t * 可能为 NULL
|
||
* 限定条件：sim_port_init() 已成功调用
|
||
*/
|
||
void *sim_port_get_display(void);
|
||
|
||
/*
|
||
* 函数功能：读取当前屏幕内容并转换为 1bpp 单色位图
|
||
* 入口参数：buf - 输出缓冲（调用方分配，≥ 宽*高/8 字节）
|
||
* buf_size - buf 容量（字节）
|
||
* 返回值：0 - 成功，-1 - 失败
|
||
* 限定条件：sim_port_init() 已成功；须在 SDL 所属线程（主循环线程）调用
|
||
* 函数说明：经 SDL_RenderReadPixels 读回屏幕实际呈现的 ARGB8888 像素，
|
||
* 按红通道阈值 128 判白(=1/墨)/黑(=0)，打包为 1bpp MSB-first，
|
||
* 与 MCU 端 ui_port_get_framebuffer 的 1bpp 布局一致
|
||
*/
|
||
int sim_port_get_screen_mono(uint8_t *buf, uint32_t buf_size);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* SIM_PORT_H */
|