KiCad Command-Line Interface - KiCad 9.0 Reference Manual

• 语言: 英语
• 格式: .pdf
• 来源: docs.kicad.org

摘要

本文档是KiCad 9.0参考手册中关于命令⾏界面的部分。KiCad通过kicad-cli二进制文件提供命令⾏界面，可对原理图、PCB、符号和封装执行自动化操作，如从PCB设计生成Gerber文件或升级符号库。kicad-cli包含6个子命令：fp、jobset、pcb、sch、sym和version。文档详细说明了PCB子命令下的多种导出功能，包括Gerber导出（gerber和gerbers命令）、GenCAD导出、SVG导出、VRML导出和PLY导出，并提供了各命令的用法、位置参数和可选参数。其中pcb export gerber命令在KiCad 9.0中已弃用，将在KiCad 10.0中移除，建议使用pcb export gerbers命令。文档还强调了在macOS上kicad-cli可执行文件的位置。

AI总结

KiCad 9.0 提供命令行界面 `kicad-cli`，用于自动化处理原理图、PCB、符号和封装。该命令包含 `fp`、`jobset`、`pcb`、`sch`、`sym` 和 `version` 六个子命令，每个子命令都有各自的参数和帮助信息（通过 `-h` 查看）。

**核心功能与关键参数：**

1. **PCB 导出 (pcb export)**：
* **Gerber 文件**：`gerbers` 命令（推荐用于制造）可将每个 PCB 层导出为独立的 Gerber 文件。`gerber` 命令（已弃用，将在 KiCad 10 中移除）则将多个层合并到一个文件中。关键参数包括：指定层列表 (`--layers`)、排除参考编号 (`--exclude-refdes`)、排除数值 (`--exclude-value`)、设置精度 (`--precision`，可选 5 或 6 位)、使用钻孔文件原点 (`--use-drill-file-origin`) 以及控制 DNP 元件的显示（隐藏、草图或打叉）。
* **DXF 文件**：`dxf` 命令支持单文件或多文件输出模式 (`--mode-single` 或 `--mode-multi`)，并可指定公共层 (`--common-layers`) 和钻孔标记形状 (`--drill-shape-opt`)。
* **SVG 文件**：`svg` 命令支持单文件、多文件或多页 PDF 模式，可设置页面大小 (`--page-size-mode`)、排除绘图图纸 (`--exclude-drawing-sheet`) 以及指定主题 (`--theme`)。
* **GenCAD 文件**：`gencad` 命令可导出 GenCAD 文件，支持翻转底部焊盘 (`--flip-bottom-pads`)、生成唯一引脚/封装名称 (`--unique-pins`, `--unique-footprints`) 以及使用钻孔原点 (`--use-drill-origin`)。
* **3D 模型**：`vrml` 和 `ply` 命令分别导出 VRML 和 PLY 格式的 3D 模型。PLY 导出功能更丰富，可控制是否包含板体、元件、走线、焊盘、阻焊层等，并支持通过 `--component-filter` 和 `--net-filter` 进行过滤。

2. **原理图导出 (sch export)**：包含用于导出原理图的相关命令。

3. **符号操作 (sym)**：包含符号导出 (`sym export`) 和符号库升级 (`sym upgrade`) 命令。

4. **版本信息 (version)**：`version` 命令用于显示版本信息。

**重要提示**：
* macOS 用户需在 `/Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli` 路径下运行该程序。
* `--plot-invisible-text` 参数自 KiCad 9.0.1 起已弃用且无效，未来版本将移除。