. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 3 应用程序编程接口（API） 21 3.1 插件类 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 插件类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 3.2 场景图类 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 模型时过滤文件名的过滤字符串之外什么都不 做。这里演示的代码是任何 3D 插件的绝对最低要求，可以用作创建更高级插件的模板。 为了构建演示项目，我们需要以下内容： • CMake • KiCad 插件头 • KiCad 场景图库‘kicad_3dsg’ 要开始，让我们创建一个项目目录和 FindPackage 脚本： mkdir demo && cd demo export DEMO_ROOT=${PWD} mkdir

模型时过滤文件名的过滤字符串之外什么都不 做。 这里演示的代码是任何 3D 插件的绝对最低要求，可以用作创建更高级插 件的模板。 为了构建演示项目，我们需要以下内容： CMake KiCad 插件头 KiCad 场景图库 ‘kicad_3dsg’ 要开始，让我们创建一个项目目录和 FindPackage 脚本： mkdir demo && cd demo export DEMO_ROOT=${PWD} mkdir “PLUGIN_3D_DEMO2” 的 3D 插件。 本教程的目 的是演示 KiCad 预览器可以渲染的非常基本的场景图的构造。 该插件声称处 理 ‘txt’ 类型的文件。 虽然文件必须存在，以便缓存管理器调用插件，但此插 件不处理文件内容; 相反，插件只是创建一个包含一对四面体的场景图。 本教 程假定第一个教程已完成，并且已创建 CMakeLists.txt 和 FindKICAD.cmake 文件来构建本教程。 由于这个插件会为 KiCad 创建一个场 景图，我们需要链接到 KiCad 的场景图库 ‘kicad_3dsg’。 KiCad 的场景图库提 供了一组可用于构建场景图对象的类; 场景图对象是 3D 缓存管理器使用的中 间数据可视化格式。 所有支持模型可视化的插件都必须通过此库将模型数据 转换为场景图。 第一步是扩展 ‘CMakeLists.txt’ 来构建这个教程项目： cd ${DEMO_ROOT}

• Linux • Apple OS X • Windows 无论操作系统如何，所有 Eeschema 文件都可以从一个操作系统 100％兼容到另一个操作系统。 Eeschema 是一个集成的应用程序，其中绘图，控制，布局，库管理和访问 PCB 设计软件的所有功能都在 Eeschema 本身内执行。 Eeschema 打算与 PcbNew 合作，后者是 KiCad 的印刷电路设计软件。它还可以导出网表文件，其中列出了其他软件 中也会高亮。 显示符号选择器对话框以选择要放置的新符号。 显示电源符号选择器对话框以选择要放置的电源符号。 画一根电线。 画一根总线 绘制线对总入口点。这些元素仅是图形化的，不会创建连接，因此它们不应用于将电线连接在一起。 绘制总线到总线的入口点。 放置“无连接”标志。这些标志应放在符号引脚上意味着没有连接。这样做是为了通知电气规则检 查器特定引脚缺少连接是故意的，应该不报告。 放置一个交 配置页面尺寸和标题栏。 打印 打印原理图项目（另见“打印和打印，打印和打印”一章）。 绘图 导出为 PDF，PostScript，HPGL 或 SVG 格式（请参见“绘图和打印，绘 图和打印”一章）。 关闭 终止应用程序。 Eeschema 简介 15 / 151 3.2 首选项菜单 管理符号库表 添加/删除符号库。 配置路径 设置默认搜索路径。 常规选项 首选项（单位，网格大小，字段名称等）。 设置语言

系统下使用： Linux Apple OS X Windows 无论操作系统如何，所有 Eeschema 文件都可以从一个操作系统100％兼容到另 一个操作系统。 Eeschema 是一个集成的应用程序，其中绘图，控制，布局，库管理和访问 PCB 设计软件的所有功能都在 Eeschema 本身内执行。 Eeschema 打算与 PcbNew 合作，后者是 KiCad 的印刷电路设计软件。 它还可 显示符号选择器对话框以选择要放置的新符号。 显示电源符号选择器对话框以选择要放置的电源符号。 画一根电线。 画一根总线 绘制线对总入口点。这些元素仅是图形化的，不会创建 连接，因此它们不 应用于将电线连接在一起。 绘制总线到总线的入口点。 放置“无连接”标志。这些标志应放在符号引脚上 意味着没有连接。这样做 是为了通知电气规则 检查器特定引脚缺少连接是故意的，应该 不报告。 放置一 配置页面尺寸和标题栏。 打印 打印原理图项目（另见“打印和打印，打印和打印”一章）。 绘图 导出为 PDF，PostScript，HPGL 或 SVG 格式（请参见“绘图 和打印，绘图和打印”一章）。 关闭 终止应用程序。 3.2. 首选项菜单 管理符号库表 添加/删除符号库。 配置路径 设置默认搜索路径。 常规选项 首选项（单位，网格大小，字段名称等）。 设置语言 选择界面语言。 图标选项 图标可见性设置。

的一部分分发的原理图设计软件，可在以下操作系统下使用： Linux Apple OS X Windows 无论操作系统如何，所有的 KiCad 文件都能 100% 地从一个操作系统兼容到另一个。 原理图编辑器是一个集成的应用程序，绘图、控制、布局、库管理和访问 PCB 设计软件的所有功能都在编辑器本身 中进行。 KiCad 原理图编辑器旨在与 KiCad PCB 编辑器合作，后者是 KiCad 的印刷电路设计软件。它还可以为其他软件包输 演示工程是一个扁平化层次结构的例子。根原理图包含两个唯一的子原理图符号，没有分层的原 理图页码。在这个工程中，根原理图除了容纳子原理图外没有任何作用，子原理图只是作为原理图中的附加页使用。 NOTE 这是在 KiCad 中创建多页原理图的最简单方法。 60 检查原理图 筛选工具 筛选工具在原理图中搜索文本，包括位号、引脚名称、符号字段和图形文本。当该工具找到一个匹配的文本时，画布 会被放大并居中显示该匹配的文本。使用顶部工具栏上的 理图中的单元必须与符号定义完全对应。 错误 符号中有未被放置的单元 多单元符号中的所有单元都应放置在原理图中。 警告 符号有未放置的输入引脚 多单元符号中有单元的输入引脚没有被放置，所以这些 输入引脚不会被连接到任何东西。所有带有输入引脚的 单元都应该被放置在原理图中。 警告 符号中有未被放置的双向引脚 多单元符号有未被放置的双向引脚的单元，因此这些双 向引脚不会连接到任何东西。所有具有双向引脚的单元

的发行的一部分，可在以下操作系统下使用： Linux Apple OS X Windows 无论是什么操作系统，所有的 KiCad 文件都能 100% 兼容所有操作系统。 原理图编辑器是一个集成的应用程序，所有绘图、控制、布局、库管理和访问 PCB 编辑器功能都在原理图编辑器中 进行。 KiCad 原理图编辑器旨在与 KiCad PCB 编辑器协同，后者是 KiCad 的印刷电路设计软件。它还可以为其他软件包输 失的连接 以多种格式导出绘图文件（Postscript，PDF，HPGL 和 SVG） 物料清单生成（通过 Python 或 XSLT 脚本，允许许多灵活的格式）。 原理图编辑器以几种方式支持多原理图设计： 扁平的层次结构（原理图页面在主图中没有明确的连接）。 简单的层次结构（每张原理图只使用一次）。 复杂的层次结构（有些原理图页面被多次使用）。 层次结构原理图会在后续章节详细描述。 这允许您选择一个项目用作模板并选择要导 入的设置 (格式首选项, 字段名称模板, 管脚冲突映射, 违规严重性设置和网络类)。 S 47 原理图格式 格式化面板包含符号、文本、标签、图形和导线的外观设置。 符号单元表示法 设置多单元符号的每个单元在其位号中的引用方式。 默认情况下，每个单元的不同字母会添加到到 没有分隔符的位号后，例如符号 U1 的第二个单元为 U1B ，但这可以更改。 可以使用数字代替字母，并且可以在符

在技术层（即不是铜 层）上绘制圆圈 在技术层（即不是铜 层）上绘制弧 放置文字 在技术层（即不是铜 层）上绘制尺寸 绘制对齐标记（出现在 所有图层上） 删除光标指向的元素 Note: 删除时，如果有多 个叠加元素 指出，优先 考虑最小（在减少 优先 级布线，文本，封装 库）。 功能“取消删除” 上部工具栏允许取消最 后一项 删除 偏移调整钻孔和放置文 件 网格原点。（网格偏 移）。主要用于编辑和 的边框 打开/关闭边框模式中的 焊盘 在边框模式中打开/关闭 过孔 打开/关闭边框模式中的 布线显示。 高亮显示模式开/关。 在此模式下激活 图层正 常显示，显示所有其他 图层 灰色的 适用于多 层电路 隐藏/显示图层管理器 使用微波工具。 正在开 发中 3.13. 弹出窗口和快速编辑 右键单击鼠标可打开弹出窗口。 其内容取决于光标指向的元素。 这样可以立即访问： Changing 或“B” 名字前缀。 构成这些层之一的覆盖区（焊盘，绘图，文本）的元 素将自动镜像，并在翻转覆盖区时移动到补充层。 配对的技术层是： 粘合剂层（F.Adhes 和 B.Adhes） 这些用于粘合剂的应用，通常在波峰焊之前将 SMD 元件粘到电路板上。 焊膏层（F.Paste 和 B.Paste） 用于生产锡膏层，通常在回流焊接之前，将焊膏放置在表面贴装元件的焊 盘上。 通常只有表面贴装焊盘占据这些层。

对 KiCad 的特殊术语。 本节列 出了 KiCad 文档和用户界面中最常用的一些术语。 其他针对 KiCad 工作流程的某一部分的术语将在本手册的后面进 行定义。 一个 原理图 是由一页或多页（张）的电路原理图组成的集合。 每个 KiCad 原理图文件代表一个单页。 层次式原理图 是由多个页面相互嵌套而成的原理图。 KiCad 支持层次原理图，但在层次结构的顶部必须有一个 根页 面。 史上称为 PcbNew）是独立的应用程序，没有直接的联系，为了根据原理图创建 PCB，用户必须在 Eeschema 中生 成一个网表文件，然后在 PcbNew 中读取这个网表文件。 在现代版本的 KiCad 中，原理图和 PCB 编辑器被集成到 5 KiCad 工程管理器中，使用网表文件不再是必需的。 许多教程仍然存在参考旧的 KiCad 工作流程的独立应用程序和 网表文件，所以在查看教程

对 KiCad 的特殊术语。 本节列 出了 KiCad 文档和用户界面中最常用的一些术语。 其他针对 KiCad 工作流程的某一部分的术语将在本手册的后面进 行定义。 一个 原理图 是由一页或多页（张）的电路原理图组成的集合。 每个 KiCad 原理图文件代表一个单页。 层次原理图 是由多个页面相互嵌套而成的原理图。 KiCad 支持层次原理图，但在层次结构的顶部必须有一个 根原理 图。 史上称为 PcbNew）是独立的应用程序，没有直接的联系，为了根据原理图创建 PCB，用户必须在 Eeschema 中生 成一个网表文件，然后在 PcbNew 中读取这个网表文件。 在现代版本的 KiCad 中，原理图和 PCB 编辑器被集成到 6 KiCad 工程管理器中，使用网表文件不再是必需的。 许多教程仍然存在参考旧的 KiCad 工作流程的独立应用程序和 网表文件，所以在查看教程

对 KiCad 的特殊术语。 本节列 出了 KiCad 文档和用户界面中最常用的一些术语。 其他针对 KiCad 工作流程的某一部分的术语将在本手册的后面进 行定义。 一个 原理图 是由一页或多页（张）的电路原理图组成的集合。 每个 KiCad 原理图文件代表一个单页。 层次原理图 是由多个页面相互嵌套而成的原理图。 KiCad 支持层次原理图，但在层次结构的顶部必须有一个 根原理 图。 史上称为 PcbNew）是独立的应用程序，没有直接的联系，为了根据原理图创建 PCB，用户必须在 Eeschema 中生 成一个网表文件，然后在 PcbNew 中读取这个网表文件。 在现代版本的 KiCad 中，原理图和 PCB 编辑器被集成到 6 KiCad 工程管理器中，使用网表文件不再是必需的。 许多教程仍然存在参考旧的 KiCad 工作流程的独立应用程序和 网表文件，所以在查看教程