wandering1
fea4cc7502
v1.1（2026-10-14）之后主干前进 59 笔，本总览积累系统性偏差，通读全文后 全局更新（含配图生成器数据同步）： - 串口三分定态：USART1=屏板链路 700 kbaud、UART4=RS-485（B2 未接线）、 UART5=控制台日志 115200（console_log CON_UART=huart5 实证； 旧文把 USART1 标成调试口是屏板批 0 迁移前的口径） - 采集主线补齐：adc_cal 标定折算、meas 200ms 遥测快照（adcTask 唯一 发布者，104 与 UI 共用同一份上游）、录波环三任务交接（adcTask 写入 冻结 / defaultTask 游标落 /wave / uiTask 单通道回放 / FTP 取回） - SOE 事件记录链路入图：protectTask 动作/复归边沿投递（纯 RAM 队列） → defaultTask 经 syslog_drain 尾部落 /log/soe.log（64B 定长） - 配置从 [network] 单段改五段注册制（+ftp/adc_cal/run_par/comm）， 另有 /prot_set.bin（B7 原子写） - UI 一节按注册表驱动重写：菜单树 61 行、16 个 #P 受保护叶、26 个 #page 绑定、ui_data 三帧契约（写侧唯一填充 ui_data_feed）、录波 两页、显存一份三出（屏板主出口/:7003 镜像/模拟器） - §2.1 任务表按 freertos.c 现值逐行核对；protectTask 如实标注 「未标定闭锁」现状（产品 required_mask 0x1F7） - 配图：gen_arch_svg.py 顶部数据（层芯片/串口/删悬空图脚注）重跑， 脚本与产物同一笔提交；check_generated_fresh.py 按「只减不增、 还清即删整条」把本次还清的 项目架构总览.svg 基线下架（留出处注） 验证：check_doc_links --all --sections-strict 通过；scripts/ci_local.py 全绿；generated-fresh 单跑 rc=0（无 DIFF/NEW）；SVG 无头渲染回读目检 两轮（首轮揪出悬空图脚注）；md 无 BOM/CR/U+FFFD；#P 计数剔注释行复核。
tools/ — 开发工具
面向开发者的功能性工具（生成器 / 转换器 / 交互工具）。 与
scripts/（质量门禁与度量）分工不同：本目录产出资产（图、字体、代码、知识库）。
工具一览
| 目录 | 工具 | 产物 | 文档 |
|---|---|---|---|
arch_diagram/ |
架构图 SVG 生成器 | docs/images/*.svg |
docs/架构设计/图形绘制流程.md |
font_gen/ |
中文字库生成 | Drivers/BSP/UI/ui_font_cn_12.c |
docs/UI设计/UI_中文字体生成与配置.md |
menu_gen/ |
菜单树代码生成 | UI 菜单代码 | docs/UI设计/菜单页面设计.md |
netlist_semantics/ |
网表语义分析 | 引脚知识库 JSON + 网表报告 | docs/硬件平台/ |
refgraph/ |
文件引用关系图 | docs/images/引用关系图.* |
docs/架构设计/引用关系图说明.md |
使用方式
# 架构图（精确布局）
& '.venv\Scripts\python.exe' tools/arch_diagram/gen_memory_svg.py
# 中文字体（含新汉字文案后必须重跑）
& '.venv\Scripts\python.exe' tools/font_gen/make_font.py
# 引用关系图
& 'tools\refgraph\gen_refgraph.bat'
# 串口助手（常驻 daemon）
& '.venv\Scripts\python.exe' .dsh/skills/serial-assistant/scripts/serial_tool.py
⚠️ 约定
- 生成器的产物与脚本一并提交（如 SVG）；本地预览产物（如 PNG）不提交
- 图表选型：精确布局图用
arch_diagram/生成器；拓扑图（流程/时序/状态机）用 Mermaid； 勿手绘 ASCII 框图（见docs/架构设计/图形绘制流程.md） - 涉及 UI 改动：走
ui-verifyskill 五步门禁；涉及字体：走font-regenskill
相关文档
docs/架构设计/图形绘制流程.md— 配图规范与选型docs/架构设计/引用关系图说明.mddocs/测试说明/串口助手使用指南.md、docs/测试说明/串口助手设计说明.md