Files

5.2 KiB
Raw Permalink Blame History

MentorExport 原理图批量导出

解压整个工具文件夹后,双击「导出.cmd」,或在命令提示符中运行它。Python 和必要包已经预置,使用者无需安装 Python、pip 或设置环境变量。需要本机已有 Mentor 安装及对应可用许可。

第一次使用

  1. 保存需要导出的原理图。
  2. 启动「导出.cmd」。自动发现 Mentor;有多套时选择版本。
  3. 输入工程根目录,递归扫描 .prj;输入结果根目录。
  4. 核对数量与原理图快照后确认。完成后可直接打开汇总、结果目录,或重试未完成项。

默认读取工程指定的原理图快照,通常是 DxD。工具不打开 Designer,不执行换料或 PCB 同步。源数据库只用于捕获稳定副本,各导出器在私有副本中运行。

命令行

导出.cmd
导出.cmd --check
导出.cmd --input "F:\工程目录" --output "F:\导出结果" --yes
导出.cmd --mentor-home "D:\Mentor\7.9.5EE\SDD_HOME" --input "F:\工程目录" --yes
导出.cmd --retry "F:\导出结果\批次_..." --yes
导出.cmd --input "F:\工程目录" --output "F:\导出结果" --jobs 3 --yes
导出.cmd --input "F:\工程目录" --jobs 1 --yes

不指定参数进入问答。--yes 适合使用固定参数重复运行;发现多套 Mentor 时需要 --mentor-home 指定。--timeout 可以调整单工具等待上限,默认 60 秒。

默认同时运行 3 个独立导出任务,可用 --jobs 1 切换串行,--jobs 2 到 8 调整并发上限。各工具使用同一已保存输入的独立副本;工程按顺序处理,库件读取在 ASCII 平铺属性就绪后与其他导出重叠,同库缓存继续共享。快照名称探测也参与同一并发上限,不额外占用任务槽。

工具退出通过进程通知立即唤醒,不额外睡眠;收尾与其他导出重叠执行。后台进程自然退出的宽限期最多 2 秒,已退出则立即结束等待。若仍有自有后台进程需要终止,会保留文件并记录提示,不标为已验证成功,也不阻塞其他任务。运行记录分别保存工具执行与收尾耗时,工程记录保存实际并发数与总耗时。

按 Ctrl+C 请求停止,等待工具收尾;不要直接关闭窗口。下次使用 --retry 指定批次,可恢复未完成项。成功产物只有在输入、工具和输出摘要仍匹配时才复用;源工程变化会完整重新导出该工程。

默认尽力导出并持续完成批次。单项异常、缺工具/缺库、超时、格式检查提示或进程收尾提示,都记录下来并继续后续工具和工程;报告文件被占用也不阻塞导出。只有用户主动按 Ctrl+C 才停止批次。

生成了非空文件便保留在正常分类目录,并显示「已导出」或「已导出(有提示)」。没有生成文件的工程显示「已跳过(无导出文件)」,单项显示「未导出」或「已跳过」。格式检查、非零退出和源文件变化保留为提示;带提示的产物不会作为已验证成功结果复用。收尾不确定时保留临时副本及自有进程句柄,继续使用独立副本运行其余任务。

退出码:0 批次已跑完(允许存在跳过项和提示);2 启动环境或输入配置错误,未能开始;130 用户主动取消。判断具体取得了哪些文件,应查看 HTML/JSON 中的逐项结果。

输出内容

每次建立独立批次,不覆盖旧结果。工程目录包含:

  • 01_连接网表:KeyinNetlist、RinfNetlist、EDIF Netlist、PXR。
  • 02_器件与引脚属性:ASCII 平铺有效值、分层值、CSV 关联表、WIR/OAT。
  • 03_位置与显示:EDIF Schematic。
  • 04_电气约束:CMS 约束记录、单位、默认值及覆盖标记。
  • 05_关联库件与封装:当前工程用到的库件/封装数据和索引。同库数据按指纹在批次内共享。
  • 90_运行日志:工具输出、参数、错误及收尾记录。

工具、模式、快照、输入/输出摘要分别保存。同名字段不互相覆盖;分层属性、平铺有效值、网表身份表和当前中央库是不同来源。先看「导出汇总.html」,再进入工程的逐项说明。

「已导出」表示文件已取得,不代表换料正确、ERC 通过或全部制造几何已核验。有检查提示时会注明具体原因;缺工具、COM 不匹配、缺库或不支持的内容均列出并跳过。

兼容与边界

面向 Windows 10/11 x64。本地原生库读取 ABI 首先支持实测 EE7.9.5 DLL 指纹;其他安装可被发现,但不盲调未验证的库 ABI。Python 运行时、依赖与完整性清单见 runtime-dependencies.json、package-manifest.json。不要只复制启动脚本,须保留整个文件夹。

多根配置暂列为需明确处理的工程,不静默选择第一个。装配变体、完整字体族、钻孔/阻焊几何、复杂多 gate/可交换脚的覆盖以报告为准,不能仅凭文件生成判断已取得全部内部信息。

开发与复现

源码为 export.py、mentorexport 和 helpers。Python 测试使用 pytest;packaging/build_portable.py 构建预置环境和 ZIP。构建过程中从 Python.org/PyPI 下载锁版本组件,使用者运行时无需网络。厂商 EXE/DLL 不随工具分发。