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 日出版。 1. KiCad 插件系统简介 KiCad 插件系统是一个使用共享库扩展 KiCad 功能的框架。 使用插件的一个 主要优点是在开发插件时没有必要重建 KiCad 套件; 事实上，可以借助 KiCad 源代码树中的一小组标题构建插件。 通过确保开发人员仅编译与正在开发的 插件直接相关的代码，从而减少每个构建和测试周期所需的时间，在插件开发 期间删除构建 KiCad 的要求极大地提高了工作效率。 码的设置和构建。 2.1. 基本的 3D 插件 本教程将引导用户开发一个名为 “PLUGIN_3D_DEMO1” 的非常基本的 3D 插 件。 本教程的目的只是为了演示一个非常基本的 3D 插件的构造，除了提供一 些允许 KiCad 用户在浏览 3D 模型时过滤文件名的过滤字符串之外什么都不 做。 这里演示的代码是任何 3D 插件的绝对最低要求，可以用作创建更高级插 件的模板。 为了构建演示项目，我们需要以下内容：

Kicad 插件 Kicad 插件 ii October 31, 2021 Kicad 插件 iii Contents 1 KiCad 插件系统简介 2 1.1 插件类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Kicad 插件 1 / 42 KiCad 插件系统 Copyright 本文档由其贡献者授予版权 © 2016，如下所示。您可以根据 GNU 通用公共许可证 (http：/www.gnu.org/licenses/gpl.html) 版本 3 2 / 42 1 KiCad 插件系统简介 KiCad 插件系统是一个使用共享库扩展 KiCad 功能的框架。使用插件的一个主要优点是在开发插件时没有必要重建 KiCad 套件; 事实上，可以借助 KiCad 源代码树中的一小组标题构建插件。通过确保开发人员仅编译与正在开发的插 件直接相关的代码，从而减少每个构建和测试周期所需的时间，在插件开发期间删除构建 KiCad 的要求极大地提高 了工作效率。

：图框编辑器。 这些工具通常从工程管理器运行，但也可以作为独立工具运行。 KiCad 没有任何电路板尺寸限制，它可以处理多达 32 个铜层，14 个技术层和 4 个辅助层。 KiCad 可以创建构建印刷电路板所需的所有文件，包括： Gerber 文件为光绘机 钻孔文件 元件位置文件 作为开源 (GPL 许可)软件, KiCad 是面向有意创建开源电子硬件的工程的工程 师的理想工具。 KiCad 要导入外部工程，需要在导入文件浏览器对话框中选择原理图文件或电路板文 件。 导入的原理图和电路板文件应具有相同的基本文件名（例如 project.sch 和 project.brd）。 选择所请求的文件后，系统将要求您选择存储导入文件的目 录，这些目录将保存为 KiCad 工程。 第 3 章 使用 KiCad 工程管理器 KiCad 工程管理器（kicad 或 kicad.exe）是一个工具，可以在创建设计时轻松 电路板布局编辑器。 4FootprintEditor 封装编辑器和封装库管理器。 5Gerbview Gerber 文件查看器。 它还可以显示钻孔文件。 6Bitmap2component用于构建封装或元件的工具 用于创建 LOGO 的 B＆W 位 图图像。 7Pcb 计算器 计算轨道宽度的工具，以及许多其他工具 的东西。 8Pl 编辑器 图框编辑器，用于创建/自定义框架 引用。 3

：图框编辑器。 这些工具通常从工程管理器运行，但也可以作为独立工具运行。 KiCad 没有任何电路板尺寸限制，它可以处理多达 32 个铜层，14 个技术层和 4 个辅助层。 KiCad 可以创建构建印刷电路板所需的所有文件，包括： • Gerber 文件为光绘机 • 钻孔文件 • 元件位置文件 作为开源 (GPL 许可) 软件, KiCad 是面向有意创建开源电子硬件的工程的工程师的理想工具。 要导入外部工程，需要在导入文件浏览器对话框中选择原理图文件或电路板文件。导入的原理图和电路板文件应具有 相同的基本文件名（例如 project.sch 和 project.brd）。选择所请求的文件后，系统将要求您选择存储导入文件的目录， 这些目录将保存为 KiCad 工程。 KiCad 8 / 20 Chapter 3 使用 KiCad 工程管理器 KiCad 工程管理器（kicad 或 kicad 电路板布局编辑器。 4 FootprintEditor 封装编辑器和封装库管理器。 5 Gerbview Gerber 文件查看器。它还可以显示钻孔文件。 6 Bitmap2component 用于构建封装或元件的工具用于创建 LOGO 的 B ＆ W 位图图像。 7 Pcb 计算器 计算轨道宽度的工具，以及许多其他工具的东西。 8 Pl 编辑器 图框编辑器，用于创建/自定义框架引用。 3.3

Eeschema 简介 1.1. 描述 Eeschema 是一个原理图设计软件，作为 KiCad 的一部分分发，可在以下操作 系统下使用： Linux Apple OS X Windows 无论操作系统如何，所有 Eeschema 文件都可以从一个操作系统100％兼容到另 一个操作系统。 Eeschema 是一个集成的应用程序，其中绘图，控制，布局，库管理和访问 PCB 设计软件的所有功能都在 Eeschema Eeschema 使用两个库表来存储可用符号库列表，这些符号库因范围而异： 全局库 每个项目都可以使用全局库表中列出的库。 它们保存在您的主目录中的 sym- lib-table 中（确切路径取决于操作系统;请检查表上方的路径）。 项目专用库 项目专用库中列出的库可用于当前打开的项目。 它们保存在项目目录中的 sym-lib-table 文件中（检查表格上方的路径）。 您可以通过单击库表下方的 全局库 选项 存储库特定选项（如果插件使用）。 说明 简要描述库内容。 3.2.2. 常规选项 显示 网格尺寸 网格大小选择。 建议 使用普通网格（0.050英寸或1,27毫米）。较小 网格 用于元件构建。 总线厚度 用于绘制总线的笔大小。 线条粗细 用于绘制没有对象的对象的笔大小 指定的笔大小。 元件 ID 表示法 用于表示符号单元的后缀样式（U1A， U1.A，U1-1等） 图标比例 调整工具栏图标大小。

Eeschema 简介 1.1 描述 Eeschema 是一个原理图设计软件，作为 KiCad 的一部分分发，可在以下操作系统下使用： • Linux • Apple OS X • Windows 无论操作系统如何，所有 Eeschema 文件都可以从一个操作系统 100％兼容到另一个操作系统。 Eeschema 是一个集成的应用程序，其中绘图，控制，布局，库管理和访问 PCB 设计软件的所有功能都在 Eeschema 使用两个库表来存储可用符号库列表，这些符号库因范围而异： • 全局库 每个项目都可以使用全局库表中列出的库。它们保存在您的主目录中的 sym-lib-table 中（确切路径取决于操作系统; 请检查表上方的路径）。 • 项目专用库 项目专用库中列出的库可用于当前打开的项目。它们保存在项目目录中的 sym-lib-table 文件中（检查表格上方的路 径）。 您可以通过单击库表下方的 存储库特定选项（如果插件使用）。 说明 简要描述库内容。 3.2.2 常规选项 3.2.2.1 显示 网格尺寸 网格大小选择。 建议使用普通网格（0.050 英寸或 1,27 毫米）。较小网格用于元件 构建。 总线厚度 用于绘制总线的笔大小。 线条粗细 用于绘制没有对象的对象的笔大小指定的笔大小。 元件 ID 表示法 用于表示符号单元的后缀样式（U1A，U1.A，U1-1 等） 图标比例 调整工具栏图标大小。

设计的实用程序，包括用于确定电路结构电气特性的 PCB 计算器、用于检查制造文件的 Gerber 查看器、用 于可视化成品 PCB 的 3D 查看器以及用于检查电路行为的集成 SPICE 仿真器。 KiCad 可在所有主要的操作系统和广泛的计算机硬件上运行。它支持多达 32 个铜层的 PCB，适合创建各种复杂的设 计。KiCad 是由世界各地的软件和电气工程师组成的志愿者团队开发的，其使命是创建适合专业设计师的免费和开源 的电子设计软件。 KiCad 7.0 版本。 下载和安装 KiCad KiCad 可在许多操作系统上运行，包括微软 Windows、苹果 macOS 和许多主要的 Linux 发行版。 你可以在 https://www.kicad.org/download/ 找到最新的说明和下载链接。这些说明没有包括在本手册中，因为它 们可能随着操作系统更新的发布而改变。 IMPORTANT 根据 KiCad 稳定发布政策，KiCad 稳定发布政策，KiCad 的稳定发布会定期进行。新的功能正在不断地被添加到开发 分支中。如果你想利用这些新功能，并通过测试它们来提供帮助，请下载你的平台的最新夜间 构建包。夜间构建可能会引入一些错误，如文件损坏、生成不良 Gerbers 等，但 KiCad 开发 团队的目标是在新功能开发期间尽可能保持开发分支的可用性。 支持 如果您有想法，评论或问题，或者您只是需要帮助： 这是 KiCad 官方用户论坛 是一个与其他

设计的实用程序，包括用于确定电路结构电气特性的 PCB 计算器、用于检查制造文件的 Gerber 查看器、用 于可视化成品 PCB 的 3D 查看器以及用于检查电路行为的集成 SPICE 仿真器。 KiCad 可在所有主要的操作系统和广泛的计算机硬件上运行。它支持多达 32 个铜层的 PCB，适合创建各种复杂的设 计。KiCad 是由世界各地的软件和电气工程师组成的志愿者团队开发的，其使命是创建适合专业设计师的免费和开源 的电子设计软件。 version 8.0. 下载和安装 KiCad KiCad 可在许多操作系统上运行，包括微软 Windows、苹果 macOS 和许多主要的 Linux 发行版。 你可以在 https://www.kicad.org/download/ 找到最新的说明和下载链接。这些说明没有包括在本手册中，因为它 们可能随着操作系统更新的发布而改变。 IMPORTANT 根据 KiCad 稳定发布政策，KiCad 稳定发布政策，KiCad 的稳定发布会定期进行。新的功能正在不断地被添加到开发 分支中。如果你想利用这些新功能，并通过测试它们来提供帮助，请下载你的平台的最新夜间 构建包。夜间构建可能会引入一些错误，如文件损坏、生成不良 Gerbers 等，但 KiCad 开发 团队的目标是在新功能开发期间尽可能保持开发分支的可用性。 支持 如果您有想法，评论或问题，或者您只是需要帮助： 这是 KiCad 官方用户论坛 是一个与其他

17 日。 第 1 章 Pcbnew 简介 1.1. 描述 Pcbnew 是一款功能强大的印刷电路板软件工具，适用于 Linux，Microsoft Windows 和 Apple OS X 操作系统。 Pcbnew 与原理图捕获程序 Eeschema 结合 使用，以创建印刷电路板。 Pcbnew 管理封装库。 每个覆盖区都是物理元件的图形，包括其焊盘图案（电 路板上焊盘的布局）。 在读取网表期间会自动加载所需的封装。 封装库表 包含一些单独的封装库的描述，以及每个库的“昵称”，用于在引用封装时引用 该库。 Pcbnew 支持几种库，每种都由“插件”支持： KiCad - 以 .pretty 格式存储在本地文件系统上的本机 KiCad 封装库（包含 .kicad_mod 文件的文件夹） Github - .pretty 格式的原生 KiCad 封装库，作为 Github 存储库在线存储 旧版 - 旧式 KiCad 开的 PCB 的文件夹中。 2.3.3. 初始配置 第一次运行 CvPcb 或 Pcbnew 并且在用户的主文件夹中找不到全局封装表文 件“fp-lib-table”，Pcbnew 将尝试复制存储在系统的 KiCad 模板文件夹中的默认 封装表文件“fp_global_table” 到用户主文件夹中的“fp-lib-table”文件。 如果找不 到“fp_global_table”，将在用户的主文件夹中创建一个空的封装库表。

Chapter 1 Pcbnew 简介 1.1 描述 Pcbnew 是一款功能强大的印刷电路板软件工具，适用于 Linux，Microsoft Windows 和 Apple OS X 操作系统。 Pcbnew 与原理图捕获程序 Eeschema 结合使用，以创建印刷电路板。 Pcbnew 管理封装库。每个覆盖区都是物理元件的图形，包括其焊盘图案（电路板上焊盘的布局）。在读取网表期间会 库表包含一些单独的封装库的描述，以及每 个库的“昵称”，用于在引用封装时引用该库。 Pcbnew 支持几种库，每种都由“插件”支持： • KiCad - 以 .pretty 格式存储在本地文件系统上的本机 KiCad 封装库（包含 .kicad_mod 文件的文件夹） • Github - .pretty 格式的原生 KiCad 封装库，作为 Github 存储库在线存储 Pcbnew 4 有两个封装库表：全局表和项目表。 2.3.1 全局封装库表 全局封装库表包含始终可用的库列表，与当前加载的项目文件无关。该表保存在用户主文件夹中的文件“fp-lib-table” 中。此文件夹的位置取决于操作系统。 2.3.2 项目特定封装库表 项目特定的封装库表包含专门用于当前加载的项目文件的库列表。项目特定的封装库表只能在与项目板文件一起加载 时进行编辑。如果没有加载项目文件或项目路径中没有封装库