Files
STM32F4-Base/Drivers/BSP/IOBOARD/ioboard_bits.c
T
wandering1 518e12f200 chore(gate): cppcheck 受检范围与编码规范对齐,存量 30 条 style 清零
起因:装真 cppcheck 2.21.0 后本钩子暴露 106 条命中,其中 76 条本就不该被扫。
cppcheck 与 coding-standard 两个钩子的注释都自称「范围一致」,实际各漏一块,
而本钩子此前从未真正跑起来(C:\cppcheck\cppcheck.exe 是坏 zipapp,进程根本没起,
--error-exitcode 对「没跑起来」不生效),所以没人发现。两轮合计 834 条命中里
802 条是「不该被扫的」,真问题被完全淹没。

一、范围对齐(106 → 30)
cppcheck 钩子 exclude 补三条 104 上游前缀:App/iec60870/common/、
App/iec60870/104/business/、App/iec60870/104/IEC104[_.]。三条只豁免上游库
尚未改造的部分,我们自己的小写适配文件(iec104_core/net_mcu/source/comm)仍受检。
不能改写成祖先目录 App/iec60870/,那会把适配层一起豁免。
test-cppcheck 钩子排除 test/host/iec104_netmcu/results(按 check_static_selftest.py
生成的自检变异体是故意写坏的副本,不是被测代码)。

二、剩余 30 条直接改代码清零(未建抑制基线)
逐条核过:cppcheck 判对了,它们违反本仓 docs/代码规范/嵌入式C语言代码规范_V1.0.md
§6.1.1「变量应在使用前声明,并尽可能在靠近使用的地方声明」。仓内对「永久免检」
有明确反对立场(coding-standard 的 104 排除注释写着「改完必须删掉这三行,否则等于
自建代码永久免检」),故不建抑制基线,直接改对:
- iec104_comm.c:4 处 v > IEC104_COMM_CA_MAX / PORT_MAX 删除。上界 65535 是
  uint16_t 类型极限,比较恒为假(compareValueOutOfTypeRangeError);宏本身保留,
  App/app/ui_data_feed.c 的 UI 范围提示仍要用它表达合法带上界。
- ioboard_bits.c:删 && (i < IOBOARD_DI_COUNT),外层 for 已限定,且它在取下标之后才判。
- iec104_source.c:三处 ifdef 哑变量(a/p/raw、e/i/b/raw/p/element、i/m/g/valid)
  把声明搬进各自编译档内,删掉全部 (void)x 抑制句——正是这些抑制句让 cppcheck
  认为「读了未赋值变量」(unassignedVariable)。另 remote_lookup / parameter_config
  的 i/n/p、g/m 就近声明。
- iec104_net_mcu.c:Listen 的 uint32_t i、Wait 的 listen_slot/client_slot/sock
  移进各自分支;sock 加 const。
- net_socket.c:net_pending_bytes 的 p_sock 加 const。
- ui_task.c:ui_task_wave_load_head 的 FRESULT fr 移进 if (ofr == FR_OK) 块。
- ioboard_di.c:ioboard_di_snap_read 的 s1/s2 移进重试循环。
- ui_page_yx.c:pg_refresh 的 dio_row 移进板级开入开出区分支。

三、实证
- cppcheck 钩子:106 → 30 → 0,Passed。
- 反证钩子没被排除条款吞掉:注入 variableScope 探针 → 立即报出
  variableScope + unreadVariable 两条;恢复后重新 Passed。
- Keil BUILD_OK 0 errors 0 warnings,Program Size 逐项不变
  (Code=365896 RO=48336 RW=2736 ZI=173104)=本轮全是纯排版,零目标码变化。
- test-cppcheck Passed(0 命中)。
- 全量 manual 阶段 52 根钩子全绿、0 失败。
- host 套件:iec104_comm 50/50、ioboard 131/131、iec104_dtu 7 tests OK、
  iec104_serv 50/50、net_socket 683/683、sys_clock 111/111、iec104_netmcu 17/17、
  net_events 34/34、net_listener 34/34、net_pending 43/43、net_select 22/22、
  ui_sink 17/17、lftpd 35/35、lftpd_inet 29/29、time_sync 33/33。
- UI golden:77 个页面 + 待机水位 + rtlive 全通过。
- net-handle:495 文件 PASS 0 违规。
- 裁剪档 IEC104_SOURCE_NO_VALUE_STORE 隔离编译 rc=0 无 error/warning
  (声明搬进 #else 后必须保证该档仍成立)。
- BOM:ui_page_yx.c / ui_task.c 编辑后 BOM 被剥,已补回,check_bom_drift rc=0。

四、顺带修掉的两处真实漏项
- ram_baseline.py 的 subsystem_of() 前缀表漏 ioboard:App/util/ioboard_di.c
  编出的 ioboard_di.o(4 B)一直静默算进「其它」而非「应用」,台账配额表看不见。
- 内存台账回填:a2242b73(IEC104_Net_Listen 修复)是上次回填 d2c328e8 之后的
  代码改动,内存数字从未重测,mem-numbers / mem-budget 两根钩子因此红。
  本轮按当前权威构建重新回填(Code=365896,相对 d2c328e8 的 365924 减 28 B)。

五、文档
docs/代码规范/cppcheck使用说明.md:
- §4.2 新增「安装陷阱:cppcheck.exe 可能是假 zipapp」——识别方法、根因、
  2.21.0 正确装法(MSI 截断与续传、管理式解包、必须整目录)、为什么不用 pip 版、
  教训(Failed 里没有命中/条数/文件名就当工具没跑起来)。
- §4.5 修正「Drivers/BSP/UI/ 不检查」的过期说法——它在本仓是手写 UI 页面代码
  (库在 Lib/lvgl/),实测本钩子直接报了 ui_page_yx.c。
- §4.6 新增两根钩子的范围关系表:共享 11 项共同核心,各自另有小块豁免
  (cppcheck 多排 test/,coding-standard 多排 Src/ Inc/ nand_ftl),是设计意图
  不是漏配;改共同核心必须两边一起改。
2026-11-19 14:00:29 +08:00

38 lines
1.6 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/*
* 模块名称:开入开出板的纯逻辑层(位序组装)
* 模块功能:74HC165 读到的比特序列 → 「A 在 LSB」的开入 mask。零寄存器、零依赖。
* 适用平台:只依赖 <stdint.h>;主机侧 MSVC 与 ARMCC 同一份源码编译。
* 作者:王建锋
* 创建日期:2026-11-16
* 修改记录:
* 2026-11-16 王建锋 创建
*/
#include "ioboard_bits.h"
/*
* 函数功能:把 74HC165 串行读出的 8 个比特组装成开入 mask(A 通道落在 bit0)
* 入口参数:bits - 长度 8;bits[i] = 第 i+1 个时钟沿之前从 QH 读到的电平
* 返回值:bit0 = A … bit7 = H
* 限定条件:纯函数
* 函数说明:详见 ioboard_bits.h 同名声明处的时序推导。这里是它在代码里的全部:
* 器件先吐 H 后吐 A,而接口要求 A 在 LSB,于是把第 i 次读到的东西塞进 7-i 位。
*/
uint8_t ioboard_di_assemble(const uint8_t bits[IOBOARD_DI_COUNT])
{
uint8_t mask = 0U;
uint8_t i;
for (i = 0U; i < (uint8_t)IOBOARD_DI_COUNT; i++) {
/* 只有 `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));
}
}
return mask;
}