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:
2026-10-27 08:59:26 +08:00
parent 26a97e99f9
commit b7c0889cc7
48 changed files with 239 additions and 219 deletions
+5 -5
View File
@@ -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; /* 缓冲已腾空,下一轮写入下一块 */