. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 3 应用程序编程接口（API） 21 3.1 插件类 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 开发的插 件直接相关的代码，从而减少每个构建和测试周期所需的时间，在插件开发期间删除构建 KiCad 的要求极大地提高 了工作效率。 插件最初是为 3D 模型查看器开发的，因此可以支持更多类型的 3D 模型，而无需对支持的每种新模型类型的 KiCad 源进行重大更改。插件框架后来被推广，以便将来开发人员可以创建不同类型的插件。目前，只有 3D 插件在 KiCad 中实现，但可以想象最终将开发 中实现，但可以想象最终将开发 PCB 插件，以使用户能够实现数据导入器和导出器。 1.1 插件类 插件分为插件类，因为每个插件都解决了特定域中的问题，因此需要该域独有的接口。例如，3D 模型插件从文件加 载 3D 模型数据并将该数据转换为可由 3D 查看器显示的格式。PCB 导入/导出插件将获取 PCB 数据并导出为其他 电气或机械数据格式，或将外部格式转换为 KiCad PCB。目前只开发了 3D 插件类，它将成为本文档的重点。

通过确保开发人员仅编译与正在开发的 插件直接相关的代码，从而减少每个构建和测试周期所需的时间，在插件开发 期间删除构建 KiCad 的要求极大地提高了工作效率。 插件最初是为 3D 模型查看器开发的，因此可以支持更多类型的 3D 模型，而 无需对支持的每种新模型类型的 KiCad 源进行重大更改。 插件框架后来被推 广，以便将来开发人员可以创建不同类型的插件。 目前，只有 3D 插件在 KiCad 中实现，但可以想象最终将开发 中实现，但可以想象最终将开发 PCB 插件，以使用户能够实现数据导 入器和导出器。 1.1. 插件类 插件分为插件类，因为每个插件都解决了特定域中的问题，因此需要该域独有 的接口。 例如，3D 模型插件从文件加载 3D 模型数据并将该数据转换为可由 3D 查看器显示的格式。 PCB 导入/导出插件将获取 PCB 数据并导出为其他电 气或机械数据格式，或将外部格式转换为 KiCad PCB。 目前只开发了 3D 插件 GetNFilters() - 1 */ char const* GetFileFilter( int aIndex ); /* 如果插件可以渲染这种类型的 3D 模型，则返回 true。 在某些情况下，插件可能尚未提供可视模型。 并且必须返回 false。 Return true if the plugin can render this type of 3D model

存在许多不同的网表格式。有时，符号列表和网络列表是两个单独的文件。该 网表是使用原理图捕获软件的基础，因为网表是与其他电子 CAD 软件的链 接，例如： PCB 布局软件。 原理图和电信号模拟器。 CPLD（和其他可编程 IC ）编译器。 Eeschema 支持几种网络列表格式。 PCBNEW 格式（印刷电路）。 ORCAD PCB2 格式（印刷电路）。 CADSTAR 格式（印刷电路）。 Spice 格式，适用于各种模拟器（其他模拟器也使用 。 在这种情况下，很容易 加载和修改现有符号。 加载将用作起点的符号。 单击 或通过右键单击值字段并编辑文本来修改其名称。 如果您选择复 制当前符号，系统将提示您输入新的符号名称。 如果模型符号具有别名，系统将提示您从新符号中删除与当前库冲突的别 名。 如果答案为否，则将中止新的符号创建。 符号库不能包含任何重复的 名称或别名。 根据需要编辑新符号。 单击图像更新当前库中的新符号： 的第一个字符表示符号是幂符号外， 参考文本并不重要。 按照惯例，引用字段以 “” 开头的每个符号都不会出现 在符号列表或网表中，并且引用被声明为不可见。 创建新的电源端口符号的更简单方法是使用另一个符号作为模型： 加载现有的电源符号。 使用新电源符号的名称编辑引脚名称。 如果要显示电源端口值, 请将值字段编辑为与引脚相同的名称。 保存新符号。 第 13 章 LibEdit - 符号 13.1.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 Eeschema 简介 x 16 仿真器 142 16.1 分配模型 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 16.1.2 模型 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 存在许多不同的网表格式。有时，符号列表和网络列表是两个单独的文件。该网表是使用原理图捕获软件的基础，因 为网表是与其他电子 CAD 软件的链接，例如： • PCB 布局软件。 • 原理图和电信号模拟器。 • CPLD（和其他可编程 IC ）编译器。 Eeschema 支持几种网络列表格式。 • PCBNEW 格式（印刷电路）。 • ORCAD PCB2 格式（印刷电路）。 • CADSTAR 格式（印刷电路）。 •

3D 查看器中的外观。 要配置电路板的压层，从物理压层部分开始： 11 在左上角设置铜层的数量，然后根据需要输入压层的物理参数。 这些参数可以保留其默认值，但请注意，在导出电 路板的 3D 模型时，将使用电路板的厚度值，所以如果你打算使用这个功能，最好确保压层厚度是正确的。 NOTE KiCad 目前仅支持铜层数为偶数的压层。 要创建具有奇数层的设计 (例如，柔性印刷电路板或金 属芯印刷电路板)， exists and has been assigned to the footprint. NOTE KiCad 标准库中的许多封装还没有为它们创建模型文件。然而，这些封装可能包含一个指向尚不 存在的 3D 模型的路径，以期待将来创建 3D 模型。 浏览 3D 视图 Dragging with the left mouse button will orbit the 3D view. By default the middle mouse button also pans the view. 不同大小的 3D 网格可以用 偏好设置 → 3D 网格 菜单来设置。每个元件的围框可以通过 偏好设置 → 显示模型围框 来 启用。 当 PCB 编辑器和 3D 查看器同时打开时，在 PCB 编辑器中选择一个封装也会在 3D 查看器中突出显示该元件。高亮显 示的颜色可以在 偏好设置 → 偏好设置… → 3D

如厚度和材料类 型。 要配置电路板的压层，从物理压层部分开始： 12 在左上角设置铜层的数量，然后根据需要输入压层的物理参数。 这些参数可以保留其默认值，但请注意，在导出电 路板的 3D 模型时，将使用电路板的厚度值，所以如果你打算使用这个功能，最好确保压层厚度是正确的。 NOTE KiCad 目前仅支持铜层数为偶数的压层。 要创建具有奇数层的设计 (例如，柔性印刷电路板或金 属芯印刷电路板)， 钻孔文件中数字的格式。 请根据制造商的建议在此处选择一个选项。 元件放置文件 元件放置文件是一种文本文件，它列出了电路板上的每个元件（封装）以及其中心位置和方向。 这些文件通常用于 对取放机进行编程，如果你订购的是完全组装的 PCB，你的制造商可能需要这些文件。 51 NOTE 如果为生成的封装启用了“从放置文件中排除”选项，该封装将不会出现在生成的放置文件中。 这 可用于排除不代表要组装的物理元件的某些封装。 切换表贴(SMD) 3D 模型 切换“表贴”属性的 3D 模型 切换直插 3D 模型 切换“直插”属性的 3D 模型 切换虚拟 3D 模型 切换“虚拟”属性的 3D 模型 翻转电路板 翻转电路板视图 Ctrl E Ctrl E Ins Shift P B Ctrl B S T V 93 操作 默认快捷键 说明 仅使用漫反射 仅使用 3D 模型文件中的漫反射颜色属性 使用所有属性

. 生成输出 打印 绘图 Generating a bill of materials 生成网表 符号和符号库 管理符号库 创建和编辑符号 浏览符号库 仿真器 值的表示 分配模型 SPICE 标识符 运行仿真 Helpful hints 高级主题 配置和定制 文本变量 数据库关联库文件 HTTP Libraries 自定义网表和 BOM 格式 操作参考 每张原理图只使用一次。 复杂： 一些原理图被多次使用。 扁平化： 简单的 层次结构的一个子案例，在子原理图和其父原理图之间没有连接。扁平的层次结构可以用来表示 一种非层次结构设计。 每种层次结构模型都可能是有用的；最合适的模型取决于设计需求。 简单的层次结构 一个简单的层次结构的例子是 KiCad 包含的 video 演示工程。根原理图包含七个独特的子原理图，每个子原理图都 有层次化标签和原理图页面 时，将加载封装库。 关于封装过滤器的更多信息，请参阅符号编辑器文档。 用封装分配工具分配封装 封装分配工具允许你将原理图中的符号与印制电路板布线时用到的封装关联起来。它提供了封装列表过滤、封装查看 和3D元件模型查看，以确保将正确的封装与每个元件联系起来。 元件可以手动或通过创建等效文件（.equ 文件）自动分配到其相应的封装。等效文件是将每个元件与它的封装联系 起来的查找表。 点击 工具 → 分配封装…

. . . . . . . . . . . 打印 绘制 生成物料清单 生成网表 符号和符号库 管理符号库 创建和编辑符号 浏览符号库 仿真器 Value notation 分配模型 SPICE directives Running simulations 高级主题 配置和定制 文本变量 数据基础库 自定义网表和 BOM 格式 操作参考 原理图编辑器 通用 每张原理图只使用一次。 复杂： 一些原理图被多次使用。 扁平化： 简单的 层次结构的一个子案例，在子原理图和其父原理图之间没有连接。扁平的层次结构可以用来表示 一种 非层次结构设计。 每种层次结构模型都可能是有用的；最合适的模型取决于设计。 简单的层次结构 一个简单的层次结构的例子是 KiCad 包含的 video 演示工程。根原理图包含七个独特的子原理图，每个子原理图都 有分层的标签和原理图页码，将 关于封装过滤器的更多信息，请参阅《封装过滤器，符号编辑器文档》。 用封装分配工具分配封装 封装分配工具允许你将原理图中的符号与铺设印制电路板时使用的封装联系起来。它提供了封装列表过滤、封装查看 和三维元件模型查看，以帮助确保将正确的封装与每个元件联系起来。 74 元件可以手动或通过创建等效文件（.equ 文件）自动分配到其相应的封装。等效文件是将每个元件与它的封装联系 起来的查找表。 用 工具 →

三维可视化 封装可以与包含元件的三维表示的文件相关联。 要将封装与模型文件相关 联，请选择 3D 设置 选项卡，如下所示。 图 13.1. 3D 模型选择界面 右侧的按钮具有以下功能： 添加3D形状 显示3D文件选择对话框并创建一个 元件的新模型条目。 删除3D形状 删除所选的模型条目。 编辑文件名 显示用于手动输入的文本编辑器 模型文件名。 配置路径 显示一个配置对话框 允许用户编辑路径别名列表和 选项卡包含一个面板，其中包含所选模型的预览以及模型的比例，偏 移和旋转数据。 缩放值对于可视化格式（如 VRML1，VRML2 和 X3D）非常有用。 由于模型 可能由任意数量的 VRML/X3D 编辑器或导出器生成，并且 VRML 不强制模型 的长度单位，因此用户可以输入适当的比例值以确保模型在 3D 查看器中显 示。 一些用户使用简单的 VRML 框作为元件的通用模型并选择比例值，以便 框具有表示组件的正确大小。 CAD（MCAD）模型，比例值应保持 为1。 MCAD 格式始终指定单位长度，任何使用 MCAD 数据格式的导出器都 将忽略缩放值。 但是 3D 查看器将始终应用比例值; 如果除了单位以外的比例 值与 MCAD 模型一起使用，则 3D 查看器的输出将与任何导出的 MCAD 模型 （如 IDF）不同。 通常需要偏移和旋转值以使 3D 模型与封装对齐。 由于 3D 建模软件的差异以 及用户构建模型的方式不同

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 13.13.13D 模型路径 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 封装可以与包含元件的三维表示的文件相关联。要将封装与模型文件相关联，请选择 3D 设置选项卡，如下所示。 Figure 13.1: 3D 模型选择界面 右侧的按钮具有以下功能： • 添加 3D 形状显示 3D 文件选择对话框并创建一个元件的新模型条目。 • 删除 3D 形状删除所选的模型条目。 • 编辑文件名显示用于手动输入的文本编辑器模型文件名。 • 配置路径显示一个配置对话框允许用户编辑路径别名列表和别名值。 设置选项卡包含一个面板，其中包含所选模型的预览以及模型的比例，偏移和旋转数据。 缩放值对于可视化格式（如 VRML1，VRML2 和 X3D）非常有用。由于模型可能由任意数量的 VRML/X3D 编辑器 或导出器生成，并且 VRML 不强制模型的长度单位，因此用户可以输入适当的比例值以确保模型在 3D 查看器中显 Pcbnew 145 / 163 示。一些用户使用简单的 VRML 框作为元件的通用模型并选择比例值