iii Contents 1 KiCad 插件系统简介 2 1.1 插件类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 1.1.1 插件类：PLUGIN_3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2 教程：3D 插件类 4 2.1 基本的 3D 插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.2 高级 3D 插件 . 12 3 应用程序编程接口（API） 21 3.1 插件类 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 3.1.1 API：Base Kicad 插件类 . . . . . . . . . . . . . . . .

入器和导出器。 1.1. 插件类 插件分为插件类，因为每个插件都解决了特定域中的问题，因此需要该域独有 的接口。 例如，3D 模型插件从文件加载 3D 模型数据并将该数据转换为可由 3D 查看器显示的格式。 PCB 导入/导出插件将获取 PCB 数据并导出为其他电 气或机械数据格式，或将外部格式转换为 KiCad PCB。 目前只开发了 3D 插件 类，它将成为本文档的重点。 实现插件类需要在 KiCad 源代码树中，文件 ‘plugins/ldr/pluginldr.h’ 声明了所有插件加载器的基 类。这个类声明了我们期望在任何 KiCad 插件（样板代码）中找到的最基本的 函数，它的实现提供了对插件加载器和可用插件之间的版本兼容性的基本检 查。标题 ‘plugins/ldr/3d/pluginldr3D.h’ 声明了 3D 插件类的加载器。加载器负 责加载给定的插件并使其功能可用于 KiCad。插件加载器的每个实例代表一个 S3D_CACHE 类中。 除非正在开发新的插件类，否则插件开发人员不需要关心 KiCad 管理插件的内 部代码的细节; 插件只需要定义其特定插件类声明的函数。 标题 ‘include/plugins/kicad_plugin.h’ 声明了所有 KiCad 插件所需的泛型函数; 这 些函数标识插件类，提供特定插件的名称，提供插件类 API 的版本信息，提供 特定插件的版本信息，并提供插件类 API 的基本版本兼容性检查。

计算器具有以下工具： 稳压器 布线宽度 电气间距 2 传输线 射频衰减器 色环电阻 电路板类型 计算器 稳压器 该计算器有助于找到线性和低压差稳压器所需的电阻值。 对于 标准型，输出电压 Vout 作为参考电压 Vref 和电阻 R1 和 R2 的函数，由以下公式给出： 对于_3 端子类型_，由于从调整引脚流过的静态电流 Iadj，有一个校正系数： 3 该电流通常低于 Iadj，选择你要计算的字段（其中一个电 阻或输出电压），并输入其他两个值。 RF 衰减器 利用射频 (RF) 衰减器工具，你可以计算出不同类型衰减器所需的电阻值： PI（π）型 T 型 桥式三通 电阻分压型 要使用这个工具，首先选择你需要的衰减器类型，然后输入所需的衰减（单位：dB）和输入/输出阻抗（单位：欧 姆）。 E 系列 这个计算器可以帮助确定满足所需电阻的标准 E 系列 IPC-6011 中，已经建立了三个性能等级 8 第 1 类普通电子产品: 包括消费产品，一些计算机和计算机外围设备，适用于外观缺陷不重要，主要要求是完成 PCB 的功能的应用。 第 2 类专门服务的电子产品: 包括通信设备、复杂的商业机器、需要高性能和延长寿命的仪器，以及需要不间断服 务但不是关键的仪器。允许有某些外观上的瑕疵。 第 3 类高可靠性电子产品: 包括持续性能或按需性能至关重要的设

• 带状线。 • 双绞线。 PCB 计算器 5 / 8 2.5 RF 衰减器 使用 RF（射频）衰减器实用程序，您可以计算不同类型衰减器所需的电阻值： • PI（￿）型 • T 型 • 桥 T 型 • 电阻分压型 要使用此工具，首先选择所需的衰减器类型，然后输入所需的衰减 (以 dB 为单位) 和输入/输出阻抗 (以欧姆为单位)。 PCB 计算器 6 / 8 2.6 色标 此 在 IPC-6011 中建立了三个性能等级 • 第 1 类通用电子产品包括消费类产品、一些计算机和计算机外围设备，适用于外观缺陷并不重要，主要要求是完整 印制板的功能。 • 第 2 类专用服务电子产品包括通信设备、精密的商用机器、需要高性能和延长使用寿命的仪器，需要不间断的服 务，但并不重要。允许存在某些外观缺陷。 • 第 3 类高可靠性电子产品包括持续性能或按需性能至关重要的设备和产品。不能容忍设备停机，必须在生命保障

83.94 页,1981 年 12 月。 带状线。 双绞线。 2.5. RF 衰减器 使用 RF（射频） 衰减器实用程序，您可以计算不同类型衰减器所需的电阻 值： PI（π）型 T 型 桥 T 型 电阻分压型 要使用此工具，首先选择所需的衰减器类型，然后输入所需的衰减(以 dB 为单 位)和输入/输出阻抗(以欧姆为单位)。 2.6. 色标 此计算器有助于将电阻器的颜色条转换为其值。 性能等级 在 IPC-6011 中建立了三个性能等级 第 1 类通用电子产品包括消费类产品、一些计算机和计算机外围设备，适 用于外观缺陷并不重要，主要要求是完整印制板的功能。 第 2 类专用服务电子产品包括通信设备、精密的商用机器、需要高性能和 延长使用寿命的仪器，需要不间断的服务，但并不重要。允许存在某些外 观缺陷。 第 3 类高可靠性电子产品包括持续性能或按需性能至关重要的设备和产 品。不

计算器具有以下工具： 稳压器 布线宽度 电气间距 2 传输线 射频衰减器 色环电阻 电路板类型 计算器 稳压器 该计算器有助于找到线性和低压差稳压器所需的电阻值。 对于 标准型，输出电压 Vout 作为参考电压 Vref 和电阻 R1 和 R2 的函数，由以下公式给出： 对于_3 端子类型_，由于从调整引脚流过的静态电流 Iadj，有一个校正系数： 3 该电流通常低于 Iadj，选择你要计算的字段（其中一个电 阻或输出电压），并输入其他两个值。 RF 衰减器 利用射频 (RF) 衰减器工具，你可以计算出不同类型衰减器所需的电阻值： PI（π）型 T 型 桥式三通 电阻分压型 要使用这个工具，首先选择你需要的衰减器类型，然后输入所需的衰减（单位：dB）和输入/输出阻抗（单位：欧 姆）。 E 系列 这个计算器可以帮助确定满足所需电阻的标准 E 系列 IPC-6011 中，已经建立了三个性能等级 8 第 1 类普通电子产品: 包括消费产品，一些计算机和计算机外围设备，适用于外观缺陷不重要，主要要求是完成 PCB 的功能的应用。 第 2 类专门服务的电子产品: 包括通信设备、复杂的商业机器、需要高性能和延长寿命的仪器，以及需要不间断服 务但不是关键的仪器。允许有某些外观上的瑕疵。 第 3 类高可靠性电子产品: 包括持续性能或按需性能至关重要的设

“插件类型”必须设置为“Github”。 下表显示了具有默认选项（无 COW 支持）的封装库表条目： 昵称 库路径 插件类 型 选 项 描述 GitHub 上 https://github.com/liftoff- sr/pretty_footprints GitHub 上 Liftoff 的 GH 封装 昵称 库路径 插件类 型 选 项 描述 写入时复制（Copy-On-Write） 要启用“写入时复制”功能 常驻部分始终是只读的，这意味着您无法删除任 何内容或直接修改指定 GitHub 存储库中的任何封装。 在所有进一步的讨论 中，聚合库类型仍然是“Github”，但它包括本地读/写部分和远程只读部分。 昵称 库路径 插件类 型 选 项 描述 GitHub 上 https://github.com/liftoff- sr/pretty_footprints GitHub 上 Liftoff 的 GH 封装 封装 磁布线 ：图形光标成为布线轴。 8.3. 网类 Pcbnew 允许您为每个网络定义不同的布线参数。 参数由一组网络定义。 一组网称为网类。 总有一个名为“默认”的网类。 用户可以添加其他网类。 网类指定： 布线宽度，直径和钻孔。 焊盘和布线（或通孔）之间的间隙。 布线时，Pcbnew 会自动选择与要创建或编辑的布线网络对应的网络类，从 而选择布线参数。 8.3.1. 设置布线参数

KiCad 有一个基于工程的工作流程。 KiCad 工程是一个包含工程文件、原理图、电路板布局 的文件夹，也可以选择其他相关文件，如符号和封装库、仿真数据、采购信息等。许多与项目相关的设置，包括网络 类和设计规则，都存储在工程层面。在其相关工程之外打开一个电路板可能会导致设计信息的丢失，所以要确保将所 有与工程相关的文件放在一起。 PCB 设计工作流程 通常情况下，首先绘制原理图。这意味着在原 Cmd Shift Ctrl Cmd M R G G M G M Del W 13 接下来，在原理图上添加电源和接地符号。虽然在这样一个简单的原理图中没有严格意义上的必要，但这些符号使大 型原理图更容易理解。 在 Power 符号库中，有许多电源和地线符号。 然而，有一个添加这些符号的快捷方式：点击 添加电源符号* 按钮 或使用 快捷键。这将弹出 选择符号* 对话框，但只显示包含电源符号的符号库。 最后，打开 设计规则 → 网络类 页面。网络类是一组与特定网络组相关的设计规则。这个页面列出了设计中每个网络 类的设计规则，并允许将网络类分配给每个网络类。 22 布线的宽度和间距可以由设计者在布局过程中手动管理，但推荐使用网络类，因为它们提供了一种自动管理和检查设 计规则的方法。 在这个设计中，没有指定网络类，所以所有的网络都属于 默认 网络类。这个网络类的默认设计规则对这个工程来说

KiCad 有一个基于工程的工作流程。 KiCad 工程是一个包含工程文件、原理图、电路板布局 的文件夹，也可以选择其他相关文件，如符号和封装库、仿真数据、采购信息等。许多与项目相关的设置，包括网络 类和设计规则，都存储在工程层面。在其相关工程之外打开一个电路板可能会导致设计信息的丢失，所以要确保将所 有与工程相关的文件放在一起。 PCB 设计工作流程 通常情况下，首先绘制原理图。这意味着在原 Cmd Shift Ctrl Cmd M R G G M G M Del W 13 接下来，在原理图上添加电源和接地符号。虽然在这样一个简单的原理图中没有严格意义上的必要，但这些符号使大 型原理图更容易理解。 在 Power 符号库中，有许多电源和地线符号。 然而，有一个添加这些符号的快捷方式：点击 添加电源符号* 按钮 或使用 快捷键。这将弹出 选择符号* 对话框，但只显示包含电源符号的符号库。 最后，打开 设计规则 → 网络类 页面。网络类是一组与特定网络组相关的设计规则。这个页面列出了设计中每个网络 类的设计规则，并允许将网络类分配给每个网络类。 布线的宽度和间距可以由设计者在布局过程中手动管理，但推荐使用网络类，因为它们提供了一种自动管理和检查设 计规则的方法。 23 在这个设计中，没有指定网络类，所以所有的网络都属于 默认 网络类。这个网络类的默认设计规则对这个工程来说

在编辑画布上导航 快捷键 鼠标操作和选择 左侧工具条显示控制 原理图创建和编辑 简介 原理图编辑操作 网格 捕捉 编辑对象属性 使用符号工作 位号和符号注释 电气连接 网络类 图形项目 原理图设置 Opening legacy schematics 层次原理图 简介 在设计中添加图框 原理图之间导航器 原理图之间的电气连接 层次设计实例 检查原理图 筛选工具 效果 禁用网格捕捉。 禁用将导线捕捉在引脚上。 编辑对象属性 所有对象都有可在对话框中编辑的属性。使用快捷键 或从右键菜单中选择属性来编辑所选项目的属性。只有当你 选择的所有项目都是同一类型时，你才能打开属性对话框。要想一次编辑不同类型的项目的属性，请参阅下面关于批 量编辑工具的章节。 在属性对话框中，任何包含数字值的字段也可以接受一个基本的数学表达式，从而得到一个数字值。例如，一个尺寸 将其与相邻的线段分开。 通常情况下，线的线型是按照网的《原理图设置网络类，网络类设置》（如果没有指定其他网络类，网就处于 默认 网络类）。然而，所选线段的线型可以在线段的属性对话框中被覆盖（当线段被选中时 ）。可以设置线的宽度、 颜色和线的样式（实线、虚线、点线等）。将宽度设置为 0 ，清除颜色，并使用 默认 线条样式，分别使用网络类设 置中的默认宽度、颜色和样式。如果在选择中包含了一个导线结点，结点的大小也可以在这里进行编辑。