Files
STM32F4-Base/simulator/sim
wandering1 04ee5867b4 fix(net): 建立网络 fd 失效值契约,杜绝零初始化误判
根因:静态 fd 零初始化为 0,而 0 是合法 socket 句柄;判据用 >=0
会把"未初始化"误判成"有效",关闭时误伤他人 fd。本次把该修复
契约化、机械化,而不是再补一个点。

- 新增 net_fd.h 定义唯一失效值 NET_FD_INVALID(-1),全仓零依赖复用
- fd 判据只用 ==/!= NET_FD_INVALID,禁 >=0/<0/数值形态/if(fd)
- 网络层内部用 NET_FD_IN_RANGE 做范围校验,上界不外泄
- 主机 fake 改 0 基并跟踪已分配 fd,补冷启动回归(变异测试可捕获)
- 新增 net-handle 静态门禁(钩子 53)+ 契约文档 + 审计 + 最小加固

验证:net-handle 487 文件 0 违规;8 个主机套件全绿;Keil 0 错误 0 警告;
审计 3 确认/5 疑似/35 安全,无第二处生产误判。
2026-11-18 22:20:00 +08:00
..

simulator/sim/ — 模拟器平台层

PC 端 LVGL 模拟器的平台适配层:把 MCU 侧的硬件/RTOS 接口替换成 PC 实现, 使 UI 源码(Drivers/BSP/UI/)与固件共用同一套代码。

文件一览

文件 替换的 MCU 侧实现 作用
sim_port.c/h ui_port.c 显示/输入移植层:SDL 窗口 → LVGL 显示驱动 + 键鼠/触摸输入
net_socket_sim.c net_socket.c 网络 Socket 的 PC 实现(宿主 BSD socket)
cfg_file_store_sim.c cfg_file_store_mcu.c 配置存储的 PC 后端(宿主堆)
sim_syslog.c sys_log_mcu.c 日志的 PC 实现(写文件而非 NAND)
ui_net_sink_backend_sim.c ui_net_sink_backend_mcu.c 推流后端的 PC 实现
sim_latency_stub.c — 时延打桩(模拟链路延迟,供测试)

设计模式

MCU 与模拟器共用核心逻辑,仅后端不同:

      共享核心(无分配符号)
      ├── cfg_file.c(配置引擎)
      └── ui_*(LVGL UI)
             ↓ 后端抽象接口
   ┌─────────┴─────────┐
MCU 后端(本工程 *_mcu.c)  PC 后端(本目录 *_sim.c)

配置引擎后端:MCU = FreeRTOS 堆、模拟器 = 宿主堆,共享核心零分配符号。

相关文档

  • 模拟器总说明:../README.md
  • UI 架构与移植要点:docs/UI设计/UI_设计架构.md
  • 模拟器部署:docs/UI设计/LVGL模拟器部署与使用说明.md