Files
STM32F4-Base/test/host/common/ch395f_fake.c
T
wandering1 0a3b932395 test(NET): 假 CH395F 芯片落地 + net_listener 模块(34 条,覆盖 99.2%)
按 §9 规格做假芯片的第一批消费者。新增 test/host/common/ch395f_fake.{h,c}:15 个
函数的**真实原型逐字照抄**(含 ch395f_sock_state_t{open,tcp_state} 与 ERR_SUCCESS/
PROTO_TYPE_TCP/SOCKET_CLOSED/TCP_CLOSED/TCP_LISTEN 的真实取值),脚本化模型沿用本仓
既有假件风格:读函数按调用序号取返回队列(耗尽回落最后一个值)、写函数记次数与
最近入参、外加一条**调用顺序日志**让时序契约可断言。两条芯片怪癖必须复刻:
① get_sock_int_status **整体读即清**、无按位清除手段(AGENTS 模块约定 B3 实证坑,
不复刻就照不出"顺手全量清一遍把别的在用 Socket 门焊死");② *_cached 是**缓存值**
而非现场值,"监听还活着"的判据是 (open != CLOSED && tcp_state == LISTEN)。
各模块 stub/ch395f.h **只做转发** include 共享件(规格里拍板的方案):三份假芯片各自
漂移会让"假件与被测代码同时错"再也报不出来,签名与常量只能有一份定义。

新增 test/host/net_listener/,34 条断言,net_listener.c 覆盖 125/126 = **99.2%**。
钉住的契约(真机上一闪而过、台架凑不齐的组合):
- 四道互相牵制的时间闸门:30ms 退避(20ms 不重试、30ms 重试)、隔离级 400ms 与
  优雅级 100ms(399ms/99ms 不放行、400ms/100ms 放行)、**800ms 上限只留痕且不放弃
  请求**(留痕只打一次,到 2000ms 预算耗尽才报 ERROR 交对账器)。排期登记里那句
  "沉降窗 800ms 上限只留痕"至此第一次有了可执行的验证。
- 该不该重建:芯片仍报 LISTEN 就不重建且清空请求;有挂起 recv/send 时让路但**保留
  请求**(挂起结束自动补做);五种条件静默放弃(非 LISTENING/CLOSED 态、
  auto_relisten=0、非 STREAM、local_port=0、in_use=0)。
- 失败不留半成品:open 失败关回去并回 BUSY;listen 失败也必须 close_socket。
- 重建后簿记:转 LISTENING、清 send_ready/recv_bytes/remote_ip(_arr)/remote_port、旧
  remote_port 记进 last_peer_port、清 lost_conn_seen/released_abnormal;源端口与协议
  取自表项本身(监听端口不能漂)。
- 芯片时序:清接收 → 关断 → 读即清 → 读状态(顺序不可换);清理接收区单次读钳到
  256B、最多 16 轮、读到空即停。越界 fd 全程静默且不打扰芯片;请求去重保留首个 reason。

测试自查修了两处(都不是生产问题但值得记):
① reset_all 只复位假世界、**没复位被测模块自己的 static**(s_relisten_req/_next/_dead/
_quarantine/_settle_*/_capped),一上来红了 9 条;改用模块自带的 net_listener_clear()
清,顺带验证了 clear 的完整性。
② 沉降窗边界必须在**独立场景**测:放行判定与 30ms 退避共用 s_relisten_next,同一条
链里"恰好 400ms"那轮 tick 会被上一轮设的退避槽挡掉。这本身是个该知道的事实——
**hold 到点后最坏还要再等一个退避周期(实测 ≤30ms)才真正放行**,已写进用例注释。
另留痕一处死分支:net_relisten_locked 的 NET_ERR_BADF 从 tick **不可达**(tick 在调用
前就因表项为空放弃),TC-NETLIS-026 记着,新增调用点时要重新审视。

桩的口径:net_listener.h/net_types.h/net_config.h/net_pending.h 用**真实头**(net_sock_t
字段与各枚举一改即编译期报错);net_socket.h 是桩,但 net_set_errno 与 NET_ERR_RETURN_1
照抄真实头同名宏(net_socket.h:528/532);真实 net_pending.h 原型带 TaskHandle_t,故
宿主 FreeRTOS.h 补一个 void* typedef(只出现在签名里,被测代码从不传它)。

覆盖率与台账:套件 22 → 23 全绿;files_tested 26 → 27;未触及 .c 40 → 39;分母
3,446 → 3,572 行;line=3128/3572(87.6%,本批净涨因为新进来的文件几乎全绿)、
func=243/266(91.3%)。恒等式 39 = 5(P1 剩) + 5(P2) + 29(P3) 仍咬合。编号补建
TC-HOST-NETLIS(游标 026),族数 16 → 17;注册表仍只做增量插入。

自查:test-cppcheck Passed(连假芯片一起过);check_ids --strict 通过;doc-links 35 处
(= 存量);新增文件 BOM/CR/U+FFFD/行尾逐项净。**本增量零生产代码改动**,未跑 @build。
--all-files 仍只有 mem-numbers / mem-budget(.map 台账漂移,等 Lead 合并后统一回填)
与 ui-golden(ref/*.bin 不入库,新 worktree 天生没有黄金参考)三条失败,与本分支无关。
2026-10-23 23:44:50 +08:00

199 lines
5.0 KiB
C

/*
* 模块名称:假 CH395F 芯片实现(NET 域主机侧单测共享件)
* 模块功能:实现 ch395f_fake.h 声明的假芯片。由测试单元 #include 本 .c 使用
* (本仓主机单测的既有做法:生产源与假件都进同一个 TU)。
* 创建日期:2026-10-23
*/
#include <string.h>
#include "ch395f_fake.h"
ch395f_fake_world_t g_fake;
ch395f_fake_obs_t g_chip;
static void fake_log(char c)
{
if (g_chip.log_n < (CH395F_FAKE_LOG_LEN - 1)) {
g_chip.log[g_chip.log_n++] = c;
g_chip.log[g_chip.log_n] = '\0';
}
}
void ch395f_fake_reset(void)
{
int i;
(void)memset(&g_fake, 0, sizeof(g_fake));
(void)memset(&g_chip, 0, sizeof(g_chip));
for (i = 0; i < CH395F_FAKE_SOCK_MAX; i++) {
g_fake.cached_open[i] = CH395F_SOCKET_CLOSED;
g_fake.cached_tcp[i] = CH395F_TCP_CLOSED;
g_fake.status_byte0[i] = CH395F_SOCKET_CLOSED;
g_fake.status_byte1[i] = CH395F_TCP_CLOSED;
g_fake.open_rc[i] = CH395F_ERR_SUCCESS;
g_fake.listen_rc[i] = CH395F_ERR_SUCCESS;
}
}
void ch395f_fake_push_recv_len(uint8_t sock, uint16_t v)
{
if ((sock < CH395F_FAKE_SOCK_MAX) &&
(g_fake.recv_len_n[sock] < CH395F_FAKE_QUEUE_LEN)) {
g_fake.recv_len_q[sock][g_fake.recv_len_n[sock]++] = v;
}
}
void ch395f_fake_set_listening(uint8_t sock)
{
if (sock < CH395F_FAKE_SOCK_MAX) {
g_fake.cached_open[sock] = CH395F_SOCKET_OPEN;
g_fake.cached_tcp[sock] = CH395F_TCP_LISTEN;
}
}
ch395f_sock_state_t ch395f_sock_state_cached(uint8_t sn)
{
ch395f_sock_state_t s;
g_chip.cached_calls++;
g_chip.last_sock = sn;
s.open = (sn < CH395F_FAKE_SOCK_MAX) ? g_fake.cached_open[sn] : CH395F_SOCKET_CLOSED;
s.tcp_state = (sn < CH395F_FAKE_SOCK_MAX) ? g_fake.cached_tcp[sn] : CH395F_TCP_CLOSED;
return s;
}
ch395f_sock_state_t ch395f_get_sock_state(uint8_t sn)
{
return ch395f_sock_state_cached(sn);
}
void ch395f_get_socket_status(uint8_t sock, uint8_t *status)
{
g_chip.get_status_calls++;
g_chip.last_sock = sock;
fake_log('s');
if (status != NULL) {
status[0] = (sock < CH395F_FAKE_SOCK_MAX) ? g_fake.status_byte0[sock] : CH395F_SOCKET_CLOSED;
status[1] = (sock < CH395F_FAKE_SOCK_MAX) ? g_fake.status_byte1[sock] : CH395F_TCP_CLOSED;
}
}
/* 整体读即清:返回后该 socket 的挂起位图清零(真实芯片没有按位清除手段) */
uint8_t ch395f_get_sock_int_status(uint8_t sock)
{
uint8_t v = 0U;
g_chip.int_status_calls++;
g_chip.last_sock = sock;
fake_log('i');
if (sock < CH395F_FAKE_SOCK_MAX) {
v = g_fake.int_status[sock];
g_fake.int_status[sock] = 0U;
}
return v;
}
uint16_t ch395f_get_recv_len(uint8_t sock)
{
uint16_t v;
g_chip.last_sock = sock;
fake_log('R');
if ((sock >= CH395F_FAKE_SOCK_MAX) || (g_fake.recv_len_n[sock] == 0)) {
return 0U;
}
/* 按调用序号取;耗尽后回落最后一个值(便于表达"一直有数据"的持续态) */
if (g_fake.recv_len_i[sock] < g_fake.recv_len_n[sock]) {
v = g_fake.recv_len_q[sock][g_fake.recv_len_i[sock]++];
} else {
v = g_fake.recv_len_q[sock][g_fake.recv_len_n[sock] - 1];
}
return v;
}
void ch395f_read_recv_buf(uint8_t sock, uint8_t *p_data, uint16_t len)
{
g_chip.read_calls++;
g_chip.last_sock = sock;
g_chip.last_read_len = len;
fake_log('r');
if ((p_data != NULL) && (len > 0U)) {
(void)memset(p_data, 0, len); /* 交出去的是零,测试不依赖内容 */
}
}
void ch395f_write_send_buf(uint8_t sock, uint8_t *p_data, uint16_t len)
{
(void)p_data;
g_chip.write_calls++;
g_chip.last_sock = sock;
g_chip.last_read_len = len;
fake_log('w');
}
uint8_t ch395f_open_socket(uint8_t sock)
{
g_chip.open_calls++;
g_chip.last_sock = sock;
fake_log('o');
return (sock < CH395F_FAKE_SOCK_MAX) ? g_fake.open_rc[sock] : 0x01U;
}
uint8_t ch395f_close_socket(uint8_t sock)
{
g_chip.close_calls++;
g_chip.last_sock = sock;
fake_log('c');
return CH395F_ERR_SUCCESS;
}
uint8_t ch395f_tcp_listen(uint8_t sock)
{
g_chip.listen_calls++;
g_chip.last_sock = sock;
fake_log('l');
return (sock < CH395F_FAKE_SOCK_MAX) ? g_fake.listen_rc[sock] : 0x01U;
}
void ch395f_set_proto_type(uint8_t sock, uint8_t proto)
{
g_chip.set_proto_calls++;
g_chip.last_sock = sock;
g_chip.last_proto = proto;
fake_log('P');
}
void ch395f_set_sour_port(uint8_t sock, uint16_t port)
{
g_chip.set_port_calls++;
g_chip.last_sock = sock;
g_chip.last_port = port;
fake_log('p');
}
void ch395f_get_remot_ipp(uint8_t sock, uint8_t *p_buf)
{
(void)sock;
if (p_buf != NULL) {
(void)memset(p_buf, 0, 4U);
}
}
void ch395f_set_keepalive_enable(uint8_t sock, uint8_t enable)
{
g_chip.keepalive_calls++;
g_chip.last_sock = sock;
g_chip.last_keepalive = enable;
}
uint8_t ch395f_link_up_cached(void)
{
return 1U;
}
uint16_t ch395f_link_change_count(void)
{
return 0U;
}