文档统一:三份链路时延文档合并为链路延迟测试说明,删过程性历史,更新全部交叉引用

This commit is contained in:
2026-09-22 06:52:58 +08:00
parent 4b78e0d36c
commit 2cffd1d2cf
10 changed files with 576 additions and 1014 deletions
+2 -2
View File
@@ -3,7 +3,7 @@
Server-driven protocol: the MCU (testTask, port 8080) sends one operation
byte; the peer executes the corresponding traffic pattern. See
docs/测试说明/链路延迟测试说明.md §2.5 for the full protocol spec.
docs/测试说明/链路延迟测试说明.md §4.5 for the full protocol spec.
Ops (MCU -> peer):
0x01 L5 recv flood : peer sends 50 x 100B (5ms apart)
@@ -42,7 +42,7 @@ OP_DONE = 0xFF
L5_CHUNKS = 20 # 2026-09-22 run1: 50 chunks saturated the chip RX buffer
# (window close -> retransmit re-delivery -> RST); 20 @ 50ms
# = 1KB/s quiet baseline (see 链路延迟测试说明.md §8)
# = 1KB/s quiet baseline (see 链路延迟测试说明.md §6.2)
L5_LEN = 100
L6_SIZE = 10
L7_REQ_LEN = 9
+3 -3
View File
@@ -350,7 +350,7 @@ const lat_stats_t *lat_probe_stats(void)
/* ============================================================
* Phase 12 — SPI 时延基线(L1/L2,硬件层模式,无需 PC)
*
* 测量对象(见 链路延迟测试说明.md §1):
* 测量对象(见 链路延迟测试说明.md §3):
* L1 SPI 字节命令 —— 3 个代表性命令的完整 SPI 事务时长
* (公开函数内部含 spi_begin/spi_end,即一次完整事务)
* L2 SPI DMA —— ch395f_read_recv_buf(N) 完整 DMA 事务
@@ -370,7 +370,7 @@ const lat_stats_t *lat_probe_stats(void)
#define LAT_P12_DMA_LEN_MAX 2048U /* L2 单发上限 = CH395F_SPI_DMA_MAX_PAYLOAD */
/* L1 阈值(us)—— 2026-09-22 台架首跑后重锁(实测 med 10~15us;
* warn ≈ 2×med,crit ≈ 2×warn,见 链路延迟测试说明.md §4.1) */
* warn ≈ 2×med,crit ≈ 2×warn,见 链路延迟测试说明.md §6.1) */
#define LAT_P12_CMD_WARN_US 40U
#define LAT_P12_CMD_FAIL_US 100U
@@ -530,7 +530,7 @@ void net_latency_phase12_run(void)
#define LAT_P13_L5_CHUNKS 20U /* L5 flood 块数(2026-09-22 run1 实证:50×100B@5ms
* 达 20KB/s 饱和芯片接收缓冲 → 窗口关闭重传 →
* 重复递交 11884/5000B → 对端 RST;降至 1KB/s
* 静默档,见 链路延迟测试说明.md §8 run1 记录) */
* 静默档,见 §6.2 M2 基线) */
#define LAT_P13_L5_CHUNK_LEN 100U
#define LAT_P13_L3_SENDS 16U /* 每次 4KB = 4 chunk → 16×4 = 64 探针样本
* (run3 后从 32 减半:控制持续 TX 总量) */
+3 -3
View File
@@ -23,7 +23,7 @@ extern "C" {
#include <stdint.h>
/*
* === 链路时延测试阶段一览(见 链路延迟测试说明.md §2.2) ===
* === 链路时延测试阶段一览(见 链路延迟测试说明.md §4.2) ===
* Phase 12 [硬件层] SPI 字节命令 / DMA 时延基线(L1/L2,无需 PC) —— M1(已完成)
* Phase 13 [NET 层] 芯片 + 队列时延(L3~L7/L10,需 PC peer) —— M2(已实现)
* Phase 14 [NET 层] 生产路径时延(L8~L11 + 模拟器 A/B,需 PC peer)—— M3(规划)
@@ -32,7 +32,7 @@ extern "C" {
* M1 各段(<5ms)与 M2 调用方侧测量(单次 <25ms)用单次读数差即可;
* 跨 25ms 的段(L4/L8 整帧与重传尖峰)由 PC 端 peer 计时。
*
* Phase 13 协议(服务器驱动:MCU 发操作字节,peer 执行;详见说明文档 §2.5):
* Phase 13 协议(服务器驱动:MCU 发操作字节,peer 执行;详见说明文档 §4.5):
* HELLO = 5A A5 58 01(peer → MCU,4 字节)
* 操作字节(MCU → peer):0x01=L5 recv flood / 0x02=L5 send flood /
* 0x03=L6 单请求 / 0x04=L7 LCDMEM 全帧 / 0x05=L3 send flood / 0xFF=完成
@@ -106,7 +106,7 @@ void lat_stat_finish(lat_stats_t *p);
* max_spikes - 尖峰数上限:spikes 超过 → FAIL
* p_verdict - 输出:本段 verdict(LAT_VERDICT_*)
* 返回值:无
* 函数说明:报告行格式见 链路延迟测试说明.md §2.4;字符串字面量纯 ASCII
* 函数说明:报告行格式见 链路延迟测试说明.md §4.4;字符串字面量纯 ASCII
*/
void lat_stat_report(const char *p_seg, const lat_stats_t *p,
uint32_t warn_med_us, uint32_t fail_med_us,
+1 -1
View File
@@ -27,7 +27,7 @@ extern "C" {
* 当前启用 CH395F 套件 + Phase 13(独立运行,勿与其他 Phase 混选)。
* 执行:先起 test/latency_peer.py --mode net --port 8080,再 @test 烧录。
* 恢复产品构建 = 注释掉下面两行(TEST_SUITE_CH395F 与 ch395f_test.h 的
* ENABLE_PHASE13_TESTS)。详见 docs/测试说明/链路延迟测试说明.md §3.2。 */
* ENABLE_PHASE13_TESTS)。详见 docs/测试说明/链路延迟测试说明.md §5.2。 */
#define TEST_SUITE_CH395F
//#define TEST_SUITE_STORAGE
//#define TEST_SUITE_GD5F