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

32 Commits

Author SHA1 Message Date
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 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 1780e5320b 实施A2/A3/A4并通过真机验证：net_task失败重试自检、ch395f有限超时故障锁存、remo_send短写阻断；@test 7/7，A1含配置持久化闭环 2026-10-03 09:05:57 +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 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 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
wandering1 a7d4339e6f CCM扩容FreeRTOS堆+DMA阈值1024防栈缓冲进CCM+HardFault现场报告与栈/内存钩子+修defaultTask栈溢出+LVGL绘制缓冲护栏+存储套件05/06与恢复模式 2026-09-21 00:47:58 +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 508577bbf0 UI 生成文件按工程约定产出：生成器补文件头、K&R 大括号与版本守卫压平 
- gen_menu.py：ui_menu_tab.h/.c 输出工程标准文件头，5 个函数定义改 K&R 大括号
- make_font.py：新增 normalize_project_conventions 后处理——工程文件头
  （替换内嵌绝对路径的 lv_font_conv 头注释）、包含收敛为 #include "lvgl.h"、
  LVGL 9.3.0 版本守卫静态压平（含守卫宏定义清理）
- 重生成 ui_font_cn_12.c / ui_menu_tab.c / ui_menu_tab.h：仅头部/大括号/守卫
  行变化，字形数据与菜单表逐字节不变
- 两文件随之满足规范检查，pre-commit 中无需再排除（配合上一提交生效）

验证：pre-commit 全钩子通过、模拟器 0 警、菜单/内容页像素回归 PASS、Keil 0 错 0 警
 2026-09-13 19:38:30 +08:00
wandering1 34528a9798 UI 代码纳入规范检查：大括号 K&R 化、strcpy 换 memcpy 等违规修复 
- pre-commit 配置：移除 Drivers/BSP/UI/ 整目录排除，14 个 UI 源文件全部受 cppcheck + 规范检查
- ui_net_sink.c：11 处 Allman 大括号归并 K&R，i/c 声明改即用
- ui_port.c：7 处大括号归并
- ui_net_sink_backend_mcu.c：2 处大括号归并
- ui_menu_view.c：menu_frame_t 指针改 const
- ui_page_net_cfg.c：6 处 strcpy 改 memcpy

验证：pre-commit 全钩子通过、模拟器 0 警、菜单/内容页像素回归 PASS、Keil 0 错 0 警
 2026-09-13 19:38:14 +08:00
wandering1 54e8356295 UI 代码：补全 remo_handle/cp_draw 注释，拆分 cp_draw_cb 绘制函数 2026-09-13 17:04:12 +08:00
wandering1 d150810587 ui_net_sink 拆分为协议层与平台后端，新增 RemoDispBus 设计文档 2026-09-11 21:25:02 +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 6662f3a455 修改菜单显示方式 2026-09-08 21:07:04 +08:00
wandering1 891c9ef0d9 增加UI 代码的注释 2026-09-08 18:36:01 +08:00
wandering1 2b41bdccb5 UI 菜单初步完成 2026-09-07 10:48:18 +08:00
wandering1 89462d8aa1 完成一个主界面开发流程 2026-09-03 23:08:16 +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 ae8b1aead5 清理全库行尾空格与文件尾换行（pre-commit 自动修复基线） 2026-09-01 10:24:50 +08:00
wandering1 2d2774124e 正常运行了 2026-08-31 15:11:18 +08:00
wandering1 67370888a1 构建初始UI界面 2026-08-30 13:30:59 +08:00
wandering1 e2f199c6bf LVGL 库提交 2026-08-30 08:57:07 +08:00