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

35 Commits

Author SHA1 Message Date
wandering1 d346e4ee84 feat(NET): N34 阶段 1.5 recv 语义主流化——无限默认+具名非阻塞+模式属性 
核心语义（实施方案 §3.5）：
- net_recv 默认无限阻塞：删除 NET_RECV_TIMEOUT_MS（30s 隐藏默认预算），
  超时归调用方策略；唤醒源=数据/EOF/close/网络重建(CONNRESET)，
  会话死亡由对账① ~400ms 判死兜底，无"对端消失永久挂死"窗口
- 新增 net_recv_nb（NET_MSG_DONTWAIT 路径转正具名）与
  net_setblocking(fd,on)（阻塞模式挂控制块属性，对齐 O_NONBLOCK/
  Python setblocking；直写单字节，net_set_event_cb 先例）
- net_types.h net_sock_t 新增 blocking 属性；net_socket() 默认置 1
  （close memset 清零后显式重置，同 released_abnormal 纪律）
- 原 1s 强制了结看门狗降级为 60s tripwire：只 [ERR] 留痕一次，
  绝不伪造 TIMEDOUT 返回值（旧实现掩盖完成路径缺陷）
- net_recvfrom 删 30s 自旋超时、同判据对齐（零生产调用者，注释警示）
- 文档契约：IWDG required_mask 内任务禁止无限阻塞 recv（BSD 指南
  §3.5/§10.1 + net_socket.h 注释）

调用点审计（§3.5.5）：零生产调用点采用无限默认——iec104_serv/
ui_net_sink 转 net_recv_nb（受监控任务逐位等价）；lftpd/time_sync
已是显式预算 net_recv_to 不动；32 轮盲收兜底未动（阶段 3 E6 门禁）

模拟器双端镜像 net_recv_nb/net_recv_to/net_setblocking（包装层
Sleep(1) 轮询模拟阻塞）；差距清单 N-3/N-6 登记义务已履行

门禁与台架：
- @build 0/0：Code 209580→209780(+200B) ZI +32B；RAM 受管区官方
  脚本同步；ci_local L0 32/32 + L0.5 951/951
- 台架全回归：relisten :7003 50/50、iec104 18/18、对时正常、
  ftp_regression 11/11、Trap23 RST 5/5+FIN 5/5、ftp_integrity
  20/20 字节一致、n30 0/10、@test PASS
- 模拟器 build_sim OK + check_remo_sink 黄金参考 0/25600 位差

队友 p15-recv-semantics 实施，Lead 全量审阅 + 独立复跑门禁与回归
 2026-10-13 11:23:19 +08:00
wandering1 b8c6a3dab0 refactor(net)!: N34 阶段1 API 面收敛（对账⑤ + 删 3 个手动自愈 API） 
BREAKING CHANGE: 删除公开 API net_relisten / net_resync_listen /
net_can_accept 与消息类型 NET_MSG_RESYNC_LISTEN / NET_MSG_RELISTEN。
生产调用者为零（仅看门狗文档与 iec104 门控），应用侧无迁移成本；
如有外部消费者须改用对账/pump 自动机制（见下）。

1. 对账①扩展为①②⑤（F-NET-2 缺口，先补缺口再删 API）
   net_reconcile_tick 新增 bad=5：本层 ESTABLISHED 且芯片 0x05/0x01
   （Socket OPEN + TCP LISTEN，静默回收回监听、不发 DISCONNECT）
   → RESYNC 语义只修本层（state→LISTENING + last_peer_port 转登 +
   lost_conn_seen 清零 + 取消挂起 recv），**不发任何芯片命令**
   （纪律同 pump③ U11，run8 实证重下发会 170s 永拒）。
   原判据①要求 TCP==CLOSED、②要求本层 LISTENING，均不命中此形态
   ——此前生产无人认领（仅手动 API 能修）。
2. 删 net_relisten（net_socket.c 函数 + 消息分派 + 头文件声明）
   footgun：对健康监听器无条件 open→USE→close 自毁 ~1s（原注释自认）；
   与 pump(100ms)/D10(30ms) 完全重叠。
3. 删 net_resync_listen（同上；语义并入第 1 条）
4. 删 net_can_accept（net_socket.c + net_socket.h + sim 三处）
   只认 ESTABLISHED 的旧门控把"监听器在服役、待 CONNECT"窗口全挡掉，
   :2404 丢 CONNECT 探针因此从不运行；iec104 门控迁 net_listener_armed。
5. timeSync :8888 会话收尾不再 net_close（同 fd 续 accept，监听跨会话
   常驻；原 close→重建每会话一个 Trap 09 沉降窗）。server 脚本注释同步
   新契约（PC 侧 2s 宽限后自行关闭）。
6. lftpd 应用层阻塞重试退役：lftpd_inet_listen 5 轮(500ms/2000ms，最坏
   10s 阻塞 ftpTask) → 单次 + 失败即 425；cmd_pasv 3×200ms 同删。
   就绪屏障已消除 Trap 09 启动形态，客户端自带传输重试语义。

台架实证修正（本提交内二次修复，务必留痕）：
- net_listener_armed 补齐 **ESTABLISHED 放行**。首版迁移只放行
  LISTENING/CLOSED+残留，漏了 ESTABLISHED=单连接模型的"待 accept"电平
  → iec104 200ms 任务周期抢不过对账② 的 ~400ms 去抖，对账②先 standalone
  accept 转 ESTABLISHED 后 armed=0 → 应用整场不 accept，18/18 检查全 FAIL
  （设备日志证据：sock1 standalone accept 后无 i104 accepted，直至对端 FIN
  才由 closed-with-data 救回）。补放行后 18/18 PASS，且耗时 127s→8.3s。
  该态 accept 必返 fd，无 RPC 风暴风险。
- 期间顺带验证 M3 无辜：sock1 suspect DISCONNECT on live conn 命中后
  defer→对账①→closed-with-data accept 把未 accept 的 RX 数据救回，
  正是 M3 设计意图（资产门保护）。

验证（全绿）：@build 0/0（Code=209580；含 CH395F 套件+Phase13 全量重编
0/0 的编译验证）；@test PASS（回读无差异）；iec104 18/18（8.3s）；
n30 0/50；:21 @0ms 50/50 p50=512；:7003 50/50 p50=517；ftp_regression
11/11；Trap23 RST 5/5 + FIN 5/5；time_sync :8888 连续推送正常（RTC 更新、
无 [ERR]）。文档同步：BSD 指南（§3.3/3.6/10.1/10.2/12 + 变更记录）、
函数调用关系、监听生命周期设计说明、IEC104 上行设计说明、模拟器差距
清单、链路延迟测试说明。

门禁说明：doc-links 工作树 junction 伪影按既定口径 SKIP；mem-budget
分支 .map 漂移同前；cppcheck/coding-standard 手跑 Passed。
 2026-10-13 06:44:26 +08:00
wandering1 a8442410d1 feat(net): N-32 P1 会话结束电平化，消灭抢先 relisten 饿死消费者 
B10 根治 P1（不变量 I）：把"这条会话结束了"从 state==CLOSED 这一
**边沿**改成 session_dead **电平**，从结构上消掉两类事故。

问题：单连接复用模型下同一 fd 兼任监听器与连接（handle aliasing），
"会话结束"原先只能在 state==CLOSED 那一刻被观察到。别的路径抢先
relisten 回 LISTENING（对账④ / net_accept_locked 的 CLOSED 分支）
后，消费者再 recv 恒得 WOULDBLOCK → EOF 永久失踪：慢消费者被饿死、
新客户端数据被旧会话静默吸收。

改动：
- net_types.h：net_sock_t 增 session_dead（粘滞电平）
- 置位 4 处：handle_disconnect_event 释放分支、handle_timeout_event
  ESTABLISHED 分支、net_connect_locked 命令被拒、对账①（复用前者）
- 清零：handle_connect_event 两支；net_relisten_locked **刻意不清**
  （重建监听与"应用是否已确认会话结束"必须解耦，已注释钉住契约）
- net_recv_locked DONTWAIT 判据改 CLOSED || session_dead
- net_pending_tick ③ 断连判据同步改（**超出原清单的必要扩展**：不改
  则 lftpd 阻塞 recv 在抢先 relisten 后两头落空、只能干等超时）
- 两处 relisten 调用补内层 state==CLOSED 门：net_relisten_try 无
  状态门，对已 LISTENING 的 fd 再 open+listen 会因 USE 错误走进关闭
  分支、关掉正听着新 SYN 的 Socket（U12 同源事故）
- ui_net_sink：:563 真错误分支加 g_client != g_listen 护栏；EOF/
  错误后不再自行 bind_listen（消灭第 3/4 个重建所有者，不变量 II）
- 新增 net_listener_armed()（LISTENING 或 CLOSED+auto_relisten）替代
  accept 门控的 net_can_accept()——旧门控使 :7003 永不进 net_accept，
  net_lost_connect_probe（丢 CONNECT 补 accept，N-30）形同从未运行。
  MCU 与 net_socket_sim.c 双端实现（sim 端恒 1，保持改前行为）

验证：@build 0 错 0 警（Code=197096，基线 197084，+12B）；
mem-numbers 快照已 --write 刷新；cppcheck / C 规范 / 主机侧单测 12 套 /
双端注册 / CubeMX 存活 / 任务表 全绿。

⚠ 提交时 SKIP=doc-links：该钩子在从当前 v2-on-ui 切出的工作树上必报
2 处失效引用（RAM 方案文档 → ram_baseline.tsv / RAM预算台账.md），
属另一在途任务未提交的文件，主工作树磁盘上有故主线门禁呈绿。非本次
引入，不代为提交他人半成品；待其合入自动消解（见 并行任务工作树方案.md §10.2）。
 2026-10-12 13:06:23 +08:00
wandering1 d1e6bb4ba7 W5波+N-19收口：FTP鉴权落地、Trap25三连定案修复(N-30)、N-20/N-23/N-26 
N-19 FTP 鉴权：
- lftpd_auth（USER/PASS 状态机 + 连续5次失败锁60s）+ SHA-256
  (user||pwd) 口令哈希；config.ini [ftp] 段 user/pwd_hash/write，
  出厂 admin/admin 在用有启动告警；lftpd_log.c 删除并入 lftpd_auth
- ftp_cfg 配置读写；台架 ftp_auth_bench.py 13/13

N-30 / Trap 25（CH395F_Trap_Records.md 四次定案全记录）：
- 修复1 closed-with-data accept：客户端发完正常 FIN 后芯片按
  FUN_PARA(0x09) §5.52② 保留 Socket+RX 缓冲，旧代码把 CLOSED 一律
  relisten 自毁缓冲 → STOR 必挂 425；改为接受"已关但可读"连接排空
- 修复2 丢 CONNECT 中断探针 net_lost_connect_probe + last_peer_port
  幽灵甄别（拆链窗口握手完成但中断丢失，双信源去抖补 accept）
- 修复3 send_list/send_nlst 批量单发：背靠背 ~60B 小段毒化芯片 TX
  （芯片报 SEND_OK 但对端全丢），整份目录一次性写入
- 证伪存档：固定沉降/Socket 轮换冷却/listen 门控（台架 v7 矩阵）
- 台架工具 test/board/ch395f_reuse_bench.{c,h} + host 脚本存档
  （不注册编译；实验分支 n30-chip-bench 保留）

N-20：Error_Handler 死循环降级（记录+复位路径）
N-23：scripts/check_registration.py 双端注册反向校验（pre-commit）
N-26：GD5F NAND 直 DMA 调用方缓冲窗口断言

验证：BUILD_OK 0/0；ftp_regression 连跑 4 轮 11/11（修复前
LIST#4/#7 100% 挂、STOR#2 曾 100% 425）；ftp_auth_bench 13/13；
@test 启动标记 PASS；ci_local L0+L0.5 全过；doc-links 通过。
登记簿 N-30 已销项。
 2026-10-11 18:50:24 +08:00
wandering1 c936441c83 门禁扩容：新增 lv-conf-sync、simulator/ 纳入全部钩子；含 L3 定值/元件框架落地 
本轮把"自研代码落在门禁之外"的口子收掉，同时落地 LVGL 特性裁剪与
L3 保护定值/元件框架。

门禁（.pre-commit-config.yaml，26 个钩子）
- 新增 scripts/check_lv_conf_sync.py + 钩子 lv-conf-sync：比对两份
  lv_conf.h 的**生效值**（未定义则取 lv_conf_internal.h 兜底默认），
  抓 MISMATCH / LVGL 不认的宏名 / 同文件重复定义
- 顶层 exclude 删掉 simulator/：其下 21 个 tracked 文件全是本项目自研
  代码，生成物（build/、SDL2/、tests/ref/、shot*）已在 .gitignore；
  doc-links 的 exclude 同步删除
- lv-conf-sync 的 files: 覆盖两端配置 → 只改 simulator/lv_conf.h 也触发
  （pre-commit 4.x 已移除 always: true，实测只告警并跳过，无兜底开关）
- 新增 prot-set-unit-test / prot-elm-unit-test 两个主机侧单测钩子
- S11(2.3.5) 判定细化：禁的是"用路径找文件"，尖括号系统头带子目录
  （如 <sys/stat.h>）不再误报；全仓库复核仅 2 处项目代码判定变化

模拟器代码整改（纳入钩子后暴露，全部修代码而非豁免）
- cppcheck 4 处：sim_syslog.c 判空分支内解引用 p_epoch（真实 bug）、
  2 处 struct tm 未初始化、1 处指针可加 const
- coding-standard 61 处：44 处函数左大括号并到右括号同行、8 处补函数
  注释、3 处补文件头注释块、2 处 __ 前缀保护宏改 XXX_H、2 处 sprintf
  改 snprintf（写入字节数与原来完全一致）

LVGL 特性裁剪（F-1/F-2/F-3）
- 两端 lv_conf.h 对齐同一特性子集：删 26 个 LVGL 9.3 不存在的选项名、
  3 处重复定义，10 项靠默认值隐式生效的改为显式固化
- 实测对镜像体积中性；价值在防漂移，且模拟器 golden 回归跑的正是固件
  实际编译的配置

L3 软件侧
- App/algo/prot_set.* Q10 定值模型（范围校验 / 整表 all-or-nothing /
  校验和封存-自检-闭锁）+ prot_elm.* 通用"滞回+定时限"元件框架 7 实例
- test/host/prot_set、test/host/prot_elm 主机侧单测；uvprojx 挂载两处

文档同步
- pre-commit使用说明：§2.8 S11 口径、§2.15 lv-conf-sync 详解、新增 §5.5
  复盘（教训：exclude 只写真正不该进钩子的路径）
- AGENTS.md、UI_设计架构 §1.4 第 10 条、RAM 分析、审查报告刷新与销项

验证
- @build BUILD_OK 0/0（Code=194276 RO=15872 RW=876 ZI=139892）
- 模拟器重建：菜单 8 状态像素逐字节一致（池 5368 B）、11 内容页黄金参考
  全过（往返 5448 B）、remo sink 0/25600 位差异、--logtest/--cfgtest PASS
- 全仓库 cppcheck / coding-standard / no-mojibake --all-files 全过
- check_doc_links --all 129/0；check_mem_numbers --check 内存数字一致
- 端到端：往 simulator/lv_conf.h 注入一行漂移 → 钩子 FAIL（exit 1）
 2026-10-11 08:48:49 +08:00
wandering1 1d1a9d4656 net/ui: UI 推流加就绪门控，刷新脱离 netTask 往返（销项 N-10） 
新增 net_can_accept() / net_can_read()：纯 RAM 读 Socket 控制块，不入队、
不等 netTask 回执，供实时性敏感任务在发 RPC 前判断"有没有活"。
ui_net_sink_poll() 改为先门控再 RPC；无客户端时 RPC 从 100 msg/s 降到 0。

两条兜底（门控引入的新卡死路径，设计阶段未预见）：
- I-2 每 32 轮无条件 recv：readable 仅由 RECV_OK 中断置位，Trap 22 三类
  对账不含"RX 非空但 readable=0"，纯门控会把已到达的数据永久藏住；
- I-3 门控返 0 时查监听控制块，消失即 g_listen=-1 重建（改前靠每轮
  accept 撞 BADF 暴露，门控会连这条暴露路径一起消掉）。
net_can_read() 对非 ESTABLISHED / 非法 fd 故意返 1，让上层必得 EOF/BADF
走既有错误分支——返 0 会把死连接永久藏住。
模拟器后端恒返 1（Winsock 无 RPC 成本，行为逐位不变）。

实测：uis 50ms→1µs、uiw 50ms→11.4ms（只剩 LVGL）；@build 0 错 0 警、
@test 10/10 PASS（uis≤1µs、uisn≡0、0 task stall、0 [ERR]）、
check_remo_sink.py e2e 0/25600 位差异、内容页文本断言 50/50。
uip 最坏 61ms 是 LVGL 帧周期地板、与网络无关，判据已按实测修订。

方案 B（把推流搬出 uiTask + 帧 seqlock）已评估并决定不做：搬任务不会
让刷新变快，收益只剩极端并发下的观感隔离，成本含必改 .ioc 的 CubeMX
重生成。残留暴露与观测手段（uis/uisn）如实记录在 §9.4。
N-19 / C7 不入登记簿（当日结案），结论沉淀进问题记录 §9。
 2026-10-10 20:47:59 +08:00
wandering1 f81747f7e3 Merge branch 'v2-on-ui' into master
CI / L0 静态门禁 (pre-commit) (push) Has been cancelled
Details
CI / L0.5 主机侧单测 (MSVC) (push) Has been cancelled
Details 
把 v2-on-ui 开发主线（250 个提交）合并进 master：涵盖 B0 产品定义、
B1 ADC 采集链路、1 kHz TIM6 采样节拍、L1-3/L1-4 语义通道映射、
@build/@download 收敛到 .dsh/skills/ 下的 skill（删除 build.bat /
download.bat / reset.bat）等。

master 侧 3 个提交（.gitignore 忽略项 + simulator/sim_config.ini）
已保留，无冲突。
 2026-10-10 16:46:28 +08:00
wandering1 0779d3a075 栈整改不抬栈：删旧档迁移、FIL静态化、日志行缓冲按模块收紧、钩子脱离HAL，defaultTask链5312→2776B 2026-10-10 10:17:00 +08:00
wandering1 bf025e6f10 模拟器构建修复：CMakeLists配置引擎引用同步至App/cfg/与test/board/（重构遗留），--cfgtest四场景PASS，跨机验证清单⑤行更新 2026-10-02 23:09:53 +08:00
wandering1 33a4aa4945 本地工具路径DTU_*环境变量改造落地：10处调用点去硬编码+变量优先解析，本机全链路验证通过，文档同步收口，requirements补pre-commit 2026-10-02 22:14:49 +08:00
wandering1 8fa3d2eb69 新增PC模拟器配置文件sim_config.ini（网络参数唯一来源，经FTP下发设备） 2026-10-02 14:40:38 +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 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 e5733b3454 链路时延M1-M3收尾：Phase12-14基线与生产路径Δ实测、D10/E-02/D17修复、D20定位与硬化、文档整理 2026-09-22 06:12:40 +08:00
wandering1 c29b728153 E-01修复：poll超长守卫前置st.size根治死码，save输出上限收紧4096，写盘闸拦截与自检留痕 2026-09-22 01:28:10 +08:00
wandering1 bad5ceac0d 模拟器构建入口改VS版本自适应（新增build_sim，兼容VS2019/2022/2026）；文档同步并补SDL2 SDK下载步骤 2026-09-21 02:30:16 +08:00
wandering1 6f51c62a9e 串口输出禁中文：syslog 中文描述改 ASCII（MCU 6 处 + 模拟器 6 处） 2026-09-20 02:45:27 +08:00
wandering1 acd29d76d9 修复了一个malloc的问题 2026-09-18 17:46:46 +08:00
wandering1 1817fe792f 就绪屏障与配置引擎重构，新增串口助手、V0.0网表分析报告及芯片手册，同步更新文档 2026-09-15 21:13:20 +08:00
wandering1 9eb1bd63b4 运行/自检记录与待机屏：sys_log定长64B日志引擎(/log/*.log,FTP可直下)+记录页x2+待机屏+密码错误提示；字体122字/217字形 2026-09-14 19:05:00 +08:00
wandering1 bc4a7da8a0 模拟器迁移 P5：2s 配置轮询 + --cfgtest 无头自检；修复 MSVC rename 覆盖与外科保存截断缺陷 2026-09-14 09:33:32 +08:00
wandering1 97661415ca 通用配置文件 P1–P3：设计文档、FS 并发 A+ 定案、FatFs 墙钟接入、cfg_file 双端引擎与 net_cfg 集成（旧档 NCFG 首启迁移） 2026-09-14 02:15:49 +08:00
wandering1 1af76023a3 UI 文档：移除 HTML 制作流程改四阶段管线，RemoDispBus 文档移入 UI 设计目录 2026-09-13 17:05:51 +08:00
wandering1 d150810587 ui_net_sink 拆分为协议层与平台后端，新增 RemoDispBus 设计文档 2026-09-11 21:25:02 +08:00
wandering1 6298beffc9 模拟器新增 RemoDispBus 推流服务端，修复远端取图 2026-09-10 16:28:39 +08:00
wandering1 4515ee4c80 修复了网络参数的保存逻辑 2026-09-10 14:21:07 +08:00
wandering1 2b80d34e74 增加网络配置界面 2026-09-10 11:36:33 +08:00
wandering1 856b6f6426 写的页面架构 2026-09-09 17:15:04 +08:00
wandering1 24c2f57555 增加两页UI 2026-09-09 13:18:06 +08:00
wandering1 9ead5679a1 继续优化菜单RAM降低 2026-09-08 22:24:45 +08:00
wandering1 2b41bdccb5 UI 菜单初步完成 2026-09-07 10:48:18 +08:00
wandering1 89462d8aa1 完成一个主界面开发流程 2026-09-03 23:08:16 +08:00
wandering1 c14e9737fd 搭建LVGL仿真环境 2026-08-31 17:09:59 +08:00