diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index 5853adf9..81f91468 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -100,18 +100,43 @@ repos: types: [c] # 仅扫描项目自有代码;排除第三方库与 LVGL 依赖文件 # (UI 生成文件 ui_font_cn_12/ui_menu_tab 由生成器按工程约定产出,纳入受检) - # ⚠ `IEC60870-Slave/` 必须排除(2026-11-19 补):它是不进任何构建的第三方快照 - # (uvprojx 命中 0、simulator/CMakeLists.txt 命中 0),仅被 test/host/iec104_dtu - # 当参考语料引用。本钩子此前漏配这一行,而 coding-standard 的 exclude 早已有它 - # (那个钩子注释写着「范围与 cppcheck 钩子一致」,两边实际不一致)。 - # 漏配的代价实测 = 726 条存量命中:装真 cppcheck 2.21.0 后全库 834 条, - # 其中 726 条来自这个目录,把真正需要看的那几条完全淹没。 + # + # ⚠ 本 exclude 与下方 `coding-standard` 钩子的 exclude 是**同一个口径的两个 + # 表达**,必须一起看、一起改。两个钩子的注释都自称"范围一致",但 2026-11-19 + # 之前实际各漏一块,而因为 cppcheck 这根钩子从未真正跑起来(装的是坏 zipapp, + # 见 docs/代码规范/cppcheck使用说明.md),谁也发现不了。对不齐的代价是存量噪音 + # 把真问题完全淹没——实测两次:漏 `IEC60870-Slave/` = 726 条,漏下面三条 104 + # 上游前缀 = 76 条,合计 834 条里 802 条是"不该被扫的"。 + # + # 两者今天的**真实关系**(2026-11-19 实测,不是"逐字相同"): + # - 共同核心 11 项:本块的 Drivers/CMSIS/、HAL_Driver/、lftpd/、dhara/、 + # 三条 104 前缀、IEC60870-Slave/、Lib/、Middlewares/、MDK-ARM/。 + # - coding-standard 额外排除 Src/、Inc/、nand_ftl\.(那三项是它自己的豁免: + # CubeMX 生成文件不做字节保真、nand_ftl 函数名由外部 API 固定)。 + # - 本块额外排除 test/(编码规范要查测试代码,本钩子不查)。 + # 所以"本钩子比 coding-standard 多扫 Src/、Inc/、nand_ftl"是设计意图: + # 那三处是只读分析(cppcheck 不写文件),当前实测 0 命中有意义。 + # + # 排除项逐条理由: + # `IEC60870-Slave/`:不进任何构建的第三方快照(uvprojx 命中 0、 + # simulator/CMakeLists.txt 命中 0),仅被 test/host/iec104_dtu 当参考 + # 语料引用。 + # 下面三条 104 前缀:`App/iec60870/` 曾是第三方 IEC 60870-5-104 子站库 + # (约 5 万行),2026-11-18 起收编为项目自有代码,但命名/注释/结构改造 + # 属单独排期。三条前缀只覆盖**尚未改造的那部分**:`common/` 与 + # `104/business/` 整目录、`104/` 下大写开头的 `IEC104_*` 上游文件。 + # 我们自己的小写适配文件(`iec104_*.{c,h}`:core / net_mcu / source / + # comm 等)**不在**排除面内,仍受本钩子约束。 + # ⚠ 不能改写成祖先目录 `App/iec60870/`——那会把适配层一起豁免。 exclude: | (?x)^( Drivers/CMSIS/| Drivers/STM32F4xx_HAL_Driver/| Drivers/BSP/NET/lftpd/| Drivers/BSP/dhara/| + App/iec60870/common/| + App/iec60870/104/business/| + App/iec60870/104/IEC104[_.]| IEC60870-Slave/| Lib/| Middlewares/| @@ -166,8 +191,12 @@ repos: entry: scripts/gate_python.py scripts/check_coding_standard.py language: system types: [c] - # 范围与 cppcheck 钩子一致;另排除 CubeMX 生成文件(Src/、Inc/,重新生成即覆盖)、 - # dhara/FatFS 接口适配层(nand_ftl,函数名由外部 API 固定) + # 与本仓库 cppcheck 钩子共享同一套共同核心排除项(11 项:Drivers/CMSIS/、 + # HAL_Driver/、lftpd/、dhara/、三条 104 前缀、IEC60870-Slave/、Lib/、 + # Middlewares/、MDK-ARM/);本钩子另排除 CubeMX 生成文件(Src/、Inc/,重新生成 + # 即覆盖)、dhara/FatFS 接口适配层(nand_ftl,函数名由外部 API 固定)。 + # cppcheck 钩子则另排除 test/(编码规范要查测试代码,cppcheck 不查)。 + # 两边差异是设计意图,不是漏配;但共同核心那 11 项必须一起改。 # `App/iec60870/` 下的协议栈曾是第三方 IEC 60870-5-104 子站库(约 5 万行), # 2026-11-18 起收编为项目自有代码:不再做字节保真校验(`UPSTREAM.sha256` 已删除), # 命名/注释/结构按本仓规范逐步改造。 diff --git a/App/iec60870/104/iec104_comm.c b/App/iec60870/104/iec104_comm.c index 0bc61c6e..af81fc8b 100644 --- a/App/iec60870/104/iec104_comm.c +++ b/App/iec60870/104/iec104_comm.c @@ -85,7 +85,11 @@ int iec104_comm_init(void) { uint16_t iec104_comm_ca(void) { uint16_t v = s_comm.ca; - if ((v < IEC104_COMM_CA_MIN) || (v > IEC104_COMM_CA_MAX)) { + /* 只看下界:ca 的类型就是 uint16_t,上界 65535 等于该类型能表示的最大值, + * 写 `v > IEC104_COMM_CA_MAX` 是一次恒为假的比较(cppcheck + * compareValueOutOfTypeRangeError)。宏本身保留——UI 数值范围提示 + * (App/app/ui_data_feed.c)仍要用它表达"合法带上界"。 */ + if (v < IEC104_COMM_CA_MIN) { return IEC104_COMM_DEF_CA; } return v; @@ -99,7 +103,8 @@ uint16_t iec104_comm_ca(void) { uint16_t iec104_comm_port(void) { uint16_t v = s_comm.port; - if ((v < IEC104_COMM_PORT_MIN) || (v > IEC104_COMM_PORT_MAX)) { + /* 同 iec104_comm_ca:上界 65535 是 uint16_t 的类型极限,比较恒为假。 */ + if (v < IEC104_COMM_PORT_MIN) { return IEC104_COMM_DEF_PORT; } return v; @@ -113,7 +118,8 @@ uint16_t iec104_comm_port(void) { * 落盘 = defaultTask 每轮无条件 iec104_comm_store_save()(无事件位) */ int iec104_comm_ca_set(uint16_t ca) { - if ((ca < IEC104_COMM_CA_MIN) || (ca > IEC104_COMM_CA_MAX)) { + /* 同 getter:只判下界,上界是类型极限(恒为假,见 iec104_comm_ca)。 */ + if (ca < IEC104_COMM_CA_MIN) { return -1; } s_comm.ca = ca; @@ -128,7 +134,8 @@ int iec104_comm_ca_set(uint16_t ca) { * 限定条件:同 iec104_comm_ca_set(生效时刻 = 下一次重 bind 监听) */ int iec104_comm_port_set(uint16_t port) { - if ((port < IEC104_COMM_PORT_MIN) || (port > IEC104_COMM_PORT_MAX)) { + /* 同 iec104_comm_port:只判下界,上界是类型极限(恒为假)。 */ + if (port < IEC104_COMM_PORT_MIN) { return -1; } s_comm.port = port; diff --git a/App/iec60870/104/iec104_net_mcu.c b/App/iec60870/104/iec104_net_mcu.c index 4f7a746a..6c4424dd 100644 --- a/App/iec60870/104/iec104_net_mcu.c +++ b/App/iec60870/104/iec104_net_mcu.c @@ -254,7 +254,6 @@ IEC104_NetResult_t IEC104_Net_Listen( { int fd = NET_FD_INVALID; int rc, addrlen; - uint32_t i; uint32_t ip; struct net_sockaddr_in addr; slot_t *slot = NULL; @@ -282,6 +281,7 @@ IEC104_NetResult_t IEC104_Net_Listen( * Close 成功,serv tick 直接强制重起 core。不变量见本文件头。 */ { uint32_t gen = net_get_generation(); + uint32_t i; for (i = 0U; i < IEC104_MCU_MAP_SIZE; ++i) { if (s_slots[i].handle != 0U && s_slots[i].net_gen != gen) { memset(&s_slots[i], 0, sizeof(s_slots[i])); @@ -562,9 +562,6 @@ IEC104_NetResult_t IEC104_Net_Wait( IEC104_NetSocket_t listener, IEC104_NetSocket_t client, uint32_t interest, uint32_t timeout_ms, uint32_t *ready_events, int *native_error) { - slot_t *listen_slot; - slot_t *client_slot; - net_sock_t *sock; uint32_t ready = 0U; (void)timeout_ms; @@ -577,7 +574,8 @@ IEC104_NetResult_t IEC104_Net_Wait( } *ready_events = 0U; if ((interest & IEC104_NET_EVENT_ACCEPT) != 0U) { - listen_slot = find_role(listener, SLOT_LISTEN); + /* listen_slot 只服务这一分支,就近声明(规范 §6.1.1)。 */ + slot_t *listen_slot = find_role(listener, SLOT_LISTEN); /* 会话在役时不报 ACCEPT 就绪:net_listener_armed 对 ESTABLISHED 恒返 1 * (net_socket.c:1543-1545,单 fd 模型下监听 fd 已转数据通道),若不挡, * 库 Wait_For_Events(:1992) 每轮收到假 ACCEPT → Process(:1897) 每轮 @@ -589,8 +587,10 @@ IEC104_NetResult_t IEC104_Net_Wait( } } if ((interest & (IEC104_NET_EVENT_READ | IEC104_NET_EVENT_WRITE)) != 0U) { - client_slot = find_client(client); - sock = (client_slot != NULL) ? net_get_sock(client_slot->fd) : NULL; + /* client_slot / sock 只服务这一分支(规范 §6.1.1 就近声明); + * sock 只读不改,加 const。 */ + slot_t *client_slot = find_client(client); + const net_sock_t *sock = (client_slot != NULL) ? net_get_sock(client_slot->fd) : NULL; if (sock != NULL) { if ((interest & IEC104_NET_EVENT_READ) != 0U && (net_can_read(client_slot->fd) != 0 || client_slot->role == SLOT_CLIENT_EOF)) { diff --git a/App/iec60870/104/iec104_source.c b/App/iec60870/104/iec104_source.c index 257bd7a4..9311f866 100644 --- a/App/iec60870/104/iec104_source.c +++ b/App/iec60870/104/iec104_source.c @@ -182,7 +182,7 @@ static bool commit_stage(uint16_t area) /* 函数功能:服务启动恢复typed表默认,观测归零且无源置IV。 */ void iec104_source_init(void) { - size_t i, a, g, m; iec104_dtu_parameter_t p; uint32_t raw; + size_t i, g, m; memset(&bindings, 0, sizeof(bindings)); memset(&stats, 0, sizeof(stats)); memset(singles, 0, sizeof(singles)); memset(single_set, 0, sizeof(single_set)); memset(doubles, 0, sizeof(doubles)); @@ -190,17 +190,24 @@ void iec104_source_init(void) memset(measurements, 0, sizeof(measurements)); memset(measurement_set, 0, sizeof(measurement_set)); clear_stage(); clock_utc = UINT64_C(946684800000); clock_mono = 0U; #ifndef IEC104_SOURCE_NO_VALUE_STORE - memset(values, 0, sizeof(values)); - for (i = 0U; i < IEC104_DTU_PARAMETER_COUNT; ++i) { - (void)iec104_dtu_parameter(i, &p); - if (!p.configured) { continue; } - raw = initial_bits(&p); - for (a = 0U; a < IEC104_DTU_AREA_COUNT; ++a) { - if (iec104_dtu_parameter_visible(i, (uint16_t)a)) { values[slot(i, (uint16_t)a)] = raw; } + { + /* a / p / raw 只服务这条填充循环,声明就近放在这里(规范 §6.1.1)。 + * 旧写法把它们提到函数头、再在 #else 里用 (void) 抑制"未使用", + * 结果 (void)a 对 cppcheck 而言就是"读了一个从未赋值的变量" + * (unassignedVariable)。声明收进各自的编译档后两句抑制都不再需要。 */ + size_t a; iec104_dtu_parameter_t p; uint32_t raw; + memset(values, 0, sizeof(values)); + for (i = 0U; i < IEC104_DTU_PARAMETER_COUNT; ++i) { + (void)iec104_dtu_parameter(i, &p); + if (!p.configured) { continue; } + raw = initial_bits(&p); + for (a = 0U; a < IEC104_DTU_AREA_COUNT; ++a) { + if (iec104_dtu_parameter_visible(i, (uint16_t)a)) { values[slot(i, (uint16_t)a)] = raw; } + } } } #else - (void)i; (void)a; (void)p; (void)raw; /* 裁剪档:参数值恒为 typed 表字面量,无需填充 */ + /* 裁剪档:参数值恒为 typed 表字面量,values 表不存在,无需填充。 */ #endif memset(standard_values, 0, sizeof(standard_values)); for (i = 0U; i < IEC104_DTU_STANDARD_COUNT; ++i) { @@ -408,11 +415,14 @@ static IEC104_RemoteParameterLookupResult_t remote_lookup(void *context, const IEC104_RemoteParameterRequest_t *r, size_t ordinal, uint32_t ioa, IEC104_RemoteParameterFrame_t *frame) { - size_t i, n = 0U; iec104_dtu_parameter_t p; iec104_source_value_t value; + iec104_source_value_t value; IEC104_RemoteParameterAddResult_t result; (void)context; if (r->sn >= IEC104_DTU_AREA_COUNT) { return IEC104_REMOTE_PARAMETER_LOOKUP_ERROR; } if (r->count == 0U) { + /* i / n / p 只服务这一段"按序号在可见表里找第 ordinal 条",声明放这里 + * (规范 §6.1.1:尽可能靠近使用点)。 */ + size_t i, n = 0U; iec104_dtu_parameter_t p; for (i = 0U; i < IEC104_DTU_PARAMETER_COUNT; ++i) { if (iec104_dtu_parameter_visible(i, r->sn) && n++ == ordinal) { break; } } @@ -427,13 +437,8 @@ static IEC104_RemoteParameterLookupResult_t remote_lookup(void *context, static IEC104_RemoteParameterActionResult_t remote_action(void *context, const IEC104_RemoteParameterRequest_t *r, IEC104_RemoteParameterArea_t *area) { - size_t e, i, b; uint32_t raw; iec104_dtu_parameter_t p; - IEC104_RemoteParameterElement_t element; bool ok; (void)context; -#ifdef IEC104_SOURCE_NO_VALUE_STORE - (void)e; (void)i; (void)b; (void)raw; (void)p; (void)element; -#endif if (r == NULL) { return IEC104_REMOTE_PARAMETER_ACTION_REJECTED; } if (r->operation == IEC104_REMOTE_PARAMETER_OP_CANCEL || r->operation == IEC104_REMOTE_PARAMETER_OP_DISCARD) { clear_stage(); return IEC104_REMOTE_PARAMETER_ACTION_APPLIED; @@ -459,23 +464,32 @@ static IEC104_RemoteParameterActionResult_t remote_action(void *context, ++stats.parameter_rejected; clear_stage(); return IEC104_REMOTE_PARAMETER_ACTION_REJECTED; #else - if (r->first_frame) { clear_stage(); owner = *r; owner._data = NULL; owner._length = 0U; stage_active = true; } - if (!same_owner(r) || owner.sn != r->sn || stage_complete) { clear_stage(); return IEC104_REMOTE_PARAMETER_ACTION_REJECTED; } - for (e = 0U; e < r->count; ++e) { - if (!IEC104_RemoteParameter_Get_Element(r, e, &element)) { clear_stage(); return IEC104_REMOTE_PARAMETER_ACTION_REJECTED; } - i = iec104_dtu_parameter_index(element.ioa); - if (!iec104_dtu_parameter_visible(i, r->sn)) { clear_stage(); return IEC104_REMOTE_PARAMETER_ACTION_UNKNOWN_IOA; } - (void)iec104_dtu_parameter(i, &p); - if (!p.writable || element.tag != p.tag || element.length != (p.tag == 1U ? 1U : (p.tag == 45U ? 2U : 4U)) || is_dirty(i)) { - clear_stage(); return IEC104_REMOTE_PARAMETER_ACTION_REJECTED; + { + /* e / i / b / raw / p / element 只服务这条预置提交循环,声明就近放在 + * 这里(规范 §6.1.1)。旧写法提到函数头再用 (void) 抑制裁剪档的 + * "未使用",那句 (void)e 等于读一个没赋值的变量(unassignedVariable)。 */ + size_t e, b; iec104_dtu_parameter_t p; + IEC104_RemoteParameterElement_t element; + if (r->first_frame) { clear_stage(); owner = *r; owner._data = NULL; owner._length = 0U; stage_active = true; } + if (!same_owner(r) || owner.sn != r->sn || stage_complete) { clear_stage(); return IEC104_REMOTE_PARAMETER_ACTION_REJECTED; } + for (e = 0U; e < r->count; ++e) { + size_t i; + uint32_t raw; + if (!IEC104_RemoteParameter_Get_Element(r, e, &element)) { clear_stage(); return IEC104_REMOTE_PARAMETER_ACTION_REJECTED; } + i = iec104_dtu_parameter_index(element.ioa); + if (!iec104_dtu_parameter_visible(i, r->sn)) { clear_stage(); return IEC104_REMOTE_PARAMETER_ACTION_UNKNOWN_IOA; } + (void)iec104_dtu_parameter(i, &p); + if (!p.writable || element.tag != p.tag || element.length != (p.tag == 1U ? 1U : (p.tag == 45U ? 2U : 4U)) || is_dirty(i)) { + clear_stage(); return IEC104_REMOTE_PARAMETER_ACTION_REJECTED; + } + raw = 0U; + for (b = 0U; b < element.length; ++b) { raw |= (uint32_t)element.value[b] << (8U * b); } + if (!valid_bits(i, raw)) { clear_stage(); return IEC104_REMOTE_PARAMETER_ACTION_REJECTED; } + { size_t s = stage_slot(i); staged[s] = raw; dirty[s / 8U] |= (uint8_t)(1U << (s % 8U)); } } - raw = 0U; - for (b = 0U; b < element.length; ++b) { raw |= (uint32_t)element.value[b] << (8U * b); } - if (!valid_bits(i, raw)) { clear_stage(); return IEC104_REMOTE_PARAMETER_ACTION_REJECTED; } - { size_t s = stage_slot(i); staged[s] = raw; dirty[s / 8U] |= (uint8_t)(1U << (s % 8U)); } + stage_complete = !r->more_follows; + return IEC104_REMOTE_PARAMETER_ACTION_APPLIED; } - stage_complete = !r->more_follows; - return IEC104_REMOTE_PARAMETER_ACTION_APPLIED; #endif } const IEC104_RemoteParameterHandlers_t iec104_source_remote_handlers = {remote_action, remote_lookup}; @@ -483,11 +497,13 @@ const IEC104_RemoteParameterHandlers_t iec104_source_remote_handlers = {remote_a * 说明:120 行同 CA,点表按 (CA,IOA) 升序;LOAD 校验和总召编码都用 standard_points。 */ void iec104_source_parameter_config(uint16_t ca, IEC104_ParameterConfig_t *config) { - size_t i, g, m; + size_t i; if (config == NULL) { return; } IEC104_Parameter_Config_Default(config); for (i = 0U; i < IEC104_DTU_STANDARD_COUNT; ++i) { - g = i / 30U; m = i % 30U; + /* g / m 由 i 派生、只在这轮循环体内用(规范 §6.1.1 就近声明)。 */ + size_t g = i / 30U; + size_t m = i % 30U; standard_points[i].common_address = ca; standard_points[i].ioa = (uint32_t)(0x8601U + g * 0x20U + m); standard_points[i].kind = g == 0U ? IEC60870_ASDU_KPA_THRESHOLD : @@ -500,11 +516,7 @@ void iec104_source_parameter_config(uint16_t ca, IEC104_ParameterConfig_t *confi /* 函数功能:校验标准参数装载;TEST不改值,周期许可由核心执行。 */ IEC104_ParameterActionResult_t iec104_source_parameter_action(void *context, const IEC104_ParameterRequest_t *r) { - size_t i, m, g; bool valid = false; (void)context; -#ifdef IEC104_SOURCE_NO_VALUE_STORE - (void)i; (void)m; (void)g; (void)valid; -#endif if (r == NULL || r->phase != IEC104_PARAMETER_PHASE_EXECUTE) { return IEC104_PARAMETER_ACTION_REJECTED; } if (r->operation != IEC104_PARAMETER_OP_LOAD) { /* QPA=3 selects periodic transmission; no value mutation is needed. @@ -516,16 +528,22 @@ IEC104_ParameterActionResult_t iec104_source_parameter_action(void *context, con ++stats.parameter_rejected; return IEC104_PARAMETER_ACTION_REJECTED; #else - i = r->point_index; - if (i >= 120U || standard_points[i].ioa != r->ioa || standard_points[i].type_id != r->type_id) { return IEC104_PARAMETER_ACTION_UNKNOWN_IOA; } - m = i % 30U; g = i / 30U; - if (g == 0U) { valid = (r->type_id == 110U ? r->value.normalized : r->value.scaled) >= 0; } - if (g == 1U) { valid = r->value.scaled >= -10000 && r->value.scaled <= standard_values[60U + m].scaled; } - if (g == 2U) { valid = r->value.scaled <= 10000 && r->value.scaled >= standard_values[30U + m].scaled; } - if (g == 3U) { valid = r->value.short_float >= 0.0f && r->value.short_float <= 60.0f; } - if (!valid) { return IEC104_PARAMETER_ACTION_REJECTED; } - if (!r->test) { standard_values[i] = r->value; increment(&stats.parameter_commits); } - return IEC104_PARAMETER_ACTION_APPLIED; + { + /* i / m / g / valid 只服务这条装载校验,声明就近放在这里(规范 §6.1.1)。 + * 旧写法提到函数头、在裁剪档用 (void) 抑制"未使用",那句 (void)valid + * 对 cppcheck 等于读一个没赋值的变量(unassignedVariable)。 */ + size_t i, m, g; bool valid = false; + i = r->point_index; + if (i >= 120U || standard_points[i].ioa != r->ioa || standard_points[i].type_id != r->type_id) { return IEC104_PARAMETER_ACTION_UNKNOWN_IOA; } + m = i % 30U; g = i / 30U; + if (g == 0U) { valid = (r->type_id == 110U ? r->value.normalized : r->value.scaled) >= 0; } + if (g == 1U) { valid = r->value.scaled >= -10000 && r->value.scaled <= standard_values[60U + m].scaled; } + if (g == 2U) { valid = r->value.scaled <= 10000 && r->value.scaled >= standard_values[30U + m].scaled; } + if (g == 3U) { valid = r->value.short_float >= 0.0f && r->value.short_float <= 60.0f; } + if (!valid) { return IEC104_PARAMETER_ACTION_REJECTED; } + if (!r->test) { standard_values[i] = r->value; increment(&stats.parameter_commits); } + return IEC104_PARAMETER_ACTION_APPLIED; + } #endif } /* 函数功能:设置仅设备虚拟墙钟的UTC纪元及单调基点。 */ diff --git a/App/task/ui_task.c b/App/task/ui_task.c index 27268a44..a572a8f2 100644 --- a/App/task/ui_task.c +++ b/App/task/ui_task.c @@ -608,7 +608,6 @@ static int ui_task_wave_load_head(uint8_t a_idx) { static FIL f; /* static:FIL = 528B,理由同 soe_store_read */ char path[WAVE_ST_PATH_MAX]; /* 容量 = WAVE_ST_PATH_MAX(17 字节口径, * 自己声明路径缓冲不得写死 16) */ - FRESULT fr; FRESULT ofr; /* 开档 FR 码:开档失败留痕用 */ UINT br = 0u; int rc; @@ -638,6 +637,7 @@ static int ui_task_wave_load_head(uint8_t a_idx) { uint32_t size; uint32_t total; uint32_t n; + FRESULT fr; /* 读档 FR 码:只在这个开档成功分支里用,就近声明(规范 §6.1.1) */ size = (uint32_t)f_size(&f); total = 0u; diff --git a/App/util/ioboard_di.c b/App/util/ioboard_di.c index b69387b2..c870bbdb 100644 --- a/App/util/ioboard_di.c +++ b/App/util/ioboard_di.c @@ -150,8 +150,6 @@ uint8_t ioboard_di_snap_publish(ioboard_di_snapshot_t *s, uint8_t mask, uint8_t uint8_t ioboard_di_snap_read(const ioboard_di_snapshot_t *s, uint8_t *out_mask, uint32_t *out_seq) { - uint32_t s1; - uint32_t s2; uint8_t n; if (di_is_null(s) != 0U) { @@ -166,7 +164,9 @@ uint8_t ioboard_di_snap_read(const ioboard_di_snapshot_t *s, uint8_t *out_mask, /* 一次读取两遍并校验序号:读期间若被写者打断,序号会变化或为奇数 → 作废重来 */ for (n = 0U; n < (uint8_t)IOBOARD_DI_SNAP_RETRY; n++) { - s1 = s->seq; + /* s1 / s2 只服务本轮的"读前序号 / 读后序号"比对,就近声明(规范 §6.1.1)。 */ + uint32_t s1 = s->seq; + uint32_t s2; if ((s1 & 1U) != 0U) { continue; /* 写者正在写 */ } diff --git a/Drivers/BSP/IOBOARD/ioboard_bits.c b/Drivers/BSP/IOBOARD/ioboard_bits.c index 06bee4fc..cfe1bc98 100644 --- a/Drivers/BSP/IOBOARD/ioboard_bits.c +++ b/Drivers/BSP/IOBOARD/ioboard_bits.c @@ -24,7 +24,10 @@ uint8_t ioboard_di_assemble(const uint8_t bits[IOBOARD_DI_COUNT]) uint8_t i; for (i = 0U; i < (uint8_t)IOBOARD_DI_COUNT; i++) { - if ((bits[i] != 0U) && (i < (uint8_t)IOBOARD_DI_COUNT)) { + /* 只有 `bits[i] != 0` 需要判:上界由 for 条件(i < IOBOARD_DI_COUNT)保证, + * 原来这里还带一个 `i < IOBOARD_DI_COUNT`,是永远为真的冗余判断 + * (cppcheck arrayIndexThenCheck 的触发点,且它在取下标之后才判)。 */ + if (bits[i] != 0U) { /* bits[0] 是 H(手册最高位)→ bit7;bits[7] 是 A → bit0 */ mask |= (uint8_t)(1U << ((uint8_t)(IOBOARD_DI_COUNT - 1U) - i)); } diff --git a/Drivers/BSP/NET/net_socket.c b/Drivers/BSP/NET/net_socket.c index 2a90c9ad..e7ebfc4d 100644 --- a/Drivers/BSP/NET/net_socket.c +++ b/Drivers/BSP/NET/net_socket.c @@ -3548,7 +3548,7 @@ int net_getpeername(int sockfd, struct net_sockaddr *addr, int *addrlen) { */ int net_pending_bytes(int sockfd) { - net_sock_t *p_sock; + const net_sock_t *p_sock; int len; if (net_ctx_is_owner_task() == 0U) { return NET_ERR_RETURN_1(NET_ERR_INVAL); diff --git a/Drivers/BSP/UI/ui_page_yx.c b/Drivers/BSP/UI/ui_page_yx.c index 725d195d..c9e386d7 100644 --- a/Drivers/BSP/UI/ui_page_yx.c +++ b/Drivers/BSP/UI/ui_page_yx.c @@ -215,7 +215,6 @@ static uint16_t pg_count(void) { */ static void pg_refresh(uint16_t a_row, char *a_name, char *a_value) { uint64_t bit; - uint16_t dio_row; a_value[0] = '\0'; if (a_row >= (uint16_t)(UI_DATA_YX_N + DIO_ROW_N)) { @@ -229,7 +228,8 @@ static void pg_refresh(uint16_t a_row, char *a_name, char *a_value) { * 上送主站),这里是板级 GPIO/74HC165 的物理状态(未进点表、不上送)。 * 两段共用一张屏只是现场"一屏看全",不代表它们是同一套点。 */ if (a_row >= (uint16_t)UI_DATA_YX_N) { - dio_row = (uint16_t)(a_row - (uint16_t)UI_DATA_YX_N); + /* dio_row 只服务这段板级开入开出区,就近声明(规范 §6.1.1)。 */ + uint16_t dio_row = (uint16_t)(a_row - (uint16_t)UI_DATA_YX_N); YX_PUT(a_name, s_dio_name[dio_row]); if (dio_row < (uint16_t)UI_DATA_DI_N) { diff --git a/docs/代码规范/cppcheck使用说明.md b/docs/代码规范/cppcheck使用说明.md index 84fec148..7496aa1a 100644 --- a/docs/代码规范/cppcheck使用说明.md +++ b/docs/代码规范/cppcheck使用说明.md @@ -111,7 +111,7 @@ cppcheck 是开源 C/C++ 静态分析工具,**不运行代码**,通过语法 > 说明: > - 上表规则均出自 cppcheck 2.21.0 `--errorlist` 中 `severity=style` 的真实清单。 > - 部分规则(如 `duplicateBranch`、`suspiciousSemicolon`、`checkConst`)需要额外 `--inconclusive` 才会激活,为减少误报**未开启**。 -> - `unusedFunction`、`unusedStructMember`、`useStlAlgorithm`、`noExplicitConstructor` 等已在 `--suppress` 中抑制,原因见第 4.3 节「抑制规则说明」。 +> - `unusedFunction`、`unusedStructMember`、`useStlAlgorithm`、`noExplicitConstructor` 等已在 `--suppress` 中抑制,原因见第 4.4 节「抑制规则说明」。 > - `--error-exitcode=1` 对**所有已启用级别**(warning/performance/portability/style)生效:任何一级发现问题都会让门禁**失败**(在 CI / `ci_local.py` 的 manual 段拦下)。style 级别的问题若确属误报,用行内抑制(见第 5 节)。 --- @@ -143,9 +143,45 @@ cppcheck 是开源 C/C++ 静态分析工具,**不运行代码**,通过语法 -I Middlewares/Third_Party/FreeRTOS/Source/include ``` -> 注意:以上为逻辑参数列表。在 `.pre-commit-config.yaml` 中书写时必须遵守第 4.2 节的 YAML 引号规则。 +> 注意:以上为逻辑参数列表。在 `.pre-commit-config.yaml` 中书写时必须遵守第 4.3 节的 YAML 引号规则。 -### 4.2 ⚠️ YAML 参数引号陷阱(曾导致钩子完全失效) +### 4.2 ⚠️ 安装陷阱:`C:\cppcheck\cppcheck.exe` 可能是个假的 zipapp(门禁静默空转) + +**这是本仓最贵的一次门禁失效**:钩子一直报 Failed,但输出是 `ModuleNotFoundError: +No module named 'cppcheck'` 这类看着像环境噪音的文本,于是长期被当成"本机没装"绕过。 +实际后果是**cppcheck 从来没有真正检查过一行代码**——上面 §4.5 范围的两次漏配 +(726 + 76 条噪音)也正因如此长期无人发现。 + +**识别方法**(三秒判定): + +```bash +python -c "import zipfile,sys; print(zipfile.is_zipfile(r'C:\cppcheck\cppcheck.exe'))" +# True = 假的。真 cppcheck 是 PE 可执行文件,不是 zip。 +``` + +**根因**:某些环境里 `C:\cppcheck\cppcheck.exe` 被塞成了一个 Python zipapp,内容只有 +`from cppcheck import cppcheck; sys.exit(cppcheck())`,而系统 Python 里没有 `cppcheck` +包。进程根本没起来,退出码 126,`--error-exitcode=1` 对"进程没跑起来"不生效。 + +**正确装法**(版本必须 2.21.0,与 §3 的规则清单对应): + +1. 从 GitHub release 取 `cppcheck-2.21.0-x64-Setup.msi`(该版本唯一资产,约 23.8 MB)。 + ⚠ 首次 `curl -sL` 可能被截断(实测拿到 22.2 MB,msiexec 报 1620); + 用 `curl -C -` 续传,或核对字节数。 +2. `msiexec /a /qb TARGETDIR=<临时目录>` 管理式解包,得到 `PFiles/Cppcheck/` + 整个目录(约 55 MB)。 +3. **必须整目录拷贝**到 `C:\cppcheck\`:只留单个 exe 会报 `-1073741515`(缺 DLL)。 + 先把旧的假 exe 改名留档。 +4. 验证:`C:\cppcheck\cppcheck.exe --version` → `Cppcheck 2.21.0`。 + +**为什么不用 pip 版**:`pip install cppcheck` 的 wheel 内嵌上游版本实测为 +1.4.8/1.5.0→2.16.2、1.5.1→2.17.1、1.5.2→2.20.0、1.5.3→**2.22.0**, +**没有任何版本给出 2.21.0**,与文档钉死的版本不符,不宜混用。 + +**教训**:门禁"Failed"必须看到**真实的检查输出**才算数。一个输出里没有 +"命中/条数/文件名"的 Failed,默认应当怀疑工具没跑起来,而不是怀疑代码有问题。 + +### 4.3 ⚠️ YAML 参数引号陷阱(曾导致钩子完全失效) `.pre-commit-config.yaml` 的 `args:` 使用 YAML **流序列** `[a, b, c]` 语法,其中**逗号是元素分隔符、空格不产生新元素**。曾出现两个致命错误,导致 cppcheck 钩子**空转**("Passed" 但从未真正检查): @@ -163,7 +199,7 @@ args: ['--enable=warning,performance,portability,style', '--error-exitcode=1', **排查方法**:怀疑参数被拆坏时,在 PATH 前置一个同名 shim(如 `cppcheck.cmd` 把 `%*` 写日志),跑 `pre-commit run cppcheck --files <某文件>` 查看实际执行的完整命令行。 -### 4.3 抑制规则说明 +### 4.4 抑制规则说明 | 抑制规则 | 原因 | 是否永久 | |---|---|---| @@ -173,26 +209,55 @@ args: ['--enable=warning,performance,portability,style', '--error-exitcode=1', | `unusedStructMember` | HAL 寄存器位域按位操作,cppcheck 不理解 | 永久 | | `redundantAssignment` | HAL 清标志宏(如 `__HAL_SPI_CLEAR_OVRFLAG`)读寄存器覆盖旧值,cppcheck 不理解"读即目的" | 永久 | -### 4.4 扫描范围 +### 4.5 扫描范围 -通过 `types: [c]` + `exclude` 控制: +通过 `types: [c]` + `exclude` 控制。 **检查**:`App/`、`Src/`、`Inc/`、`Drivers/BSP/` 下的 .c 文件 -**不检查**(第三方库,问题不是我们的): +**不检查**(第三方库 / 上游快照,问题不是我们的): ``` -Drivers/CMSIS/ # ARM CMSIS -Drivers/STM32F4xx_HAL_Driver/ # ST HAL -Drivers/BSP/UI/ # LVGL UI 层 -Drivers/BSP/NET/lftpd/ # LwIP FTP -Drivers/BSP/dhara/ # NAND FTL -Lib/ # LVGL 库 -Middlewares/ # FreeRTOS -MDK-ARM/ # Keil 工程文件 -test/ # 测试代码 +Drivers/CMSIS/ # ARM CMSIS +Drivers/STM32F4xx_HAL_Driver/ # ST HAL +Drivers/BSP/NET/lftpd/ # LwIP FTP +Drivers/BSP/dhara/ # NAND FTL +IEC60870-Slave/ # 104 子站库的第三方快照(不进任何构建) +App/iec60870/common/ # 104 上游库未改造部分(见下) +App/iec60870/104/business/ # 同上 +App/iec60870/104/IEC104[_.] # 同上(大写开头的上游文件) +Lib/ # LVGL 库 +Middlewares/ # FreeRTOS +MDK-ARM/ # Keil 工程文件 +test/ # 测试代码(另由 test-cppcheck 只查 warning) ``` +⚠ **`Drivers/BSP/UI/` 是被检查的**——它在本仓是手写 UI 页面代码(不是 LVGL 库本体, +库在 `Lib/lvgl/`)。本节早期版本把它列进"不检查",与配置不符:2026-11-19 实测 +本钩子直接报了 `Drivers/BSP/UI/ui_page_yx.c` 的 `variableScope`。 + +这三条 `App/iec60870/` 前缀的边界要看清:它们只豁免**上游库尚未改造的那部分**。 +我们自己的小写适配文件(`iec104_core.c`、`iec104_net_mcu.c`、`iec104_source.c`、 +`iec104_comm.c` 等)**不在**豁免面内,改动仍会被本钩子检查——`IEC104_Net_Listen` +那个真缺陷就是在这个口径下抓出来的。⚠ 不能图省事把三条改写成祖先目录 +`App/iec60870/`,那会把适配层一起豁免。 + +### 4.6 本钩子与 coding-standard 的范围关系 + +两个钩子共享**同一套 11 项共同核心排除项**(`Drivers/CMSIS/`、`HAL_Driver/`、 +`lftpd/`、`dhara/`、上面三条 104 前缀、`IEC60870-Slave/`、`Lib/`、`Middlewares/`、 +`MDK-ARM/`)。在此之外各有一小块自己的豁免,是设计意图而非漏配: + +| 钩子 | 额外排除 | 理由 | +|---|---|---| +| `cppcheck` | `test/` | 由 `test-cppcheck` 专管(只查 warning) | +| `coding-standard` | `Src/`、`Inc/`、`nand_ftl\.` | CubeMX 生成文件不做字节保真;nand_ftl 函数名由外部 API 固定 | + +改共同核心那 11 项时**必须两边一起改**。这条纪律是踩出来的:2026-11-19 之前 +`cppcheck` 漏了 `IEC60870-Slave/`(726 条)和三条 104 前缀(76 条),合计 834 条 +命中里 802 条是噪音,真问题被完全淹没;而因为本钩子当时根本没跑起来(见 §4.2 的 +坏 zipapp 事故),这个不一致谁也没发现。 + --- ## 5. 误报抑制方法 @@ -213,6 +278,6 @@ if (day_count < diy) break; ### 5.2 全局抑制(`--suppress`) -某条规则在整个工程中都是噪音/不适用时,在 `.pre-commit-config.yaml` 的 args 中添加 `--suppress=规则名`(同样遵守 4.2 节引号规则),现有清单见 4.1 节。 +某条规则在整个工程中都是噪音/不适用时,在 `.pre-commit-config.yaml` 的 args 中添加 `--suppress=规则名`(同样遵守 4.3 节引号规则),现有清单见 4.1 节。 --- diff --git a/docs/内存管理/RAM使用分析与优化方案.md b/docs/内存管理/RAM使用分析与优化方案.md index 9f37436a..8ff51e10 100644 --- a/docs/内存管理/RAM使用分析与优化方案.md +++ b/docs/内存管理/RAM使用分析与优化方案.md @@ -47,10 +47,10 @@ dhara 失败类 +84;RO 另 +208,全是该失败类名表)→ `ER_IROM1` | 区域 | 用量 | 容量 | 占比 | |---|---|---|---| -| ER_IROM1 | 414,260 B (404.55 KB) | 1,048,576 B (1024 KB) | 39.5% | +| ER_IROM1 | 414,232 B (404.52 KB) | 1,048,576 B (1024 KB) | 39.5% | | RW_IRAM1 | 118,416 B (115.64 KB) | 131,072 B (128 KB) | 90.3% | | RW_CCM | 57,376 B (56.03 KB) | 65,280 B (64 KB) | 87.9% | -| **Flash (ROM 合计)** | **416,996 B (407.2 KB)** | 1,048,576 B (1024 KB) | **39.8%** | +| **Flash (ROM 合计)** | **416,968 B (407.2 KB)** | 1,048,576 B (1024 KB) | **39.8%** | 各区的容量与常量来源: diff --git a/docs/内存管理/RAM预算台账.md b/docs/内存管理/RAM预算台账.md index 777b1505..3e4d7bae 100644 --- a/docs/内存管理/RAM预算台账.md +++ b/docs/内存管理/RAM预算台账.md @@ -15,7 +15,7 @@ | 区域 | 用量 | 容量 | 占比 | 门禁(≤92%) | |---|---|---|---|---| -| ER_IROM1 (Flash) | 414,260 B | 1,048,576 B | 39.5% | 参考 | +| ER_IROM1 (Flash) | 414,232 B | 1,048,576 B | 39.5% | 参考 | | RW_CCM | 57,376 B | 65,280 B | 87.9% | PASS | | UNINIT_CCM | 48 B | 256 B | 18.8% | 参考 | | RW_IRAM1 | 118,416 B | 131,072 B | 90.3% | PASS | @@ -26,8 +26,8 @@ | 存储 | 9,144 B | 12 KB | OK | | UI | 36,791 B | 16 KB | ⚠ 超 19.9 KB | | RTOS 堆 | 57,376 B | 56 KB | 堆=配额 | -| 应用 | 47,707 B | 8 KB | ⚠ 超 38.6 KB | -| 其它 | 10,797 B | — | 参考 | +| 应用 | 47,715 B | 8 KB | ⚠ 超 38.6 KB | +| 其它 | 10,789 B | — | 参考 | - **门禁**:pre-commit `mem-budget` 钩子(`scripts/ram_baseline.py --gate`)—— diff --git a/scripts/ram_baseline.py b/scripts/ram_baseline.py index 3f2e2f9d..530c5ad8 100644 --- a/scripts/ram_baseline.py +++ b/scripts/ram_baseline.py @@ -85,7 +85,7 @@ def subsystem_of(obj): "task_prof", "boot_stats", "vol_idle_sync", "sys_", "cfg_", "dbg_", "console_log", "task_watchdog", "sha256", "tpafe", "sd2506", "test_task", "time_sync", - "time_sntp", + "time_sntp", "ioboard", "default_task")): return "应用" return "其它" diff --git a/scripts/ram_baseline.tsv b/scripts/ram_baseline.tsv index 3df88258..612c550b 100644 --- a/scripts/ram_baseline.tsv +++ b/scripts/ram_baseline.tsv @@ -24,4 +24,4 @@ date code ro rw zi er_irom1 er_pct iram1 iram1_pct ccm ccm_pct top_rwzi 2026-11-13 256592 32036 2088 152584 288628 27.5 97248 74.2 57376 87.9 heap_4.o=57376;lv_mem_core_builtin.o=16384;nand_ftl.o=8288;lftpd.o=7884;ui_net_sink.o=6802;ui_port.o=6432;wave_ring.o=5332;sb_link.o=4376;ch395f.o=4162;console_log.o=4132 2026-11-15 256592 32036 2088 152584 288628 27.5 97248 74.2 57376 87.9 heap_4.o=57376;lv_mem_core_builtin.o=16384;nand_ftl.o=8288;lftpd.o=7884;ui_net_sink.o=6802;ui_port.o=6432;wave_ring.o=5332;sb_link.o=4376;ch395f.o=4162;console_log.o=4132 2026-11-18 365896 48336 2736 173104 414232 39.5 118416 90.3 57376 87.9 heap_4.o=57376;lv_mem_core_builtin.o=16384;nand_ftl.o=8288;lftpd.o=7884;iec104_tcpserver.o=7656;ui_net_sink.o=6802;ui_port.o=6432;iec104_source.o=5944;wave_ring.o=5332;sb_link.o=4376 -2026-11-19 365924 48336 2736 173104 414260 39.5 118416 90.3 57376 87.9 heap_4.o=57376;lv_mem_core_builtin.o=16384;nand_ftl.o=8288;lftpd.o=7884;iec104_tcpserver.o=7656;ui_net_sink.o=6802;ui_port.o=6432;iec104_source.o=5944;wave_ring.o=5332;sb_link.o=4376 +2026-11-19 365896 48336 2736 173104 414232 39.5 118416 90.3 57376 87.9 heap_4.o=57376;lv_mem_core_builtin.o=16384;nand_ftl.o=8288;lftpd.o=7884;iec104_tcpserver.o=7656;ui_net_sink.o=6802;ui_port.o=6432;iec104_source.o=5944;wave_ring.o=5332;sb_link.o=4376 diff --git a/scripts/size_attestation.json b/scripts/size_attestation.json index 2e3fa0da..e0b9b486 100644 --- a/scripts/size_attestation.json +++ b/scripts/size_attestation.json @@ -1,17 +1,17 @@ { - "built_at": "2026-11-19T10:44:05+08:00", - "fingerprint": "b5fe5759eaf4a4b13edd5a6042aff84d16a7734170d14b689e2e58e761a83379", + "built_at": "2026-11-19T13:52:35+08:00", + "fingerprint": "a9c3b6948cde488de7e58c613af764f0f2136499c8c933d9e0dc27543135ecd6", "fingerprint_files": 1563, "fingerprint_source": "git-index", "gated_regions": [ "RW_IRAM1", "RW_CCM" ], - "git_head": "b142ca5531b7f791ec4bc489a460cf86bffd3bdd", + "git_head": "a2242b7345a7e2cd6ba1e764e11456e297b6e17d", "map": "MDK-ARM/STM32F407-Demo/STM32F407-Demo.map", - "map_mtime": 1795056226, + "map_mtime": 1795067117, "pct": { - "ER_IROM1": 39.51, + "ER_IROM1": 39.5, "RW_CCM": 87.89, "RW_IRAM1": 90.34, "UNINIT_CCM": 18.75 @@ -19,7 +19,7 @@ "regions": { "ER_IROM1": { "max": 1048576, - "size": 414260 + "size": 414232 }, "RW_CCM": { "max": 65280, @@ -37,7 +37,7 @@ "schema": 2, "scope_note": "\u540c\u7801\u51ed\u8bc1\uff1a\u6307\u7eb9\u8986\u76d6\u56fa\u4ef6\u4f53\u79ef\u76f8\u5173\u6e90\u7801\uff0c\u53e3\u5f84\u89c1\u672c\u811a\u672c docstring", "sizes": { - "code": 365924, + "code": 365896, "ro_data": 48336, "rw_data": 2736, "zi_data": 173104 diff --git a/test/host/iec104_netmcu/results/report.json b/test/host/iec104_netmcu/results/report.json index 229190fd..83617d4c 100644 --- a/test/host/iec104_netmcu/results/report.json +++ b/test/host/iec104_netmcu/results/report.json @@ -1,7 +1,7 @@ { "scope": "REAL backend App/iec60870/104/iec104_net_mcu.c + fake net layer; host-only isolation evidence, not full core/TcpServer/hardware", "backend": "App/iec60870/104/iec104_net_mcu.c", - "backend_sha256": "b4c2878742213213ad3b3472a72147736ef1dc71a62e0be6b8058a36853e8082", + "backend_sha256": "8a78fac4971a99f54a1e1b1964f5d49ed7f510178a0159ec12fa2babf31d7436", "sources": { "MATRIX.md": "e430599e1aea5868819992c43c257ecfb57b28c598fa3b0b5465fad5b9efd7a4", "net_socket_fake.h": "c7c712256b5ac4b5162fd445319296dd32ada4abc6efa0384e65e2635bba38c9",