test(host): P2 覆盖率批次，5 套主机单测与共享假 FatFs

P2 五个文件全部进分母（三名队友并行，写范围互斥、零越界）：
  net_socket 420 条 / 881-883=99.8%、52-52 函数（S1~S6 分片）
  sys_log_mcu 75 条 / 310-313=99.0%、12-12
  console_log 104 条 / 188-189=99.5%、15-15
  cfg_file_store_mcu 34 条 / 97-97=100%、10-10
  soe_store 26 条 / 78-79=98.7%、4-4
合计 659 条断言，P2 本体 1554-1561=99.6%、93-93 函数。

账：套件 28→33 全绿；files_tested 32→37；未触及 112→107（.c 34→29，
恒等式 29 = 0(P1剩) + 0(P2) + 29(P3) 咬合，§9 终点判据达成）；分母
4684→6245 插桩行；line 85.8%→89.3%；func 90.1%→92.2%（这批 5 个文件
全都以 ≥98.7% 进分母，故未摊薄）。--update-baseline 前后逐文件比对：
下降 0 个文件。

基建：新建 test/host/common/fatfs_fake.{h,c}（以真实 ff.h 为声明源、只
定义三文件实际调用的 9 个 f_*，缺哪个链接期响；卷忙/短写/FR_DENIED
可注入；短名违规分档）；扩展 ch395f_fake 为纯新增（g_fx/g_fxchip 另开
一份世界 + ext_reset 挂进既有复位，既有三套面一字不动），并按真头修正
两个错值常量（SOCKET_OPEN 0x01→0x05、TCP_ESTABLISHED 0x05→0x04），
另在 net_socket runner 加真头/假件同名常量文本核对闸（负例验证过）。
存量回归：net_listener 34、net_events 34、net_pending 43、net_select 22、
nand_port 149、lftpd_io 33、vol_lock 33、soe 32、cfg_file 151 全绿。

编号：补 TC-HOST-{NETSOCK,SYSLOG,CFGFST,SOESTORE,CONLOG} 五族（22→27，
先补族再引号）；net_socket 模块码由自取的两字母 NS 正名为 NETSOCK；
id-check 增量拦截无台账外新账，可判定比例 83.27%（基线 82.6%）。

文档：覆盖率口径 §9 新增「P2 落地」（含两套分母口径差、10 条现状表、
12 条可复用手法与并发红线），§8 第 1 条改「清单已吃穿」，补变更记录。
本提交未改任何生产代码（App/Drivers/Src/Lib/MDK-ARM 零触碰）。

10 条现状已逐条登记在 §9（含 sys_log_mcu.c:509~537 卷忙整批丢日志、
net_socket.c 同文件两套 IP 字节序、UDP 两 API 绕过 netTask），已获指示
全部修复，另开一轮（含测试字面量统一纯 ASCII）。

gate: pre-commit run --all-files → 39 hooks, 38 Passed; only mem-numbers
Failed（本工作树从未 @build，无 .map 事实源，属分支期已知陷阱）；
mem-budget Passed；test-coverage 与 id-check Passed。RAM/Flash 增量 = 0
（纯测试批次）。按仓内分支约定走 --no-verify，台账回填留待主树合并后。

test/host/net_socket/stub/FreeRTOS.h

@@ -0,0 +1,40 @@
+/*
+ * 模块名称：主机侧单测桩 - FreeRTOS.h（net_socket 模块专用）
+ * 模块功能：给宿主一份与 FreeRTOS 语义等价的类型定义。net_socket.c 用到 TaskHandle_t /
+ *           TickType_t / BaseType_t / eNotifyAction / pdTRUE / portMAX_DELAY，真实那份
+ *           经 portmacro.h 拉编译器与芯片寄存器，PC 上编不动。
+ *           ⚠ 枚举成员与取值照抄 Middlewares/.../include/task.h:92-97 与 projdefs.h:44
+ *           （eSetBits=0 起、pdTRUE=1、pdFALSE=0），改了就是换分母。
+ * ⚠ 仅供主机侧单测使用，不参与 MCU 构建。
+ * 创建日期：2026-10-24
+ */
+#ifndef FREERTOS_H
+#define FREERTOS_H
+
+#include <stddef.h>
+#include <stdint.h>
+
+typedef void       *TaskHandle_t;
+typedef long        BaseType_t;
+typedef unsigned long UBaseType_t;
+typedef uint32_t    TickType_t;
+
+#define pdFALSE           ((BaseType_t)0)
+#define pdTRUE            ((BaseType_t)1)
+#define pdPASS            pdTRUE
+#define pdFAIL            pdFALSE
+
+#ifndef portMAX_DELAY
+#define portMAX_DELAY     ((TickType_t)0xFFFFFFFFU)
+#endif
+
+/* 与真实 task.h 同序（eSetBits..eSetValueWithoutOverwrite），取值不可重排 */
+typedef enum {
+    eNoAction = 0,
+    eSetBits,
+    eIncrement,
+    eSetValueWithOverwrite,
+    eSetValueWithoutOverwrite
+} eNotifyAction;
+
+#endif /* FREERTOS_H */

test/host/net_socket/stub/ch395f.h

@@ -0,0 +1,10 @@
+/*
+ * 模块名称：主机侧单测桩 - ch395f.h（net_socket 模块入口）
+ * 模块功能：只做转发，真身在 test/host/common/ch395f_fake.h/.c（NET 域共享假芯片）。
+ * ⚠ 仅供主机侧单测使用，不参与 MCU 构建。
+ * 创建日期：2026-10-24
+ */
+#ifndef CH395F_H
+#define CH395F_H
+#include "ch395f_fake.h"
+#endif /* CH395F_H */

test/host/net_socket/stub/cmsis_os.h

@@ -0,0 +1,14 @@
+/*
+ * 模块名称：主机侧单测桩 - cmsis_os.h（net_socket 模块专用）
+ * 模块功能：net_socket.c include 的是 CMSIS-RTOS **v1** 头，但它实际用的 API
+ *           （osDelay / osMessageQueueGet/Put / osKernelGetState / osOK / osWaitForever）
+ *           全在 v2 头里。真实 v1 头会拉 FreeRTOS.h + task.h + cmsis_os2.h，
+ *           前两个由本目录桩接管，cmsis_os2.h 用**真实头**（只依赖 stdint/stddef，
+ *           宿主可编）——所以本桩就是一次转发，把 v2 的真实类型/枚举/原型接进来。
+ * ⚠ 仅供主机侧单测使用，不参与 MCU 构建。
+ * 创建日期：2026-10-24
+ */
+#ifndef CMSIS_OS_H
+#define CMSIS_OS_H
+#include "cmsis_os2.h"
+#endif /* CMSIS_OS_H */

test/host/net_socket/stub/dbg_log.h

@@ -0,0 +1,23 @@
+/*
+ * 模块名称：主机侧单测桩 - dbg_log.h（net_socket 模块专用）
+ * 模块功能：DBG_* 换成计数，风格与本目录既有 NET 域桩一致（net_listener / net_events
+ *           同名文件）。net_socket.c 有 11 条 DBG_ERROR + 6 条 DBG_INFO，其中
+ *           「短写必留痕」「版本门控拒置 bit3 必 [ERR]」「open 失败必 [ERR]」
+ *           「close 复位没成也放行仍要留痕」这四条本身就是可断言的契约。
+ *           本模块在 include 本头之前把 DBG_LINE_BUF_MAX 设为 128U（AGENTS 深调用链纪律），
+ *           桩不关心缓冲大小，只数条数。
+ * ⚠ 仅供主机侧单测使用，不参与 MCU 构建。
+ * 创建日期：2026-10-24
+ */
+#ifndef DBG_LOG_H
+#define DBG_LOG_H
+
+extern int g_ns_info_count;
+extern int g_ns_error_count;
+extern int g_ns_debug_count;
+
+#define DBG_INFO(fmt, ...)   do { (void)(fmt); g_ns_info_count++; } while (0)
+#define DBG_DEBUG(fmt, ...)  do { (void)(fmt); g_ns_debug_count++; } while (0)
+#define DBG_ERROR(fmt, ...)  do { (void)(fmt); g_ns_error_count++; } while (0)
+
+#endif /* DBG_LOG_H */

test/host/net_socket/stub/main.h

@@ -0,0 +1,35 @@
+/*
+ * 模块名称：主机侧单测桩 - main.h（net_socket 模块专用）
+ * 模块功能：net_socket.c 从真实 Inc/main.h 只要三样：HAL_GetTick（自旋/超时/挂起预算的
+ *           唯一致度源）、HAL_GPIO_ReadPin（轮询 CH395F INT#，低电平有效）、
+ *           CH395_INT_GPIO_Port / CH395_INT_Pin（Inc/main.h:60-61，PE5）。
+ *           引脚名/号按真实头转抄（真值改了就编译期/断言期报错），GPIO_TypeDef 用不透明
+ *           void*（本层不碰寄存器，只需类型能编）。
+ * ⚠ 仅供主机侧单测使用，不参与 MCU 构建。
+ * 创建日期：2026-10-24
+ */
+#ifndef MAIN_H
+#define MAIN_H
+
+#include <stdint.h>
+
+typedef void GPIO_TypeDef;
+
+typedef enum {
+    GPIO_PIN_RESET = 0,
+    GPIO_PIN_SET
+} GPIO_PinState;
+
+/* 转抄 Inc/main.h:60-61 */
+#define CH395_INT_Pin        0x0020U          /* GPIO_PIN_5 */
+#define CH395_INT_GPIO_Port  ((GPIO_TypeDef *)0)
+
+uint32_t HAL_GetTick(void);
+GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin);
+
+/* 每轮 net_poll 时基自走多少毫秒（默认 1ms：轮询本身就要花时间，自走才量得到
+ * NET_SEND_SPIN_MS 这类"有界自旋"预算；测试可置 0 造"时钟冻结"形态） */
+extern uint32_t g_ns_poll_tick_inc;
+extern uint32_t g_ns_poll_calls;   /* net_poll 经 GPIO 读 INT# 的次数（也是跑飞保险计数） */
+
+#endif /* MAIN_H */

test/host/net_socket/stub/net_latency_test.h

@@ -0,0 +1,9 @@
+/*
+ * 模块名称：主机侧单测桩 - net_latency_test.h（net_socket 模块专用）
+ * 模块功能：空壳，配合 TEST_LATENCY_PROBE 不定义即把 lat_* 调用全部条件编译掉。
+ * ⚠ 仅供主机侧单测使用，不参与 MCU 构建。
+ * 创建日期：2026-10-24
+ */
+#ifndef NET_LATENCY_TEST_H
+#define NET_LATENCY_TEST_H
+#endif /* NET_LATENCY_TEST_H */

test/host/net_socket/stub/ns_rtos.h

@@ -0,0 +1,84 @@
+/*
+ * 模块名称：假内核（net_socket 主机侧单测专用）
+ * 模块功能：给 net_socket.c 一份可在 PC 上跑的 FreeRTOS/CMSIS-RTOS2 薄壳——
+ *           消息队列（osMessageQueuePut/Get，真实 cmsis_os2.h 的原型）、
+ *           任务通知（xTaskNotify / xTaskNotifyWait）、当前任务句柄、时基、临界区计数。
+ *
+ * ⚠ 仅供 test/host/net_socket/ 使用，不参与 MCU 构建。
+ *
+ * 关键设计：**阻塞等待即调度点**。net_wait_result 的第二段
+ * xTaskNotifyWait(..., portMAX_DELAY) 在真机上是"睡到 netTask 回执"；这里把这一次
+ * 等待实现成"调用测试装泵的 pump 钩子（= 以 netTask 身份跑一轮
+ * net_process_messages()），再拾取通知值"。于是单次 net_send()/net_recv() 调用就能
+ * 把"入队 → 分派 → 通知值回传 → 调用方恢复 errno"整条跨上下文链真实跑完，
+ * 而不是把中间环节假掉。
+ *
+ * 泵保险：pump 钩子最多跑 NS_PUMP_MAX 轮，超了直接 exit(2)——否则一条"该通知却没通知"
+ * 的缺陷会让门禁挂死而不是报错（本仓假 osDelay 的跑飞保险同一条纪律）。
+ *
+ * 创建日期：2026-10-24
+ */
+#ifndef NS_RTOS_H
+#define NS_RTOS_H
+
+#include "FreeRTOS.h"
+#include "cmsis_os2.h"
+#include "main.h"          /* 桩：HAL_GetTick / HAL_GPIO_ReadPin / CH395_INT_* */
+
+#define NS_Q_CAP      8u
+#define NS_PUMP_MAX  50
+
+/* 两个假任务：调用方任务 + netTask（句柄取地址即唯一） */
+extern int g_ns_task_caller;
+extern int g_ns_task_net;
+
+/* 当前任务句柄（测试直接读写：切换"我是调用方"还是"我是 netTask"） */
+extern TaskHandle_t g_ns_cur_task;
+
+/* 阻塞等待时跑的泵（测试装：通常 = 跑一轮 net_process_messages） */
+typedef void (*ns_pump_fn)(void);
+extern ns_pump_fn g_ns_pump;
+extern int        g_ns_pump_calls;      /* 泵被驱动的次数 */
+extern int        g_ns_block_waits;     /* 真正走到"阻塞分支"的次数 */
+
+/* 通知/队列观测面 */
+extern int        g_ns_notify_calls;    /* xTaskNotify 总次数 */
+extern uint32_t   g_ns_notify_last_val;
+extern TaskHandle_t g_ns_notify_last_to;
+extern int        g_ns_put_calls;
+extern int        g_ns_get_calls;
+extern int        g_ns_crit_enter;
+extern int        g_ns_crit_exit;
+extern uint32_t   g_ns_tick;
+
+void ns_rtos_reset(void);
+void ns_rtos_q_flush(void);
+int  ns_rtos_q_count(void);
+void ns_rtos_q_fill(int n);             /* 预灌 n 条占位消息（把队列灌到满，测 BUSY 分支） */
+
+/* 测试用的显式通知投递（不经队列，直接给某任务置通知值） */
+void ns_rtos_post_notify(TaskHandle_t to, uint32_t v);
+
+/* 手工投一条原始消息（绕过公开包装器：造未知 type、造 netTask 自调等异常形态） */
+int  ns_rtos_q_put_raw(const net_msg_t *msg);
+
+/* —— 下面是给桩头对接的实现（原型与真实头一致） —— */
+osStatus_t osMessageQueuePut(osMessageQueueId_t mq_id, const void *msg_ptr,
+                             uint8_t msg_prio, uint32_t timeout);
+osStatus_t osMessageQueueGet(osMessageQueueId_t mq_id, void *msg_ptr,
+                             uint8_t *msg_prio, uint32_t timeout);
+osKernelState_t osKernelGetState(void);
+osStatus_t osDelay(uint32_t ticks);
+
+/* 每轮 net_poll（= 一次 INT# 读取）都调一下测试回调：用来在"等待发送缓冲/等待数据"
+ * 的循环途中投递并发事件（对端断线、芯片突然可读），而不必自己发明时间 API */
+typedef void (*ns_poll_hook_fn)(void);
+extern ns_poll_hook_fn g_ns_on_poll;
+
+/* CH395F INT# 电平（1=SET 无中断，net_poll 走短路分支） */
+extern int g_ns_int_pin_set;
+
+/* 内核状态可注入（net_errno_slot 靠它判"内核没跑起来"的退化分支） */
+extern osKernelState_t g_ns_kernel_state;
+
+#endif /* NS_RTOS_H */

test/host/net_socket/stub/task.h

@@ -0,0 +1,32 @@
+/*
+ * 模块名称：主机侧单测桩 - task.h（net_socket 模块专用）
+ * 模块功能：声明 net_socket.c 用到的三件套 + 临界区宏。原型与真实
+ *           Middlewares/.../include/task.h 逐字一致（返回值/参数顺序都不许改），
+ *           实现在 ns_rtos.c（假内核：任务通知值 + 当前任务句柄可切换）。
+ *           taskENTER_CRITICAL/EXIT_CRITICAL 记计数——临界区只存在于本层槽位分配，
+ *           计数能断言"只在占槽时进临界区、且成对退出"。
+ * ⚠ 仅供主机侧单测使用，不参与 MCU 构建。
+ * 创建日期：2026-10-24
+ */
+#ifndef TASK_H
+#define TASK_H
+
+#include "FreeRTOS.h"
+
+TaskHandle_t xTaskGetCurrentTaskHandle(void);
+BaseType_t   xTaskNotify(TaskHandle_t xTaskToNotify, uint32_t ulValue,
+                         eNotifyAction eAction);
+BaseType_t   xTaskNotifyWait(uint32_t ulBitsToClearOnEntry,
+                             uint32_t ulBitsToClearOnExit,
+                             uint32_t *pulNotificationValue,
+                             TickType_t xTicksToWait);
+uint32_t     xTaskGetTickCount(void);
+
+int  ns_os_crit_depth(void);
+void ns_os_enter_critical(void);
+void ns_os_exit_critical(void);
+
+#define taskENTER_CRITICAL()   ns_os_enter_critical()
+#define taskEXIT_CRITICAL()    ns_os_exit_critical()
+
+#endif /* TASK_H */

test/host/net_socket/stub/test_config.h

@@ -0,0 +1,11 @@
+/*
+ * 模块名称：主机侧单测桩 - test_config.h（net_socket 模块专用）
+ * 模块功能：空壳。net_socket.c 只在 TEST_LATENCY_PROBE 打开时才用延迟探针，
+ *           主机单测刻意**不开**（探针要写真实时间/真实周期计数，不是被测对象）；
+ *           也不定义 NET_BENCH_CMD_LOG（压测命令日志同理，见 net_events 同名说明）。
+ * ⚠ 仅供主机侧单测使用，不参与 MCU 构建。
+ * 创建日期：2026-10-24
+ */
+#ifndef TEST_CONFIG_H
+#define TEST_CONFIG_H
+#endif /* TEST_CONFIG_H */