wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 30 Pull Requests Actions Packages Projects 2 Releases Wiki Activity
296 Commits 3 Branches 0 Tags
61a6061950a9aff1c5b7d8459bb417184911662b
Commit Graph

20 Commits

Author SHA1 Message Date
wandering1 6f3891a6b9 ADC 通道映射表建档（V0.1 语义固化）+ .ioc 启用 ADC1 九通道 
新增 docs/硬件平台/ADC通道映射说明.md：17 路语义↔网名↔通道号权威映射
语义：UA/UB/UC/UN=AIN1~4、IA/IB/IC/IN=AIN8~11、V_ZL2=温度，其余备用
勘误：PC4=ADC12_IN14（非 IN12）；PB0=ADC12_IN8（V0.0 B5 定性有误）
勘误：PC5=ADC12_IN15；网名 ADC17 承载 UB，不是 V_ZL2
.ioc：PA0~PA7/PC4 → ADC1_IN0..7/IN14，Rank1~9 + 144 cycles + 软件触发
.ioc 键名与取值逐条比对 CubeMX 自带 DB（aditf2_v1_1_Cube）后写入
尚未 Generate Code：adc.c 与 HAL adc 驱动未入库，生成后需注册 uvprojx
 2026-10-09 17:17:32 +08:00
wandering1 9734c2526a 新增产品需求设计文档：完整产品需求基线 
基于项目全量内容编写 docs/产品需求/产品需求设计文档.md，作为面向
产品的需求基线，覆盖：
- 产品概述：定位、形态与部署、设计目标与原则、产品范围
- 系统架构：六层分层、六任务模型、就绪屏障、启动时序、线程间通信
- 硬件规格：主控/内存、V0.1 外设引脚、存储器件、版本差异、平台约束
- 功能需求：网络/存储/时间/配置/日志/UI/看门狗/LED（已实现）+
  ADC/RS-485（待实现）
- 接口规范：端口、RemoDispBus、对时、FTP、配置格式、串口、对外 API
- 非功能需求：可靠性、性能指标、内存预算、测试门禁、双端、权限
- UI 规格：屏幕/菜单树 42 节点/内容页/密码/字体
- 待实现项与路线图（阶段 B/C/D）、验收判据（构建/自检/现场/台架）

同步在 docs/README.md 新增 §3 产品需求、§2 阅读顺序置顶、§1 目录树
登记产品需求/，后续章节号顺延。
 2026-10-06 02:48:54 +08:00
wandering1 75c234b0c2 docs: 项目审查报告移入 问题记录/，删除空的 审查记录/ 目录 
让评审报告与 待处理内容.md 的分工更直观：
- git mv 项目审查与优化建议报告.md → docs/问题记录/（与 Trap 台账、
  错误码传播审计同处"专项审计"目录）；rmdir 空的 docs/审查记录/。
- docs/README.md：§8 标题改为「评审报告 · 环境与部署 · 外部资料」，
  §8.1 改为「评审报告」，目录树删 审查记录/、补 问题记录/ 说明，
  按角色导航改为 §8.1/§8.3，补 2026-10-04 变更记录。
- 根 README.md 目录树同步。
- docs/文档规范.md §1.1 现有目录列表、§6 归属表同步。
- 看门狗设计说明.md / 待处理内容.md 的路径引用重定向。

pre-commit 17/17 Passed。
 2026-10-04 02:34:40 +08:00
wandering1 f4fea70749 docs: 合并 4 份待办文档为统一登记簿 待处理内容.md 
合并 docs/待处理内容.md（N/S/T-x）、审查记录/项目审计改进清单.md（P-x）、
审查记录/下一步任务规划.md（阶段与基线）、审查记录/测试与架构改进建议.md
（S1x/A-x）为单一《待处理内容（统一待办登记簿）》。

- 结构：编号空间与来源 / 未闭环一览 / 任务排序（阶段 A~D）/
  逐条详述 / 待验证与待确认 / 设计基线 / 诊断基线 / 内存预算 / 维护约定。
- 编号沿用且不回收；E-xx 仍由 错误码传播审计.md 独立维护。
- 删除 3 份被合并文档；重定向下游引用：README、AGENTS、审查报告、
  实机测试实施指南、Net 层架构、NET/cfg 模块 README、脚本注释。
- 同步订正计数：P1=2(+1 收尾) / P2=10 / P3=6。

pre-commit 17/17 Passed。
 2026-10-04 02:28:52 +08:00
wandering1 7f393956cc 测试与架构改进建议：删除已落地条目，只保留待办 
- 12/14 条建议已落地，按"只保留待办"约定重写本文件
- 保留：S12 断言宏、S1-c 可选单测、A-4 采集链路测试约束
- 保留：A-5 残余（CI 体积门禁盲区）
- 保留：错误码通道四要素（设计基线，供后续驱动接入沿用）
- 删除：S1-a/S1-b、S2~S11、S13、S14；T-1~T-5；A-1~A-3/A-6/A-7
- 删除：评价表/盘点表、路线图、总结、变更记录
- 同步修正 6 个外部文档对本文件章节的死引用
- 新增"编号约定"：S/T/A 编号不随条目删除而回收
 2026-10-04 02:12:41 +08:00
wandering1 e7442cc73f 下一步任务规划：删除已完成内容，只保留待办 
按用户要求，本文件只保留"待办"，完成项直接删除、不留变更记录（历史见 git log）：
- 删 §1.1「已闭环」整表；§1.3 结构性判断 3 条 → §1.1（去掉已完成项引用）。
- 阶段 A：删 A1~A4（已闭环），仅留 A5（P1-7 待手册）。
- 阶段 C：删 C2（GD5F 错误通道，已闭环）；C5 去掉 E-34/E-04 删除线。
- 阶段 D：删 D1（P1-10，已闭环）。
- §3 顺序图同步；§5 维护约定改为「完成即删、不留变更记录」。
- 删文末「变更记录」表（属已处理内容）。

同步修正外部引用：
- docs/README.md 索引描述改为「只保留待办，完成即删」。
- 实机测试实施指南 §10 P1-8 去向：上游由「下一步任务规划 阶段 A」改为「项目审计改进清单 P1-8」；
  抬头上游描述「（阶段 A）」→「（任务排序）」。

验证：pre-commit --all-files 17/17 Passed。
 2026-10-04 01:42:44 +08:00
wandering1 aef1d92b3f 实机测试实施指南重构为纯执行流程：步骤1~7+状态标记，已完成事项（S7/A1~A4）细节与证据移出至各模块文档，§1改执行流程总览，外部引用同步 2026-10-03 22:45:19 +08:00
wandering1 599776cd55 实机测试实施指南§3.2去"待上板"框架：A1~A4已落地并真机验证，改写为客观事实记录（列名改实施内容+验证判据），§1总览P0-B状态改已闭环，抬头与README索引同步为真机验证状态
CI / L0 静态门禁 (pre-commit) (push) Failing after 17s
Details
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 18s
Details
2026-10-03 22:27:30 +08:00
wandering1 ddbba714f7 实机测试规划更名为实机测试实施指南：与文档性质（常设执行判据）对齐，H1/README索引同步，引用面仅1处 2026-10-02 23:51:31 +08:00
wandering1 3cc08f5d53 实机测试规划改造为执行判据说明：删除一次性台架窗口状态（§0.5取证记录）与规划框架，A1~A4代码状态按代码核对改写，16处外部引用重指向模块文档 2026-10-02 23:46:27 +08:00
wandering1 6aae6bd34e docs: 新增实机测试规划（无 MCU 窗口的验证债执行面） 2026-10-02 14:05:03 +08:00
wandering1 d9425ddd23 测试：补启动段可观测性与模拟器差距清单，run_all_suites 加只编译模式（S10+S13+S6）
CI / L0 静态门禁 (pre-commit) (push) Successful in 1m10s
Details
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 25s
Details
2026-10-02 13:57:25 +08:00
wandering1 fe963e7d91 测试：新增 cfg_file 主机侧单测并修复外科手术保存死码缺陷（S1-b+S2）
CI / L0 静态门禁 (pre-commit) (push) Successful in 49s
Details
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 17s
Details
2026-10-02 13:00:54 +08:00
wandering1 fac9d1c409 测试：新增 sys_clock 主机侧单测并修复 Zeller 星期缺陷 2026-10-02 11:40:35 +08:00
wandering1 7feeea6c56 实现独立看门狗：CubeMX 配置 IWDG + 任务心跳位图，恢复三处被覆盖定制 
经 CubeMX 图形界面启用 IWDG（Prescaler=64 / Reload=1249，标称 2498ms /
最坏 1701ms），并落地心跳位图判定、各任务埋点、RCC_CSR 复位原因上报与
configASSERT 改造。重生成覆盖的既有定制已全部恢复。

P0（开机死循环）：HAL_IWDG_Init() 内部立即启动看门狗，而 CubeMX 把
MX_IWDG_Init() 插在 app_main_init() 之前——该段 NAND/RTC/ADC 初始化耗时
数秒无喂狗点，按 2.5s 超时必然复位。改 Src/iwdg.c 为只填参数不启动，
启动移交 task_wd_start()，由 defaultTask 在存储 bring-up 完成后调用。

恢复的三处定制（重生成覆盖）：
- Src/stm32f4xx_it.c：HardFault_Handler 崩溃现场采集被打回空 while(1)
- Inc/FreeRTOSConfig.h：栈溢出检测与堆失败钩子两个宏被整块删除
- Src/freertos.c：三处任务栈实测记录中文注释丢失（数值未丢）

新增：
- App/util/task_watchdog.{c,h}：心跳位图 + 抽样判定 + IWDG 延后启动
- time_sync.c 长等待切片：net_recv_to 单次可睡满 30s 预算，切成 200ms 片
- Src/main.c 复位原因锁存（读后即清 RMVF，防残留误判）

埋点：defaultTask（唯一喂狗者）/ netTask（含 PHY 等待循环）/ uiTask /
timeSyncTask。ftpTask 首期剔除掩码，待二期改 lftpd。

门禁：build 0 错误 0 警告；pre-commit 10 钩子全通过；Flash +2956B / RAM +40B。
 2026-09-29 07:22:04 +08:00
wandering1 e18e9f2cfd 新增看门狗设计说明：IWDG 选型与任务心跳位图方案 2026-09-29 06:46:27 +08:00
wandering1 0485e79da0 Net 阻塞模型文档改写为架构设计并迁入 docs/网络 2026-09-29 05:51:16 +08:00
wandering1 b46e6bffed Net 阻塞模型调研文档退役：客观实施记录留存，二期基线迁入任务规划 2026-09-26 14:21:13 +08:00
wandering1 5c049daa7c Net 阻塞模型文档销项修正 + 新增项目下一步任务规划 2026-09-26 14:15:56 +08:00
wandering1 a6cdebde62 文档体系重组与 D-7 一致性门禁落地，清理芯片手册孤儿图片 
- D-6 目录规范化：docs 根目录散落文档归入 UI设计/子系统设计/架构设计/审查记录/
  环境与部署/网络 等子目录，去掉目录名空格，重命名 嵌入式C语言代码规范_V1.0.md
- D-7 三档一致性门禁：新增 scripts/check_doc_links.py（链接存在性）、
  scripts/gen_task_table.py（FreeRTOS 任务表数值）、scripts/check_mem_numbers.py
  （内存/Flash 体积），均支持 --check/--write/--diff，pre-commit 钩子同步注册
- D-5 文档索引：新建 docs/README.md，新建 docs/文档规范.md 约束目录命名与链接写法
- D-1 芯片手册瘦身：删除 1069 张无引用孤儿图片（77.06 MB），
  docs/芯片手册 120 MB → 41 MB，已引用图片零断链
- 同步 C 源码注释中的文档路径引用（D-6 重组后），构建 0 错误 0 警告
 2026-09-26 00:51:53 +08:00