使用库管理器添加表条目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.3.5 环境变量替代 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 本地打印输出。 1.3 一般建议 由于必要的控制程度，强烈建议使用带有 pcbnew 的 3 键鼠标。平移和缩放等许多功能都需要 3 键鼠标。 在 KiCad 的新版本中，pcbnew 已经从 CERN 的开发人员那里看到了广泛的变化。这包括诸如新渲染器（OpenGL 和 Cairo 视图模式），交互式推送布线器，差分和曲折布线和调整，重新设计的封装编辑器以及许多其他功能等功能。 请注意，大多数这些新功能 支持几种库，每种都由“插件”支持： • KiCad - 以 .pretty 格式存储在本地文件系统上的本机 KiCad 封装库（包含 .kicad_mod 文件的文件夹） • Github - .pretty 格式的原生 KiCad 封装库，作为 Github 存储库在线存储 Pcbnew 4 / 163 • 旧版 - 旧式 KiCad 封装库（.mod 文件） • Eagle - Eagle 封装库（包含

本地打印输出。 1.3. 一般建议 由于必要的控制程度，强烈建议使用带有 pcbnew 的3键鼠标。 平移和缩放等 许多功能都需要3键鼠标。 在 KiCad 的新版本中，pcbnew 已经从 CERN 的开发人员那里看到了广泛的变 化。 这包括诸如新渲染器（OpenGL 和 Cairo 视图模式），交互式推送布线 器，差分和曲折布线和调整，重新设计的封装编辑器以及许多其他功能等功 能。 请注意，大多数这些新功能 支持几种库，每种都由“插件”支持： KiCad - 以 .pretty 格式存储在本地文件系统上的本机 KiCad 封装库（包含 .kicad_mod 文件的文件夹） Github - .pretty 格式的原生 KiCad 封装库，作为 Github 存储库在线存储 旧版 - 旧式 KiCad 封装库（.mod 文件） Eagle - Eagle封装库（包含 .fp 文件的文件夹） Geda-PCB 可以定义为绝对，相对或环境变量替换（见下文） 必须选择适当的插件类型才能使库成为必需的。必须选择适当的插件类型 才能正确读取库。阅读。 还有一个描述字段用于添加库条目的描述。 选项字段包含特定于插件的特殊 选项，通常为空白。 虽然在同一个表中不能有重复的库昵称，但是在全局和项目特定的封装库表中 都可以有重复的库昵称。 当出现重复的名称时，项目特定的表条目将优先于 全局表条目。 2.3.5. 环境变量替代

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 5.1.5 环境变量替代 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 6.3 开发链 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 每个图书馆条目必须有一个独特的昵称。 这不必以任何方式与实际库文件名或路径相关。冒号“:”和“/”字符不能在库昵称中的任何位置使用。每个库条目 必须具有有效的路径和/或文件名，具体取决于库的类型。路径可以定义为绝对，相对或环境变量替换（参见下面的部 分）。 必须选择适当的插件类型才能正确读取库。KiCad 目前仅支持旧版符号库文件插件。 还有一个描述字段用于添加库条目的描述。此时不使用选项字段，因此在加载库时添加选项将不起作用。

变量 定义路径。 一些环境变量由 KiCad 在 内部定义，可用于定义库，3D 形状等的路径。 当绝对路径未知或可能发生变化时（例如，当您将工程传输到另一台计算机 时），以及许多类似工程共享一个基本路径时，这非常有用。 请考虑以下可 能安装在不同位置的内容： Eeschema 元件库 Pcbnew 封装库 封装定义中使用的 3D 形状文件 例如，使用 KISYSMOD 环境变量时，connect 环境变量时，connect.pretty 封装库的路径将被定义为 ${KISYSMOD}/connect.pretty 此选项允许您使用环境变量定义路径，并根据需要添加您自己的环境变量以定 义个人路径。 KiCad 环境变量： KICAD_PTEMPLATES 工程创建期间使用的模板（ 5.0.0-rc2 版本开 始已经弃用 ，改为使用 KICAD_TEMPLATE_DIR）。 如果您使用此 变量，则必须定义它。 如果在封装库名 称中未使用绝对路径，则必须定义。 KICAD_TEMPLATE_DIR 使用 KiCad 安装的模板的位置。 KICAD_USER_TEMPLATE_DIR个人模板的位置。 另请注意，环境变量 KIPRJMOD 始终由 KiCad 内部定义，并且是 当前工程 绝对路径。 例如，${KIPRJMOD}/connect.pretty 总是在 connect.pretty 文件夹（漂亮的封装

fp-lib-table）：第一个（位于用户主目录中）对于所有工程都是全局的， 第二个（位于工程目录中）是可选的，专用于工程。 2.4 路径配置 在 KiCad 中，可以使用 environment 变量定义路径。一些环境变量由 KiCad 在内部定义，可用于定义库，3D 形状等 的路径。 KiCad 5 / 20 当绝对路径未知或可能发生变化时（例如，当您将工程传输到另一台计算机时），以及许多类似工程共享一个基本路 Pcbnew 封装库 • 封装定义中使用的 3D 形状文件 例如，使用 KISYSMOD 环境变量时，connect.pretty 封装库的路径将被定义为 ${KISYSMOD}/connect.pretty 此选项允许您使用环境变量定义路径，并根据需要添加您自己的环境变量以定义个人路径。 KiCad 环境变量： KICAD_PTEMPLATES工程创建期间使用的模板（5.0.0-rc2 版本开始已经弃用，改为使用 封装库文件夹的基本路径，如果在封装库名称中未使用绝对路径，则必须定义。 KICAD_TEMPLATE_DIR 使用 KiCad 安装的模板的位置。 KICAD_USER_TEMPLATE_DIR 个人模板的位置。 另请注意，环境变量 KIPRJMOD 始终由 KiCad 内部定义，并且是 当前工程绝对路径。 例如，${KIPRJMOD}/connect.pretty 总是在 connect.pretty 文件夹（漂亮的封装库）中找到的

这不必以任何方式与实际库文件名或路径相关。 冒号 “:” 和 “/” 字符不能在库 昵称中的任何位置使用。 每个库条目必须具有有效的路径和/或文件名，具体 取决于库的类型。 路径可以定义为绝对，相对或环境变量替换（参见下面的 部分）。 必须选择适当的插件类型才能正确读取库。 KiCad 目前仅支持旧版符号库文件 插件。 还有一个描述字段用于添加库条目的描述。 此时不使用选项字段，因此在加 载库时添加选项将不起作用。 5.1.5. 环境变量替代 符号库表的最强大功能之一是环境变量替换。 这允许定义符号库存储在环境 变量中的自定义路径。 使用库路径中的语法 ${ENV_VAR_NAME} 支持环境变 量替换。 默认情况下，在运行时 KiCad 定义 两个环境变量 ： KIPRJMOD 环境变量，始终指向当前打开的项目目录。 KIPRJMOD 无法修 改。 KICAD_SYMBOL_DIR 环境变量。 这指向使用 网表和网络文件，生成网表），用于传输到 PCB 布局。 原理图主要由符号，电线，标签，连接点，总线和电源端口组成。 为了清晰 起见，您可以放置纯粹的图形元素，如总线条目，注释和折线。 6.3. 开发链 符号从符号库添加到原理图中。 在制作原理图之后，生成一个网表，稍后用 于将连接和封装集导入 PcbNew。 6.4. 符号放置和编辑 6.4.1. 找到并放置一个符号 要将符号加载到原理图中，可以使用图标

模拟器。 KiCad 可在所有主要的操作系统和广泛的计算机硬件上运行。 它支持多达 32 个铜层的 PCB，适合创建各种复杂的设 计。 KiCad 是由世界各地的软件和电气工程师组成的志愿者团队开发的，其使命是创建适合专业设计师的免费和开 源的电子设计软件。 该文件的最新版本可在 https://docs.kicad.org 。 系统要求 KiCad 能够在多种硬件和操作系统上运行，但 设置》一节)。如果您在一台计算机上以您喜欢的方式配置了 KiCad 快捷键，则可以通过导入适当的 .hotkeys 文件 将该配置传输到另一台计算机。 15 路径配置 在 KiCad 中，人们可以使用 环境变量 定义路径。 一些环境变量是由 KiCad 内部定义的，可以用来定义库、3D 形状 等的路径。 当绝对路径未知或可能发生变化时（例如，当您将工程传输到另一台计算机时），以及许多类似工程共享一个基本路 径时，这非常有用。 ${KICAD7_FOOTPRINT_DIR}/connect.pret 。 在 偏好设置 → 配置路径… 菜单中，您可以为一些内置的 KiCad 环境变量定义路径，如果需要，还可以添加自己的环 境变量来定义个人路径。 KiCad 环境变量 KICAD7_3DMODEL_DIR Base path of KiCad’s standard 3D footprint model library

模拟器。 KiCad 可在所有主要的操作系统和广泛的计算机硬件上运行。 它支持多达 32 个铜层的 PCB，适合创建各种复杂的设 计。 KiCad 是由世界各地的软件和电气工程师组成的志愿者团队开发的，其使命是创建适合专业设计师的免费和开 源的电子设计软件。 该文件的最新版本可在 https://docs.kicad.org 。 系统要求 KiCad 能够在多种硬件和操作系统上运行，但 配置了 KiCad 快捷键，则可以通过导入适当的 .hotkeys 文件 将该配置传输到另一台计算机。 路径配置 在 KiCad 中，可以使用 environment 变量 定义路径。 一些环境变量由 KiCad 在内部定义，可用于定义库，3D 形状 等的路径。 当绝对路径未知或可能发生变化时（例如，当您将工程传输到另一台计算机时），以及许多类似工程共享一个基本路 径时，这非常有用。 ${KICAD6_FOOTPRINT_DIR}/connect.pretty . 在 偏好设置 → 配置路径… 菜单中，您可以为一些内置的 KiCad 环境变量定义路径，如果需要，还可以添加自己的环 境变量来定义个人路径。 KiCad 环境变量： KICAD6_3DMODEL_DIR Base path of 3D models used in footprints. KICAD6_3RD_PARTY

KiCad 功能的框架。 使用插件的一个 主要优点是在开发插件时没有必要重建 KiCad 套件; 事实上，可以借助 KiCad 源代码树中的一小组标题构建插件。 通过确保开发人员仅编译与正在开发的 插件直接相关的代码，从而减少每个构建和测试周期所需的时间，在插件开发 期间删除构建 KiCad 的要求极大地提高了工作效率。 插件最初是为 3D 模型查看器开发的，因此可以支持更多类型的 3D 模型，而 无需对支持的每种新模型类型的 无需对支持的每种新模型类型的 KiCad 源进行重大更改。 插件框架后来被推 广，以便将来开发人员可以创建不同类型的插件。 目前，只有 3D 插件在 KiCad 中实现，但可以想象最终将开发 PCB 插件，以使用户能够实现数据导 入器和导出器。 1.1. 插件类 插件分为插件类，因为每个插件都解决了特定域中的问题，因此需要该域独有 的接口。 例如，3D 模型插件从文件加载 3D 模型数据并将该数据转换为可由 模型数据并将该数据转换为可由 3D 查看器显示的格式。 PCB 导入/导出插件将获取 PCB 数据并导出为其他电 气或机械数据格式，或将外部格式转换为 KiCad PCB。 目前只开发了 3D 插件 类，它将成为本文档的重点。 实现插件类需要在 KiCad 源代码树中创建代码来管理插件代码的加载。在 KiCad 源代码树中，文件 ‘plugins/ldr/pluginldr.h’ 声明了所有插件加载器的基 类。这个类声明了我们期望在任何

KiCad 功能的框架。使用插件的一个主要优点是在开发插件时没有必要重建 KiCad 套件; 事实上，可以借助 KiCad 源代码树中的一小组标题构建插件。通过确保开发人员仅编译与正在开发的插 件直接相关的代码，从而减少每个构建和测试周期所需的时间，在插件开发期间删除构建 KiCad 的要求极大地提高 了工作效率。 插件最初是为 3D 模型查看器开发的，因此可以支持更多类型的 3D 模型，而无需对支持的每种新模型类型的 模型，而无需对支持的每种新模型类型的 KiCad 源进行重大更改。插件框架后来被推广，以便将来开发人员可以创建不同类型的插件。目前，只有 3D 插件在 KiCad 中实现，但可以想象最终将开发 PCB 插件，以使用户能够实现数据导入器和导出器。 1.1 插件类 插件分为插件类，因为每个插件都解决了特定域中的问题，因此需要该域独有的接口。例如，3D 模型插件从文件加 载 3D 模型数据并将该数据转换为可由 模型数据并将该数据转换为可由 3D 查看器显示的格式。PCB 导入/导出插件将获取 PCB 数据并导出为其他 电气或机械数据格式，或将外部格式转换为 KiCad PCB。目前只开发了 3D 插件类，它将成为本文档的重点。 实现插件类需要在 KiCad 源代码树中创建代码来管理插件代码的加载。在 KiCad 源代码树中，文件‘plugins/ldr/- pluginldr.h’声明了所有插件加载器的基类。这个类声明了我们期望在任何