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

昵称是用于将符号分配给元件的简短唯一标识符。符号 由'：'字符串表示。 库路 径 路径指向库位置。 插件 类型 确定库文件格式。 选项 存储库特定选项（如果插件使用）。 说明 简要描述库内容。 3.2.2. 常规选项 显示 网格尺寸 网格大小选择。 建议 使用普通网格（0.050英寸或1,27毫米）。较小 网格 用于元件构建。 默认格式 选中以选择 Pcbnew 作为默认格式。 还可以生成其他格式: Orcad PCB2 CadStar Spice (simulators) 可以添加外部插件来扩展网表格式列表（上图中添加了 PadsPcb 插件）。 有关在《create-a-netlist, Create a Netlist》一章中创建网表的更多信息。 4.4. 注释工具 图标 启动注释工具。 此工具分配对元件的引用。 初始化为默认值 恢复原始设置。 4.6. 物料清单工具 图标 启动物料清单（BOM）生成器。 此工具生成一个列出元件和/或分层 连接（全局标签）的文件。 Eeschema 的 BOM 生成器使用外部插件，可以是 XSLT 或 Python 脚本。 KiCad 程序文件目录中安装了一些示例。 用于 BOM 的一组有用的元件属性包括： 值 - 使用的每个部件的唯一名称。 封装 - 手动输入或反标注（见下文）。

图形对象 标注 布线 向前和向后批注 锁定 批量编辑工具 清理工具 正在导入图形 检查电路板 测量工具 设计规则检查 查找工具 搜索面板 3D 查看器 网络检查 生成输出 2 2 3 3 4 5 5 5 6 7 7 8 9 9 9 9 10 10 18 18 19 19 20 23 26 28 32 35 42 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 制造输出和绘制 钻孔文件 元件放置文件 额外的制造产出 打印 正在导出文件 封装和封装库 管理封装库 创建和编辑封装 高级主题 配置和自定义 Text variables 自定义设计规则 在电路板编辑器对话框的电路板完成和阻焊/锡膏部分可以找到一些其他的电路板压层设置。电路板完成部分包含用 于定义铜电镀和特殊功能 (如镶边或边缘电镀) 的设置。请注意，这些设置目前只影响作为 Gerber 作业文件一部分的 电路板属性输出。 12 阻焊/锡膏部分允许全局调整电路板上焊盘的铜形和阻焊/锡膏形之间的间隙（正或负）。 这些值将被添加到在个别封 装或焊盘上设置的任何间隙覆盖。 正的间隙值将导致阻焊层或锡膏开口的形状比铜的形状

使用区域 图形对象 标注 布线 向前和向后批注 锁定 批量编辑工具 清理工具 正在导入图形 检查电路板 测量工具 设计规则检查 Find tool 3D 查看器 网络检查 生成输出 2 2 3 3 4 5 5 5 6 7 7 7 9 9 9 9 11 11 18 18 19 19 19 20 23 26 27 30 36 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 制造输出和绘制 钻孔文件 元件放置文件 额外的制造产出 打印 正在导出文件 封装和封装库 管理封装库 创建和编辑封装 高级主题 配置和自定义 自定义设计规则 脚本 Working With 在电路板编辑器对话框的电路板完成和阻焊/锡膏部分可以找到一些其他的电路板压层设置。电路板完成部分包含用 于定义铜电镀和特殊功能 (如镶边或边缘电镀) 的设置。请注意，这些设置目前只影响作为 Gerber 作业文件一部分的 电路板属性输出。 13 阻焊/锡膏部分允许全局调整电路板上焊盘的铜形和阻焊/锡膏形之间的间隙（正或负）。 这些值将被添加到在个别封 装或焊盘上设置的任何间隙覆盖。 正的间隙值将导致阻焊层或锡膏开口的形状比铜的形状

可以在封装内放置任何独特焊盘的组合。 Pcbnew 可轻松生成生产所需的所有文件： 制造输出： 用于 GERBER RS274X 格式的 Photoplotters 的文件。 用于以 EXCELLON 格式钻孔的文件。 以 HPGL，SVG 和 DXF 格式绘制文件。 以 POSTSCRIPT 格式绘制和钻取地图。 本地打印输出。 1.3. 一般建议 由于必要的控制程度，强烈建议使用带有 pcbnew 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） . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 15.8 动作插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . 测量工具 设计规则检查 Board Statistics 查找工具 搜索面板 3D 查看器 网络检查 生成输出 制造输出和绘图 钻孔文件 IPC-2581 files 元件拾放文件 其它制造输出 打印 导出文件 封装和封装库 管理封装库 创建和编辑封装 Browsing footprint libraries 高级主题 配置和自定义 Finish)和阻焊/锡膏部分可以找到一些其他的电路板层叠设置。电路 板表面处理部分包含用于定义铜的表面处理和特殊功能 (如刻痕或边缘电镀) 的设置。请注意，这些设置目前只影响 作为 Gerber 文件一部分的电路板属性输出。 阻焊/锡膏部分允许全局调整电路板上焊盘的铜形和阻焊/锡膏形之间的间隙（正或负）。 这些值将被添加到在个别封 装或焊盘上设置的任何间隙覆盖。 正的间隙值将导致阻焊层或锡膏开口的形状比铜的形状 更大。 。 一旦该工具被激活，点击一次以设置测量起点，然后再点击一次以完成测量。 NOTE 测量工具用于不需要永久显示的快速测量。 您所做的任何测量都将仅在该工具处于活动状态时显 示。 要创建将显示在打印输出和打印中的永久性尺寸标注，请使用尺寸标注工具。 设计规则检查 设计规则检查器用于验证 PCB 是否符合 “电路板设置” 对话框中建立的所有要求，以及所有焊盘是否按照网表或原理 图连接。 KiCad

电气规则检查 分配封装 在符号属性中分配封装 放置符号时分配封装 用封装分配工具分配封装 正向和反向批注 从原理图更新 PCB（正向批注） 从 PCB 上更新原理图（反向批注） 生成输出 2 2 2 4 4 5 5 6 7 7 7 8 9 9 9 19 21 32 36 42 48 53 53 53 54 55 57 60 60 any single character. 你可以使用 导出为 CSV… 按钮，将符号字段保存到外部文件。这可以作为一个简单的 BOM 生成工具，尽管 《BOM 导出，BOM 工具》提供了对生成的输出的更好控制。 简化填写字段的技巧 电子表格中有几种特殊的复制/粘贴方法，用于将数值粘贴到较大的区域，包括自动增加粘贴的单元格。这些功能在 粘贴几个符号中共享的数值时可能很有用。 这些方法如下所示。 本节还将讨论两种特殊类型的符号，可以用右侧工具栏上的 "电源符号" 按钮添加： 电源符号：用于将电线连接到电源或地网络的符号。 PWR_FLAG：一个特定的符号，用于表示一个网络在没有连接到电源输出引脚时是有电源的（例如，一个由板 外连接器提供的电源网络）。 导线 导线用于在两点之间直接建立电气连接。 要建立连接，必须将一段导线的末端与另一段导线或一个引脚相连。只有 导线的末端才能建立