refactor(编号·批次二): 代码与测试侧 215 处保护功能号改成功能名，零行为改动
用户裁定「不要用字母加数字的编号，语义标识是最好的」后的批次二代码半（道 ui-param 执行，逐文件站点数与 自证见其交付）。唯一口径 = 映射表 ci-artifacts/lprot_map.tsv 的功能名列原文，**零自造同义词**；L2.5 与 L-TEST 经实测各 0 处（不是本族），TC 族一字未动。 固件 22 文件 128 处（adc_task.c 21、phasor.c 22、phasor.h 13…），主机测试 13 文件 87 处（pha sor_test.c 57…）；设计文档指针新增 19 行，另 16 只文件本来就写着规划文档 ⇒ 不重复加。 **两条只有真改过 215 处才会踩到的坑，都写进注释规范实践**： · 指针**不能接在原句尾部**——那会替原文一个未闭合的半括号封口，实测咬坏 App/algo/sample_ring.h 这类 跨行句 ⇒ 指针一律**单独成行**； · 号删掉会留下**叠词**（「自检失败闭锁 闭锁判定」「定值校验和 定值巡检」）⇒ 复扫并收口 4 处，措辞只用 映射名本身；具体对象需要留住时写成「自检失败闭锁（采样故障闭锁）」。 自证（不靠嘴说）：改前把 35 只文件原文备份到仓外 temp，逐文件比 `/*`、`*/` 计数、三类括号计数、行数增量 恰等于指针行数、全角括号增删相等、残留号 0 ⇒ **35/35 通过**；Lead 复核后跑权威 @build **0 错 0 警**， Program Size `Code=233900 RO=26104 RW=1536 ZI=136808` —— **与三条道各自改前改后测的四数逐 字节同数**， 这就是「只动注释与文本」的机器证据；八套主机单测 exit 0，cppcheck 按钩子参数零发现，coding-standard 0。 文件头「修改记录」里的号**一并换名、不还原**（Lead 裁定）：这些号是全仓退役的，留一个查无此号的引用比 留一条改过名的条目更坏——「冻结历史不回改」保护的是**别替历史改口**，不是保护一个再也查不到的字符串； id-check 对变更记录行本就豁免，两种选择都不影响门禁。
This commit is contained in:
@@ -73,7 +73,7 @@ static int bench_wait_sock_int(uint8_t sock, uint32_t timeout, uint8_t *out_bits
|
||||
while ((uint32_t)(HAL_GetTick() - t0) < timeout) {
|
||||
/* 直读本 Socket SINT（读即清）。不用全局寄存器门控：它读即清，未配对
|
||||
* 读取会吞事件；且门控观察分不清"芯片未锁存"与"全局位被读清"
|
||||
* （TRAP-NET-20 观察混淆源）。唯一读者 = net_poll（F-NET-7）。 */
|
||||
* （TRAP-NET-20 观察混淆源）。唯一读者 = net_poll（唯一读者红线（docs/网络/网络自愈架构设计.md §7 I7））。 */
|
||||
uint8_t si = ch395f_get_sock_int_status(sock);
|
||||
if (si != 0U) {
|
||||
if (out_bits != 0) {
|
||||
@@ -173,7 +173,7 @@ static void bench_round(unsigned idx) {
|
||||
/* 排事件在 LISTEN **之前**（对齐生产 listen 路径 E14 改法：post-listen 排事件
|
||||
* 会吞掉快速到达的 CONNECT——上一版矩阵 3/48 被本探针现场抓获，现已根除该
|
||||
* 自伤形态；本探针保留，drain 若仍见 CONNECT 即回归信号）。
|
||||
* 逐 Socket SINT 读（读即清，不读全局——唯一读者 = net_poll，F-NET-7） */
|
||||
* 逐 Socket SINT 读（读即清，不读全局——唯一读者 = net_poll，唯一读者红线） */
|
||||
for (int j = 0; j < 8; j++) {
|
||||
uint8_t dj = ch395f_get_sock_int_status((uint8_t)j);
|
||||
if (dj != 0U) {
|
||||
@@ -456,7 +456,7 @@ static int bench_wait_closed(uint8_t sock, uint32_t timeout_ms) {
|
||||
|
||||
/* 排空本 Socket 事件：直读 SINT（读即清），连续 2 轮（20ms 节奏）无新位即停；
|
||||
* 返回排空期间见过的 SINT 位 OR（E8 M5 drain-until-quiescent 的 bench 版）。
|
||||
* 不读全局寄存器——读即清，唯一读者 = net_poll（F-NET-7） */
|
||||
* 不读全局寄存器——读即清，唯一读者 = net_poll（唯一读者红线（docs/网络/网络自愈架构设计.md §7 I7）） */
|
||||
static uint8_t bench_drain_events(uint8_t sock, uint32_t max_ms) {
|
||||
uint32_t t0 = HAL_GetTick();
|
||||
uint8_t seen = 0U;
|
||||
|
||||
@@ -77,7 +77,7 @@ static void test_parse_ip(const char *str, uint8_t *ip_arr)
|
||||
static void phase1_run(void) {
|
||||
uint8_t ip_info[20];
|
||||
|
||||
/* 全局中断寄存器读即清，唯一读者 = net_poll（F-NET-7；用户裁定 2026-10-13：
|
||||
/* 全局中断寄存器读即清，唯一读者 = net_poll（唯一读者红线（docs/网络/网络自愈架构设计.md §7 I7）；用户裁定 2026-10-13：
|
||||
* 测试代码同样禁自行读取）。net_stack_bring_up() 的 set_phy 强制重协商会
|
||||
* 锁存 GINT_STAT_PHY_CHANGE（0x0004）——由全局中断状态项内部双读自清，不在此预清。 */
|
||||
|
||||
@@ -339,7 +339,7 @@ static void phase2_tc201(void)
|
||||
* 直接读本 Socket 中断状态 CMD_GET_INT_STATUS_SN（8 位，读即清）——事件位：
|
||||
* SENBUF_FREE / SEND_OK / RECV_OK / CONNECT / DISCONNECT / DISCARD / SOCK_TIMEOUT。
|
||||
* 不用全局寄存器 GET_GLOB_INT_STATUS_ALL 做门控：它读即清，任何未配对 SINT
|
||||
* 消费的读取都会吞掉事件通知；唯一读者 = net_poll（F-NET-7），测试代码同样
|
||||
* 消费的读取都会吞掉事件通知；唯一读者 = net_poll（唯一读者红线（docs/网络/网络自愈架构设计.md §7 I7）），测试代码同样
|
||||
* 禁自行读取（用户裁定 2026-10-13）。测试知道自己操作哪个 Socket，直读
|
||||
* SINT 即可——每轮一次 SPI 事务，成本与旧两级方案相同，且观察无门控混淆。
|
||||
*/
|
||||
@@ -897,7 +897,7 @@ static void phase2_tc203(void)
|
||||
/* 预清陈旧事件（TRAP-NET-12）：上一会话 close 的 DISCONNECT 可能滞后锁存
|
||||
* 在 SINT_SN 中（wait-CLOSED 轮询的 STATUS 是纯查询、不清中断），
|
||||
* 若不清除，本用例首次读中断会误吃旧事件导致负向误判。
|
||||
* 只清本 Socket SINT——全局寄存器读即清，唯一读者 = net_poll（F-NET-7）。 */
|
||||
* 只清本 Socket SINT——全局寄存器读即清，唯一读者 = net_poll（唯一读者红线（docs/网络/网络自愈架构设计.md §7 I7））。 */
|
||||
(void)ch395f_get_sock_int_status(sock);
|
||||
|
||||
/* 步2：OPEN + CONNECT。命令为异步下发，此时均应立即返回成功，
|
||||
@@ -1188,7 +1188,7 @@ static void phase4_run(void) {
|
||||
uint8_t dhcp_ok = 0;
|
||||
while (HAL_GetTick() - tick < 30000) {
|
||||
/* DHCP 状态寄存器是真相（纯查询）；不读全局寄存器——读即清，
|
||||
* 唯一读者 = net_poll（F-NET-7），测试代码同样禁自行读取 */
|
||||
* 唯一读者 = net_poll（唯一读者红线（docs/网络/网络自愈架构设计.md §7 I7）），测试代码同样禁自行读取 */
|
||||
if (ch395f_get_dhcp_status() == 0x00) { dhcp_ok = 1; break; }
|
||||
HAL_Delay(500);
|
||||
}
|
||||
@@ -1459,7 +1459,7 @@ static void phase5_run(void) {
|
||||
} else {
|
||||
/* ---- 等待上一次写入被芯片搬走（SENBUF_FREE） ----
|
||||
* 直读本 Socket SINT（读即清）；不读全局寄存器——读即清且
|
||||
* 唯一读者 = net_poll（F-NET-7）。
|
||||
* 唯一读者 = net_poll（唯一读者红线（docs/网络/网络自愈架构设计.md §7 I7））。
|
||||
*/
|
||||
if (ch395f_get_sock_int_status(sock) & CH395F_SINT_STAT_SENBUF_FREE) {
|
||||
can_write = 1; /* 缓冲已腾空，下一轮写入下一块 */
|
||||
|
||||
@@ -449,7 +449,7 @@ void net_latency_phase12_run(void)
|
||||
default:
|
||||
/* 例外（同 Phase 1 全局中断状态用例）：被测对象就是本 API 的 SPI 时延——硬件层
|
||||
* 独占上下文、无并发消费者；除此之外测试代码禁读全局寄存器
|
||||
* （读即清，唯一读者 = net_poll，F-NET-7） */
|
||||
* （读即清，唯一读者 = net_poll，唯一读者红线） */
|
||||
(void)ch395f_get_glob_int_status_all();
|
||||
break;
|
||||
}
|
||||
@@ -760,7 +760,7 @@ void net_latency_phase13_run(int32_t sockfd)
|
||||
if (s_p13_state != P13_ST_ABORT) {
|
||||
return; /* 正常完成/DONE：会话终态，不再处理 */
|
||||
}
|
||||
/* F-NET-3：原"进 abort 分状态手动重同步 + 10s 周期 relisten"
|
||||
/* 冗余 API 面清理（docs/网络/网络自愈架构设计.md §7）：原"进 abort 分状态手动重同步 + 10s 周期 relisten"
|
||||
* 已删——三种去向全部由 net 层自动机制认领（静默回收滞留 ESTABLISHED
|
||||
* → 对账⑤ RESYNC；CLOSED 失位 → 对账③④ 认领重建；LISTENING 静默丢
|
||||
* 监听 → 形态③"芯片不在听"判据），手动 API net_resync_listen/net_relisten
|
||||
|
||||
Reference in New Issue
Block a user