KiCad 8.0 Command-Line Interface

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

摘要

文档介绍了KiCad 8.0的命令行接口（kicad-cli）的功能和使用方法。kicad-cli支持多种操作，包括_footprint、PCB、符号和原理图的导出与升级。文档详细说明了每个子命令的用法，例如fp upgrade用于升级_footprint库，pcb drc用于运行PCB设计规则检查，sym upgrade用于升级符号库，以及version用于获取KiCad版本信息。每个命令都提供了详细的参数说明和使用示例。

AI总结

# KiCad 8.0 命令行界面总结

KiCad 提供了一个强大的命令行界面（CLI），通过运行 `kicad-cli` 二进制文件即可访问。该界面支持自动化操作，适用于对原理图、PCB、符号和贴片进行批量处理，如生成 Gerber 文件、升级文件格式等。

## 核心功能

### 1. 足迹升级 (`fp upgrade`)
- **用途**：将 legacy 格式的 footprint 库升级为当前版本的原生格式。
- **用法**：

  kicad-cli fp upgrade [-h] [--output OUTPUT_DIR] [--force] INPUT_DIR

- `INPUT_DIR`：待升级的 footprint 库目录。
- `--output`：指定输出目录，未指定则覆盖原文件。
- `--force`：强制保存，即使文件已为当前格式。

### 2. PCB 设计规则检查 (`pcb drc`)
- **用途**：对 PCB 进行设计规则检查并生成报告。
- **用法**：

  kicad-cli pcb drc [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--format FORMAT] INPUT_FILE

- `INPUT_FILE`：待检查的 PCB 文件。
- `--output`：指定输出报告文件。
- `--define-var`：定义或覆盖项目变量。
- `--format`：指定输出格式（如 plain、commit、about）。

### 3. PCB 导出
- **Gerber 文件导出**：将 PCB 导出为 Gerber 文件。
- **GLB 文件导出**：将 PCB 导出为 3D 的 GLB 文件。
- **IPC-2581 导出**：将 PCB 导出为 IPC-2581 格式。

### 4. 符号升级 (`sym upgrade`)
- **用途**：将 legacy 格式的 symbol 库升级为当前版本的原生格式。
- **用法**：

  kicad-cli sym upgrade [--help] [--output OUTPUT_FILE] [--force] INPUT_FILE

- `INPUT_FILE`：待升级的 symbol 库文件。
- `--output`：指定输出文件。
- `--force`：强制保存，即使文件已为当前格式。

### 5. 版本信息 (`version`)
- **用途**：显示 KiCad 的版本信息。
- **用法**：

  kicad-cli version [--help] [--format VAR]

- `--format`：指定输出格式（如 plain、commit、about）。
- `about` 格式可用于提交 bug 报告。

## 其他注意事项
- **macOS**：`kicad-cli` 位于 `/Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli`。
- **帮助**：每个子命令均支持 `--help` 以查看更多详细信息。

KiCad 的命令行工具功能强大，适用于自动化工作流和批量处理，建议结合具体项目需求灵活使用。