From fd767d1dcd5267c8fcadf926fe5fb8540e66238d Mon Sep 17 00:00:00 2001 From: Wanderingss <1624155937@qq.com> Date: Mon, 16 Nov 2026 18:30:31 +0800 Subject: [PATCH] =?UTF-8?q?feat(ioboard):=20=E5=BC=80=E5=85=A5=E5=BC=80?= =?UTF-8?q?=E5=87=BA=E6=9D=BF=E9=A9=B1=E5=8A=A8=E3=80=81=E5=8E=BB=E6=8A=96?= =?UTF-8?q?=E5=BF=AB=E7=85=A7=E4=B8=8E=E4=B8=BB=E6=9C=BA=E4=BE=A7=E5=8D=95?= =?UTF-8?q?=E6=B5=8B=E6=8E=A5=E5=85=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 根钩子全通过。 --- .dsh/roles/README.md | 18 +- .dsh/roles/mcu-specialist.md | 146 ++++ App/task/default_task.c | 132 +++ App/util/ioboard_di.c | 217 +++++ App/util/ioboard_di.h | 180 ++++ App/util/task_prof.c | 6 +- App/util/task_prof.h | 2 + Drivers/BSP/IOBOARD/README.md | 253 ++++++ Drivers/BSP/IOBOARD/ioboard.c | 682 +++++++++++++++ Drivers/BSP/IOBOARD/ioboard.h | 259 ++++++ Drivers/BSP/IOBOARD/ioboard_bits.c | 34 + Drivers/BSP/IOBOARD/ioboard_bits.h | 58 ++ Drivers/BSP/TPAFE5160/README.md | 2 +- Inc/main.h | 18 + MDK-ARM/STM32F407-Demo.uvprojx | 17 +- STM32F407-Demo.ioc | 189 +++-- Src/gpio.c | 49 +- Src/main.c | 26 + docs/README.md | 6 +- docs/任务规划/README.md | 2 +- docs/任务规划/{登记簿.md => 硬件改版登记.md} | 1 + docs/内存管理/RAM使用分析与优化方案.md | 6 +- docs/文档规范.md | 25 +- docs/架构设计/硬件规格与能力边界.md | 8 +- docs/测试说明/专项验证/ADC前端注入验证流程.md | 2 +- .../单元测试/ADC输入层单元测试说明.md | 2 +- docs/硬件平台/ADC通道映射说明.md | 2 +- docs/硬件平台/V0.1_网表详细分析报告.md | 8 +- docs/硬件平台/开入开出实施说明.md | 381 +++++++++ docs/算法/继电保护功能复现规划.md | 6 +- scripts/check_registration.py | 2 + scripts/test_coverage_baseline.json | 304 ++++--- simulator/CMakeLists.txt | 10 +- test/host/ioboard/ioboard_test.c | 782 ++++++++++++++++++ test/host/ioboard/run_unit_test.py | 60 ++ 35 files changed, 3646 insertions(+), 249 deletions(-) create mode 100644 .dsh/roles/mcu-specialist.md create mode 100644 App/util/ioboard_di.c create mode 100644 App/util/ioboard_di.h create mode 100644 Drivers/BSP/IOBOARD/README.md create mode 100644 Drivers/BSP/IOBOARD/ioboard.c create mode 100644 Drivers/BSP/IOBOARD/ioboard.h create mode 100644 Drivers/BSP/IOBOARD/ioboard_bits.c create mode 100644 Drivers/BSP/IOBOARD/ioboard_bits.h rename docs/任务规划/{登记簿.md => 硬件改版登记.md} (79%) create mode 100644 docs/硬件平台/开入开出实施说明.md create mode 100644 test/host/ioboard/ioboard_test.c create mode 100644 test/host/ioboard/run_unit_test.py diff --git a/.dsh/roles/README.md b/.dsh/roles/README.md index c3f300bb..92d64bc2 100644 --- a/.dsh/roles/README.md +++ b/.dsh/roles/README.md @@ -24,6 +24,7 @@ spawn_teammate({ | `network-specialist` | 网络协议专家 | CH395F SPI 以太网、netTask socket 栈、IEC 60870-5-104、FTP、SNTP | `ops_grep`/`ops_glob`/`ops_inspect_local_file` + `edit`/`write` | | `storage-specialist` | 存储文件系统专家 | GD5F SPI NAND、dhara FTL、FatFs、日志系统、卷自愈 | `ops_grep`/`ops_glob`/`ops_inspect_local_file` + `edit`/`write` | | `ui-specialist` | UI/LVGL 专家 | LVGL 160×160 单色菜单、PC 模拟器、菜单树生成器、UI 自动化回归 | `ops_grep`/`ops_glob`/`ops_inspect_local_file` + `edit`/`write` | +| `mcu-specialist` | STM32 底层与引脚驱动专家 | GPIO/EXTI/AF 复用、时钟树、CubeMX 用户代码区边界、外部时序器件(移位寄存器/并口/SPI 从设备)的位操作与时序实现 | `ops_grep`/`ops_glob`/`ops_inspect_local_file` + `edit`/`write` | ### 通用工作角色(项目专项) @@ -36,7 +37,7 @@ spawn_teammate({ > **关于工具调用预算**:角色文件 frontmatter 里都写了 `maxToolCalls`,但该预算**只对 `subagent_role` 路径生效**,对 `spawn_teammate` 起的 teammate 不起约束(插件 `lib/budget.js` 的 `arm()` 只由委派工具调用,team 路径不挂账)。所以本表不再列预算列,免得被当成上限承诺。缺口与后续补齐口径 → `.dsh/plugins/dsh-plugin-subagent-roles/docs/子Agent角色自动注入实现说明.md` §1.1。 -> **关于模型**:角色文件 frontmatter **支持** `provider`/`model`/`reasoningEffort` 三个字段,但同样**只有 `subagent_role` 路径会读**。`spawn_teammate` 起的 teammate 一律跑在宿主默认模型上(本机 profile 的 `agent-default-model` = `workbuddy` / `deepseek-v4.1-flash`),与角色无关。当前 8 个角色文件都没写这三个字段,全部继承宿主默认。要给某个成员换模型用 `team_member_revive({ target, provider, model })`(活体立即生效,冷会话挂起到复活瞬间)。机制与两条改造路径 → `.dsh/plugins/dsh-plugin-subagent-roles/docs/子Agent角色自动注入实现说明.md` §1.2。 +> **关于模型**:角色文件 frontmatter **支持** `provider`/`model`/`reasoningEffort` 三个字段,但同样**只有 `subagent_role` 路径会读**。`spawn_teammate` 起的 teammate 一律跑在宿主默认模型上(本机 profile 的 `agent-default-model` = `workbuddy` / `deepseek-v4.1-flash`),与角色无关。当前 9 个角色文件都没写这三个字段,全部继承宿主默认。要给某个成员换模型用 `team_member_revive({ target, provider, model })`(活体立即生效,冷会话挂起到复活瞬间)。机制与两条改造路径 → `.dsh/plugins/dsh-plugin-subagent-roles/docs/子Agent角色自动注入实现说明.md` §1.2。 ## 角色详细说明 @@ -88,6 +89,18 @@ spawn_teammate({ --- +### mcu-specialist(STM32 底层与引脚驱动专家) + +**通用知识体系**:MCU 引脚的四层决定因素(焊盘/复用矩阵/GPIO 模式/时刻)、时钟使能与初始化顺序、微秒级时序约定(脉冲宽度、边沿极性、建立保持时间)、GPIO 位操作原子性、HAL 库的正确使用姿势(`GPIO_InitTypeDef` 清零、EXTI 回调在 ISR 上下文、HAL 时基依赖)、外部时序器件五维自查模型(装载/移位模式切换、时钟边沿方向、位序与移位方向、装载前后的时钟状态、上电静止态)、输出类器件(光耦/继电器)的有效电平与安全态。 + +**行业标准**:STM32F4 参考手册 RM0090(寄存器与复用映射)、数据手册 DS8626(Table 7 引脚定义)、CMSIS 与 HAL 的层次边界、74HC 系列逻辑器件手册(功能表与 AC 特性)、IEC 60255(出口回路语义)。 + +**项目专项**:引脚来源链 `.ioc` → `main.h` 的 `