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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 7.2 在层次结构中导航 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 7.4 层次结构创建摘要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 . . . . . . . . . . . . . . 54 7.8 复杂层次结构 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 7.9 平面层次结构 . . . . . . . . . . . . . . . . . . . . .

因此，对元件、元件引脚，连接或板的数量 没有实际限制。 在多张图表的情况下，表示是分层的。 Eeschema可以通过以下几种方式使用多表格图表： 简单的层次结构（每个原理图只使用一次）。 复杂的层次结构（一些原理图在多个实例中不止一次使用）。 扁平层次结构（原理图未在主图中明确连接）。 第 2 章 通用 Eeschema 命令 命令可以通过以下方式执行： 单击菜单栏（屏幕顶部）。 单击屏幕顶部的图标 重做：还原最后一次撤消操作。 显示在原理图中搜索符号和文本的对话框。 显示用于搜索和替换原理图中文本的对话框。 刷新屏幕;缩放以适应。 放大和缩小。 查看和导航层次结构树。 保留当前工作表并进入层次结构中。 调用符号库编辑器以查看和修改库和符号。 浏览符号库。 注释符号。 电气规则检查器（ERC），自动验证电气连接。 调用CvPcb为符号分配封装。 导出网表（Pcbnew，SPICE和其他格式）。 昵称是用于将符号分配给元件的简短唯一标识符。符号 由'：'字符串表示。 库路 径 路径指向库位置。 插件 类型 确定库文件格式。 选项 存储库特定选项（如果插件使用）。 说明 简要描述库内容。 3.2.2. 常规选项 显示 网格尺寸 网格大小选择。 建议 使用普通网格（0.050英寸或1,27毫米）。较小 网格 用于元件构建。

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） . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 15.8 动作插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

物料清单生成（通过 Python 或 XSLT 脚本，允许许多灵活的格式）。 原理图编辑器以几种方式支持多张原理图： 扁平的层次结构（原理图表在主图中没有明确的连接）。 简单的层次结构（每张原理图只使用一次）。 复杂的层次结构（有些原理图表被多次使用）。 层次结构图有详细描述《层次结构图，在手册后面》。 初始配置 当原理图编辑器首次运行时，如果在 KiCad 配置文件夹中没有找到全局符号库表文件 sym-lib-table 打开/关闭隐藏引脚的显示。 在自由角度和水平/垂直放置新导线、总线和图形线之间进行切换。 在自由角度、90 度模式和 45 度模式之间切换，以放置新的导线、总线和图形线。 打开和关闭停靠的层次结构导航面板。 Ctrl Ctrl Cmd Shift Shift Shift Ctrl Shift Ctrl Shift Cmd Shift Esc Esc 7 原理图创建和编辑 简介 局部标签 4. 层次标签 5. 测试原理图页码 如果一个网络有多个同一类型的标签，则按字母顺序排序，使用第一个。 如果一个网络穿过《层次原理图,层次》的多张原理图，它将从它有层次标签或局部标签的层次结构的最高层取名。 通常，局部标签优先于层次标签。 32 如果上面的标签类型都没有附加到网络中，那么网络的名称将根据连接的符号引脚自动生成。 PWR_FLAG 在上面的截图中可以看到两个 PWR_FLAG

创建一个新工程 从其他 EDA 工具导入工程 KiCad 配置 共同偏好设置 鼠标和触摸板偏好设置 快捷键偏好设置 路径配置 库配置 工程模板 使用模板 模板位置： 创建模板 插件和内容管理器 Actions reference KiCad Project Manager 2 2 2 5 5 5 7 7 7 8 8 9 10 10 12 13 软件套件。 KiCad 支持综合设计工作流程，其中 原理图和相应的 PCB 一起设计，也支持特殊用途的独立工作流程。 KiCad 还包括一些帮助电路和 PCB 设计的实用程 序，包括用于确定电路结构电气属性的 PCB 计算器、用于检查制造文件的 Gerber 浏览器和用于检查电路行为的集成 SPICE 模拟器。 KiCad 可在所有主要的操作系统和广泛的计算机硬件上运行。 它支持多达 32 元数据目录是名为 meta 的子目录，其中包含描述模板的文件。 元数据由一个必需文件组成，可能包含可选文件。 所有文件必须由用户使用文本编辑器或以前的 KiCad 工程文件创 建，并放入所需的目录结构中。 18 使用模板创建工程时，模板中的所有文件和目录都将复制到新的工程路径，但 meta 除外。包含模板名称的文件和目 录将使用新的工程文件名重命名。 例如，从名为 示例 的模板创建名为 新工程

物料清单生成（通过 Python 或 XSLT 脚本，允许许多灵活的格式）。 原理图编辑器以几种方式支持多原理图设计： 扁平的层次结构（原理图页面在主图中没有明确的连接）。 简单的层次结构（每张原理图只使用一次）。 复杂的层次结构（有些原理图页面被多次使用）。 层次结构原理图会在后续章节详细描述。 初始配置 当原理图编辑器首次运行时，如果在 KiCad 配置文件夹中没有找到全局符号库表文件 sym-lib-table 2. 电源符号 3. 局部标签 4. 层次标签 5. 层次原理图引脚 如果一个网络有多个同一类型的标签，则按字母顺序排序，使用第一个。 如果一个网络经过层次的多张原理图，它的名字将取决于层次结构中优先级最高的标签。通常，局部标签优先级高于 层次标签。 如果以上标签类型都没有添加到网络中，那么网络的名称将根据连接的符号引脚自动生成。 PWR_FLAG 上面的截图中可以看到两个 PWR_FLAG Remap Legacy Library Symbols… . 58 层次原理图 简介 在 KiCad 中，多张原理图可以形成层次结构：有一个根原理图，其他图作为根原理图或另一个子原理图的子原理图 被创建。如果需要的话，原理图可以被多次包含在一个层次结构中。 仔细地将原理图绘制成层次设计，可以提高原理图的可读性，减少重复绘制。 创建层次原理图是从根原理图开始的。其过程是创建一个子原理图

显示一个网的焊盘（表面贴装和通孔）和过孔的数量。 过孔长度 显示每个过孔的总高度（不考 虑过孔连接到哪个铜层）。 换句话说，过孔长度等于过孔数乘以电路板的堆积高度。 布线长度 显示一个网络中所有 布线段的总长度，不考虑拓扑结构。 芯片长度 显示了网络中所有焊盘设置的焊盘长度值的总和。 NOTE 网络检查器中显示的长度不同于长度调整工具中显示的长度， 因为网络检查器显示连接到网络的 所有布线的总和， 而长度调整工具显示最近的两个焊盘或分支过孔之间的距离。 to relocate projects without breaking their project library tables. 使用 GitHub 插件 NOTE KiCad 在 6.0 版本中取消了对 GitHub 库插件的支持。 Shift 67 创建和编辑封装 NOTE This section of the KiCad documentation has not yet 观的预览。 操作插件 KiCad PCB 编辑器支持用 Python 编写的插件，可以对正在编辑的电路板进行操作。 这些插件可以使用内置的插件 和内容管理器来安装（详见 KiCad 章节），或者将插件文件放在用户的插件目录中。 详见下面的脚本部分。 每个被检测到的插件都会在这个偏好设置上显示一排。 插件可以在 PCB 编辑器的顶部工具栏上显示一个按钮。 如果 一个插件的 "显示按钮" 控制没有被选中，它仍然可以从