feat(固件): 标定值语义 setter + 卷锁 fail-open 自检留痕 + 控制台编号写法整理
三批同笔的理由:它们是同一份权威构建(Linker run 04:5x,Code=233,900 / RW=1,536)里的内容,中间态从未 单独编译过,拆开提任何一段都没有对应的构建凭证。按道分述如下。 **① 算法层(ui-maint):写值与置脏成对,不留可单独调用的置脏口**。新增 run_par_cal_k_set() / run_par_cal_b_set(),被拒时副本不动也不置脏(= 不承诺持久化);104 的 run_par_104_write() k/b 两支 同批改调 setter,函数内自己碰 s_dirty 的两处删净——**消除两份置脏逻辑才是本段的目的**。刻意**没有**新增 公开 run_par_mark_dirty():作者的理由我采纳并原文保留——「一旦存在就一定有人只调它」,与今天删掉的零消费 者接口是同一失效机理。另新增合法域唯一出口 run_par_db_range()、粗守上限 RUN_PAR_K_MAX_UV、毫→工程换算 单点 s_milli_to_eng(),并改正了头文件里「除以 1000 唯一在此」那条在加 db_range 后会变假陈述的说法。 **顺带满足 task-43 第①项**:adc_cal 落盘口的缺口由本段 setter 解决(写值必置脏),task-43 剩余项 = 可诊断 性与文档。 **② 日志层(log-maint):卷锁 fail-open 的 defaultTask 侧边沿留痕**。syslog_drain() 尾部紧跟既有 s_quiet_ drop 差值块之后读 vol_lock_get_stats(),水位新增才算一个 episode、每上电一条,投 SYSLOG_SELFTEST,文本 vollock failopen=%lu。三条硬约束都落了且**有牙**:失败调用点零改动(wdev.log 自己也要这把非递归卷锁); 不打错级、**不打 [ERR]**(断言里 g_sys_err_count == 0 就是机器判据,把「改成 DBG_ERROR」注入后四条用例 全红);锁层只自增、唯一写者消费。作者一度按我的要求准备造 obs_first_ms/obs_last_ms 字段,我撤了那条 要求——记录自带 ts 就是被观测时刻,**再造一个时间戳字段等于造第二个「看起来像发生时刻」的东西**。 成本 .bss +48 B、**零栈增量**(缓冲全静态),已由本笔权威构建的 after 表证实:9 条链全 PASS, iec104Task 1,464 / margin 1,096、defaultTask 3,040 与提交态逐项一致。 **③ 控制台与中断(log-maint,纯注释/文档)**:b623a406 之后的编号写法整理,把裸形态号改为可校验形式, 零代码行为改动。 实测:@build 0 错误 0 警告;run_par 67/67、sys_log_mcu 141/141、console_log 套件零回归 覆盖率只增不减 (sys_log_mcu.c 410/413 = 99.3%、函数 22/22);cppcheck / coding-standard / doc-links / bom / mojibake / nested-comment 全 0;编号五项式错误差值 0、不可判定绝对数 **1,156**(上限 1,166 未动,本笔没吃余量)。 台账随本笔回填:ram_baseline --write 与 mem-numbers --write 同批(RW_IRAM1 80,920 B 61.7% / RW_CCM 57,376 B 87.9% / ER_IROM1 260,004 B 24.8%)。
This commit is contained in:
+103
-24
@@ -77,10 +77,21 @@ static uint8_t s_dirty;
|
||||
|
||||
/* 内部函数实现区 */
|
||||
|
||||
/*
|
||||
* 函数功能:毫单位定点 → 工程量浮点(**本模块唯一换算点**)
|
||||
* 入口参数:milli - 毫单位 内 int32_t
|
||||
* 返 回 值:工程量 内 float
|
||||
* 限定条件:仅本文件内使用(消费侧一律走 run_par_deadband()/run_par_db_range(),
|
||||
* 不许各自再写一次 /1000——那才是"第二真源"最常见的样子)
|
||||
*/
|
||||
static float s_milli_to_eng(int32_t milli) {
|
||||
return (float)milli / 1000.0f;
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:死区点量程上限(毫单位)
|
||||
* 入口参数:idx - 0..8 uint8_t
|
||||
* 返 回 值:上限;idx 越界返 0 长(一切值皆拒) 内 int32_t
|
||||
* 返 回 值:上限;idx 越界返 0 内 int32_t
|
||||
*/
|
||||
static int32_t s_db_cap_milli(uint8_t idx) {
|
||||
if (idx < 4u) {
|
||||
@@ -156,7 +167,29 @@ float run_par_deadband(uint8_t idx) {
|
||||
if (idx >= RUN_PAR_DB_N) {
|
||||
return 0.0f;
|
||||
}
|
||||
return ((float)s_db.db[idx]) / 1000.0f; /* 毫→工程唯一换算点 */
|
||||
return s_milli_to_eng(s_db.db[idx]); /* 毫→工程:唯一换算点 = s_milli_to_eng */
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:取第 idx 路死区的合法域(工程量)——**合法域的唯一出口**
|
||||
* 入口参数:idx - 0..8 uint8_t;lo/hi - 输出下限/上限(工程量 V/A/Hz) float *
|
||||
* 返回值:0 - 已写出;-1 - idx 越界或指针为空(调用方不得回退成自造默认域) int
|
||||
* 限定条件:任意上下文(纯常量读,无锁、无 I/O)
|
||||
* 函数说明:为什么公开这个口:UI 整定页要给数字编辑器设 min/max,而这些上限的
|
||||
* 真源是本模块的 RUN_PAR_DB_MAX_*(电压 50V / 电流 1A / 频率 5Hz,
|
||||
* "额定 × 二档裕量")。页面里抄一份就是第二真源——判据「不新增第二份
|
||||
* 真源」最典型的复发形态是"顺手把常量写进界面代码"。因此本函数的
|
||||
* 消费者是装配层 App/app/ui_data_feed.c 的注入表实现,不是页面本身。
|
||||
* ⚠ 给的是**粗守域**(挡误写),不是工况域;真提交仍由 s_db_check
|
||||
* 同源守卫裁(104 选择段与 UI 编辑器共用同一批常量,不会漂移)。
|
||||
*/
|
||||
int run_par_db_range(uint8_t idx, float *lo, float *hi) {
|
||||
if ((idx >= RUN_PAR_DB_N) || (lo == NULL) || (hi == NULL)) {
|
||||
return -1;
|
||||
}
|
||||
*lo = 0.0f;
|
||||
*hi = s_milli_to_eng(s_db_cap_milli(idx));
|
||||
return 0;
|
||||
}
|
||||
|
||||
/*
|
||||
@@ -198,19 +231,74 @@ int run_par_104_read(uint32_t addr, float *out) {
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:104 运行参数地址写(两段式;k/b 直通 adc_cal_set——**run_par 不存
|
||||
* 函数功能:写某路系数 k(µV/码)**并在同一函数内置脏**——整定的语义写入口
|
||||
* 入口参数:sem - 电气语义通道 adc_semantic_t;k_uv - 系数(µV/码,>0) float
|
||||
* 返回值:0 - RAM 副本已写 + 已置脏;-1 - 粗守或执行段拒(副本未动、不置脏) int
|
||||
* 限定条件:整定路径上下文(iec104Task 的 104 执行段;UI 经 ui_data_yt_ops_t 由
|
||||
* 装配层 App/app/ui_data_feed.c 转进来)。勿在 adcTask 调用
|
||||
* 函数说明:**为什么"写值 + 置脏"必须长在一个函数里**(lead 裁②,2026-10-27):
|
||||
* 置脏是持久化承诺,写值是 RAM 事实,两者拆开就会出现"屏上已改、盘上
|
||||
* 永不落、且没有任何错误返回"这种无人报错的状态——本仓今天已实测到它的
|
||||
* 既有形态(绕过本模块直调 adc_cal_set() 的写者不置脏,值永远不落盘,
|
||||
* 另立 task-43 处置)。所以这里不提供单独的 mark_dirty 公开口:它一旦
|
||||
* 存在就一定有人只调它(同"零消费者的状态查询口"那条教训)。
|
||||
* 零点 b 走 RMW 取**当前生效值**(经合法带哨兵,天然满足再写校验)。
|
||||
* 粗守(0 < k ≤ RUN_PAR_K_MAX_UV)只为挡误写,真带在 adc_cal 执行段裁:
|
||||
* 两层各说各的,页面上"合法域内仍被拒(ERR)"就是执行段拒的,不伪装。
|
||||
*/
|
||||
int run_par_cal_k_set(adc_semantic_t sem, float k_uv) {
|
||||
int32_t k_q16;
|
||||
int32_t b_codes;
|
||||
|
||||
/* 通道号不在这里判:adc_cal_set 自带合法性与合法带裁决(越界一律 -1),
|
||||
* 本层再判一次就是第二真源。粗守只挡误写:0 < k ≤ RUN_PAR_K_MAX_UV */
|
||||
if (!isfinite(k_uv) || !(k_uv > 0.0f) || (k_uv > RUN_PAR_K_MAX_UV)) {
|
||||
return -1;
|
||||
}
|
||||
k_q16 = (int32_t)lrintf(k_uv * 65536.0f);
|
||||
b_codes = (int32_t)lrintf(adc_cal_b_codes(sem));
|
||||
if (adc_cal_set(sem, k_q16, b_codes) != 0) {
|
||||
return -1; /* 执行段拒:副本未动,脏位也不置 = 不承诺任何持久化 */
|
||||
}
|
||||
s_dirty = 1u;
|
||||
return 0;
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:写某路零点偏移 b(码值)并置脏(与 k 同款语义,粗守 ±1e6 码)
|
||||
* 入口参数:sem - 电气语义通道 adc_semantic_t;b_codes - 零点(码值) int32_t
|
||||
* 返回值:0 - 已写并置脏;-1 - 粗守或执行段拒(副本未动、不置脏) int
|
||||
* 限定条件:同 run_par_cal_k_set()
|
||||
* 函数说明:k 侧 RMW 用当前生效值;±8192 真带由 adc_cal 执行段裁(粗守目的是
|
||||
* 挡误写不是限工况)。本函数的消费者 = 104 的 0x8048~ 分支(改造后),
|
||||
* 不是"为将来预留"的口
|
||||
*/
|
||||
int run_par_cal_b_set(adc_semantic_t sem, int32_t b_codes) {
|
||||
int32_t k_q16;
|
||||
|
||||
if (((float)b_codes < -1.0e6f) || ((float)b_codes > 1.0e6f)) {
|
||||
return -1;
|
||||
}
|
||||
k_q16 = (int32_t)lrintf(adc_cal_k_uv(sem) * 65536.0f);
|
||||
if (adc_cal_set(sem, k_q16, b_codes) != 0) {
|
||||
return -1;
|
||||
}
|
||||
s_dirty = 1u;
|
||||
return 0;
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:104 运行参数地址写(两段式;k/b 经本模块语义 setter——**run_par 不存
|
||||
* 系数**,系数唯一真源 = [adc_cal]/[adc_cal_ofs],lead 裁②a)
|
||||
* 返 回 值:0 接受 / -1 拒绝 / -2 非本段(调用方落 prot_set) int
|
||||
* 函数说明:选择段 = 校验不提交(死区走与 set 同源守卫;k/b 的 adc_cal 合法带
|
||||
* 由执行段裁决——IEC104 允许执行段 PN,两段结果可不一致,注释在此
|
||||
* 明说防"选择过了怎么还 PN"的现场困惑);k/b 单侧写 RMW 用**当前
|
||||
* 生效值**做另一侧(生效值经合法带哨兵,天然满足再写校验)。
|
||||
* 明说防"选择过了怎么还 PN"的现场困惑)。k/b 两支自 2026-10-27 起一律
|
||||
* 走 run_par_cal_k_set() / run_par_cal_b_set():写值与置脏在同一个函数
|
||||
* 里发生,本函数不再自己碰 s_dirty(lead 裁②:消除两份置脏逻辑)。
|
||||
*/
|
||||
int run_par_104_write(uint32_t addr, float v, uint8_t select) {
|
||||
uint8_t slot; /* 每个命中分支先赋值再使用(无未init读路径) */
|
||||
int32_t k_q16;
|
||||
int32_t b_codes;
|
||||
int rc;
|
||||
|
||||
if ((addr >= RUN_PAR_IOA_DB0) && (addr < RUN_PAR_IOA_DB0 + RUN_PAR_DB_N)) {
|
||||
int32_t milli;
|
||||
@@ -234,29 +322,20 @@ int run_par_104_write(uint32_t addr, float v, uint8_t select) {
|
||||
if (select != 0u) {
|
||||
return 0; /* 粗守过了 ≠ 执行必过:合法带裁决在执行段(见函数头) */
|
||||
}
|
||||
k_q16 = (int32_t)lrintf(v * 65536.0f);
|
||||
b_codes = (int32_t)lrintf(adc_cal_b_codes((adc_semantic_t)slot));
|
||||
rc = adc_cal_set((adc_semantic_t)slot, k_q16, b_codes);
|
||||
if (rc == 0) {
|
||||
s_dirty = 1u;
|
||||
}
|
||||
return rc;
|
||||
/* 写值 + 置脏收进语义 setter(粗守 0<k≤上限 也在里面,与本支
|
||||
* 原先那条逐字同值守卫一致,行为不变)*/
|
||||
return run_par_cal_k_set((adc_semantic_t)slot, v);
|
||||
}
|
||||
if ((addr >= RUN_PAR_IOA_B0) && (addr < RUN_PAR_IOA_B0 + RUN_PAR_CH_N)) {
|
||||
slot = (uint8_t)(addr - RUN_PAR_IOA_B0);
|
||||
if (!isfinite(v) || (v < -1000000.0f) || (v > 1000000.0f)) {
|
||||
return -1; /* 粗守 ±1e6 码;±8192 真带由 adc_cal 执行段裁 */
|
||||
if (!isfinite(v)) {
|
||||
return -1; /* NaN/Inf 不得进 lrintf(该转换是 UB) */
|
||||
}
|
||||
if (select != 0u) {
|
||||
return 0;
|
||||
}
|
||||
b_codes = (int32_t)lrintf(v);
|
||||
k_q16 = (int32_t)lrintf(adc_cal_k_uv((adc_semantic_t)slot) * 65536.0f);
|
||||
rc = adc_cal_set((adc_semantic_t)slot, k_q16, b_codes);
|
||||
if (rc == 0) {
|
||||
s_dirty = 1u;
|
||||
}
|
||||
return rc;
|
||||
/* 同款语义 setter:粗守 ±1e6 码在 setter 内,±8192 真带由 adc_cal 执行段裁 */
|
||||
return run_par_cal_b_set((adc_semantic_t)slot, (int32_t)lrintf(v));
|
||||
}
|
||||
return -2;
|
||||
}
|
||||
|
||||
+51
-1
@@ -33,6 +33,14 @@
|
||||
* 修改记录:
|
||||
* v1.0 2026-10-25 DTU 项目组 创建:[run_par] 段 + 104 地址映射 + 直通
|
||||
* adc_cal + B7 式脏标志落盘请求
|
||||
* v1.1 2026-10-27 DTU 项目组 道F task-7(遥测整定两页)配套:新增语义
|
||||
* setter run_par_cal_k_set / run_par_cal_b_set
|
||||
* (写值 + 置脏成对;104 的 k/b 两支同批改调它,
|
||||
* 消除两份置脏逻辑)+ 合法域唯一出口
|
||||
* run_par_db_range() + 系数粗守上限
|
||||
* RUN_PAR_K_MAX_UV;毫→工程换算收进模块内单点
|
||||
* s_milli_to_eng()(顺带把 task-43 第①项所需的
|
||||
* "写值必置脏"这一半满足掉)
|
||||
*/
|
||||
|
||||
#ifndef RUN_PAR_H
|
||||
@@ -40,6 +48,7 @@
|
||||
|
||||
#include <stdint.h>
|
||||
|
||||
#include "adc_cal.h" /* adc_semantic_t:公开语义 setter 的形参类型(同层 algo→algo,方向不逆)*/
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
@@ -48,6 +57,11 @@ extern "C" {
|
||||
#define RUN_PAR_DB_N 9u
|
||||
#define RUN_PAR_CH_N 8u
|
||||
|
||||
/* 系数 k 的**粗守**上限(µV/码):只为挡误写(如把 mV 当 µV 填),不是工况域;
|
||||
* 真合法带在 adc_cal 执行段裁(µV/码 ×[0.5,2.0]),两层各说各的、互不掩盖。
|
||||
* 公开它是因为 UI 整定页要给编辑器设上限——上限在这里,就不许页面再抄一份。*/
|
||||
#define RUN_PAR_K_MAX_UV 1.0e9f
|
||||
|
||||
/*
|
||||
* 函数功能:运行参数初始化——副本置工厂默认 + 注册 [run_par] 段进 cfg 引擎
|
||||
* 入口参数:无
|
||||
@@ -64,7 +78,9 @@ void run_par_init(void);
|
||||
* 入口参数:idx - 0..7 = 语义通道序(UA..IN),8 = 频率 uint8_t
|
||||
* 返 回 值:死区 V / A / Hz;idx 越界返 0.0(调用方按"无死区"保守处理) float
|
||||
* 限定条件:任意上下文(int32 单字读原子;104 COV 每拍调用)
|
||||
* 函数说明:毫单位 → 浮点的换算点(除以 1000 唯一在此,勿在消费侧另写)。
|
||||
* 函数说明:毫单位 → 浮点的换算在本模块内也只有一处(run_par.c 的
|
||||
* s_milli_to_eng(),run_par_deadband 与 run_par_db_range 共用);
|
||||
* 消费侧一律取本模块给的工程量,不要再各自除 1000。
|
||||
*/
|
||||
float run_par_deadband(uint8_t idx);
|
||||
|
||||
@@ -105,6 +121,40 @@ int run_par_104_read(uint32_t addr, float *out);
|
||||
*/
|
||||
int run_par_104_write(uint32_t addr, float v, uint8_t select);
|
||||
|
||||
/*
|
||||
* 函数功能:写某路系数 k(µV/码)**并在同一函数内置脏**——整定的语义写入口
|
||||
* 入口参数:sem - 电气语义通道(adc_semantic_t 枚举序) adc_semantic_t;
|
||||
* k_uv - 系数(µV/码,须 >0 且 <= RUN_PAR_K_MAX_UV) float
|
||||
* 返回值:0 - RAM 副本已写且已置脏;-1 - 粗守或执行段拒(副本未动、不置脏) int
|
||||
* 限定条件:整定路径上下文(iec104Task 的 C_SE 执行段;UI 侧由装配层
|
||||
* App/app/ui_data_feed.c 经 ui_data_yt_ops_t 转进来)。勿在 adcTask 调用
|
||||
* 函数说明:**写值与置脏成对,不许拆开**(lead 裁②):拆开就等于"屏上已改、
|
||||
* 盘上永不落、且没有任何错误返回"。因此本模块**不提供**公开的
|
||||
* mark_dirty——单独调它等于空承诺;零点 b 由本函数 RMW 取当前生效值。
|
||||
*/
|
||||
int run_par_cal_k_set(adc_semantic_t sem, float k_uv);
|
||||
|
||||
/*
|
||||
* 函数功能:写某路零点偏移 b(码值)并置脏(与 k 同款语义,粗守 ±1e6 码)
|
||||
* 入口参数:sem - 电气语义通道 adc_semantic_t;b_codes - 零点(码值) int32_t
|
||||
* 返回值:0 - 已写并置脏;-1 - 粗守或执行段拒(副本未动、不置脏) int
|
||||
* 限定条件:同 run_par_cal_k_set()
|
||||
* 函数说明:k 侧 RMW 取当前生效值;±8192 真带由 adc_cal 执行段裁。消费者 =
|
||||
* 104 的 0x8048~ 分支(改造后走这里),不是为将来预留的口
|
||||
*/
|
||||
int run_par_cal_b_set(adc_semantic_t sem, int32_t b_codes);
|
||||
|
||||
/*
|
||||
* 函数功能:取第 idx 路死区的合法域(工程量)——**合法域的唯一出口**
|
||||
* 入口参数:idx - 0..8 uint8_t;lo/hi - 输出下限/上限(V/A/Hz) float *
|
||||
* 返回值:0 - 已写出;-1 - idx 越界或指针空(调用方不得回退成自造默认域) int
|
||||
* 限定条件:任意上下文(纯常量读)
|
||||
* 函数说明:存在的唯一理由:UI 整定页要给编辑器设 min/max,而这些上限的真源是
|
||||
* 本模块的 RUN_PAR_DB_MAX_*;页面抄一份就是第二真源。给的是**粗守域**,
|
||||
* 真提交仍由与 104 选择段同源的守卫裁,两条路不会漂移到两套数字。
|
||||
*/
|
||||
int run_par_db_range(uint8_t idx, float *lo, float *hi);
|
||||
|
||||
/*
|
||||
* 函数功能:落盘脏标志探查(非消费)
|
||||
* 入口参数:无
|
||||
|
||||
@@ -168,7 +168,7 @@ static TaskHandle_t s_con_writer_task; /* 写者任务句柄(自等保护
|
||||
* 窗口可能被更高优先级上下文再次进入,共享量会被它改写、退出时就恢复错了。
|
||||
* ⚠ 只允许包住"几条指令"的量级,**绝不允许**包住串口发送本身:一行 90 B @115200
|
||||
* 约 7.8 ms,把它关进中断等于给启动窗口塞 7.8 ms 中断延迟与最坏喂狗抖动
|
||||
* (红线与机器判据见 con_tx_bounded 函数头与主机单测 TC-CONLOG-015b/177)。
|
||||
* (红线与机器判据见 con_tx_bounded 函数头与主机单测 TC-CONLOG-015b 与 TC-CONLOG-177)。
|
||||
*/
|
||||
#define CON_CRIT_ENTER(pm_var) do { (pm_var) = __get_PRIMASK(); __disable_irq(); } while (0)
|
||||
#define CON_CRIT_EXIT(pm_var) do { __set_PRIMASK(pm_var); } while (0)
|
||||
|
||||
@@ -7,6 +7,15 @@
|
||||
* 作者:王建锋
|
||||
* 创建日期:2026-09-14
|
||||
* 修改记录:
|
||||
* v1.8 2026-10-27 DTU 项目组 道G task-40:syslog_drain() 尾部按**边沿**补投一条
|
||||
* 卷锁 fail-open(零互斥那一态)自检记录。锁层只自增计数不产日志
|
||||
* (唯一能写的通道自己也要这把**非递归**卷锁),留痕必须由
|
||||
* 唯一写者做;一个 episode(= 一次上电)只投一条,不打
|
||||
* DBG 错级、不打 [ERR]([ERR] 是"设备出故障"的唯一信号
|
||||
* 通道,塞进可观测性事件就变成第二个信号源——与 task-23
|
||||
* "日志让路不计 [ERR]"同一根判据)。
|
||||
* 成本:.bss +48 B(3 枚计数/标志 + 静态快照 + 静态行缓冲),
|
||||
* **零栈增量**(缓冲全静态;前后两表见 task-40 交付)。
|
||||
* v1.7 2026-10-26 王建锋 「记录 5 页」的数据面(task-10):syslog_id_t 尾部追加
|
||||
* SYSLOG_ACCIDENT / ALARM / START / OPER / YK 五枚,本文件
|
||||
* s_paths[]/s_caps[] 同步到七项(**必须与枚举同序**,越界
|
||||
@@ -162,6 +171,33 @@ static volatile uint8_t s_post_pboot_full_reported;/* 启动前数组满丢弃
|
||||
static volatile uint32_t s_quiet_drop; /* quiet 通道累计丢弃条数 */
|
||||
static uint32_t s_quiet_reported; /* drain 侧已上报水位(唯一写者私有) */
|
||||
|
||||
/* 卷锁 fail-open(零互斥那一态)的边沿留痕(道G task-40,2026-10-27)
|
||||
* ------------------------------------------------------------------
|
||||
* 锁层只**自增计数**、绝不产日志:唯一能把事写下来的通道(/log/wdev.log 等)自己也要
|
||||
* 取这把卷锁,而卷锁**非递归**——被卷忙挡住时既写不出东西,也不许在失败分支里再去取
|
||||
* 同一把锁(App/fs/vol_lock.h「可观测性」段 + task-17 查出的事实)。所以留痕由唯一写者
|
||||
* (defaultTask)在这里按**边沿**补投,投的是自检记录。
|
||||
* ⚠ episode = 一次上电,只投一条。fail-open 的成因是"互斥体从未创建成功"(vol_lock.c
|
||||
* 的那一支),一旦成立,后面每一次取锁都零互斥;若"计数每前进一次报一条"
|
||||
* 就等于每轮 drain 一条记录 + 一次 NAND 写——诊断自己变成负载,正是上面 s_quiet_drop
|
||||
* 那条纪律要避免的事(同款先例另有 App/fs/vol_idle_sync.c 的 s_vol_sync_fail_latch)。
|
||||
* ⚠ **不打 DBG 错级、不打 [ERR]**:[ERR] 在本仓是"设备出故障"的唯一信号通道(@test 的
|
||||
* Forbidden 标记也依赖它,四个 Fault 的崩溃日志都以 [ERR] 开头)。把一个可观测性事件
|
||||
* 塞进 [ERR],它就同时不再是故障、也不再是禁令,两边一起失去意义——与 task-23 里
|
||||
* "日志让路不计 [ERR]"是同一根判据。机器判据 = TC-SYSLOG-137 里的 g_sys_err_count == 0。
|
||||
* 时刻:本模块在这里**不读 tick**(读一次 tick 就给 defaultTask 的 drain 最坏链多挂一个
|
||||
* callee,而这条链的余量我们一直在省着花)。记录自带的 ts 字段就是"**被观测到的时刻**"
|
||||
* ——不是发生时刻,粒度 = 一轮 drain;这正是 vol_lock.h 第②条告诫要求消费方自己说清的
|
||||
* 那件事,所以这里不另造 obs_first_ms/obs_last_ms 字段(那只会造出第二个"看起来像发生
|
||||
* 时刻"的东西)。要"何时开始忙"的精确窗口,请读 vol_lock_get_stats() 的现值。
|
||||
* 成本:3 枚计数/标志 + 一份静态快照 + 一行静态文本 ≈ 48 B .bss,**零栈增量**
|
||||
* (缓冲全静态,照 App/util/task_prof.c 的 s_prof_line 先例;前后 stack_report 两表
|
||||
* 见 task-40 交付)。 */
|
||||
static volatile uint32_t s_vl_failopen_seen; /* drain 侧上次读到的 fail-open 计数 */
|
||||
static uint8_t s_vl_reported; /* 本 boot 已留痕(1 = 本 episode 不再投) */
|
||||
static vol_lock_stats_t s_vl_now; /* 静态快照,不走调用方栈 */
|
||||
static char s_vl_note[32]; /* 记录文本(落盘按 SYSLOG_DESC_MAX=28 截断) */
|
||||
|
||||
/* 日志读写放大收口(2026-10-15,读侧):8 条滑动读窗口 + 写者代数。
|
||||
* 窗口 512 B 走静态(不吃任务栈;defaultTask/uiTask 最坏链见 stack_report.py,
|
||||
* 预算余量见 docs/内存管理/RAM预算台账.md)。s_rd_gen 由写者自增、读者比对,
|
||||
@@ -843,6 +879,22 @@ void syslog_drain(void) {
|
||||
s_quiet_reported = s_quiet_drop;
|
||||
DBG_ERROR("quiet drop total=%lu", (unsigned long)s_quiet_drop);
|
||||
}
|
||||
/* 卷锁 fail-open(零互斥那一态)边沿补投一条自检记录(约束与理由全在上面那组静态量旁边)。
|
||||
* vol_lock_get_stats() 不取锁、不关中断、不阻塞:卷被长期占住时正是最需要读它的
|
||||
* 时刻,观测口若再去抢同一把锁,就把观测做成了故障的一部分。
|
||||
* 必须排在 s_clear_service() 之前吗?不必——两者无先后关系(清除的是记录文件,
|
||||
* 本条是**新增**一条自检记录);但必须排在下面 soe_store_drain() 之前,因为本函数
|
||||
* 这条支路不持卷锁,而 soe_store_drain() 自己 try 锁(沿用本函数既有纪律)。 */
|
||||
vol_lock_get_stats(&s_vl_now);
|
||||
if (s_vl_now.failopen != s_vl_failopen_seen) {
|
||||
s_vl_failopen_seen = s_vl_now.failopen; /* 水位每轮都追:别让下一轮误判"新增" */
|
||||
if (s_vl_reported == 0U) {
|
||||
s_vl_reported = 1U; /* 一个 episode 一条(= 一次上电) */
|
||||
(void)snprintf(s_vl_note, sizeof(s_vl_note), "vollock failopen=%lu",
|
||||
(unsigned long)s_vl_failopen_seen);
|
||||
syslog_post(SYSLOG_SELFTEST, s_vl_note);
|
||||
}
|
||||
}
|
||||
/* 「清除记录」的落地半边——必须在上面的条目排空**之后**(顺序是判据的一部分:
|
||||
* 先删后写会把本轮刚排空的旧记录又落回去,count 不归零 = 没实际效果的按钮),
|
||||
* 也在 soe_store_drain() 之前:本函数自带卷锁 try,绝不在此持锁状态下调用。
|
||||
|
||||
Reference in New Issue
Block a user