Files
STM32F4-Base/test/host/iec104_netmcu/net_socket_fake.h
T
wandering1 90cc9a7d99 feat(iec104): 把 104 骨架完整迁到 MCU 板端并在台架跑通总召
把 IEC104 从模拟器端整体搬到板端:协议栈原先由独立 iec104Task 驱动,
现在改为 netTask 单 owner 的 threadless 驱动,退役独立任务。

驱动与后端:
- 新增 iec104_net_mcu.c/.h,实现 IEC104_Net.h 的 11 个 ABI 函数,
  用槽表加单调句柄映射 net_socket 的单 fd 模型;CLIENT 拆除只走
  net_drop_conn_locked,绝不 net_close 监听 fd。
- net_socket 增 5 个 owner-only 接口(net_accept_locked、
  net_drop_conn_locked、net_pending_bytes、net_send_try、
  net_mono_now_ms)。
- iec104_serv.c 重写为 iec104_serv_net_tick(),在 netTask 1ms 主循环
  里驱动 core;无 osDelay/阻塞调用,喂狗是第一句。
- Src/freertos.c 删除 iec104Task 三件套,对应栈水位探针表项同步删除。

内存:目标板 192KB SRAM 装不下 vendor 默认容量档,按实测裁剪到
skeleton 档(TCP 缓冲、业务池、SOE 256->128、值槽密集化),
RW_IRAM1 118,408 B / 90.3%,留 2,178 B 余量。

台架修复(只在真硬件暴露):
- SNTP s_ctx.fd 零初始化后为 0,而 net fd 0 是合法槽位下标,
  首次代次变化时误 net_close(0) 关掉 ftpTask 的监听槽,导致 104
  连接被 FTP 的 220 banner 抢走;改为显式 .fd = -1。
- Accept 幂等:单 fd 模型下 vendor 每轮重试 Accept 会拿到同一 fd,
  后端改为会话在役时返 WOULD_BLOCK,Close 不再清槽。

验证:
- Keil 全量重建 0 error 0 warning,uvprojx 零抖动。
- 模拟器真实 TCP 13/13、transport 10/10。
- netmcu 后端单测 13/13(新增 N12)。
- 台架 serial-boot-test required 全中;板端 2404 总召 129 帧收到
  59 遥信(53 有源、全 IV)+ 16 双点 + 30 遥测(PT1 三相非零、
  UN/频率/温度按未标定置 IV)、遥控选择执行全否定、校时 COT 7。
- 期间顺带修正 UI 漂移自检文案、.serialtest required 陈旧项、
  coding-standard 对 vendor 与外部 ABI 名字的排除口径。
2026-11-18 10:29:18 +08:00

137 lines
6.2 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/*
* FAKE net_socket —— 板端 IEC104 Net 后端(iec104_net_mcu.c)的隔离契约测试替身。
*
* 定位:这不是产品实现,只在 test/host/iec104_netmcu/ 下被测试单元链接。
* 它按 Drivers/BSP/NET/net_socket.h 的**对外语义**实现 net_* 子集,
* 把 CH395F 侧的全部不确定性变成测试可控的开关。
*
* 被仿真的真实约束(每条都对应 MATRIX.md 里至少一个用例):
* 1. 单连接模型:net_accept() 交回的“客户端 fd”就是监听 fd 自身(同一整数);
* 对监听 fd 调 net_close() 会连监听一起毁掉 —— fake 里监听 fd 的
* net_close 直接返回 -1 并置 fault_listen_closed,让违规可被判红。
* 拆除会话的正解是 net_drop_conn()(保留监听、异步重建)。
* 2. net_send/net_recv/net_accept 均可短写 / WOULD_BLOCK / BUSY(RETRY)。
* 3. 接收侧没有 FIONREAD;“内核接收队列字节数”由 ch395f_get_recv_len() 等价
* 接口提供,fake 用 net_fake_recv_len() 暴露同一个值,并支持“降级”模式
* (返回 0 或未定义值),用于验证 Pending_Input 的降级契约。
* 4. 网络代次:net_generation_inc() 之后旧 fd 一律 NET_ERR_BADF(模拟芯片
* 复位/重连后句柄失效),新 listen 拿到新 fd。
* 5. 32 位节拍:net_fake_tick() 是板端 tick 的低 32 位,测试可直接把它
* 摆到 0xFFFFFFFF 验证回绕扩展。
*
* 未实现(故意):UDP、事件回调、net_select 的就绪判定细节、FreeRTOS 队列。
* 板端后端若调用这些,链接期会直接失败 —— 这正是我们要知道的“后端越界”。
*/
#ifndef NET_SOCKET_FAKE_H
#define NET_SOCKET_FAKE_H
#include <stdint.h>
#include "net_types.h"
#ifdef __cplusplus
extern "C" {
#endif
/* ---------------------------- 控制面(仅测试用) ---------------------------- */
/* net_socket.h 的真实声明由产品头文件提供;本 fake 的 .c 通过产品 include 路径包含它。 */
#include "net_socket.h"
/* reset 到“干净上电”:无监听、无会话、无在途数据;监听 fd 由后端的
* IEC104_Net_Listen → net_socket/bind/listen 创建(单连接模型下这个整数
* 会同时充当客户端句柄)。 */
void net_fake_reset(void);
/* 建一个待接入的客户端(对端 10.0.0.x)。false = 队列已满。 */
int net_fake_peer_arrive(uint8_t last_octet, uint16_t port);
/* 往当前会话的接收队列灌数据(模拟对端已发出的字节)。 */
int net_fake_push_rx(const void *data, int len);
/* 模拟对端关闭(有序 FIN)。下一次 recv 在排空后返回 0。 */
void net_fake_peer_fin(void);
/* 模拟对端 RST(异常断链)。 */
void net_fake_peer_reset(void);
/* 控制下一次(或此后 n 次)net_send 的行为。 */
typedef enum {
FAKE_SEND_NORMAL = 0, /* 有多少收多少 */
FAKE_SEND_SHORT, /* 只收 short_limit 字节,其余留待下次 */
FAKE_SEND_WOULDBLOCK, /* 返回 NET_ERR_WOULDBLOCK,不接受任何字节 */
FAKE_SEND_BUSY, /* 返回 NET_ERR_BUSY(RETRY 语义) */
FAKE_SEND_ZERO_OK /* 返回 0 字节但 net_send 视为成功(OK 但零进度) */
} net_fake_send_mode_t;
void net_fake_set_send_mode(net_fake_send_mode_t mode, int times, int short_limit);
/* 控制下一次 net_accept 的行为。 */
typedef enum {
FAKE_ACCEPT_NORMAL = 0,
FAKE_ACCEPT_WOULDBLOCK,
FAKE_ACCEPT_BUSY, /* RETRY */
FAKE_ACCEPT_RESOURCE_LOW /* RETRY_LATER:芯片 socket 池暂缺 */
} net_fake_accept_mode_t;
void net_fake_set_accept_mode(net_fake_accept_mode_t mode, int times);
/* recv 侧故障注入:下一次 recv 返回 WOULD_BLOCK / BUSY。 */
void net_fake_set_recv_mode(net_fake_send_mode_t mode, int times);
/* 接收队列长度的“降级”契约:0 = 精确值;1 = 芯片查不到(返回 0xFFFF 哨兵),
* 2 = 恒返回小值 1(报小,但仍有数据;上层须有界续收而非一次即停)。
* 裸 0 与“真的空”不可区分,所以 fake 用 0xFFFF 表达“查询不可信”。 */
void net_fake_set_recv_len_degraded(int mode);
/* 网络代次:模拟芯片复位/重连。旧 fd 一律 NET_ERR_BADF;本 fake 直接调用
* 产品 net_socket.h 声明的 net_generation_inc() 递增代次,不做另一套计数器。 */
void net_fake_generation_inc(void);
uint32_t net_fake_generation(void);
/* 32 位 tick(板端节拍低 32 位)。 */
void net_fake_set_tick(uint32_t tick_low);
uint32_t net_fake_tick_low(void);
/* 执行上下文开关:1 = netTask owner(默认),0 = 非 owner。
* N9 用它验证后端每个入口自己拒绝,且底层硬件面零访问。 */
void net_fake_set_owner(uint8_t owner);
uint8_t net_fake_owner(void);
/* 观测:测试用来断言后端“没干坏事”。 */
typedef struct {
int listen_closed_attempts; /* 对监听 fd 调 net_close 的次数(必须始终 0) */
int close_calls;
int drop_conn_calls;
int accept_calls;
int send_calls;
int recv_calls;
int recv_len_calls;
int would_block_returns; /* 所有接口返回 WOULD_BLOCK 的累计 */
int busy_returns; /* 所有接口返回 BUSY 的累计 */
int bytes_sent; /* 实际被内核接受的字节数 */
int hardware_calls; /* 任何 net_* 底层动作计数(N9 必须零增长) */
uint8_t last_peer_ip[4]; /* 最近一次 accept 交出的对端 IP */
uint16_t last_peer_port;
} net_fake_stats_t;
void net_fake_stats(net_fake_stats_t *out);
void net_fake_stats_reset(void);
/* 当前会话 fd(未接入时为 -1)。同一时刻只允许一个会话(单连接模型)。 */
int net_fake_session_fd(void);
int net_fake_listen_fd(void);
/* close 后是否允许 fd 复用(默认 1;B6 的假后端会关掉它来制造复用)。 */
void net_fake_set_reuse_after_close(int on);
/* 读取 fake 内核已接受的发送字节(验证 Send 不借用调用方 buffer)。 */
int net_fake_copy_tx(uint8_t *data, int capacity);
/* 直接读取 fake 监听 armed 状态(= net_listener_armed 的同源状态)。 */
int net_fake_listener_armed(void);
#ifdef __cplusplus
}
#endif
#endif /* NET_SOCKET_FAKE_H */