TC-NET-604结案为非缺陷:Trap21改短+删机理图解+N-7作废,清理源码误导注释

This commit is contained in:
2026-09-23 01:36:43 +08:00
parent af9011968d
commit 60337f315c
9 changed files with 42 additions and 289 deletions
+1 -1
View File
@@ -1163,7 +1163,7 @@ void ch395f_read_recv_buf(uint8_t sock, uint8_t *p_data, uint16_t len) {
total = 4U + len;
if (total > CH395F_DMA_BUF_SIZE) {
/* 异常金丝雀:接收读不应超过整个接收缓冲(2KB,recv_len 不可能超过缓冲大小);
* 触发即调用方参数异常。静默丢弃会把芯片接收窗口锁死在 0(见 Trap 21),
* 触发即调用方参数异常。静默丢弃会让数据与错误一起消失(无从诊断),
* 故必须留痕。正常路径不会到达此处。 */
DBG_ERROR("read_recv_buf OVERSIZE: sock %u req %u > max %u, read dropped",
(unsigned)sock, (unsigned)len, (unsigned)(CH395F_DMA_BUF_SIZE - 4U));
+8 -10
View File
@@ -114,11 +114,9 @@ extern "C" {
* TCP MSS(CH395F_CMD_SET_TCP_MSS 参数)
* 由 net_init 经 ch395f_set_tcp_mss() 下发(须在 ch395f_init 之前);此处为单一真值源。
* 维持 1024:8 Socket 共享 24KB 缓冲时,单 Socket 接收缓冲 = 2×MSS = 2KB(手册 §9.2.8
* 满足上限的最大值)。TC-NET-604 台架验证(2026-09-22,详见 Trap 21):芯片接收冻结角
* (WCH FAQ:"收不到数据且 TCP 窗口不更新")不受 MSS 裕量影响——降 512 反而更差
* (新连接 4096B 突发即确定性停摆,剩 64B 未达);MSS=1024 时新连接 4096B 正常,
* 仅"同连接前序突发 + 新突发 + 任务负载"模式触发。MSS 裕量假设被证伪,恢复 1024
* (每次满缓冲周期段数少 = 触发概率低)。MSS 只影响芯片分包与窗口动态,
* 满足上限的最大值)。MSS=512 裕量方案未采纳;当年支撑该决策的台架判据不可信,
* 已随 TC-NET-604 结案为非缺陷一并撤回(2026-09-23,见 Trap 21)——维持 1024 的
* 现有理由 = 手册允许的最大值、满缓冲周期段数少。MSS 只影响芯片分包与窗口动态,
* 与下方缓冲块布局解耦。
*/
#define CH395F_TCP_MSS 1024U
@@ -127,10 +125,10 @@ extern "C" {
#define CH395F_RAM_BLOCK_SIZE 512U
/* 单 Socket 缓冲块数:固定布局(2026-09-22 与 MSS 解耦;此前由 MSS 推导,改 MSS 会
* 连带静默缩小布局):接收 4 块=2KB、发送 2 块=1KB,8 Socket × 6 块 = 48 块恰好用满。
* 布局满足手册 §9.2.8:接收 2KB = 2×MSS(1024)(建议下沿,零裕量——用满 48 块的代价,
* 其携带的窗口冻结角见 Trap 21)/ ≥ MSS(必须)/ ≤ 6×MSS(建议);
* 发送 1KB = MSS(WCH FAQ 要求"发送缓冲 > MSS",此处取等值——台架实测芯片在
* 缓冲边界可正常成包,验证记录见 Trap 21)。 */
* 布局满足手册 §9.2.8:接收 2KB = 2×MSS(1024)(建议下沿,零裕量——用满 48 块的代价)/
* ≥ MSS(必须)/ ≤ 6×MSS(建议);
* 发送 1KB = MSS(WCH FAQ 要求"发送缓冲 > MSS",此处取等值——生产实测(FTP 大文件
* 上传/下载 + UI 推流)在缓冲边界可正常成包)。 */
#define CH395F_RECV_BLOCKS 4U
#define CH395F_SEND_BLOCKS 2U
/* 单 Socket 硬件收发缓冲字节数(= 块数 × 块大小)。写入发送 FIFO 的单次长度严禁超过此值,
@@ -145,7 +143,7 @@ extern "C" {
* 导致剩余数据不可见),故总缓冲 = 接收缓冲大小 + 4(4 为命令头开销),
* 有效载荷 = 接收缓冲大小(2KB)。
* 2026-09-22:与 MSS 解耦(此前 = 2×MSS+4,MSS 下调会把 DMA 缓冲缩到装不下整缓冲
* → 整缓冲读被截断丢弃 → 窗口锁死,见 Trap 21)。
* → 整缓冲读会被截断丢弃)。
*/
#define CH395F_SPI_DMA_BUF_SIZE (CH395F_RECV_BUF_SIZE_BYTES + 4U)
#define CH395F_SPI_DMA_MAX_PAYLOAD (CH395F_SPI_DMA_BUF_SIZE - 4U)