软硬件引脚一致性审查

嘉立创 EDA 专业版 V3 扩展，用于只读比较原理图中选定 MCU 的 GPIO 连接与 STM32CubeMX .ioc 配置。v1.4 使用全局电路连接图追踪同名网络标签和远端器件，帮助发现引脚遗漏、标签冲突、拓扑冲突和 MCU 型号不一致。

功能演示

原理图示例

MCU 引脚可以仅使用 PA9、PB10 等物理引脚名称，再通过同名网络标签连接远端 LED、按键或接口电路。插件依据嘉立创 EDA 生成的原理图网表追踪完整连接关系。

审查结果

选择 STM32CubeMX .ioc 后，结果窗口会显示 MCU 型号检查、状态统计、硬件拓扑推断、置信度、CubeMX 配置、判断证据和完整连接路径。

以上截图为扩展在嘉立创 EDA 专业版 V3 中的实际运行效果。

功能

• 读取当前原理图中选中的单个 MCU 及其 GPIO 引脚。
• 生成并解析嘉立创 EDA 原理图网表。
• 读取 STM32CubeMX .ioc 中的 MCU、封装、GPIO 功能和 User Label。
• 以物理引脚名（如 PA5、PK15）关联软硬件数据。
• 标记一致、拓扑一致、冲突、硬件遗漏、软件遗漏和待确认状态。
• 将网表转换为全局连接图，沿同名网络标签追踪远端电路。
• 识别 LED 与限流电阻的两种排列顺序，以及按键上拉/下拉电路。
• 识别 GPIO 经三极管或 MOS 管控制 LED 的负载支路。
• 从远端器件引脚名称推断 I²C、SPI、UART、PWM 接口。
• 识别连接器和测试点；普通排针外部用途未知时保持“待确认”。
• 展示硬件推断角色、证据、完整路径和高/中/低置信度。
• 在 IFrame 表格中筛选结果并导出 UTF-8 CSV。

扩展只读取原理图和 IOC，不会修改原理图、PCB 或 CubeMX 工程。

使用方法

1. 在嘉立创 EDA V3 中打开并保存原理图。
2. 只选中一个 STM32 MCU 器件。
3. 点击“软硬件引脚审查 → 开始审查...”。
4. 选择与该硬件对应的 STM32CubeMX .ioc 文件。
5. 在结果窗口查看型号、封装、状态统计和逐引脚差异。
6. 如需留档，点击“导出 CSV”。

状态说明

开发与构建

需要 Node.js >=20.17.0。Windows PowerShell 如果禁止执行 npm.ps1，请使用 npm.cmd。

npm.cmd install
npm.cmd test
npm.cmd run lint
npm.cmd run build

构建结果位于：

build/dist/pin-contract_v1.4.0.eext

在嘉立创 EDA V3 中通过“高级 → 扩展管理器 → 导入”安装。

目录结构

extension.json       扩展清单、版本和菜单入口
src/index.ts         EDA API、文件选择、网表读取和 IFrame 通信
src/core.ts          IOC 解析、STM32 型号与软硬件语义比较
src/topology.ts      全局网络图、路径遍历、器件分类和置信度推断
iframe/index.html    结果 UI、筛选和 CSV 导出
tests/core.test.mjs  核心逻辑测试
build/dist/          .eext 构建输出

当前范围

• 面向 STM32CubeMX .ioc 文件，支持所有使用标准 P字母+数字 端口命名的 STM32 普通 GPIO。
• 不审查 VDD、VSS、NRST、BOOT、OSC、VBAT 等特殊、电源和启动引脚。
• 电路推断依赖网表中的最终网络名、器件位号、器件属性和远端引脚名。
• 连接器外部模块未知、器件属性不足或只有网络名称提示时不会强行判定一致。
• 嘉立创 EDA 的网表导出 API 仍为 BETA；当前自动测试使用模拟 ENET 数据，真实跨页/层次网络需结合实际工程继续验证。

许可证

Apache-2.0