门禁扩容：新增 lv-conf-sync、simulator/ 纳入全部钩子；含 L3 定值/元件框架落地
本轮把"自研代码落在门禁之外"的口子收掉，同时落地 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）
This commit is contained in:
+55
-38
@@ -1,4 +1,12 @@
|
||||
/**
|
||||
* 模块名称：PC 模拟器入口（simulator/main.c）
|
||||
* 模块功能：在 PC 上以 SDL2 跑**与固件同一套** UI 源码，提供窗口调试与多种无头自检模式
|
||||
* 适用平台：Windows（CMake + SDL2）
|
||||
* 作者：王建锋
|
||||
* 创建日期：2026-08-31
|
||||
* 修改记录：
|
||||
* v1.0 2026-08-31 王建锋 创建：基于 lv_port_pc_vscode 适配
|
||||
*
|
||||
* @file main.c
|
||||
* @brief LVGL 模拟器入口 — 160x160 1bpp 单色菜单 UI
|
||||
* @note 基于 lv_port_pc_vscode 适配，用于 PC 上 UI 开发与调试
|
||||
@@ -69,30 +77,35 @@
|
||||
static uint8_t g_shot_buf[SIM_SCREEN_W * SIM_SCREEN_H / 8];
|
||||
|
||||
/*
|
||||
* @brief 离屏截图用空 delay 回调
|
||||
* @note 默认 lv_delay_ms 会忙等 tick 前进，但离屏渲染时 tick 不会在等待期间推进，
|
||||
* 导致死循环挂死。window 模式经 SDL 设了真实 delay，离屏这里用空实现代替。
|
||||
* 函数功能：离屏截图用的空 delay 回调
|
||||
* 入口参数：ms - 请求延时的毫秒数（未使用） uint32_t
|
||||
* 返回值：无
|
||||
* 说明：默认 lv_delay_ms 会忙等 tick 前进，但离屏渲染时 tick 不会在等待期间推进，
|
||||
* 导致死循环挂死。window 模式经 SDL 设了真实 delay，离屏这里用空实现代替。
|
||||
*/
|
||||
static void shot_delay_cb(uint32_t ms)
|
||||
{
|
||||
static void shot_delay_cb(uint32_t ms) {
|
||||
(void)ms;
|
||||
}
|
||||
|
||||
/*
|
||||
* @brief 离屏截图 flush 回调（不写真实设备，直接标记就绪）
|
||||
* 函数功能：离屏截图 flush 回调（不写真实设备，直接标记就绪）
|
||||
* 入口参数：disp - LVGL 显示对象 lv_display_t *
|
||||
* area - 刷新区域（未使用） const lv_area_t *
|
||||
* color_p - 像素缓冲（未使用） uint8_t *
|
||||
* 返回值：无
|
||||
*/
|
||||
static void shot_flush_cb(lv_display_t * disp, const lv_area_t * area, uint8_t * color_p)
|
||||
{
|
||||
static void shot_flush_cb(lv_display_t * disp, const lv_area_t * area, uint8_t * color_p) {
|
||||
(void)area;
|
||||
(void)color_p;
|
||||
lv_display_flush_ready(disp);
|
||||
}
|
||||
|
||||
/*
|
||||
* 键序列字符 → LVGL 键值（非键字符返回 0 = 忽略）
|
||||
* 函数功能：键序列字符 → LVGL 键值映射（--keys 无头回归用）
|
||||
* 入口参数：c - 键序列字符（u=↑ d=↓ l=← r=→ e=确认 s=返回） char
|
||||
* 返回值：LVGL 键值；非键字符返回 0 = 忽略 uint32_t
|
||||
*/
|
||||
static uint32_t sim_map_key_char(char c)
|
||||
{
|
||||
static uint32_t sim_map_key_char(char c) {
|
||||
switch (c) {
|
||||
case 'u': return LV_KEY_UP;
|
||||
case 'd': return LV_KEY_DOWN;
|
||||
@@ -105,12 +118,14 @@ static uint32_t sim_map_key_char(char c)
|
||||
}
|
||||
|
||||
/*
|
||||
* @brief 待机屏底部时钟提供回调（平台差异：模拟器 = 宿主 time()）
|
||||
* 函数功能：待机屏底部时钟提供回调（平台差异：模拟器 = 宿主 time()）
|
||||
* 入口参数：buf - 输出缓冲（格式化时间串） char *
|
||||
* len - 缓冲长度 size_t
|
||||
* 返回值：无
|
||||
*/
|
||||
static void sim_time_cb(char *buf, size_t len)
|
||||
{
|
||||
static void sim_time_cb(char *buf, size_t len) {
|
||||
time_t t = time(NULL);
|
||||
struct tm tmv;
|
||||
struct tm tmv = {0}; /* 显式清零：localtime_s/r 是"输出型"参数，静态分析按未初始化报 */
|
||||
|
||||
#if defined(_MSC_VER)
|
||||
localtime_s(&tmv, &t);
|
||||
@@ -123,14 +138,13 @@ static void sim_time_cb(char *buf, size_t len)
|
||||
}
|
||||
|
||||
/*
|
||||
* @brief 无窗口离屏渲染（可注入键序列）并导出末帧像素
|
||||
* @param keys 键序列（u=上 d=下 l=左 r=右 e=确认 s=返回；空 = 不注键）
|
||||
* @param path 输出文件（写入 160x160 I1 原始像素）
|
||||
* @param standby 非 0 = 注键后强制进入待机屏再截图（--standby 模式）
|
||||
* @return 0 成功，非 0 失败
|
||||
* 函数功能：无窗口离屏渲染（可注入键序列）并导出末帧像素
|
||||
* 入口参数：keys - 键序列（u=上 d=下 l=左 r=右 e=确认 s=返回；空 = 不注键） const char *
|
||||
* path - 输出文件（写入 160x160 I1 原始像素） const char *
|
||||
* standby - 非 0 = 注键后强制进入待机屏再截图（--standby 模式） int
|
||||
* 返回值：0 - 成功；非 0 - 失败 int
|
||||
*/
|
||||
static int run_headless(const char * keys, const char * path, int standby)
|
||||
{
|
||||
static int run_headless(const char * keys, const char * path, int standby) {
|
||||
setvbuf(stdout, NULL, _IONBF, 0);
|
||||
lv_init();
|
||||
lv_delay_set_cb(shot_delay_cb);
|
||||
@@ -209,7 +223,7 @@ static int run_headless(const char * keys, const char * path, int standby)
|
||||
uint32_t snap_h = snap->header.h;
|
||||
/* I1 缓冲区布局：[palette 8B][pixel data]，跳过 palette 只写像素 */
|
||||
uint32_t pal_bytes = LV_COLOR_INDEXED_PALETTE_SIZE(LV_COLOR_FORMAT_I1) * (uint32_t)sizeof(lv_color32_t);
|
||||
uint8_t * px = snap->data + pal_bytes;
|
||||
const uint8_t * px = snap->data + pal_bytes; /* 只读：写文件时不再改动快照 */
|
||||
uint32_t px_bytes = (uint32_t)snap->header.stride * (uint32_t)snap_h;
|
||||
FILE *fp = fopen(path, "wb");
|
||||
if (fp == NULL) {
|
||||
@@ -239,13 +253,13 @@ static const char s_cfgtest_doc[] =
|
||||
static const uint8_t s_cfgtest_ip[4] = { 10u, 0u, 0u, 1u };
|
||||
|
||||
/*
|
||||
* @brief 配置轮询自检（无窗口、无需 LVGL/SDL，进程内闭环）
|
||||
* @note 验证链：net_cfg_load（只读 INI）→ poll 建基线 → 伪造外部编辑
|
||||
* → poll 两次（沉降去抖）→ 重载并更新 RAM 副本
|
||||
* @return 0 PASS，非 0 FAIL
|
||||
* 函数功能：配置轮询自检（无窗口、无需 LVGL/SDL，进程内闭环）
|
||||
* 入口参数：无
|
||||
* 返回值：0 - PASS；非 0 - FAIL int
|
||||
* 说明：验证链 net_cfg_load（只读 INI）→ poll 建基线 → 伪造外部编辑
|
||||
* → poll 两次（沉降去抖）→ 重载并更新 RAM 副本
|
||||
*/
|
||||
static int run_cfgtest(void)
|
||||
{
|
||||
static int run_cfgtest(void) {
|
||||
int i;
|
||||
const net_cfg_t *p_cfg;
|
||||
|
||||
@@ -367,13 +381,13 @@ static int run_cfgtest(void)
|
||||
}
|
||||
|
||||
/*
|
||||
* @brief 日志引擎自检（无窗口、进程内闭环）
|
||||
* @note 验证链：清理旧档 → post N 条 → count/get 回读断言 + 宿主文件字节级校验
|
||||
* （64B 定长、ISO 时间戳格式、epoch 字段 ≈ now、NUL 填充）
|
||||
* @return 0 PASS，非 0 FAIL
|
||||
* 函数功能：日志引擎自检（无窗口、进程内闭环）
|
||||
* 入口参数：无
|
||||
* 返回值：0 - PASS；非 0 - FAIL int
|
||||
* 说明：验证链 清理旧档 → post N 条 → count/get 回读断言 + 宿主文件字节级校验
|
||||
* （64B 定长、ISO 时间戳格式、epoch 字段 ≈ now、NUL 填充）
|
||||
*/
|
||||
static int run_logtest(void)
|
||||
{
|
||||
static int run_logtest(void) {
|
||||
uint32_t ep;
|
||||
char ts[SYSLOG_TS_LEN + 1u];
|
||||
char desc[SYSLOG_DESC_MAX + 1u];
|
||||
@@ -464,10 +478,13 @@ static int run_logtest(void)
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 程序入口
|
||||
* 函数功能：模拟器入口（解析模式开关 → 窗口模式或无头自检）
|
||||
* 入口参数：argc - 参数个数 int
|
||||
* argv - 参数数组（--screenshot / --keys / --standby / --cfgtest /
|
||||
* --logtest / --idle） char **
|
||||
* 返回值：0 - 正常退出或自检 PASS；非 0 - 失败 int
|
||||
*/
|
||||
int main(int argc, char **argv)
|
||||
{
|
||||
int main(int argc, char **argv) {
|
||||
/* 截图/自检模式：--screenshot / --keys / --standby / --cfgtest / --logtest */
|
||||
for (int i = 1; i < argc; i++) {
|
||||
if (strcmp(argv[i], "--screenshot") == 0 && (i + 1) < argc) {
|
||||
|
||||
Reference in New Issue
Block a user