PCB 与硬件设计 / 系统课时

将符号封装库固定到工程

将符号封装库固定到工程

PCB 工程在本机正常、换电脑却找不到符号或封装,通常是库表仍指向个人电脑的绝对路径。本课以 KiCad 8、9 的项目级库配置为例,将自定义符号和封装收进工程目录,使用可迁移的相对路径,并通过独立环境验证库映射和器件版本是否可靠。

学习目标

  • 建立项目专用符号库、封装库及对应库表。
  • 使用 ${KIPRJMOD} 消除工程对本机绝对路径的依赖。
  • 检查符号、封装和 PCB 已放置器件的一致性,并完成跨电脑验证。

整理项目专用库

以一个包含自定义连接器的双层 PCB 项目 sensor-board 为例,先在工程根目录创建 libraries 文件夹,统一存放项目必须携带的库文件。

建议保留以下文件结构:

路径 用途
sensor-board.kicad_pro KiCad 工程配置
sensor-board.kicad_sch 原理图
sensor-board.kicad_pcb PCB 布局
sym-lib-table 项目级符号库表
fp-lib-table 项目级封装库表
libraries/ProjectSymbols.kicad_sym 项目专用符号库
libraries/ProjectFootprints.pretty/ 项目专用封装库目录

例如,自定义连接器符号命名为 Conn_04_Custom,封装文件命名为 Conn_04_Custom.kicad_mod。封装目录名必须以 .pretty 结尾,目录内的每个 .kicad_mod 文件对应一个封装。

KiCad 工程文件与项目级符号封装库的组织关系

如果原来的符号和封装存放在全局库中,应先复制到项目专用库,而不是直接修改 KiCad 安装目录中的官方库。

在 KiCad 的符号编辑器中,通过 文件 → 新建库 创建项目库,选择项目级库表,并保存为 libraries/ProjectSymbols.kicad_sym。随后从已有库复制需要的符号,粘贴到新库并保存。

在封装编辑器中同样通过 文件 → 新建库 创建项目专用封装库,选择项目级并保存到 libraries/ProjectFootprints.pretty。再将自定义封装复制并保存至该库。

不同 KiCad 版本及界面语言中的菜单文字可能略有差异,但创建库时必须选择项目级,而不是全局级。

配置工程级库表

KiCad 使用工程根目录中的 sym-lib-table 和 fp-lib-table 管理项目专用库。以下为配置文件示例,适用于 KiCad 8、9 的原生库格式。

sym-lib-table 的有效内容如下,文件名实际不包含开头空格:

scheme
(sym_lib_table
  (lib
    (name "ProjectSymbols")
    (type "KiCad")
    (uri "${KIPRJMOD}/libraries/ProjectSymbols.kicad_sym")
    (options "")
    (descr "Project-specific symbols")
  )
)

fp-lib-table 的有效内容如下:

scheme
(fp_lib_table
  (lib
    (name "ProjectFootprints")
    (type "KiCad")
    (uri "${KIPRJMOD}/libraries/ProjectFootprints.pretty")
    (options "")
    (descr "Project-specific footprints")
  )
)

这两个文件是完整的单库表示例。如果工程已有其他项目级库项,应保留原有条目,并在对应表中增加新库项,不能直接覆盖整个文件。

${KIPRJMOD} 由 KiCad 解析为当前工程目录。它并非操作系统普通环境变量,也不需要人工替换成 C: 盘路径。

使用 KiCad 图形界面维护库表时,可以分别打开原理图编辑器中的 偏好设置 → 管理符号库,以及封装编辑器中的 偏好设置 → 管理封装库,切换到项目专用库表进行核对。保存后检查工程根目录下的两个库表文件。

固定符号与封装映射

仅仅让库表能找到文件,还不代表所有器件已经使用项目库。需要检查原理图中每个自定义符号的库标识和封装属性。

打开原理图,选中连接器符号并按 E 进入符号属性,核对以下内容:

检查项 正确示例
符号库标识 ProjectSymbols:Conn_04_Custom
Footprint 属性 ProjectFootprints:Conn_04_Custom
符号引脚编号 1、2、3、4
封装焊盘编号 1、2、3、4

符号库标识由库昵称与符号名称构成,封装属性则由封装库昵称与封装名称构成。两者不要求名称相同,但必须指向实际存在的库对象。

已经放置在原理图中的符号可能仍引用旧库昵称。修改库表并不会自动把它们全部迁移到新库。应使用符号编辑器或原理图编辑器中的更改符号相关功能,将引用切换到项目库,再检查引脚编号、隐藏电源引脚和引脚类型是否符合原设计。

对于已经完成布局的 PCB,还要检查板上的封装是否需要更新。KiCad 会在 PCB 文件中保存封装几何数据,因此即使外部封装库丢失,已有 PCB 图形也可能正常显示;这并不能证明库配置正确。

例如,原理图引脚 1 是 VCC,封装焊盘 1 却连接到 GND,即使数量都是四个,映射依然存在严重错误。检查时应依据器件数据手册核对每个引脚编号及功能,不能只比较引脚和焊盘数量。

锁定器件版本与变更记录

KiCad 的库昵称不是版本号。同一个 ProjectFootprints:Conn_04_Custom 可以在不同时间包含不同的焊盘尺寸,所以必须把实际库文件纳入工程版本管理。

建议使用 Git 将 .kicad_sym、.kicad_mod、两个库表以及原理图和 PCB 文件一起提交。第一次提交可以标记为 pcb-library-v1,后续修改封装时通过 Git 差异记录变更。

每次修改自定义器件至少核对以下项目:

  • 符号引脚编号、名称和电气类型是否变化。
  • 焊盘编号、尺寸、间距、封装原点和方向是否变化。
  • 3D 模型路径是否仍依赖外部个人目录;自定义模型建议一并放入工程目录。
  • 原理图中已放置符号及 PCB 中已放置封装是否需要从库更新。

举例来说,连接器焊盘间距从 2.00 mm 调整为 2.54 mm,属于机械尺寸变化。修改库文件后应在 PCB 编辑器中执行 工具 → 从库更新封装,检查更新范围和预览结果,再重新确认板框、孔位与相邻器件间距。该操作不会仅因为库文件变化就自动发生。

在干净环境中验证迁移

验证时不能只在原电脑反复打开工程,因为全局库可能掩盖项目依赖缺失的问题。

  1. 保存并关闭 KiCad,将整个 sensor-board 工程文件夹复制到另一台安装兼容 KiCad 版本的电脑,或独立的测试环境。
  2. 通过复制后的 .kicad_pro 文件打开工程,不使用旧电脑上的最近文件入口。
  3. 在符号编辑器中选择 ProjectSymbols,确认 Conn_04_Custom 能找到并正常显示。
  4. 在封装编辑器中选择 ProjectFootprints,确认封装可打开,焊盘编号和间距正确。
  5. 在原理图中打开符号属性,确认封装属性引用项目库,并使用分配封装工具验证候选封装可找到。
  6. 从原理图执行 工具 → 从原理图更新 PCB,检查更新对话框中的错误和变化,并按实际需要决定是否应用。
  7. 分别运行原理图 ERC 与 PCB DRC,处理与库迁移有关的新错误;不能仅凭检查工具没有报错就认定物理引脚映射正确。

如果出现 library not found,先核对库表昵称和 ${KIPRJMOD} 路径,再检查库文件是否随工程复制。如果出现 footprint not found,检查 Footprint 属性中的库昵称、封装文件名及 .pretty 目录内文件是否一致。

如果封装可以打开但 PCB 焊盘位置未变化,说明现有板级封装可能尚未从库更新,需要明确执行更新并检查差异;不要通过删除、重新放置全部器件来解决。

验收标准是:在不依赖原电脑个人库的环境中,可以打开自定义符号和封装、解析全部项目级映射,并完成原理图到 PCB 的更新检查。 只有工程目录内的库文件、库表和已放置器件保持一致,交付给其他工程师的双层板工程才真正具备可复现性。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

将符号封装库固定到工程

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通