 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
|
54d6d2d5d5
|
docs: 删除 Task #32 停摆分析（已结案），可复用结论并入看门狗设计说明 §11
按登记簿"完成即销项"规则删除 docs/问题记录/UI任务看门狗停摆分析.md
（560 行）。结案依据：累计 38 次上板启动 0 复现（原 L2 基线 3/10），
P0/P1-4a/P1-5/P2/方案 A 全部落地，方案 B 已评估决定不做。
并入 docs/子系统设计/看门狗设计说明.md 新增 §11（只留可复用部分）：
- §11.1 三条易误读的判读口径：启动期 MISS start 0x67 是良性 episode；
miss= 是累计不是连续（连续数饱和在 WD_MISS_TOLERANCE=8）；
reset cause 不能区分 IWDG 溢出与台架软件复位
- §11.2 诊断四步：先看掩码缺几位（只缺 1 位 = 定点打击，多位 = 全局
饥饿）→ 逐项量化占空比（实测 10%~13%，否掉"CPU 饱和"直觉）→
用计数速率反证空转（ring 恰好 1000/s）→ 用 [PROF] 指认占用者
- §11.3 三条结构性脆弱点（uiTask 唯一 BelowNormal／心跳曾依赖 netTask
往返／自定截止期不可恢复）+ 两个顺带修掉的正确性缺陷（无新帧仍压环
≈3% 频率失配、失败拍静默沿用旧值）
- §11.4 [PROF]/[PROF2] 全字段语义 + v2.8 实测基线（netp=0 是真实值、
adcm 峰值来自心跳日志、uip 地板 = LVGL 帧周期）与三机理判读口诀
- §11.5 三条教训：门控类优化必须保留低频兜底；门控会顺手消灭暴露路径；
事件驱动要核对节拍源启动时刻 vs 消费者创建时刻
- §11.6 明确不做的四条及理由（提 uiTask 优先级会掩盖真缺陷、net_* 有界
等待版会串回执、推流搬出 uiTask、推流塞进 netTask）
UI 推流门控与方案 B 否决理由收进 RemoDispBus 协议说明 §3（该处原本已有
摘要，改为自洽不再回指）；就绪门控 API 的约束已在 BSD Socket 指南 §10.1。
引用改指 12 处：ui_task.c、task_prof.c/.h、ui_net_sink.c/.h、docs/README、
RemoDispBus、看门狗设计说明 R7 行、ADC 采样节拍设计说明、BSD Socket 指南
×2、项目审查报告 N-10 ×2。
⚠ ui_task.c / ui_net_sink.c / ui_net_sink.h 是带 BOM 文件，Edit 剥掉了
BOM，已按原样补回 3 字节 EF BB BF（未整文件重写）。
验证：check_doc_links --all 通过（127 个文档，无悬空引用）；
@build 0 错 0 警，Code=257660 与删除前一字不差（纯注释改动）。
|
2026-10-11 00:38:50 +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
|
bb76cfd779
|
修复规范矛盾并定案5项规则，保护宏统一XXX_H
规则定案：常量在右（a>5）、保护宏XXX_H（禁双下划线）、
头文件常量用#define、存储类前缀（g_/s_）优先、允许void返回值
全库32个.h头文件保护宏 __XXX_H → XXX_H 改名（字节级替换）
S1检查规则同步更新（拒绝双下划线），Inc/gpio.h 反向验证被正确拦截
规范示例矛盾修复：K&R括号、标准类型、变量初始化、命名常量、注释字段补全
|
2026-09-01 16:07:00 +08:00 |
|
|
wandering1
|
e2f199c6bf
|
LVGL 库提交
|
2026-08-30 08:57:07 +08:00 |
|