docs(架构): 项目架构总览全局更新——同步录波/SOE/屏板并订正串口归属

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 计数剔注释行复核。
This commit is contained in:
2026-10-30 06:53:07 +08:00
parent 613fc25651
commit fea4cc7502
4 changed files with 267 additions and 185 deletions
+2 -2
View File
@@ -99,8 +99,8 @@ RUN_PY = [sys.executable]
# 存量基线:接线当天实测已漂的产物,**只减不增**(还清即删整条,--prune 打印出处)
BASELINE = (
("docs/images/项目架构总览.svg", "tools/arch_diagram/gen_arch_svg.py",
"脚注写 docs/项目架构总览.md,生成器已改成 docs/架构设计/(文档挪目录,产物没重跑)"),
# 2026-10-30 还清下架 1 条:docs/images/项目架构总览.svg <- tools/arch_diagram/gen_arch_svg.py
# (分层图数据补录波/SOE/屏板后重跑,脚本与产物同批逐字节一致;见该文件提交说明)
("docs/images/配置文件分层架构.svg", "tools/arch_diagram/gen_cfg_arch_svg.py",
"图内写 App/cfg_file.c,生成器已改成 App/cfg/cfg_file.c(配置引擎挪目录,产物没重跑)"),
("docs/images/RemoDispBus帧格式.svg", "tools/arch_diagram/gen_frame_svg.py",