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 的要求极大地提高了工作效率。 插件最初是为 插件最初是为 3D 模型查看器开发的，因此可以支持更多类型的 3D 模型，而 无需对支持的每种新模型类型的 KiCad 源进行重大更改。 插件框架后来被推 广，以便将来开发人员可以创建不同类型的插件。 目前，只有 3D 插件在 KiCad 中实现，但可以想象最终将开发 PCB 插件，以使用户能够实现数据导 入器和导出器。 1.1. 插件类 插件分为插件类，因为每个插件都解决了特定域中的问题，因此需要该域独有

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

. . . . . . . . . . . . 10 2.3.7 使用 KiCad 插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 2.3.7.1 安装 KiCad 插件库 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 2.3.8 使用 GitHub 插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 2.3.8.1 写入时复制（Copy-On-Write） . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 3.9.3.1 3D 查看器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 3.9.4 设置菜单

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

使用封装 使用焊盘 使用区域 图形对象 标注 布线 向前和向后批注 锁定 批量编辑工具 清理工具 正在导入图形 检查电路板 测量工具 设计规则检查 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 封装和封装库 管理封装库 创建和编辑封装 高级主题 配置和自定义 自定义设计规则 脚本 Working With IDF Component Outlines 操作参考 PCB 编辑器 3D 查看器 Common 47 49 50 52 52 53 55 55 57 58 58 62 73 74 84 84 92 94 1 参考手册 NOTE 数，例如厚度和材料类 型。 要配置电路板的压层，从物理压层部分开始： 12 在左上角设置铜层的数量，然后根据需要输入压层的物理参数。 这些参数可以保留其默认值，但请注意，在导出电 路板的 3D 模型时，将使用电路板的厚度值，所以如果你打算使用这个功能，最好确保压层厚度是正确的。 NOTE KiCad 目前仅支持铜层数为偶数的压层。 要创建具有奇数层的设计 (例如，柔性印刷电路板或金 属芯印刷电路板)，

使用封装 使用焊盘 使用区域 图形对象 标注 布线 向前和向后批注 锁定 批量编辑工具 清理工具 正在导入图形 检查电路板 测量工具 设计规则检查 查找工具 搜索面板 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 封装和封装库 管理封装库 创建和编辑封装 高级主题 配置和自定义 Text variables 自定义设计规则 脚本 使用 IDF 元件边框的工作 操作参考 PCB 编辑器 3D 查看器 通用 57 59 60 61 62 63 65 65 67 68 68 72 73 89 90 99 99 110 112 1 参考手册 NOTE 物理压层部分用于配置铜层的数量，以及铜层和电介质层的物理 参数，如厚度和材料类型。介质层、阻焊层和丝印层可以被分配颜色，这将影响电路板在 3D 查看器中的外观。 要配置电路板的压层，从物理压层部分开始： 11 在左上角设置铜层的数量，然后根据需要输入压层的物理参数。 这些参数可以保留其默认值，但请注意，在导出电 路板的 3D 模型时，将使用电路板的厚度值，所以如果你打算使用这个功能，最好确保压层厚度是正确的。 NOTE KiCad

. . . . . . . . . . . . . . . . . . . . . . . . . . . 测量工具 设计规则检查 Board Statistics 查找工具 搜索面板 3D 查看器 网络检查 生成输出 制造输出和绘图 钻孔文件 IPC-2581 files 元件拾放文件 其它制造输出 打印 导出文件 封装和封装库 管理封装库 创建和编辑封装 Browsing Browsing footprint libraries 高级主题 配置和自定义 文本变量 自定义设计规则 脚本 IDF component outlines 操作参考 PCB 编辑器 3D 查看器 通用 77 77 80 81 82 83 85 88 88 91 92 93 94 94 95 101 101 103 130 132 132 部分用于启用或禁用技术层（非铜 层），如果需要的话，还可以给各层自定义名称。 物理层叠部分用于配置铜层的数量，以及铜层和电介质层的物理 参数，如厚度和材料类型。介电层、阻焊层和丝印层可以被分配颜色，这将影响电路板在 3D 查看器中的外观。 要配置电路板的层叠，从物理层叠部分开始： 12 Set the number of copper layers in the upper left corner and then

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 5.2.6 使用 GitHub 插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 5.2.7 使用模式 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 CvPcb iv 6.2 查看当前 3D 模型 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 预定义于原理图符号库中, 在用户从库中加载这类元器件时, 其封装会被自动设置。 CvPcb 提供了在创建原理图的过程中为元器件分配 PCB 封装的简便方法。它拥有封装列表过滤, 封装预览以及 3D 模型预览功能. 这些功能旨在提高分配封装时的准确率。 用户可以手动为元器件分配对应的封装。通过创建.equ 文件, 也可以实现封装的自动分配。.equ 文件包含了元器件和 其对应封装的相关信息。

件的封装字段创建的。此外封装也可能被预定义于原理图符号库中, 在用户从 库中加载这类元器件时,其封装会被自动设置。 CvPcb 提供了在创建原理图的过程中为元器件分配 PCB 封装的简便方法。它 拥有封装列表过滤, 封装预览以及 3D 模型预览功能. 这些功能旨在提高分配封 装时的准确率。 用户可以手动为元器件分配对应的封装。通过创建 .equ 文件, 也可以实现封装 的自动分配。.equ 文件包含了元器件和其对应封装的相关信息。 。列表中的每一项需要有一个可用的路径。根据 封装库类型的不同，路径的具体表现形式可能不同。“路径” 字段中的内容可以 是绝对路径，相对路径，或者是环境变量(下文中会进一步讨论) 为了正确读取封装库，列表中每一项的 “插件类型” 字段必须被正确选择。目 前 KiCad 支持的类型包括 KiCad legacy, KiCad Pretty, Eagle, 和 GEDA 封装库。 列表中的 “描述” 字段，用于为项添加额外的备注信息。列表中的 将封装库存储于项目目 录下。 使用 GitHub 插件 GitHub 插件提供了只读访问那些包含 Kicad pretty 封装库文件的 GitHub 仓库 的接口。 该插件也提供了 COW(“复制时写入”) 功能。 该功能是可选项，它将 允许用户编辑从 GitHub 仓库读取的封装库， 并且将它们保存在本地。因而， “GitHub” 插件用于 只读访问托管于 https://github.com/

loading project archives KiCad 配置 共同偏好设置 鼠标和触摸板偏好设置 快捷键偏好设置 路径配置 库配置 工程模板 使用模板 模板位置 创建模板 插件和内容管理器 操作参考 KiCad 工程管理器 2 2 2 5 5 5 7 7 7 8 8 9 9 11 11 13 14 15 17 18 18 18 *.pro , *.sch , *.lib , *.dcm , *.cmp , *.brd , *.mod Legacy KiCad design files *.stp , *.step 3D models *.g? , *.g?? , *.gm?? , *.gbrjob Gerber files *.pos , *.drl , *.nc , *.xnc , *.d356 , *.rpt 会自动重新打开之前打开的所有文件。 自动保存： 在编辑原理图和电路板文件时，KiCad 会定期自动保存您的工作。设置为 0 将禁用此功能。 文件历史大小： 配置最近打开的文件列表中的条目数 3D 缓存文件时长： KiCad 创建 3D 模型缓存，以提高 3D 观看速度。 您可以配置在删除旧文件之前保留此缓存的时 间。 自动备份工程：开启后，KiCad 工程将根据以下设置自动存档为 ZIP 文件。 存档将保存在工程文件夹的子文件夹