Changelog

# Changelog

## 1.3.0 — 2026-08-27

- **开机防花屏**：背光初始化后保持熄屏，`ksdiy_lvgl_port_init()` 路径推迟到首帧渲染完成（`LV_EVENT_REFR_READY` 后延时 40ms，让 DPI 扫出新帧）再按当前亮度点亮；另设 3s 保底定时器防异常黑屏
- **重启防泛蓝**：`ksdiy_lcd_backlight_init()` 内通过 `esp_register_shutdown_handler()` 注册熄屏回调——任何 `esp_restart()` 路径（OTA 完成、设置页重启、模式切换等）复位前自动 duty=0，MIPI 面板不再失信号泛蓝；应用层无需任何改动
- **裸面板路径行为不变**：直接调用 `ksdiy_panel_bare_init()`（视频直写帧缓冲、无 LVGL）的工程保持上电即亮（改由 bare_init 末尾点亮）
- `ksdiy_lcd_set_brightness()` 在首帧未出时只记录目标亮度不立即生效，首帧点亮时统一应用
- `CMakeLists.txt` 的 `PRIV_REQUIRES` 新增 `esp_timer` / `esp_system`（IDF6 依赖显式化要求）

## 1.2.5 — 2026-08-23

- 新增 `menuconfig` 选项 **KSDIY P4C5 BSP → LCD pixel format**，可在 **RGB565** 与 **RGB888** 之间选择
- 修复 `bits_per_pixel` 此前固定为 16 的问题，现与所选像素格式一致
- 编译期校验 `LV_COLOR_DEPTH` 与 BSP 色深匹配（RGB565=16，RGB888=24），避免格式错配导致花屏
- 初始化日志输出当前 LCD 色深配置

## 1.2.3 — 2026-08-17

- 中文字体 `myFont_24` / `myFont_20` 补齐缺失字形，覆盖全部例程 UI 文案：
  - 覆盖码点 1091 → 1352（新增 261 个：204 个此前缺失的汉字/符号 + 补全 Latin-1 补充区）
  - 字形源：微软雅黑（Microsoft YaHei）为主，Segoe UI Symbol 补 `▮☐☑✓✔✦` 等符号字形
  - `myFont.h` 内的字符集注释块同步再生成，与实际覆盖一致
  - 保持 24px/20px、2bpp、无压缩的 lv_font_conv `lvgl` 格式，LVGL 8/9 双版本兼容
  - 生成文件手工补回 `__has_include` 前导块，避免 `#include "lvgl/lvgl.h"` 分支触发 IDF include 检查报错
- 说明：emoji（U+1F300 以上码位，如 🌤😂）不属于中文字体覆盖范围，如需显示请另行集成 emoji 字体

## 1.2.2 — 2026-08-04

- 维护更新（详见仓库提交历史）

## 1.2.1 — 2026-07-14

- 维护更新（详见仓库提交历史）

## 1.2.0 — 2026-07-14

- BSP 上线组件库：LVGL9 + ST7102 4.3" MIPI DSI + ST7123 触摸 + AXP2101 PMIC 一体支持，工程改用在线组件依赖