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 . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 10.5.3 转换器和工作表样式 (插件) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 10.5.4 中间网表文件格式 . . . . . . . . . . . . . . 125 15.3.4 Eeschema 插件界面 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 15.3.4.1 初始化对话窗口 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 15.3.4.2 插件配置参数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 15.3.4.3 使用命令行生成网络列表文件 . . . . . . . . . . . . . . . . .

工程模式运行，那么对应于所选网络的铜将 在 Pcbnew 中也会高亮。 显示符号选择器对话框以选择要放置的新符号。 显示电源符号选择器对话框以选择要放置的电源符号。 画一根电线。 画一根总线 绘制线对总入口点。这些元素仅是图形化的，不会创建 连接，因此它们不 应用于将电线连接在一起。 绘制总线到总线的入口点。 放置“无连接”标志。这些标志应放在符号引脚上 意味着没有连接。这样做 是为了通知电气规则 检查器特定引脚缺少连接是故意的，应该 分层子表。它将创建对 应于分层的分层引脚 放置在目标子表中的标签。 在子表中放置分层引脚。该命令只能在执行时执行 分层子表。它会创建任 意分层引脚，即使它们也是如此 目标子表中不存在。 划一条线。这些只是图形化的，不能连接任何东西。 放置文本注释。 放置位图图像。 删除所选元素。 2.9. 左工具栏图标 此工具栏管理显示选项： Toggle grid visibility. Switch units 昵称是用于将符号分配给元件的简短唯一标识符。符号 由'：'字符串表示。 库路 径 路径指向库位置。 插件 类型 确定库文件格式。 选项 存储库特定选项（如果插件使用）。 说明 简要描述库内容。 3.2.2. 常规选项 显示 网格尺寸 网格大小选择。 建议 使用普通网格（0.050英寸或1,27毫米）。较小 网格 用于元件构建。

由于必要的控制程度，强烈建议使用带有 pcbnew 的3键鼠标。 平移和缩放等 许多功能都需要3键鼠标。 在 KiCad 的新版本中，pcbnew 已经从 CERN 的开发人员那里看到了广泛的变 化。 这包括诸如新渲染器（OpenGL 和 Cairo 视图模式），交互式推送布线 器，差分和曲折布线和调整，重新设计的封装编辑器以及许多其他功能等功 能。 请注意，大多数这些新功能 仅 存在于新的 OpenGL 4.0 版本开始，Pcbnew 使用名为“封装库表”的文件组织封装库。 封装库表 包含一些单独的封装库的描述，以及每个库的“昵称”，用于在引用封装时引用 该库。 Pcbnew 支持几种库，每种都由“插件”支持： KiCad - 以 .pretty 格式存储在本地文件系统上的本机 KiCad 封装库（包含 .kicad_mod 文件的文件夹） Github - .pretty 格式的原生 KiCad 每个库条目必须具有有效的路径和/或文件名，具体取决于库的类型。 路径 可以定义为绝对，相对或环境变量替换（见下文） 必须选择适当的插件类型才能使库成为必需的。必须选择适当的插件类型 才能正确读取库。阅读。 还有一个描述字段用于添加库条目的描述。 选项字段包含特定于插件的特殊 选项，通常为空白。 虽然在同一个表中不能有重复的库昵称，但是在全局和项目特定的封装库表中 都可以有重复的库昵称。 当出现重复的名称时，项目特定的表条目将优先于

. . . . . . . . . . . . 10 2.3.7 使用 KiCad 插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 2.3.7.1 安装 KiCad 插件库 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 2.3.8 使用 GitHub 插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 2.3.8.1 写入时复制（Copy-On-Write） . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 13.13三维可视化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

默认网络类不能分配颜色， 因为该类中的网络将仅使用颜色主题定义的默认飞线最高颜色。 您还可以通过外观面板选择并高亮网络和网络类：右击网络或网络类以在菜单中显示这些选项。 网络类列表下面是一个包含网络显示选项的可扩展面板。第一个选项控制如何应用网络颜色。当选择了“所有”时，属 于网络或网络类别的所有铜项 (焊盘、布线、过孔和区域) 都将呈现所选的颜色。当选中“飞线”(默认值)时，只有飞线 受网络和网络类别颜色的影响。 你可以右键单击选择过滤器中的任何对象类型，快 速改变过滤器，只允许选择该类型的对象。 当一个连接的铜线项目被选中时，你可以使用右键菜单中的 "扩展选择" 命令或快捷键 将选择扩展到同一网络的其 他铜线项目。 第一次运行这个命令时，选择将被扩展到最近的焊盘。 第二次，选择将被扩展到所有层上的所有连接 项。 选择一个对象会在窗口底部的信息面板上显示该对象的信息。双击一个对象可以打开一个窗口来编辑该对象的属性。 性。 可以为对话框中显示的六种不同类别的图层配置线粗细、文字大小和文字外观。此外，可以为所有图层配置标注对象 的特性。有关标注属性的更多详细信息，请参阅下面的标注部分。 虚线的外观是在 "格式化" 部分控制的。虚线长度 控制虚线的长度，而 间隔长度 控制虚线和圆点之间的间距。虚线和 间隔的长度是相对于行宽而言的：间隔长度为 2 意味着是行宽的两倍。 文本替换变量可以在文本变量部分创建。

默认网络类不能分配颜色， 因为该类中的网络将仅使用颜色主题定义的默认飞线颜色。 您还可以通过外观面板选择并高亮网络和网络类：右击网络或网络类以在菜单中显示这些选项。 网络类列表下面是一个包含网络显示选项的可扩展面板。第一个选项控制如何应用网络颜色。当选择了 “所有” 时， 属于网络或网络类的所有铜对象 (焊盘、布线、过孔和敷铜) 都将呈现所选的颜色。当选中 “飞线” (默认值)时，只有 飞线受网络和网络类颜色的影响。 你可以右键单击选择过滤器中的任何对象类型，快 速改变过滤器，只允许选择该类型的对象。 当一个连接的铜对象被选中时，你可以使用右键菜单中的 "扩展选择" 命令或快捷键 将选择扩展到同一网络的其他 铜线对象。 第一次运行这个命令时，选择将被扩展到最近的焊盘。 第二次，选择将被扩展到所有层上的所有连接 项。 选择一个对象会在窗口底部的信息面板上显示该对象的信息。双击一个对象可以打开一个窗口来编辑该对象的属性。 性。 可以为对话框中显示的六种不同类别的图层配置线粗细、文本大小和文本外观。此外，可以为所有图层配置标注对象 的特性。有关标注属性的更多详细信息，请参阅下面的标注部分。 虚线的外观是在 "格式化" 部分控制的。虚线长度 控制虚线的长度，而 间隔长度 控制虚线和圆点之间的间距。虚线和 间隔的长度是相对于行宽而言的：间隔长度为 2 意味着是行宽的两倍。 文本替换变量可以在文本变量部分创建。

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 5.2.6 使用 GitHub 插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 5.2.7 使用模式 com/kicad/services/kicad-doc/issues • 关于 KiCad 软件: https://gitlab.com/kicad/code/kicad/issues • 关于 KiCad 软件国际化: https://gitlab.com/kicad/code/kicad-i18n/issues 发行日期及软件版本 发布于 2015-05-22。 CvPcb 2 / 24 1 CvPcb CvPcb 简介 CvPcb 能够为原理图中的元器件与进行 PCB 布局时的封装分配关联。二者的关联关系将被添加入由原理图创建程序 Eeschema 创建的网络列表文件中。 仅当在元器件的封装字段初始化后, 由 Eeschema 生成的网络列表文件才会包含元器件 PCB 封装与原理图端口的关 联关系。 这种情况下，封装和原理图之间的关联是用户在编辑原理图时，通过设置元件的封装字段创建的。此外封装也可能被

KiCad 软件国际化: https://gitlab.com/kicad/code/kicad-i18n/issues 发行日期及软件版本 发布于 2015-05-22。 1. CvPcb 简介 CvPcb 能够为原理图中的元器件与进行PCB布局时的封装分配关联。二者的关 联关系将被添加入由原理图创建程序 Eeschema 创建的网络列表文件中。 仅当在元器件的封装字段初始化后, 由 Eeschema Eeschema 访问 CvPcb 通常来说是更好的选择, 这是因为: CvPcb 需要读取项目配置文件, 以确定哪些封装库需要被加载。 当项目文件和打开的原理图文件处于同一目录时, Cvpcb 可以初始化元器件 的封装设置字段。 从通过 Kicad 项目管理器启动的 Eeschema 访问 CvPcb, 可以确保上述要求自动 得到满足。 警告 尽管用户确实 能够 从单独启动的 Eeschema 中访问 的库管 理工具，新的管理工具允许用户通过以下方式 直接使用封装库 KiCad 传统封装库文件 (.mod 文件) KiCad 新式 .pretty 封装库(在用户的本地磁盘中， 拥有 .pretty 扩展名并包含 了 .kicad_mod 文件的文件夹) KiCad 新式 .pretty 封装库 (托管在官方或第三方维护的 Github 仓库中) GEDA 封装库(包含了 .fp 文件的文件夹)