电路地图 / Circuit Map

简体中文 | English

面向嘉立创 EDA 专业版的只读原理图理解、连接检查与调试辅助扩展。它把当前原理图的 .enet 网表组织成可搜索、可追踪的电路关系，并进一步整理电源、地、功能模块、接口、潜在问题和调试测量顺序。

功能演示

上图为扩展在嘉立创 EDA 专业版原理图中的实际运行界面：顶部汇总元件、网络、连接引脚和图页数量；左侧搜索与筛选网络或元件；中间查看所选对象的引脚连接；右侧查看属性，并可通过“在画布中定位”返回原理图。

功能

扩展提供八个工作区：

1. 浏览
   • 按电源、地、接口/总线、普通和未命名网络分类、搜索和筛选。
   • 查看元件位号、名称、参数、封装、图页、属性及每个引脚的连接。
   • 点击网络、元件或引脚，在 API 能匹配实时图元时回到画布定位。
   • 在画布中选中导线后，可为整条网络设置仅在扩展内显示的名称；原始网络名始终保留。
2. 寻线
   • 选择两个元件，查找元件—网络图中的最短连接路径。
   • 默认排除公共电源和地，避免所有元件经公共电源形成无意义捷径。
   • 路径节点可以逐个定位；结果表示拓扑连接，不表示电气方向。
3. 电源地图
   • 汇总电源轨、标称电压、候选来源、连接负载、涉及图页和去耦电容。
   • 识别稳压器 EN、PG、FB、VSENSE 等控制网络，以及可推断的上下游电源。
   • 单独整理 GND、AGND、DGND、PGND、EARTH 等地网络，显示 0Ω、磁珠或 Net Tie 等跨地连接器件。
4. 功能模块
   • 使用确定性规则将元件归入电源、控制器/MCU、通信、传感器、显示、模拟、电机、保护、接口、时钟、存储等模块。
   • 点击模块中的元件，查看它的直接关联元件、涉及网络、可能受影响模块和影响等级。
5. 连接审查
   • 检查单点网络、未连接引脚、资料缺失、NC 误接、电压命名、高扇出和不完整接口。
   • 增加自动网络名、悬空 EN/FB/RESET/BOOT、I²C 上拉、CAN 终端及同电压多名称提示。
   • 这是网表语义和可维护性提示，不替代 ERC、线宽、间距、制造规则或器件手册。
6. 接口图谱
   • 按网络名识别 I²C、SPI、UART、CAN、USB、SWD、RS485、JTAG、SDIO 和以太网信号组。
   • 整理连接器 Pinout、必要信号和涉及元件，并显示交叉连接、上拉、终端、公共地等接线核对提示与范例。
7. 调试助手
   • 根据实际电源、MCU、复位、时钟、下载口和接口拓扑生成“输出电压异常、MCU 不启动、接口无数据”等建议检测顺序。
   • 推荐电源、地、复位、SWD、UART、总线、ADC、PWM、EN、PG、FB 等关键网络作为测试点，并给出预期测量类型。
8. 变更对比
   • 在本机保存网表基线，刷新后比较新增、删除或变化的元件、网络、参数、封装和引脚接线。
   • 基线可随时更新或删除，不上传到外部服务。

每个工作区以及“命名导线”旁都有独立的 ?，其中包含适用场景、操作步骤、使用范例和结果边界。扩展还支持 UTF-8 BOM CSV/TXT 导出和简体中文/英文即时切换。

安装与使用

1. 在嘉立创 EDA 专业版中安装 build/dist/circuit-map-2df38e_v1.0.0.eext。
2. 打开一个原理图图页。
3. 从原理图顶部菜单选择“电路地图 → 打开电路地图”。
4. 首次使用建议依次打开“浏览 → 电源地图 → 功能模块 → 连接审查”；不知道某项怎么用时，点击它旁边的 ?。
5. 需要命名自动网络时，在原理图画布选中一根导线，再点击扩展顶部的“命名导线”。

扩展仅面向原理图，不提供 PCB 视图。

数据与隐私

扩展只读取当前编辑器中的原理图数据。主线程使用生产资料 API 生成嘉立创 EDA .enet 网表，并以只读图元 API 补充可匹配的图元 ID 和坐标。IFrame 只通过编辑器消息总线请求数据。

• 不创建、修改或删除原理图图元。
• 不上传工程、网表或元件数据。
• 不访问外部网络，也不申请外部交互权限。
• 扩展内网络名称按原理图保存在扩展用户配置中，不写入工程文件。
• “变更对比”的网表基线只保存在本机扩展窗口存储中，可由用户随时删除。
• 电源、模块、影响、检查、调试和测试点分析均在本地由确定性规则完成，不调用在线 AI。
• 日志只记录格式版本、数量和错误摘要，不记录网表正文。

兼容性与限制

• 需要嘉立创 EDA 专业版 3.x 扩展运行时。
• 解析器依据官方 .enet 2.0 JSON 结构；遇到未知可选字段时尽量兼容并显示提示。
• 未命名网络以友好名称显示，导出时仍保留原始网名。
• 电源方向、功能模块、接口协议、影响等级和调试步骤依赖网络名、引脚名、器件资料与图拓扑启发式推断；应结合原理图和器件手册确认。
• 调试助手不会读取真实板上电压，也不替代安全操作、万用表/示波器测量或工程判断。
• 重复位号、跨图页同名对象或无法与实时图元唯一匹配时，连接仍可查看，但画布定位可能不可用。
• “定位”仅改变选择和视图，不修改设计内容。

开发与验证

npm install
npm test
npm run lint
npm run build

已包含网表解析、连接分析、电源/模块/调试分析、网络别名和八工作区 DOM/功能契约测试，并执行 ESLint、脚本语法检查和正式构建。最终交付环境没有可连接的嘉立创 EDA 专业版实例，因此安装、真实工程读取、画布选择/定位、扩展存储和保存对话框仍需在编辑器中验收；仓库未使用离线固定数据冒充真实运行截图。

相关规范：IFrame 开发指南、生产资料网表 API、官方 .enet 格式。

许可

Apache License 2.0。详见 LICENSE。