Kicad 插件 The KiCad Team KiCad 插件系统 Copyright 本文档由其贡献者授予版权 © 2016，如下所示。您可以根据 GNU 通用公共许 可证(http：/www.gnu.org/licenses/gpl.html)版本 3 或更高版本或知识共享许可协 议(http：/creativecommons.org/licenses/by/3.0/)、版本 3.0 KiCad 插件系统简介 KiCad 插件系统是一个使用共享库扩展 KiCad 功能的框架。 使用插件的一个 主要优点是在开发插件时没有必要重建 KiCad 套件; 事实上，可以借助 KiCad 源代码树中的一小组标题构建插件。 通过确保开发人员仅编译与正在开发的 插件直接相关的代码，从而减少每个构建和测试周期所需的时间，在插件开发 期间删除构建 KiCad 的要求极大地提高了工作效率。 插件最初是为 无需对支持的每种新模型类型的 KiCad 源进行重大更改。 插件框架后来被推 广，以便将来开发人员可以创建不同类型的插件。 目前，只有 3D 插件在 KiCad 中实现，但可以想象最终将开发 PCB 插件，以使用户能够实现数据导 入器和导出器。 1.1. 插件类 插件分为插件类，因为每个插件都解决了特定域中的问题，因此需要该域独有 的接口。 例如，3D 模型插件从文件加载 3D 模型数据并将该数据转换为可由

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

4.0 版本开始，Pcbnew 使用名为“封装库表”的文件组织封装库。 封装库表 包含一些单独的封装库的描述，以及每个库的“昵称”，用于在引用封装时引用 该库。 Pcbnew 支持几种库，每种都由“插件”支持： KiCad - 以 .pretty 格式存储在本地文件系统上的本机 KiCad 封装库（包含 .kicad_mod 文件的文件夹） Github - .pretty 格式的原生 KiCad 每个库条目必须具有有效的路径和/或文件名，具体取决于库的类型。 路径 可以定义为绝对，相对或环境变量替换（见下文） 必须选择适当的插件类型才能使库成为必需的。必须选择适当的插件类型 才能正确读取库。阅读。 还有一个描述字段用于添加库条目的描述。 选项字段包含特定于插件的特殊 选项，通常为空白。 虽然在同一个表中不能有重复的库昵称，但是在全局和项目特定的封装库表中 都可以有重复的库昵称。 当出现重复的名称时，项目特定的表条目将优先于 如果您 使用的是 Github 插件（没有本地副本），则在需要时会从 Github 加载封装。 2.3.7. 使用 KiCad 插件 KiCad 插件处理您计算机上存在的本机 KiCad 库（或某些可访问的文件系 统）。 它用于与 KiCad 一起安装的预安装库，以及其他 KiCad 库，可以是官方的 KiCad 库集，第三方库或您自己的策划库。 安装 KiCad 插件库 Footprint Library

. . . . . . . . . . . . 10 2.3.7 使用 KiCad 插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 2.3.7.1 安装 KiCad 插件库 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 2.3.8 使用 GitHub 插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 2.3.8.1 写入时复制（Copy-On-Write） . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 8.3 网类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

选项，并从列表中选择要删除的预设。 网络和网络类控件 外观面板的网络选项卡显示电路板中所有网络和网络类的列表。每个网都有一个可见性控件，用于控制该网在飞线中 的可见性。在飞线中隐藏网络不会改变电路板的连接性，也不会影响设计规则检查器；这只是为了使飞线更容易理 解。 每个网络和网络类还可以指定一种颜色。默认情况下，此颜色适用于网络 (或网络类中的所有网络) 的飞线。默认情 况下，网络没有 况下，网络没有颜色；这由色样中的棋盘格图案指示。双击或右键单击网络或网络类颜色样本以设置颜色。 NOTE 默认网络类不能分配颜色， 因为该类中的网络将仅使用颜色主题定义的默认飞线最高颜色。 您还可以通过外观面板选择并高亮网络和网络类：右击网络或网络类以在菜单中显示这些选项。 网络类列表下面是一个包含网络显示选项的可扩展面板。第一个选项控制如何应用网络颜色。当选择了“所有”时，属 于网络或网络类别的所有铜项 于网络或网络类别的所有铜项 (焊盘、布线、过孔和区域) 都将呈现所选的颜色。当选中“飞线”(默认值)时，只有飞线 受网络和网络类别颜色的影响。 当选择“没有”时，网络和网络类颜色被忽略。 第二个选项控制如何绘制飞线。“所有图层”表示将在所有未连接的项目之间绘制飞线。“可见层”意味着不会向隐藏层 上的项目绘制任何最新的飞线，即使这些项目是未连接的。 选择和选择筛选器 Selecting items in the editing

选项，并从列表中选择要删除的预设。 网络和网络类控件 外观面板的网络选项卡显示电路板中所有网络和网络类的列表。每个网都有一个可见性控件，用于控制该网在飞线中 的可见性。在飞线中隐藏网络不会改变电路板的连接性，也不会影响设计规则检查器；这只是为了使飞线更容易理 解。 每个网络和网络类还可以指定一种颜色。默认情况下，此颜色适用于网络 (或网络类中的所有网络) 的飞线。默认情 况下，网络没有 况下，网络没有颜色；这由色样中的棋盘格图案指示。双击或右键单击网络或网络类颜色样本以设置颜色。 NOTE 默认网络类不能分配颜色， 因为该类中的网络将仅使用颜色主题定义的默认飞线最高颜色。 您还可以通过外观面板选择并高亮网络和网络类：右击网络或网络类以在菜单中显示这些选项。 网络类列表下面是一个包含网络显示选项的可扩展面板。第一个选项控制如何应用网络颜色。当选择了“所有”时，属 于网络或网络类别的所有铜项 于网络或网络类别的所有铜项 (焊盘、布线、过孔和区域) 都将呈现所选的颜色。当选中“飞线”(默认值)时，只有飞线 受网络和网络类别颜色的影响。 当选择“没有”时，网络和网络类颜色被忽略。 第二个选项控制如何绘制飞线。“所有图层”表示将在所有未连接的项目之间绘制飞线。“可见层”意味着不会向隐藏层 上的项目绘制任何最新的飞线，即使这些项目是未连接的。 选择和选择筛选器 选择编辑画布中的项目是用鼠标左键完成的。 单独

deleted from the list. 网络和网络类控件 外观面板的网络选项卡显示电路板中所有网络和网络类的列表。每个网络都有一个可见性控件，用于控制该网络在飞 线中的可见性。在飞线中隐藏网络不会改变电路板的连接性，也不会影响设计规则检查器；这只是为了使飞线更容易 理解。 每个网络和网络类还可以指定一种颜色。默认情况下，此颜色适用于网络 (或网络类中的所有网络) 的飞线。默认情 况下，网络没 况下，网络没有颜色；这由色样中的棋盘格图案指示。双击或右键单击网络或网络类颜色样本以设置颜色。 NOTE 默认网络类不能分配颜色， 因为该类中的网络将仅使用颜色主题定义的默认飞线颜色。 您还可以通过外观面板选择并高亮网络和网络类：右击网络或网络类以在菜单中显示这些选项。 网络类列表下面是一个包含网络显示选项的可扩展面板。第一个选项控制如何应用网络颜色。当选择了 “所有” 时， 属于网络或网络类的所有铜对象 (焊盘、布线、过孔和敷铜) (焊盘、布线、过孔和敷铜) 都将呈现所选的颜色。当选中 “飞线” (默认值)时，只有 飞线受网络和网络类颜色的影响。 当选择 “无” 时，网络和网络类颜色被忽略。 第二个选项控制如何绘制飞线。“所有图层” 表示将在所有未连接的项目之间绘制飞线。“可见层” 意味着不会向隐藏 层上的项目绘制任何最新的飞线，即使这些项目是未连接的。 Ctrl Tab Tab Shift Tab Ctrl Shift Tab Tab

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 5.2.6 使用 GitHub 插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 5.2.7 使用模式 每一项需要有一个可用的路径。根据封装库类型的不同，路径的具体表现形式可能不同。“路径”字段中的内容可以是 绝对路径，相对路径，或者是环境变量 (下文中会进一步讨论) 为了正确读取封装库，列表中每一项的“插件类型”字段必须被正确选择。目前 KiCad 支持的类型包括 KiCad legacy, KiCad Pretty, Eagle, 和 GEDA 封装库。 列表中的“描述”字段，用于为项添加额外的 库存储于项目目录下。 5.2.6 使用 GitHub 插件 GitHub 插件提供了只读访问那些包含 Kicad pretty 封装库文件的 GitHub 仓库的接口。该插件也提供了 COW(“复 制时写入”) 功能。该功能是可选项，它将允许用户编辑从 GitHub 仓库读取的封装库，并且将它们保存在本地。因 而，“GitHub”插件用于 只读访问托管于 https://github.com/

lib）也是文本文件，它们也很容易编辑或编写脚本。 58. 要创建物料清单（BOM），请转到 Eeschema 原理图编辑器，然后单击顶部工 具栏上的 生成物料清单 图标 。 默认情况下，没有处于活动的插件。 您可 以通过单击 添加插件 按钮添加一个。 选择要使用的 *.xsl 文件，在这种情况 下，我们选择 bom2csv.xsl。 注意 Linux: 如果缺少 xsltproc，您可以下载并安装它： sudo 间距 和 最小布线宽度 设置为PCB制造商要求的宽度。 通常，您可以将 间隙设置为 0.25mm，将最小轨道宽度设置为 0.25mm 。 单击 设置 → 设计规则 菜单。 如果它尚未显示，请单击 网络类编辑器 选项卡。 将窗口顶部的 间距 字 段更改为 0.25mm，将 布线宽度 字段更改为 0.25mm，如下所示。 这里的测量 单位是 mm。 4. 单击 全局设计规则 选项卡，将 最小布线宽度 设置为 置电路板时从下拉菜单中选择布线的宽度。 请参阅下面的示例（英寸）。 17. 或者，您可以添加一个 网络类 ，在其中指定一组选项。 转到 设置 → 设计规则 → 网络类编辑器 并添加一个名为 电源 的新类。 将布线宽度从 8mil（表示为 0.0080）更改为 24mil（表示为0.0240）。 接下来，将除地面之外的所有内容添 加到 电源 类（左侧选择 默认 ，右侧选择 电源 并使用箭头）。 18. 如果要更改网格大小，右键单击

lib）也是文本文件，它们也很容易编辑或编写脚本。 58. 要创建物料清单（BOM），请转到 Eeschema 原理图编辑器，然后单击顶部工具栏上的 生成物料清单图标 。 默认情况下，没有处于活动的插件。您可以通过单击 添加插件按钮添加一个。选择要使用的 *.xsl 文件，在这种 情况下，我们选择 bom2csv.xsl。 KiCad 入门 20 / 41 Note Linux: 如果缺少 xsltproc，您可以下载并安装它： 最好将 间距和 最小布线宽度设置为 PCB 制造商要求的宽度。通常，您可以将间隙设置为 0.25mm，将最小轨 道宽度设置为 0.25mm 。单击 设置 → 设计规则菜单。如果它尚未显示，请单击 网络类编辑器选项卡。将窗口 顶部的 间距字段更改为 0.25mm，将 布线宽度字段更改为 0.25mm，如下所示。这里的测量单位是 mm。 KiCad 入门 23 / 41 4. 单击 全局设计规则选项卡，将 寸）。 KiCad 入门 25 / 41 17. 或者，您可以添加一个 网络类，在其中指定一组选项。转到 设置 → 设计规则 → 网络类编辑器并添加一个名为 电源的新类。将布线宽度从 8mil（表示为 0.0080）更改为 24mil（表示为 0.0240）。接下来，将除地面之外的所 有内容添加到 电源类（左侧选择 默认，右侧选择 电源并使用箭头）。 18. 如果要更改网格大小，右键单击