feat(ioboard): 开入开出板驱动、去抖快照与主机侧单测接入

74HC165 开入 + 光耦继电器开出的完整硬件抽象层,接进 defaultTask
的 50ms 节拍。开入 8 路(第二块 165 数据线板上未接,故只有 8 位),
开出 4 路(高电平吸合)。

驱动 BSP drivers:
- IOBOARD/ioboard.c 装载与移位时序,每步注明数据手册依据;
  SH/LD 拉高前先拉低 CLK,否则装载瞬间多移一位;
  单次读取上界 26us(延时按最慢列 VCC 2V 全温区取值)。
- IOBOARD/ioboard_bits.c 位序组装纯函数,只依赖 stdint.h,
  主机侧可直接 include 做单测:读 8 次为 H,G,F,E,D,C,B,A,
  A 放 bit0(bit(7-i) = reads[i])。
- 极性集中在 IOBOARD_DO_LEVEL_ACTIVE 一处,接口语义统一为
  mask 的 1 = 吸合。

业务接线:
- App/util/ioboard_di.c 通道去抖与双区快照,纯逻辑;
  刻意不 include ioboard.h(其引脚宏会牵入 main.h),
  两处路数常量由测试的编译期静态断言钉住。
- default_task.c 的 default_task_di_poll():读失败不喂去抖、
  不写发布值,只把上一有效值加 valid=0 发布出去,
  避免"全 0"被现场读成开入全部复归。
- 去抖实际粒度 50ms(每个轮询周期喂一拍),最坏上报约 100ms;
  想要真 20ms 需另建定时器,本次不做。
- Src/main.c 在 app_main_init 之前调 ioboard_init(),
  上电即把 4 路出口钉在全释放并确认 165 静止态。

测试:
- test/host/ioboard/ 100 条断言。位序主判据为单比特两端
  (只有 A 得 0x01、只有 H 得 0x80)加八点双射穷举;
  混合图样降级为辅助,因该图样曾先后被算成 0xA5、0x5A、0xAA。
- 去抖覆盖 20ms 边界、抖动不翻、跨 49.7 天回绕。
- 失败语义覆盖"失败保留上次有效值"与"失败窗口内的真实变位不丢"。

文档:
- 新增 docs/硬件平台/开入开出实施说明.md。
- 硬件规格与能力边界 §5 的能力边界现状改写:出口继电器与
  开入回路已具备、业务层未接入;4 路开出只可台架验证,
  不得用于真实跳闸。
- 修正 docs/文档规范.md §3.1:原文要求所有互链用仓库根相对,
  与 check_doc_links.py 的实际解析基准矛盾(markdown 链接按
  当前文档目录解析,反引号路径才按仓库根)。改为区分两类,
  并补 §3.1b 写明对应校验器。
- 清理 docs/任务规划/登记簿.md 改名为硬件改版登记.md 后
  遗留的 9 处旧名引用。

门禁: keil-build 0 Error 0 Warning;主机侧单测 ioboard 100/100、
sb_proto 45/45;pre-commit 48 根钩子全通过。
This commit is contained in:
2026-11-16 18:30:31 +08:00
parent d9f8dbfd90
commit fd767d1dcd
35 changed files with 3646 additions and 249 deletions
+2
View File
@@ -137,6 +137,8 @@ SIM_EXEMPT = [
("Drivers/BSP/NET/net_pending.c", "MCU 挂起 recv 模型(依赖 ch395f_* SPI 读出与 FreeRTOS 通知),模拟器另有 net_socket_sim.c 按外部语义模拟"),
("Drivers/BSP/NET/net_udp.c", "MCU UDP 数据面执行器与挂起 recv 槽(2026-11-03 UDP 队列化改造;依赖 ch395f_* SPI 读写、net_send_locked 与 FreeRTOS 通知),模拟器另有 net_socket_sim.c 按外部语义模拟"),
("Drivers/BSP/RS485/rs485.c", "MCU RS-485 驱动"),
("Drivers/BSP/IOBOARD/ioboard.c", "MCU 开入开出驱动(74HC165 GPIO 时序 + 光耦继电器 BSRR 写),依赖 main.h 引脚宏与 FreeRTOS 临界区,模拟器无对应;纯逻辑(位序组装)在 ioboard_bits.c"),
("Drivers/BSP/IOBOARD/ioboard_bits.c", "开入开出纯逻辑层(不依赖 HAL/RTOS),模拟器无消费路径;位序由主机侧单测直接编译覆盖于 test/host/ioboard"),
("Drivers/BSP/SD2506/sd2506.c", "MCU RTC 驱动"),
("Drivers/BSP/ScreenLink/sb_proto.c", "屏板链路协议层纯逻辑(帧 A 解析 / 帧 B 组帧 / CRC-16),消费者 = MCU 侧 USART1 收发起发(批 1/2),模拟器无消费路径;主机侧纯逻辑单测覆盖于 test/host/sb_proto"),
("Drivers/BSP/ScreenLink/sb_link.c", "屏板链路传输层(USART1 IDLE 中断收 + ORE 清除 + 统计),依赖 HAL 句柄与中断上下文,MCU 专属;主机侧单测以桩覆盖于 test/host/sb_link"),
+173 -131
View File
@@ -1,12 +1,12 @@
{
"files": {
"App/algo/adc_cal.c": {
"func_rate": 0.9412,
"funcs_covered": 16,
"funcs_valid": 17,
"line_rate": 0.9463,
"lines_covered": 141,
"lines_valid": 149
"func_rate": 0.9565,
"funcs_covered": 22,
"funcs_valid": 23,
"line_rate": 0.9637,
"lines_covered": 186,
"lines_valid": 193
},
"App/algo/adc_health.c": {
"func_rate": 1.0,
@@ -65,12 +65,12 @@
"lines_valid": 179
},
"App/algo/run_par.c": {
"func_rate": 0.9286,
"funcs_covered": 13,
"funcs_valid": 14,
"line_rate": 0.8837,
"lines_covered": 114,
"lines_valid": 129
"func_rate": 0.9333,
"funcs_covered": 14,
"funcs_valid": 15,
"line_rate": 0.8919,
"lines_covered": 132,
"lines_valid": 148
},
"App/algo/sample_ring.c": {
"func_rate": 1.0,
@@ -93,24 +93,24 @@
"funcs_covered": 15,
"funcs_valid": 15,
"line_rate": 0.9956,
"lines_covered": 225,
"lines_valid": 226
"lines_covered": 227,
"lines_valid": 228
},
"App/algo/wave_store.c": {
"func_rate": 1.0,
"funcs_covered": 29,
"funcs_valid": 29,
"line_rate": 0.9612,
"lines_covered": 446,
"lines_valid": 464
"funcs_covered": 30,
"funcs_valid": 30,
"line_rate": 0.9551,
"lines_covered": 468,
"lines_valid": 490
},
"App/cfg/cfg_file.c": {
"func_rate": 0.963,
"funcs_covered": 26,
"funcs_valid": 27,
"line_rate": 0.8882,
"lines_covered": 612,
"lines_valid": 689
"func_rate": 0.9643,
"funcs_covered": 27,
"funcs_valid": 28,
"line_rate": 0.878,
"lines_covered": 662,
"lines_valid": 754
},
"App/cfg/cfg_file_store_mcu.c": {
"func_rate": 1.0,
@@ -240,6 +240,14 @@
"lines_covered": 78,
"lines_valid": 81
},
"App/util/ioboard_di.c": {
"func_rate": 1.0,
"funcs_covered": 8,
"funcs_valid": 8,
"line_rate": 0.9358,
"lines_covered": 102,
"lines_valid": 109
},
"App/util/sha256.c": {
"func_rate": 1.0,
"funcs_covered": 7,
@@ -273,12 +281,20 @@
"lines_valid": 73
},
"Drivers/BSP/GD5F2GQ5UE/nand_ftl.c": {
"func_rate": 0.6364,
"funcs_covered": 14,
"funcs_valid": 22,
"line_rate": 0.4862,
"lines_covered": 123,
"lines_valid": 253
"func_rate": 0.8,
"funcs_covered": 20,
"funcs_valid": 25,
"line_rate": 0.6262,
"lines_covered": 191,
"lines_valid": 305
},
"Drivers/BSP/IOBOARD/ioboard_bits.c": {
"func_rate": 1.0,
"funcs_covered": 1,
"funcs_valid": 1,
"line_rate": 1.0,
"lines_covered": 8,
"lines_valid": 8
},
"Drivers/BSP/NET/lftpd/lftpd.c": {
"func_rate": 0.8077,
@@ -301,8 +317,8 @@
"funcs_covered": 9,
"funcs_valid": 9,
"line_rate": 1.0,
"lines_covered": 127,
"lines_valid": 127
"lines_covered": 128,
"lines_valid": 128
},
"Drivers/BSP/NET/lftpd/lftpd_io.c": {
"func_rate": 0.3846,
@@ -402,19 +418,19 @@
},
"Drivers/BSP/ScreenLink/sb_proto.c": {
"func_rate": 1.0,
"funcs_covered": 6,
"funcs_valid": 6,
"funcs_covered": 5,
"funcs_valid": 5,
"line_rate": 1.0,
"lines_covered": 75,
"lines_valid": 75
"lines_covered": 55,
"lines_valid": 55
},
"Drivers/BSP/UI/ui_data.c": {
"func_rate": 0.8235,
"func_rate": 0.8077,
"funcs_covered": 42,
"funcs_valid": 51,
"line_rate": 0.8692,
"funcs_valid": 52,
"line_rate": 0.8611,
"lines_covered": 372,
"lines_valid": 428
"lines_valid": 432
},
"Drivers/BSP/UI/ui_net_sink.c": {
"func_rate": 0.7692,
@@ -437,10 +453,10 @@
"modules": {
"adc_cal": {
"files": {
"App/algo/adc_cal.c": 149,
"App/cfg/cfg_file.c": 689
"App/algo/adc_cal.c": 193,
"App/cfg/cfg_file.c": 754
},
"lines_total": 838,
"lines_total": 947,
"ok": true
},
"adc_health": {
@@ -466,9 +482,9 @@
},
"cfg_file": {
"files": {
"App/cfg/cfg_file.c": 689
"App/cfg/cfg_file.c": 754
},
"lines_total": 689,
"lines_total": 754,
"ok": true
},
"cfg_file_store_mcu": {
@@ -511,21 +527,21 @@
},
"iec104": {
"files": {
"App/algo/adc_cal.c": 149,
"App/algo/adc_cal.c": 193,
"App/algo/freq.c": 130,
"App/algo/meas.c": 64,
"App/algo/phasor.c": 55,
"App/algo/prot_elm.c": 122,
"App/algo/prot_set.c": 179,
"App/algo/run_par.c": 129,
"App/algo/run_par.c": 148,
"App/algo/sample_ring.c": 41,
"App/cfg/cfg_file.c": 689,
"App/cfg/cfg_file.c": 754,
"App/protocol/iec104/iec104_asdu.c": 103,
"App/protocol/iec104/iec104_comm.c": 50,
"App/protocol/iec104/iec104_link.c": 405,
"App/protocol/iec104/iec104_pts.c": 255
},
"lines_total": 2371,
"lines_total": 2499,
"ok": true
},
"iec104_serv": {
@@ -535,6 +551,14 @@
"lines_total": 173,
"ok": true
},
"ioboard": {
"files": {
"App/util/ioboard_di.c": 109,
"Drivers/BSP/IOBOARD/ioboard_bits.c": 8
},
"lines_total": 117,
"ok": true
},
"lftpd": {
"files": {
"Drivers/BSP/NET/lftpd/lftpd.c": 473,
@@ -545,9 +569,9 @@
},
"lftpd_inet": {
"files": {
"Drivers/BSP/NET/lftpd/lftpd_inet.c": 127
"Drivers/BSP/NET/lftpd/lftpd_inet.c": 128
},
"lines_total": 127,
"lines_total": 128,
"ok": true
},
"lftpd_io": {
@@ -569,9 +593,9 @@
},
"nand_port": {
"files": {
"Drivers/BSP/GD5F2GQ5UE/nand_ftl.c": 253
"Drivers/BSP/GD5F2GQ5UE/nand_ftl.c": 305
},
"lines_total": 253,
"lines_total": 305,
"ok": true
},
"net_cfg": {
@@ -628,14 +652,14 @@
},
"prot_dim": {
"files": {
"App/algo/adc_cal.c": 149,
"App/algo/adc_cal.c": 193,
"App/algo/freq.c": 130,
"App/algo/phasor.c": 55,
"App/algo/prot_elm.c": 122,
"App/algo/prot_set.c": 179,
"App/algo/sample_ring.c": 41
},
"lines_total": 676,
"lines_total": 720,
"ok": true
},
"prot_elm": {
@@ -666,11 +690,11 @@
},
"run_par": {
"files": {
"App/algo/adc_cal.c": 149,
"App/algo/run_par.c": 129,
"App/cfg/cfg_file.c": 689
"App/algo/adc_cal.c": 193,
"App/algo/run_par.c": 148,
"App/cfg/cfg_file.c": 754
},
"lines_total": 967,
"lines_total": 1095,
"ok": true
},
"sb_led_map": {
@@ -683,16 +707,16 @@
"sb_link": {
"files": {
"Drivers/BSP/ScreenLink/sb_link.c": 243,
"Drivers/BSP/ScreenLink/sb_proto.c": 75
"Drivers/BSP/ScreenLink/sb_proto.c": 55
},
"lines_total": 318,
"lines_total": 298,
"ok": true
},
"sb_proto": {
"files": {
"Drivers/BSP/ScreenLink/sb_proto.c": 75
"Drivers/BSP/ScreenLink/sb_proto.c": 55
},
"lines_total": 75,
"lines_total": 55,
"ok": true
},
"sha256": {
@@ -756,10 +780,10 @@
},
"ui_data": {
"files": {
"Drivers/BSP/UI/ui_data.c": 428,
"Drivers/BSP/UI/ui_data.c": 432,
"Drivers/BSP/UI/ui_w_soe.c": 62
},
"lines_total": 490,
"lines_total": 494,
"ok": true
},
"ui_sink": {
@@ -792,25 +816,25 @@
},
"wave_ring": {
"files": {
"App/algo/wave_ring.c": 226,
"App/algo/wave_store.c": 464
"App/algo/wave_ring.c": 228,
"App/algo/wave_store.c": 490
},
"lines_total": 690,
"lines_total": 718,
"ok": true
},
"wave_store": {
"files": {
"App/algo/wave_store.c": 464
"App/algo/wave_store.c": 490
},
"lines_total": 464,
"lines_total": 490,
"ok": true
},
"wave_trig": {
"files": {
"App/algo/wave_ring.c": 226,
"App/algo/wave_store.c": 464
"App/algo/wave_ring.c": 228,
"App/algo/wave_store.c": 490
},
"lines_total": 690,
"lines_total": 718,
"ok": true
}
},
@@ -847,11 +871,13 @@
"App/sync/time_sync.c",
"App/task/iec104_serv.c",
"App/util/boot_stats.c",
"App/util/ioboard_di.c",
"App/util/sha256.c",
"App/util/sys_clock.c",
"App/util/task_prof.c",
"App/util/task_watchdog.c",
"Drivers/BSP/GD5F2GQ5UE/nand_ftl.c",
"Drivers/BSP/IOBOARD/ioboard_bits.c",
"Drivers/BSP/NET/lftpd/lftpd.c",
"Drivers/BSP/NET/lftpd/lftpd_auth.c",
"Drivers/BSP/NET/lftpd/lftpd_inet.c",
@@ -874,16 +900,16 @@
],
"totals": {
"files_generated_excluded": 5,
"files_tested": 54,
"files_untested": 177,
"func_rate": 0.929,
"funcs_covered": 641,
"funcs_valid": 690,
"line_rate": 0.901,
"lines_covered": 8552,
"lines_valid": 9492,
"modules_ok": 48,
"modules_total": 48
"files_tested": 56,
"files_untested": 181,
"func_rate": 0.9339,
"funcs_covered": 664,
"funcs_valid": 711,
"line_rate": 0.9027,
"lines_covered": 8848,
"lines_valid": 9802,
"modules_ok": 49,
"modules_total": 49
},
"untested_sources": [
{
@@ -891,23 +917,23 @@
"path": "Drivers/BSP/CH395F/ch395f.c"
},
{
"code_lines": 689,
"code_lines": 712,
"path": "Drivers/BSP/GD5F2GQ5UE/gd5f2gq5ue.c"
},
{
"code_lines": 570,
"code_lines": 597,
"path": "App/task/ui_task.c"
},
{
"code_lines": 466,
"code_lines": 539,
"path": "App/task/default_task.c"
},
{
"code_lines": 420,
"code_lines": 423,
"path": "App/app/ui_data_feed.c"
},
{
"code_lines": 369,
"code_lines": 375,
"path": "App/task/adc_task.c"
},
{
@@ -919,7 +945,7 @@
"path": "Drivers/BSP/UI/ui_w_setview.c"
},
{
"code_lines": 303,
"code_lines": 334,
"path": "Drivers/BSP/UI/ui_content_page.c"
},
{
@@ -930,20 +956,28 @@
"code_lines": 264,
"path": "Drivers/BSP/SD2506/sd2506.c"
},
{
"code_lines": 262,
"path": "Drivers/BSP/IOBOARD/ioboard.c"
},
{
"code_lines": 261,
"path": "Drivers/BSP/UI/ui_page_sntp.c"
},
{
"code_lines": 251,
"code_lines": 255,
"path": "Drivers/BSP/UI/ui_standby.c"
},
{
"code_lines": 253,
"path": "Drivers/BSP/UI/ui_page_wave_play.c"
},
{
"code_lines": 230,
"code_lines": 232,
"path": "Drivers/BSP/UI/ui_data.h"
},
{
"code_lines": 218,
"code_lines": 219,
"path": "Drivers/BSP/UI/ui_page_clock.c"
},
{
@@ -958,10 +992,6 @@
"code_lines": 205,
"path": "Drivers/BSP/UI/ui_page_net_cfg.c"
},
{
"code_lines": 204,
"path": "Drivers/BSP/UI/ui_standby.c"
},
{
"code_lines": 200,
"path": "Drivers/BSP/UI/ui_w_ytview.c"
@@ -971,11 +1001,11 @@
"path": "Drivers/BSP/TPAFE5160/tpafe5160.c"
},
{
"code_lines": 152,
"code_lines": 154,
"path": "Drivers/BSP/UI/ui_page_runreport.c"
},
{
"code_lines": 150,
"code_lines": 152,
"path": "App/algo/wave_store.h"
},
{
@@ -983,11 +1013,11 @@
"path": "Drivers/BSP/UI/ui_page_password.c"
},
{
"code_lines": 146,
"code_lines": 148,
"path": "Drivers/BSP/UI/ui_page_device_info.c"
},
{
"code_lines": 142,
"code_lines": 143,
"path": "App/app/app_main.c"
},
{
@@ -1015,7 +1045,7 @@
"path": "Drivers/BSP/UI/ui_page_action.c"
},
{
"code_lines": 112,
"code_lines": 114,
"path": "Drivers/BSP/UI/ui_page_ac.c"
},
{
@@ -1039,13 +1069,17 @@
"path": "Drivers/BSP/GD5F2GQ5UE/gd5f2gq5ue.h"
},
{
"code_lines": 86,
"code_lines": 87,
"path": "Drivers/BSP/UI/ui_page_yx.c"
},
{
"code_lines": 84,
"path": "Drivers/BSP/RS485/rs485.c"
},
{
"code_lines": 78,
"path": "App/algo/wave_ring.h"
},
{
"code_lines": 77,
"path": "App/algo/prot_set.h"
@@ -1055,11 +1089,7 @@
"path": "Drivers/BSP/dbg_log.h"
},
{
"code_lines": 75,
"path": "App/algo/wave_ring.h"
},
{
"code_lines": 69,
"code_lines": 70,
"path": "Drivers/BSP/UI/ui_page_dc.c"
},
{
@@ -1102,6 +1132,10 @@
"code_lines": 46,
"path": "App/log/soe_rec.h"
},
{
"code_lines": 46,
"path": "Drivers/BSP/UI/ui_content_page.h"
},
{
"code_lines": 46,
"path": "Drivers/BSP/UI/ui_page_reset.c"
@@ -1114,10 +1148,6 @@
"code_lines": 44,
"path": "App/algo/adc_input.h"
},
{
"code_lines": 43,
"path": "Drivers/BSP/UI/ui_content_page.h"
},
{
"code_lines": 42,
"path": "App/cfg/cfg_file.h"
@@ -1151,12 +1181,16 @@
"path": "Drivers/BSP/UI/ui_page_deadband.c"
},
{
"code_lines": 38,
"path": "Drivers/BSP/UI/ui_page_wave_manual.c"
"code_lines": 39,
"path": "App/algo/adc_cal.h"
},
{
"code_lines": 36,
"path": "Drivers/BSP/ScreenLink/sb_proto.h"
"code_lines": 38,
"path": "App/util/ioboard_di.h"
},
{
"code_lines": 38,
"path": "Drivers/BSP/UI/ui_page_wave_manual.c"
},
{
"code_lines": 36,
@@ -1186,10 +1220,6 @@
"code_lines": 33,
"path": "Drivers/BSP/UI/ui_page_action.h"
},
{
"code_lines": 32,
"path": "App/algo/adc_cal.h"
},
{
"code_lines": 32,
"path": "App/util/boot_stats.h"
@@ -1202,6 +1232,14 @@
"code_lines": 31,
"path": "App/protocol/iec104/iec104_pts.h"
},
{
"code_lines": 31,
"path": "Drivers/BSP/IOBOARD/ioboard.h"
},
{
"code_lines": 31,
"path": "Drivers/BSP/ScreenLink/sb_proto.h"
},
{
"code_lines": 31,
"path": "Drivers/BSP/UI/ui_deco.c"
@@ -1230,6 +1268,14 @@
"code_lines": 27,
"path": "App/task/task_handles.h"
},
{
"code_lines": 27,
"path": "App/util/task_prof.h"
},
{
"code_lines": 27,
"path": "Drivers/BSP/GD5F2GQ5UE/nand_ftl.h"
},
{
"code_lines": 27,
"path": "Drivers/BSP/NET/net_pending.h"
@@ -1242,10 +1288,6 @@
"code_lines": 26,
"path": "App/algo/sb_led_map.h"
},
{
"code_lines": 26,
"path": "App/util/task_prof.h"
},
{
"code_lines": 26,
"path": "Drivers/BSP/UI/ui_port.h"
@@ -1264,11 +1306,11 @@
},
{
"code_lines": 23,
"path": "App/protocol/iec104/iec104_comm.h"
"path": "App/algo/run_par.h"
},
{
"code_lines": 22,
"path": "App/algo/run_par.h"
"code_lines": 23,
"path": "App/protocol/iec104/iec104_comm.h"
},
{
"code_lines": 22,
@@ -1366,6 +1408,10 @@
"code_lines": 15,
"path": "Drivers/BSP/UI/ui_standby.h"
},
{
"code_lines": 14,
"path": "Drivers/BSP/IOBOARD/ioboard_bits.h"
},
{
"code_lines": 14,
"path": "Drivers/BSP/UI/ui_style.c"
@@ -1398,10 +1444,6 @@
"code_lines": 12,
"path": "App/task/iec104_serv.h"
},
{
"code_lines": 12,
"path": "Drivers/BSP/GD5F2GQ5UE/nand_ftl.h"
},
{
"code_lines": 12,
"path": "Drivers/BSP/NET/lftpd/private/lftpd_io.h"