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）
319 lines
11 KiB
C
319 lines
11 KiB
C
/**
|
||
* 模块名称：LVGL 配置 —— PC 模拟器侧（simulator/lv_conf.h）
|
||
* 模块功能：LVGL v9.3.0 编译期特性裁剪与 SDL2 适配（160x160 1bpp 单色）
|
||
* 适用平台：Windows（CMake + SDL2）
|
||
* 作者：王建锋
|
||
* 创建日期：2026-08-31
|
||
* 修改记录：
|
||
* v1.0 2026-08-31 王建锋 创建：基于 Lib/lv_conf.h 适配 PC 模拟器
|
||
*
|
||
* ⚠ 本文件与 `Lib/lv_conf.h`（MCU 端）必须保持**同一特性子集**，已由门禁校验：
|
||
* `python scripts/check_lv_conf_sync.py`（pre-commit 钩子 lv-conf-sync，
|
||
* 两端任一改动都会触发）。规则正文见 docs/UI设计/UI_设计架构.md §1.4 第 10 条。
|
||
*
|
||
* @file lv_conf.h
|
||
* @brief LVGL v9.3.0 配置 — Windows SDL2 模拟器（160x160 1bpp 单色）
|
||
* @note 基于项目 Lib/lv_conf.h 适配，用于 PC 模拟器 UI 开发
|
||
*/
|
||
#ifndef LV_CONF_H
|
||
#define LV_CONF_H
|
||
|
||
/* clang-format off */
|
||
|
||
/*============================================================================
|
||
* MEMORY AND STANDARD LIBRARY
|
||
*============================================================================*/
|
||
#define LV_USE_STDLIB_MALLOC LV_STDLIB_BUILTIN
|
||
#define LV_USE_STDLIB_STRING LV_STDLIB_BUILTIN
|
||
#define LV_USE_STDLIB_SPRINTF LV_STDLIB_BUILTIN
|
||
|
||
#define LV_STDINT_INCLUDE <stdint.h>
|
||
#define LV_STDDEF_INCLUDE <stddef.h>
|
||
#define LV_STDBOOL_INCLUDE <stdbool.h>
|
||
#define LV_INTTYPES_INCLUDE <inttypes.h>
|
||
#define LV_LIMITS_INCLUDE <limits.h>
|
||
#define LV_STDARG_INCLUDE <stdarg.h>
|
||
|
||
#if LV_USE_STDLIB_MALLOC == LV_STDLIB_BUILTIN
|
||
#define LV_MEM_SIZE (40 * 1024U)
|
||
#define LV_MEM_ADR 0
|
||
#endif
|
||
|
||
/*============================================================================
|
||
* OS
|
||
*============================================================================*/
|
||
#define LV_USE_OS LV_OS_NONE
|
||
|
||
/*============================================================================
|
||
* RENDERING
|
||
*============================================================================*/
|
||
/** 1bpp 单色 */
|
||
#define LV_COLOR_DEPTH 1
|
||
#define LV_COLOR_MIX_ROUND_OFS 0
|
||
|
||
/** 刷新周期（ms） */
|
||
#define LV_DEF_REFR_PERIOD 20
|
||
|
||
/** DPI */
|
||
#define LV_DPI_DEF 130
|
||
|
||
/** 绘制缓冲对齐 */
|
||
#define LV_DRAW_BUF_STRIDE_ALIGN 1
|
||
#define LV_DRAW_BUF_ALIGN 4
|
||
|
||
/** 复杂绘制：主界面顶部开口浅 V 装饰含斜线（lv_line 斜段依赖 LV_DRAW_SW_COMPLEX），须与 MCU 端一致保持开启，否则两腿不渲染 */
|
||
#define LV_DRAW_SW_COMPLEX 1
|
||
/* 注：9.3 没有 LV_DRAW_SW_COMPLEX_GRADIENTS / LV_DRAW_SW_YIELD / LV_DRAW_SW_ASYNC
|
||
* （9.4 才引入），原定义无效，已删 */
|
||
#define LV_DRAW_SW_SHADOW_CACHE_SIZE 0
|
||
#define LV_DRAW_SW_CIRCLE_CACHE_SIZE 4 /* LV_DRAW_SW_COMPLEX 依赖非零（零长数组 C2466）；与 MCU 端默认一致 */
|
||
#define LV_DRAW_LAYER_SIMPLE_BUF_SIZE 0
|
||
#define LV_DRAW_LAYER_MAX_MEMORY 0
|
||
|
||
/** SW 渲染器：启用 I1 支持 */
|
||
#define LV_USE_DRAW_SW 1
|
||
#define LV_DRAW_SW_SUPPORT_RGB565 0
|
||
#define LV_DRAW_SW_SUPPORT_RGB565_SWAPPED 0
|
||
#define LV_DRAW_SW_SUPPORT_RGB565A8 0
|
||
#define LV_DRAW_SW_SUPPORT_RGB888 0
|
||
#define LV_DRAW_SW_SUPPORT_XRGB8888 0
|
||
#define LV_DRAW_SW_SUPPORT_ARGB8888 0
|
||
#define LV_DRAW_SW_SUPPORT_ARGB8888_PREMULTIPLIED 0
|
||
#define LV_DRAW_SW_SUPPORT_L8 0
|
||
#define LV_DRAW_SW_SUPPORT_AL88 0
|
||
#define LV_DRAW_SW_SUPPORT_A8 0
|
||
#define LV_DRAW_SW_SUPPORT_I1 1
|
||
#define LV_DRAW_SW_I1_LUM_THRESHOLD 127
|
||
|
||
/** 关闭 GPU/矢量绘制（注：9.3 无 LV_USE_DRAW_NEMA_GFX / PPA / EVE / NANOVG，
|
||
* 属更新版本 lv_conf_template 残留，原定义无效，已删） */
|
||
#define LV_USE_DRAW_VG_LITE 0
|
||
#define LV_USE_DRAW_DAVE2D 0
|
||
#define LV_USE_DRAW_PXP 0
|
||
#define LV_USE_DRAW_DMA2D 0
|
||
#define LV_USE_DRAW_G2D 0
|
||
#define LV_USE_DRAW_OPENGLES 0
|
||
#define LV_USE_DRAW_SDL 0
|
||
#define LV_USE_THORVG 0
|
||
#define LV_USE_VECTOR_GRAPHIC 0
|
||
#define LV_USE_MATRIX 0
|
||
/* 离屏截图（--screenshot）用 lv_snapshot 取整屏，需要开启 */
|
||
#define LV_USE_SNAPSHOT 1
|
||
|
||
/*============================================================================
|
||
* INPUT DEVICES
|
||
*============================================================================*/
|
||
#define LV_USE_GRIDNAV 0
|
||
#define LV_USE_GESTURE_RECOGNITION 0
|
||
|
||
/*============================================================================
|
||
* CORE
|
||
*============================================================================*/
|
||
#define LV_OBJ_STYLE_CACHE 1
|
||
#define LV_USE_OBJ_NAME 1
|
||
#define LV_USE_OBJ_ID 1
|
||
#define LV_OBJ_ID_AUTO_ASSIGN 1
|
||
#define LV_USE_OBJ_ID_BUILTIN 1
|
||
#define LV_USE_OBJ_PROPERTY 0
|
||
#define LV_USE_FLOAT 0
|
||
#define LV_USE_OBSERVER 0
|
||
#define LV_USE_COLOR_FILTER 0
|
||
/* 注：9.3 无 LV_USE_EXT_DATA / LV_USE_TRANSLATION（9.4 才有），原两行无效，已删 */
|
||
|
||
/*============================================================================
|
||
* LOGGING
|
||
*============================================================================*/
|
||
#define LV_USE_LOG 0
|
||
|
||
/*============================================================================
|
||
* THEMES
|
||
*============================================================================*/
|
||
#define LV_USE_THEME_DEFAULT 0
|
||
#define LV_USE_THEME_SIMPLE 0
|
||
#define LV_USE_THEME_MONO 1
|
||
|
||
/*============================================================================
|
||
* LAYOUTS
|
||
*============================================================================*/
|
||
#define LV_USE_FLEX 0 /* 2026-10-11 与 MCU 端一致：全仓无 lv_obj_set_flex_* 调用 */
|
||
#define LV_USE_GRID 0
|
||
|
||
/*============================================================================
|
||
* IMAGE SETTINGS
|
||
*============================================================================*/
|
||
#define LV_CACHE_DEF_SIZE 0
|
||
#define LV_IMAGE_HEADER_CACHE_DEF_CNT 0
|
||
#define LV_USE_RLE 0
|
||
#define LV_USE_LZ4 0
|
||
#define LV_BIN_DECODER_RAM_LOAD 0
|
||
#define LV_USE_LODEPNG 0
|
||
#define LV_USE_LIBPNG 0
|
||
#define LV_USE_BMP 0
|
||
#define LV_USE_TJPGD 0
|
||
#define LV_USE_LIBJPEG_TURBO 0
|
||
#define LV_USE_SVG 0
|
||
|
||
/*============================================================================
|
||
* TEXT & FONT
|
||
*============================================================================*/
|
||
#define LV_TXT_ENC LV_TXT_ENC_UTF8
|
||
#define LV_TXT_BREAK_CHARS " ,.;:-_)]}"
|
||
#define LV_TXT_LINE_BREAK_LONG_LEN 0
|
||
#define LV_TXT_COLOR_CMD "#"
|
||
#define LV_USE_BIDI 0
|
||
#define LV_USE_ARABIC_PERSIAN_CHARS 0
|
||
|
||
/** 内置字体：仅启用 Montserrat 12 作为基础 */
|
||
#define LV_FONT_MONTSERRAT_8 0
|
||
#define LV_FONT_MONTSERRAT_10 0
|
||
#define LV_FONT_MONTSERRAT_12 1
|
||
#define LV_FONT_MONTSERRAT_14 0
|
||
#define LV_FONT_MONTSERRAT_16 0
|
||
#define LV_FONT_MONTSERRAT_18 0
|
||
#define LV_FONT_MONTSERRAT_20 0
|
||
#define LV_FONT_MONTSERRAT_22 0
|
||
#define LV_FONT_MONTSERRAT_24 0
|
||
#define LV_FONT_MONTSERRAT_26 0
|
||
#define LV_FONT_MONTSERRAT_28 0
|
||
#define LV_FONT_MONTSERRAT_30 0
|
||
#define LV_FONT_MONTSERRAT_32 0
|
||
#define LV_FONT_MONTSERRAT_34 0
|
||
#define LV_FONT_MONTSERRAT_36 0
|
||
#define LV_FONT_MONTSERRAT_38 0
|
||
#define LV_FONT_MONTSERRAT_40 0
|
||
#define LV_FONT_MONTSERRAT_42 0
|
||
#define LV_FONT_MONTSERRAT_44 0
|
||
#define LV_FONT_MONTSERRAT_46 0
|
||
#define LV_FONT_MONTSERRAT_48 0
|
||
#define LV_FONT_MONTSERRAT_28_COMPRESSED 0
|
||
#define LV_FONT_DEJAVU_16_PERSIAN_HEBREW 0
|
||
#define LV_FONT_SOURCE_HAN_SANS_SC_14_CJK 0
|
||
#define LV_FONT_SOURCE_HAN_SANS_SC_16_CJK 0
|
||
#define LV_FONT_UNSCII_8 0
|
||
#define LV_FONT_UNSCII_16 0
|
||
|
||
/** 自定义字体：中文 12px 1bpp */
|
||
#define LV_FONT_USE_CUSTOM_INCLUDE 1
|
||
#define LV_FONT_CUSTOM_INCLUDE "ui_font_cn_12.h"
|
||
#define LV_FONT_CUSTOM_DECLARE LV_FONT_DECLARE(ui_font_cn_12)
|
||
#define LV_FONT_DEFAULT &ui_font_cn_12
|
||
|
||
/* 注：9.3 无 LV_USE_CUSTOM_FONT_DEFAULT，原行无效，已删 */
|
||
#define LV_FONT_FMT_TXT_LARGE 0
|
||
#define LV_USE_FONT_COMPRESSED 0
|
||
#define LV_USE_FONT_PLACEHOLDER 1
|
||
#define LV_USE_FONT_MANAGER 0
|
||
#define LV_USE_IMGFONT 0
|
||
#define LV_USE_FREETYPE 0
|
||
#define LV_USE_TINY_TTF 0
|
||
|
||
/*============================================================================
|
||
* WIDGETS
|
||
*============================================================================*/
|
||
#define LV_WIDGETS_HAS_DEFAULT_VALUE 0
|
||
|
||
#define LV_USE_3DTEXTURE 0
|
||
#define LV_USE_ANIMIMG 0
|
||
#define LV_USE_ARC 0
|
||
#define LV_USE_BAR 0
|
||
#define LV_USE_BARCODE 0
|
||
#define LV_USE_BUTTON 0
|
||
#define LV_USE_BUTTONMATRIX 0
|
||
#define LV_USE_CALENDAR 0
|
||
#define LV_USE_CANVAS 0
|
||
#define LV_USE_CHART 0
|
||
#define LV_USE_CHECKBOX 0
|
||
#define LV_USE_DROPDOWN 0
|
||
#define LV_USE_FFMPEG 0
|
||
#define LV_USE_GIF 0
|
||
/* 注：9.3 无 LV_USE_GLTF / LV_USE_GSTREAMER / LV_USE_ARCLABEL（更新版本残留），已删 */
|
||
/* 2026-10-11（F-2/F-3 对齐 MCU 端 Lib/lv_conf.h）：本项目 UI 全部自绘，
|
||
* 三处代码（Drivers/BSP/UI、App、simulator）零控件构造函数、零 flex/grid 调用。
|
||
* 关掉后模拟器与固件跑的是同一套特性子集，golden 回归才能真正验证 MCU 配置。
|
||
* 若将来引入控件型页面（U2 原型库），两端同步逐项打开并复跑 ui-verify。 */
|
||
#define LV_USE_IMAGE 0
|
||
#define LV_USE_IMAGEBUTTON 0
|
||
#define LV_USE_IME_PINYIN 0
|
||
#define LV_USE_KEYBOARD 0
|
||
#define LV_USE_LABEL 0
|
||
#define LV_LABEL_TEXT_SELECTION 0
|
||
#define LV_LABEL_LONG_TXT_HINT 0
|
||
#define LV_LABEL_WAIT_CHAR_COUNT 0
|
||
#define LV_USE_LED 0
|
||
#define LV_USE_LINE 1
|
||
#define LV_USE_LIST 0
|
||
#define LV_USE_LOTTIE 0
|
||
#define LV_USE_MENU 0
|
||
#define LV_USE_MSGBOX 0
|
||
#define LV_USE_QRCODE 0
|
||
#define LV_USE_RLOTTIE 0
|
||
#define LV_USE_ROLLER 0
|
||
#define LV_USE_SCALE 0
|
||
#define LV_USE_SLIDER 0
|
||
#define LV_USE_SPAN 0
|
||
#define LV_USE_SPINBOX 0
|
||
#define LV_USE_SPINNER 0
|
||
#define LV_USE_SWITCH 0
|
||
#define LV_USE_TEXTAREA 0
|
||
#define LV_USE_TABLE 0
|
||
#define LV_USE_TABVIEW 0
|
||
#define LV_USE_TILEVIEW 0
|
||
#define LV_USE_WIN 0
|
||
|
||
/*============================================================================
|
||
* DRIVERS — SDL2 (模拟器专用)
|
||
*============================================================================*/
|
||
#define LV_USE_LINUX_DRM 0
|
||
#define LV_USE_LINUX_FBDEV 0
|
||
#define LV_USE_FT81X 0
|
||
#define LV_USE_LOVYAN_GFX 0
|
||
#define LV_USE_GENERIC_MIPI 0
|
||
#define LV_USE_EVDEV 0
|
||
#define LV_USE_LIBINPUT 0
|
||
#define LV_USE_NUTTX 0
|
||
#define LV_USE_OPENGLES 0
|
||
#define LV_USE_GLFW 0
|
||
#define LV_USE_QNX 0
|
||
#define LV_USE_UEFI 0
|
||
#define LV_USE_WAYLAND 0
|
||
|
||
/** SDL2 驱动：启用 */
|
||
#define LV_USE_SDL 1
|
||
|
||
#if LV_USE_SDL
|
||
#define LV_SDL_INCLUDE_PATH "SDL2/SDL.h"
|
||
#define LV_SDL_AUTO_BACKEND 1
|
||
#define LV_SDL_BACKEND LV_SDL_BACKEND_SW
|
||
|
||
/** 1bpp 必须使用 PARTIAL 模式 */
|
||
#define LV_SDL_RENDER_MODE LV_DISPLAY_RENDER_MODE_PARTIAL
|
||
|
||
#define LV_SDL_BUF_COUNT 1
|
||
#define LV_SDL_ACCELERATED 0
|
||
#define LV_SDL_FULLSCREEN 0
|
||
#define LV_SDL_DIRECT_EXIT 1
|
||
#define LV_SDL_MOUSEWHEEL_MODE LV_SDL_MOUSEWHEEL_MODE_ENCODER
|
||
#endif
|
||
|
||
#define LV_USE_WINDOWS 0
|
||
|
||
/*============================================================================
|
||
* THEMES 子选项（LV_USE_THEME_DEFAULT / SIMPLE 本体已在上面 THEMES 块定义，
|
||
* 此处勿重复定义——同文件重复 #define 后者生效，极易误读）
|
||
*============================================================================*/
|
||
#define LV_THEME_DEFAULT_DARK 0
|
||
#define LV_THEME_DEFAULT_GROW 0
|
||
#define LV_THEME_DEFAULT_TRANSITION_TIME 0
|
||
|
||
/*============================================================================
|
||
* EXPORTS
|
||
*============================================================================*/
|
||
#define LV_USE_DEMO_NONE 1
|
||
#define LV_USE_DEMO_WIDGETS 0
|
||
#define LV_USE_DEMO_MUSIC 0
|
||
#define LV_USE_DEMO_BENCHMARK 0
|
||
#define LV_USE_DEMO_STRESS 0
|
||
#define LV_USE_DEMO_KEYPAD_AND_ENCODER 0
|
||
|
||
#endif /* LV_CONF_H */
|