170 lines
6.0 KiB
C
170 lines
6.0 KiB
C
/*
|
||
* 模块名称：CH395F Driver Test Suite
|
||
* 模块功能：CH395F 驱动各功能模块的测试入口，分阶段组织测试用例，
|
||
* 覆盖 SPI 命令路径、协议栈配置、Socket 状态机、大文件传输、
|
||
* 边界条件、KeepAlive、PHY 链路恢复等，基于单连接 socket 模式
|
||
* 适用平台：STM32F4 系列（CH395F 以太网芯片）
|
||
* 作者：王建锋
|
||
* 创建日期：2026-07-19
|
||
* 修改记录：
|
||
* 2026-07-22 全面重构为单连接模式，增加大文件传输、边界条件等测试
|
||
*
|
||
* === 测试阶段一览 ===
|
||
* Phase | 类型 | 描述
|
||
* ---------|--------------|-----------------------------------------------
|
||
* Phase 1 | 独立运行 | 寄存器读写 + SPI 命令路径验证
|
||
* Phase 2 | PC 配合 | TCP Client 收发 + 关闭重连
|
||
* Phase 3 | PC 配合 | UDP Server Echo（HELLO + PING + 大包）
|
||
* Phase 4 | netTask | NET 层 TCP Echo（单连接模式，基础收发验证）
|
||
* Phase 5 | netTask | NET 层大文件传输（20KB+ 分块收发）
|
||
* Phase 6 | PC 配合 | DHCP 自动获取 IP
|
||
* Phase 7 | netTask | Select/Poll I/O 多路复用
|
||
* Phase 8 | netTask | 边界条件测试（零长度、DMA 边界、缓冲溢出）
|
||
* Phase 9 | 需拔插网线 | PHY 链路恢复
|
||
* Phase 10 | netTask | KeepAlive 超时断开测试
|
||
*/
|
||
|
||
#ifndef __CH395F_TEST_H
|
||
#define __CH395F_TEST_H
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
#include <stdint.h>
|
||
|
||
/*
|
||
* 阶段使能开关（取消注释即启用对应阶段）
|
||
* 注意：一次仅启用一个阶段（Phase 4/5/7/8 共享 netTask 循环，可同时启用）
|
||
* Phase 6 (DHCP) 会改变 IP，必须独立运行
|
||
*/
|
||
//#define ENABLE_PHASE1_TESTS /* 寄存器读写 + SPI 命令路径 */
|
||
//#define ENABLE_PHASE2_TESTS /* TCP Client 收发 + 关闭重连 */
|
||
//#define ENABLE_PHASE3_TESTS /* UDP Server Echo */
|
||
#define ENABLE_PHASE4_TESTS /* NET 层 TCP Echo（单连接基础收发） */
|
||
//#define ENABLE_PHASE5_TESTS /* NET 层大文件传输（20KB+ 分块） */
|
||
//#define ENABLE_PHASE6_TESTS /* DHCP 自动获取 IP（会改 IP！独立运行） */
|
||
//#define ENABLE_PHASE7_TESTS /* Select/Poll I/O 多路复用 */
|
||
//#define ENABLE_PHASE8_TESTS /* 边界条件测试 */
|
||
//#define ENABLE_PHASE9_TESTS /* PHY 链路恢复测试 */
|
||
//#define ENABLE_PHASE10_TESTS /* KeepAlive 超时断开测试 */
|
||
|
||
/* 测试统计 */
|
||
typedef struct {
|
||
uint16_t total;
|
||
uint16_t passed;
|
||
uint16_t failed;
|
||
} test_stats_t;
|
||
|
||
extern test_stats_t g_test_stats;
|
||
|
||
#define TEST_CHECK(cond, fmt, ...) do { \
|
||
g_test_stats.total++; \
|
||
if (cond) { \
|
||
g_test_stats.passed++; \
|
||
DBG_INFO("[PASS] " fmt, ##__VA_ARGS__); \
|
||
} else { \
|
||
g_test_stats.failed++; \
|
||
DBG_ERROR("[FAIL] " fmt, ##__VA_ARGS__); \
|
||
} \
|
||
} while (0)
|
||
|
||
#define TEST_REPORT(name) do { \
|
||
DBG_INFO("=== %s: %d/%d PASSED (failed=%d) ===", \
|
||
name, g_test_stats.passed, g_test_stats.total, g_test_stats.failed); \
|
||
} while (0)
|
||
|
||
/*
|
||
* Phase 1: 底层寄存器测试
|
||
* 通过: 9 项全部打印 OK/SUCCESS/YES/0x00
|
||
* 失败: 任何一项 FAIL/ERROR/MISMATCH
|
||
*/
|
||
void ch395f_phase1_tests(void);
|
||
|
||
/*
|
||
* Phase 2: TCP Client 收发 + 关闭重连 ×3 轮
|
||
* 通过: 日志打印 3 轮 "PASS"
|
||
* 失败: 任何一轮打印 "FAIL" 或超时
|
||
* PC 端预启动:
|
||
* python test/ch395f_socket_test.py tcp_server --port 8081
|
||
*/
|
||
void ch395f_phase2_tests(void);
|
||
|
||
/*
|
||
* Phase 3: UDP Server Echo + PING + 大包
|
||
* 通过: 30/30 回显匹配
|
||
* 失败: 任何回显超时或丢包
|
||
* PC 端：
|
||
* python test/ch395f_socket_test.py udp_client --ip 192.168.1.100 --port 60000
|
||
*/
|
||
void ch395f_phase3_tests(void);
|
||
|
||
/*
|
||
* Phase 4: NET 层 TCP Echo（单连接模式，netTask 中运行）
|
||
* 验证 Socket 0 单连接生命周期：LISTEN → ESTABLISHED → DISCONNECT → re-LISTEN
|
||
* 覆盖载荷：64B、1460B(MSS)、4096B(缓冲满)、20KB(大文件分块)
|
||
* PC 端：
|
||
* python test/ch395f_socket_test.py tcp_client --ip 192.168.1.100 --port 8080
|
||
*/
|
||
void ch395f_phase4_tests(void);
|
||
|
||
/*
|
||
* Phase 5: NET 层大文件传输（netTask 中运行）
|
||
* 验证超过 CH395F 内部缓冲区大小（4KB）的连续数据收发
|
||
* 覆盖载荷：20480B(20KB)、65535B(64KB，recv_len上限)
|
||
* PC 端：
|
||
* python test/ch395f_socket_test.py tcp_file --ip 192.168.1.100 --port 8080 --size 20480
|
||
*/
|
||
void ch395f_phase5_init(void);
|
||
void ch395f_phase5_tests(void);
|
||
|
||
/*
|
||
* Phase 6: DHCP 自动获取 IP
|
||
* 通过: DHCP SUCCESS + IP 非零 + 广播宣告 + HELLO 回显
|
||
* 失败: DHCP timeout 或宣告/HELLO 失败
|
||
* 注意: 会改变 IP，需独立运行
|
||
* PC 端：管理员权限
|
||
* python test/ch395f_socket_test.py dhcp_server --dhcp-iface 192.168.1.2 --ip 192.168.1.100
|
||
*/
|
||
void ch395f_phase6_tests(void);
|
||
|
||
/*
|
||
* Phase 7: Select/Poll I/O 多路复用（netTask 中运行）
|
||
* 验证 net_select() 和 net_poll_events() 在单 socket 模式下正确工作
|
||
* PC 端：
|
||
* python test/ch395f_socket_test.py tcp_client --ip 192.168.1.100 --port 8080
|
||
*/
|
||
void ch395f_phase7_tests(void);
|
||
|
||
/*
|
||
* Phase 8: 边界条件测试（netTask 中运行）
|
||
* 覆盖：零长度收发、DMA 边界（4095/4096/4097B）、recv 缓冲区小于数据、
|
||
* 连续快速发送、多轮快速连接-断开循环
|
||
* PC 端：
|
||
* python test/ch395f_socket_test.py tcp_client --ip 192.168.1.100 --port 8080
|
||
*/
|
||
void ch395f_phase8_init(void);
|
||
void ch395f_phase8_tests(void);
|
||
|
||
/*
|
||
* Phase 9: PHY 链路恢复测试
|
||
* 通过拔插网线验证 PHY 断开检测和链路恢复后 socket 自动重新监听
|
||
* 需物理操作，PC 端：
|
||
* python test/ch395f_socket_test.py tcp_client --ip 192.168.1.100 --port 8080
|
||
*/
|
||
void ch395f_phase9_tests(void);
|
||
|
||
/*
|
||
* Phase 10: TCP KeepAlive 超时断开测试
|
||
* 验证 KeepAlive 在空闲超时后触发断开并自动重新监听
|
||
* PC 端：连接后静置（不发数据），等待 KeepAlive 触发
|
||
* python test/ch395f_socket_test.py tcp_client --ip 192.168.1.100 --port 8080 --silent
|
||
*/
|
||
void ch395f_phase10_tests(void);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* __CH395F_TEST_H */
|