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

128 Commits

Author SHA1 Message Date
wandering1 5c978465c9 TPAFE驱动闭环E-44/E-45/E-58取数契约，固化E-59门禁，adc_task挂进Keil工程 2026-10-10 03:46:50 +08:00
wandering1 53bd9af02e 对齐 CubeMX 输出：提交第三方与生成文件的文件末尾空行（85 文件，零逻辑变化） 2026-10-10 01:05:15 +08:00
wandering1 5eed2151de CubeMX 生成 ADC1（9 通道）+ 复原重生成定制，FreeRTOS 加固迁 L1、钩子落 USER CODE 4/5，门禁豁免生成文件空白改写 2026-10-10 00:53:20 +08:00
wandering1 718d399f70 net_drain_chip_rx 补实测注释：scratch 静态化反亏，勿再"优化" 
ARMCC 把 256B 分块 scratch 与同函数内不重叠的 192B 日志缓冲叠放
实测静态化只省 ~16B 栈、反增 256B BSS，已回退并留注释防重复尝试
 2026-10-09 17:17:48 +08:00
wandering1 ad0fd53389 阶段 D 收口：P3 卫生六项 + S-2 boot_log 存档流程 + 登记簿销项 
阶段 D（验证与卫生）离线可完成项收口；台架依赖项 D2/D5/D6 保留登记。

- D4 P3 卫生六项：
  - P3-1 cfg_file.c s_encode：STR 型 len==0 回绕（p_key->len - 1u）直接拒绝
  - P3-2 cfg_file_store_mcu.c：原子写临时名由 p_path 同目录推导（s_build_tmp_path）
  - P3-4 rs485.c：模块描述订正为实际实现（HAL_Delay(1)，非 DWT µs）
  - P3-6 ch395f_get_socket_status：补 p_status NULL 检查
  - P3-8 build.md：退出码契约订正为 0/1/2 三档
  - P3-11 adc_task/rs485_task：注明"预留桩（未启用）"
- D3 S-2：新增 docs/测试说明/boot_log_data/（快照存档目录 + 流程），
  并在 测试开发标准流程.md §7.3 登记沉淀约定
- 登记簿销项：删 P3-1/2/4/6/8/11、S-2；阶段 D 表移除 D3/D4；
  §1 计数更新（P3 6→0、登记簿 10→9）；§3 章节重排
  （登记簿→§3.2、专项→§3.3）；清理 App/cfg/README.md 等对已销编号的引用
- 同步刷新内存快照：Flash 266,632 B / ROM 合计 267,372 B

验证：@build 0 错 0 警；cfg_file 主机单测 149/149；
pre-commit --all-files 17/17 通过。
 2026-10-05 10:15:53 +08:00
wandering1 de1b50efe9 修复 P1-7：MAC 写入顺序改为 INIT_CH395 之前 
- 手册 §9.2.1：SET_MAC(步骤①) 必须先于 INIT_CH395(步骤⑤)；SET_MAC 写
  芯片 EEPROM，INIT 从中加载 MAC——原顺序反了则本次上电 MAC 不生效
  （回落芯片内置/上次值），UI 显示与设备在线身份不符
- net_socket.c net_init()：SET_MAC 移到 ch395f_init() 之前（对齐步骤①）
- ch395f.c：四个 SET（MAC/IP/GWIP/MASK）限定条件注释由"芯片已初始化"
  订正为"必须在 ch395f_init() 之前调用"
- net_socket.h / BSD_Socket_API_函数调用关系.md：同步顺序描述
- CH395F_Trap_Records.md：新增 Trap 24 沉淀根因与修复
- 待处理内容.md：P1-7 销项（§1/§2 阶段 A/§3.1/§4）；阶段 A 清空后重编号
- 验证：Keil 构建 0 错 0 警；pre-commit 17/17 全通过
 2026-10-04 23:07:00 +08:00
wandering1 e0b02d397c 修复 P2 全部 10 项：错误传播/竞态/门控/文档失真 
待办池 docs/待处理内容.md §3.2 的 10 个 P2 全部闭环；逐项落代码 + 注释说明。

P2-1  cfg_file: 受管键行超 CFG_LINE_TEST_MAX 拒绝保存（防重复键行）
P2-2  ch395f: DMA 失败传播状态 + 锁存通道故障 + 读不拷不可信数据
P2-7  net_select: LISTENING 不再恒判可读（消除 select 忙轮询地雷）
P2-8  time_sync: 核实 L3 pending 改写已闭环（net_recv_to 分片 + 总预算）
P2-9  sys_log: 挂载改幂等 + 卷锁，defaultTask 2s 重试建 /log
P2-10 sys_log: s_read_raw 纳入卷锁 try（读者/写者 unlink 互斥）
P2-11 net_task: RECONFIG 改 osEventFlagsWait 原子取走 + 清除
P2-12 app_cfg: APP_*_ENABLE 如实标注为未接线占位，删“开关”说法
P2-13 freertos: 产品构建 vTaskDelete(testTask) 回收 8KB CCM 栈
P2-15 download.bat: 先删旧日志 + 增“未产出日志”判定

P2-13 用 USER CODE 区回收而非生成区 #if 门控：生成区改动会被 CubeMX
重生成覆盖，本方案重生成不丢。P2-12 因产品定义 B0 未定、APP_NET_ENABLE
无单一接线点，按修复建议备选（删“开关”说法）处理。

验证：@build 0 错 0 警；主机单测 watchdog 39/39 + sys_clock 100/100 +
cfg_file 149/149（新增 TC-CFG-044）；pre-commit --all-files 17/17。
 2026-10-04 08:30:30 +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 029437be89 台架执行《实机测试实施指南》步骤 3~7 并闭环 
步骤 3/4（IWDG V2/V4/V5 + 堆低水位 S11）：
- V2 任务饿死 stall 后 ≤2.5s IWDG 复位；V4 关中断死循环 ~4.9s 稳定复位；
  V5 30min 120×FTP 全 PASS、零 IWDG 复位。堆告警全程未触发（min_ever=4728B）。
- task_watchdog.c：stall 证据写盘会经 nand_ftl_wd_feed 喂狗 → 增 s_stall_evidenced
  每次 stall 仅取一次证据，避免"取证据"本身阻止复位。
- default_task.c：堆低水位告警（HEAP_LOW_WATER_B=3072）。

步骤 5（GD5F 错误通道 S9）：gd5f2gq5ue.c/.h + nand_ftl.c 错误码统一为 int32_t 并
全量检查返回值；套件回归 16/16 PASSED。
- test/run_all_suites.py：--forbidden 改为按套件覆盖（GD5F 用 "HardFault;assert"）——
  TC-GD5F-704 故意触发 [ERR] 回落轮询，统一默认值会误判 FAIL。

步骤 6（网络稳定性）：7.1 正常路径 ✅（V5 证据）；7.2 N-2 丢弃可观测性代码已具备、
49s 静默在 V5 未复现（降级低风险观察项）；7.3 N-3 待 PC peer。

步骤 7（工程卫生）：
- S5：新增 test-cppcheck 钩子（仅 warning，排除模拟器桩）。
- S4：新增 scripts/check_test_traceability.py（默认仅告警）。
- 待核实项 TEST_SUITE_SELECTED 实机核实 = 死代码（无使用点）；RTC 套件实际正常执行，
  真缺口 = 缺套件级汇总行 → sd2506_test_task.c 补 === RTC Tests: N/M PASSED === 并
  修正 Phase 级汇总累计问题；test_config.h 补齐 RTC 并注释"当前无引用"。

验证：产品 @build 0/0；pre-commit --all-files 17/17 Passed；
run_all_suites.py --suites RTC → PASS。
文档：实机测试实施指南 / SD2506_Test_Guide / 待处理内容 / 测试与架构改进建议 同步。
 2026-10-04 00:35:06 +08:00
wandering1 1780e5320b 实施A2/A3/A4并通过真机验证：net_task失败重试自检、ch395f有限超时故障锁存、remo_send短写阻断；@test 7/7，A1含配置持久化闭环 2026-10-03 09:05:57 +08:00
wandering1 930215f81a 修复IWDG超时未配置与dhara resume回滚：看门狗误复位与复位后写入全部丢失，台架全量自检PASS 2026-10-02 20:48:30 +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 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 0485e79da0 Net 阻塞模型文档改写为架构设计并迁入 docs/网络 2026-09-29 05:51:16 +08:00
wandering1 b46e6bffed Net 阻塞模型调研文档退役：客观实施记录留存，二期基线迁入任务规划 2026-09-26 14:21:13 +08:00
wandering1 22559365b9 整理 App 与 test 目录：按职责分子目录并同步全库引用 2026-09-26 12:52:39 +08:00
wandering1 39bd06adea 为自建代码目录补齐 README，建立目录级导航体系 
- 新增 26 份目录 README：App/(+log,task,util,protocol)、Drivers/BSP/(+8子系统)、
  Src/、Inc/、scripts/、tools/(+6子工具)、test/、MDK-ARM/、simulator/(+sim,tests)
- 每份含：定位、文件清单表、关键约束/陷阱、指向 docs 权威文档
- 第三方库与生成代码目录排除（CMSIS/HAL/Middlewares/Lib/SDL2）
- docs/文档规范.md 新增 §1.1b 代码目录 README 约定；根 README 目录结构加入说明
 2026-09-26 12:25:36 +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
wandering1 1b46e2a340 修复E-03：s_net_errno 改按任务隔离槽位，消除跨任务错误码错报 2026-09-25 19:17:18 +08:00
wandering1 78ea81aecb net_socket.c 全部 59 个函数体注释改为逐行风格（纯注释改动，构建 0/0） 2026-09-25 15:00:36 +08:00
wandering1 df79cf2be3 net_process_messages注释改为标准字段格式(功能/返回值/限定/说明)，内容不变，二进制零差异 2026-09-25 05:55:03 +08:00
wandering1 c12139da06 Trap23待办3: 异常释放(TIMEOUT/RST)挂起recv以CONNRESET了结, STOR异常结束回450并删除截断文件, 探针加--check-abort 2026-09-25 02:04:46 +08:00
wandering1 a1f1f46262 Trap23两阶段修复: 异常释放400ms隔离+正常释放100ms沉降(仅收过数据), 修复中止后新传输首笔静默截断 2026-09-25 01:57:03 +08:00
wandering1 d0cbeb6b5b 控制台日志实现迁出HAL生成文件至App/log并新增设计说明；defaultTask任务体迁至App/task，freertos.c恢复纯CubeMX接线形态 2026-09-25 01:32:09 +08:00
wandering1 3763e699dc 控制台改单写者发送：defaultTask唯一发串口其余任务写环形缓冲，杜绝日志交错与脏指针入UART；溢出钩子加指针窗口校验、崩溃上报改显式长度 2026-09-24 23:47:23 +08:00
wandering1 c075cfa076 修复F1：lftpd会话结束复用auto_relisten监听器不再关闭控制监听，net关闭时清隔离标志防跨轮残留 2026-09-24 22:49:33 +08:00
wandering1 86e261d6df net_socket.c补net_process_messages分派文档：三个自愈tick机制、各消息类型处理说明与结果回传路径 2026-09-24 22:49:15 +08:00
wandering1 95e7f42aa2 修复发送中途断连空等1s：send等待循环加状态检查，断连立即失败回传CONNRESET 2026-09-24 17:14:12 +08:00
wandering1 77ee778605 修复Trap22快速复连丢中断致监听死亡：net层周期对账自愈(去抖+冷却)，复现用例与回归全绿 2026-09-23 02:27:10 +08:00
wandering1 3ac8eb807d TC-NET-604结案为非缺陷：Trap21改短+删机理图解+N-7作废，清理源码误导注释 2026-09-23 01:36:57 +08:00
wandering1 7d70445c16 修复Trap23：异常释放后复监听隔离并排空RX残渣，上传中止截断消除（RST10/10+FIN5/5通过，正常50/50） 2026-09-23 01:31:07 +08:00
wandering1 cca3b60d64 Trap21定案部分窗口重通告机制：N-7改非阻塞RX读强制排空至空，netcmd日志入库 2026-09-23 00:07:45 +08:00
wandering1 93bae35e21 TC-NET-604 根因闭环：芯片 RX 窗口冻结角（Trap 21），MSS=512 裕量方案证伪回退，缓冲布局与 MSS 解耦 + 超限读金丝雀 
- 根因：CH395F 片内 TCP 状态机角（WCH 官方 FAQ 留档，W5500 同类）：窗口=接收缓冲剩余空间，
  缓冲恰好填满 + 排空时序交叠后芯片 RX 静默冻结（不 RST、不自恢复），触发模式 = 同连接前序突发 +
  新突发 + 任务负载；驱动超限读丢弃与 L3 pending 均经插桩台架排除
- MSS=512 裕量实验证伪（原序列 10/10 仍停摆，且新连接 4096B 确定性停摆恒剩 64B）→ 维持 1024
- 缓冲块布局（RX 4/TX 2 块）与 SPI DMA 缓冲（接收缓冲+4）与 MSS 解耦，杜绝改 MSS 连带缩小布局
- ch395f_read_recv_buf 超限守卫改为 OVERSIZE 留痕（原静默 return 会把窗口锁死 0 且无从诊断）
- 文档：Trap 21 全记录（含 MSS=512 负结果/64B 残留/FAQ 引文/触发模式）；N-1 改写（残留决策项 =
  lftpd 数据通道停摆预算 30s→10-15s 待用户决策）；E-02 STOR 预测机制修正；延迟说明基线免重锁注记
- 台架复验：新连接 4096B 31ms PASS（4x1024 粒度）、竞争序列停摆复现（芯片角，已文档化）、
  停摆后重连 520ms 恢复（auto-relisten + 回显正常）；芯片行为参数零变化 → M3 基线全部继续有效
 2026-09-22 18:57:48 +08:00
wandering1 a45c0cb883 L3 pending化一期：阻塞recv改挂起请求+主循环节拍完成（netTask零占用），lftpd/timeSync分片协议退役 2026-09-22 16:29:31 +08:00
wandering1 4ce966dfb8 net_recv_to补全分步注释：片超时-2返回码不依赖errno依据、值拷贝队列陷阱、三分支返回语义（E-02配套留档，无逻辑变化） 2026-09-22 15:37:19 +08:00
wandering1 7fb5d66799 清除 net 层调试残留：ch395f_reset 六行与 net_init 七行步骤打印 2026-09-22 12:17:31 +08:00
wandering1 894b51feb3 移除 P0-a 验收探针（台架验收完成），开机省去 60ms 状态轮询与证据行 2026-09-22 12:03:11 +08:00
wandering1 06d4064366 修复 P0-a 重传周期 200ms 与 P0-b per-recv 日志，台架重锁 M2/M3 基线并复验 2026-09-22 11:36:16 +08:00
wandering1 2cffd1d2cf 文档统一：三份链路时延文档合并为链路延迟测试说明，删过程性历史，更新全部交叉引用 2026-09-22 06:52:58 +08:00
wandering1 e5733b3454 链路时延M1-M3收尾：Phase12-14基线与生产路径Δ实测、D10/E-02/D17修复、D20定位与硬化、文档整理 2026-09-22 06:12:40 +08:00
wandering1 1d2a53bbc9 E-31修复：dhara resume失败按错误分类（仅真空白判新卷），mount失败自检上报+主循环有界重试 2026-09-21 18:38:23 +08:00
wandering1 83b599a4b4 SD2506 init 移除 0x7B 死写说明注释（评审精简，纯注释无代码变化） 2026-09-21 17:59:19 +08:00
wandering1 115ed00039 SD2506初始化18H改回读校验+漂移时写允许窗口修复，充电宏位与注释订正（E-32修复） 2026-09-21 17:36:48 +08:00
wandering1 ee206ab688 GD5F页读回归主线单发令(settle与二次发令移除、3.1V误判更正归一Trap05)、新增Phase11复现用例(16轮零复现)、附台架环境与审计文档 2026-09-21 16:55:05 +08:00
wandering1 f86cb8824b 存储栈RAM优化P0-1：BBT缓冲按实际载荷272B收紧，编程回读校验整体移除（向业界靠拢），新增存储栈RAM优化调研报告 2026-09-21 11:23:15 +08:00
wandering1 472c8172fb 修复远端推流整帧纯白:MCU端补dark mono主题应用与I1调色板,net发送侧加停顿/短写诊断 2026-09-21 05:12:18 +08:00
wandering1 5cb7614959 修复net公开API错误码被覆盖致UI推流连上即断(改用通知值回传,单连接EOF不关监听) 2026-09-21 04:46:47 +08:00
wandering1 57632e910a 内存管理文档4→2合并：报告/规划并入主文档，lftpd静态化降栈峰值，同步架构/FTP/部署文档 2026-09-21 04:37:27 +08:00
wandering1 03f175e7ba I1 绘制缓冲布局写入 ui_port.h 并去掉多余护栏，取帧端补防回归注记 2026-09-21 03:50:54 +08:00
wandering1 47b38f08ef 修复 I1 绘制缓冲缺 8 字节 palette 头导致的越界写与整帧错位，补存储维护文档 2026-09-21 03:45:55 +08:00