KiCad 7.0 Command-Line Interface

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

摘要

文档详细介绍了KiCad 7.0的命令行界面功能，包括通过kicad-cli工具执行的各种操作，如符号库升级、版图导出、电子 schematic 导出及版本信息查询。文档还提供了各命令的使用方法、可选参数及功能说明，涵盖了从设计文件导出到格式转换的多种应用场景。同时，文档指出了命令行工具在不同操作系统中的路径，并说明了如何提交反馈和报告问题。

AI总结

《KiCad 7.0 Command-Line Interface》文档总结如下：

### 1. 简介
KiCad 7.0 提供了命令行界面（CLI）工具 `kicad-cli`，可通过命令行执行自动化操作，如导出 Gerber 文件、升级符号库等。文档正在修订，部分内容未完成，欢迎贡献。

### 2. 常用命令
#### a. 基本 команд
- **`kicad-cli`**：主命令，可执行多个子命令。
- **`kicad-cli version`**：显示 KiCad 版本信息。
- 选项：
- `--format`：指定输出格式（plain、commit、about）。

#### b. 符号升级
- **`kicad-cli sym upgrade`**：将遗留格式的符号库升级为当前版本格式。
- 选项：
- `--output`：指定输出文件名，未指定则覆盖原文件。
- `--force`：强制重新保存，即使已为当前格式。

#### c. 导出功能
- **SVG 导出**
- **`kicad-cli pcb export svg`**：导出 PCB 为 SVG 文件。
- 选项：
- `--layers`：指定要导出的层。
- `--mirror`：镜像翻转显示底层。
- `--theme`：指定主题。

- **DXF 导出**
- **`kicad-cli sch export dxf`** 和 **`kicad-cli pcb export dxf`**：分别导出原理图和 PCB 为 DXF 文件。
- 选项：
- `--layers`：指定层。
- `--exclude-refdes` 和 `--exclude-value`：排除参考设计ator 和值。

- **HPGL 导出**
- **`kicad-cli sch export hpgl`**：导出原理图为 HPGL 文件，适用于笔绘图仪。
- 选项：
- `--pen-size`：指定笔尖大小。

- **PDF 导出**
- **`kicad-cli sch export pdf`** 和 **`kicad-cli pcb export pdf`**：分别导出原理图和 PCB 为 PDF 文件。
- 选项：
- `--page-size-mode`：设置页面尺寸模式。
- `--exclude-drawing-sheet`：排除绘图表单。

- **Gerber 导出**
- **`kicad-cli pcb export gerbers`**：将 PCB 设计导出为每层一个 Gerber 文件。
- 选项：
- `--layers`：指定导出层数。
- `--exclude-refdes` 和 `--exclude-value`：排除参考设计ator 和值。

- **位置文件导出**
- **`kicad-cli pcb export pos`**：导出位置文件。
- 选项：
- `--side`：指定 PCB 侧。
- `--format`：指定输出格式（如 IPC-7351）。
- `--units`：指定单位（mm 或 in）。

### 3. 其他信息
- **版权与许可证**：文档采用 GNU GPL 或 Creative Commons Attribution License。
- **反馈机制**：用户可通过 [KiCad 网站](https://www.kicad.org/help/report-an-issue/) 提交反馈或报告问题。
- **macOS 注意事项**：`kicad-cli` 可执行文件位于 `/Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli`。

### 4. 总结
KiCad 7.0 的命令行界面通过 `kicad-cli` 提供了丰富的功能，支持自动化操作，适合批量处理。在升级符号库、导出各类文件时，用户可通过命令行灵活配置参数以满足不同需求。