关于 kicad-panelize
此技能使用 KiKit 指导 PCB 拼板,包括检查源板、设置拼板参数、生成并检查带版本的输出文件。它适用于准备 PCB 制造且需保留源文件的场景。
主要功能
- 01检查板框及边缘相关特征
- 02设置拼板布局和制造参数
- 03配置连接筋、工艺孔和基准点
- 04在 build 目录生成带版本的拼板
- 05验证拼板并渲染外观
适用场景
- 01准备 PCB 版图以供制造
- 02将多个电路板排列成拼板
- 03检查拼板几何形状和渲染结果
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ american-embedded/ kistack --skill kicad-panelize安装后在 Claude Code 中输入/kicad-panelize确认已加载。
详细介绍
PCB 拼板技能
设置
确保已安装 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 控制从上/下边伸出的连接桥数量。
- 数量设为零会取消对应方向的连接桥。
-
只有在必须排除选定线段或某一侧时,才使用标注连接桥。
-
必须根据每块板的几何形状和旋转角度推导需要保护的连接桥方向。切勿将“底部”或“右侧”硬编码为通用规则。
-
全局鼠咬孔切割方法会处理所有生成的切割路径,包括 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