kicad-panelize 是一个用于 PCB 拼板的技能,核心是借助 KiKit 将给定的 KiCad 电路板文件拼成面板。
用途 该技能面向需要将单块 PCB 拼板(panelization)的场景,输入为用户指定的源 .kicad_pcb 文件,输出为拼板后的 KiCad 电路板文件。
主要能力
- 定位并检查源 .kicad_pcb 文件,查看其板框(Edge.Cuts)、铜层、焊盘以及可能触及板边的元件,以识别邮票孔(castellations)、边缘连接器、天线、镀边(plated edges)等特征。
- 解析网格尺寸、间距、旋转、连接筋(tabs)、分离方式、边框(frame)以及制造商限制。
- 定位工具孔(tooling holes)与基准点(fiducials)相对于面板外框的位置。
- 生成严格 JSON 配置,并在 build 子目录中生成带版本号的拼板,不覆盖源文件。
- 在通知用户前检查生成的拼板,确保从板文件层面和渲染层面都正常。
使用方式 前置条件:确保已安装 KiKit,可用 kikit --version 验证。在添加参数前,需查看安装目录下的 resources/panelizePresets/default.json 和 panelize_ui_sections.py 作为依据。
流程:找到用户要求的源 .kicad_pcb 文件;检查其板文件、Edge.Cuts、铜层、焊盘和可能触及板边的元件;确定网格尺寸、间距、旋转、连接筋、分离、边框和制造商限制;定位工具孔与基准点;写出严格 JSON;在 build 子目录生成带版本号的拼板;检查生成结果后再通知用户。
推荐起始值:板间走线间隙 2mm;连接筋宽度 3mm;邮票孔钻径 0.5mm;邮票孔间距 0.8mm;邮票孔偏移 0mm;完整边框宽度 5mm;边框到阵列间隙 2mm;边框断开切割无;外框圆角半径 2mm;内部走线圆角半径 0.25mm;工具孔为三个 1.5mm 孔;工具孔钢网开窗启用;基准点为三个,1mm 铜、1mm 开窗;基准点锡膏开窗禁用。
KiKit 行为说明:source.type 为 "auto" 适用于普通单板文件;tabs.type 为 "spacing" 会对称放置连接筋,无法排除特定边;使用固定连接筋时,hcount 控制左右边缘伸出的连接筋,vcount 控制上下边缘伸出的连接筋,计数为零则抑制该对方向;当只需排除选定段或某一侧时,使用注释连接筋(annotation tabs);受保护的连接筋方向必须根据每块板的几何形状和旋转推导,不能硬编码为“底部”或“右侧”;全局邮票孔切割方法会处理所有生成的切割路径,包括 framing.cuts,因此 framing.cuts 为 "both" 配合邮票孔会打断穿过边框的排;使用 framing.cuts 为 "none" 可获得连续边框;工具孔和基准点偏移是从面板外边缘向内测量,要在 5mm 边框上居中,使用 2.5mm 垂直偏移;工具孔和基准点若数量和偏移相同会重叠,需沿边框分开;paste: true 表示该特征在钢网锡膏层上开窗,并不控制钻孔是否可见;framing.fillet 圆整面板外角;post.millradius 圆整内部走线的凹角;post.reconstructarcs: true 生成真实的 Edge.Cuts 圆弧,而非密集线段近似。
常用命令: python3 -m json.tool panelize.json kikit panelize -p panelize.json input.kicad_pcb output-panel.kicad_pcb 导出完整合并的 KiKit 配置: kikit panelize -p panelize.json -d resolved.json input.kicad_pcb output-panel.kicad_pcb 渲染并打开: kicad-cli pcb render --output panel-top.png --width 1600 --height 1200 --side top --background opaque --quality high panel.kicad_pcb kicad-cli pcb render --output panel-iso.png --width 1600 --height 1200 --perspective --rotate 325,0,35 panel.kicad_pcb
适用场景 适用于使用 KiCad 设计、需要将单板拼成面板以便制造或组装的 PCB 项目,尤其是涉及邮票孔、边缘连接器、天线、镀边等板边特征,以及需要工具孔、基准点和边框设计的场景。
限制 资料未提供该技能的具体安装方式、支持的 KiCad 版本范围、收费或价格信息、平台限制以及效果保证。使用前需自行确保 KiKit 已安装,并参考安装目录下的预设与脚本文件。