kicad-circuit-design
下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/user_cf334712--kicad-circuit-design.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_cf334712/kicad-circuit-design。- KiCad 电路原理图与 PCB 设计 一句话简介 根据电路需求描述 / 元件清单 / 网表,自动生成可直接用 KiCad 打开的 .kicad_sch 原理图和 .kicad_pcb PCB 工程文件,并完成 ERC/DRC 检查与 Gerber / BOM / PDF / SVG 导出。 技能简介 本技能通过 Python 脚本调用本机 KiCad 安装…
- 一段电路需求"
- 到"
- 完整 KiCad 工程文件"
- 的全流程自动化。无需手动画原理图、布 PCB,把电路描述写成 JSON,脚本自动完成模块化布局、网络连接、ERC/DRC 自检和制板文件导出。 核心能力 原理图生成:从 JSON 电路描述生成 .kicad_sch,符号 / 网络标签 / 标注 / 模块化自动布局(按电源、主控、信号、接口等模块分区摆放,模块间虚线边框 + 名称) PCB 生成:从同一份 J…
- 我的电路"
- …(完整说明见下方「阅读全文」)
阅读全文 (展开查看完整说明)
概述
KiCad 电路原理图与 PCB 设计
概述
本技能通过 Python 脚本调用本机 KiCad 安装,实现从电路需求描述到完整 KiCad 项目文件的自动化生成。支持原理图绘制、PCB 布局、ERC/DRC 检查、Gerber/BOM/PDF/SVG 导出全流程。
核心能力:
- 先设计、后绘图(强制关卡):无论用户是否提供参考文件(PDF/XLS/网表),
一律先基于需求产出电路设计文档 md(架构框图、模块划分、选型、电源树、接口分配、关键参数),用户确认设计方案后再动手画图。有参考文件 → 文档复刻原设计并标注来源;无参考文件 → 文档从需求推导完整方案。防止方向不对导致返工。
- 从 JSON 电路描述生成
.kicad_sch原理图(符号、网络标签、标注、ERC 自检) - 模块化自动布局:按功能模块(groups)分区摆放,元件按符号实际尺寸排列不重叠,
模块间留间距并画虚线边框 + 模块名
- 原理图重排版(reflow):把 AI 生成/导入的杂乱
.kicad_sch重新排版成整洁、
按功能模块分区的专业原理图,保留原有电气连接与导线(重新正交布线),并自动ERC 验证电气正确性
- 层次化原理图:大型多模块载板拆成根图纸 + 子图(sheet),层次标签路由,
逐子图填充(build_*.py 脚本模式),每张画完给用户确认
- 画完原理图自动生成 Markdown 技术文档(BOM 表、网络连接表、引脚明细、ERC 结果)
- 从 JSON 电路描述生成
.kicad_pcbPCB 文件(封装内嵌、网络分配、板框、DRC 自检) - 运行 kicad-cli 的 ERC/DRC 检查
- 导出 Gerber、钻孔文件、BOM、PDF、SVG、网表、STEP 模型
- 符号库/封装库查找与映射
前置条件
本机已安装 KiCad(推荐 10.0+),kicad-cli 可被脚本自动探测。脚本会自动查找以下位置:
- Windows:
C:Program FilesKiCad<版本>binkicad-cli.exe - macOS:
/Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli - Linux:
/usr/bin/kicad-cli
无需手动配置环境变量——脚本会探测 KiCad 安装路径并使用绝对路径。
层次化原理图(大型多模块工程)
单页 JSON 适合中小规模电路。当电路规模较大(多模块载板、几十上百个元件、多个外设接口)时,用层次化原理图:根图纸 + 多个子图,每个模块一个子图文件,独立编辑、并行填充、层次标签路由解耦。
适用场景:工业载板(电源/核心/显示/隔离通讯/串口/USB/音频/IO 八大模块)、ARM 核心板 + 多外设扩展等。
推荐模块划分(8 大模块):
| 子图 | 内容 |
|---|---|
| 01_Power | 三路输入(USB-C/电池/太阳能)、DC-DC、电压监控 |
| 02_Core | 主控、DDR、eMMC、时钟、复位 |
| 03_Display / 04_IsoCom / 05_UART | LCD / CAN·RS485 / RS232·调试串口 |
| 06_USB / 07_Audio / 08_IO | Type-C+USB / 功放+喇叭 / 按键·指示灯·蜂鸣器 |
核心流程(详见 references/hierarchical-workflow.md):
① 建骨架:create_project.py + 生成空子图(含 passive 电源标签 + input 信号标签)
② 根图纸 sheet 引脚路由:根图纸内用同名 local net label 桥接 Core 输出与外设 input
③ 逐子图填充:每个子图一个 build_*.py 脚本,复用本技能公共库
(实例化元件 → 计算引脚世界坐标 → 网络表 → 标签四类锚点 → 模块边框)
④ ERC 分层验证:单子图 standalone ERC 看 pin_not_connected;最终以整图 ERC 为准
⑤ SVG 导出 + Chrome headless 渲染 PNG 预览,向用户确认逐子图交付节奏:先全部生成骨架让用户看到整体框架 → 用户确认后逐个填充子图(每张画完给用户确认)→ 全部完成后整图 ERC + 导出 SVG/PDF/BOM 收尾。
快速开始
完整流程(推荐)——先设计文档,用户确认后再画
铁律:任何画图/建工程动作之前,必须先产出设计文档并等用户确认。
用户说"直接画"也不行——除非他明确看过设计方案。因为不知道是否符合需求就
往下画,方向错了整张图全白费。
步骤 0(强制前置):需求 → 设计文档 → 用户确认
0a 收集需求:听用户口述,或读取参考文件(PDF/XLS/网表/图片,可多份)
0b 产出「电路设计文档.md」(见下方「设计文档必备内容」)
0c 呈现给用户审阅,等确认(确认后才进入步骤 1)
- 有参考文件:文档逐模块复刻原设计,标注来源页码/表单
- 无参考文件:文档从需求推导完整方案(选型/电源树/接口分配/关键参数)
0d 用户提出修改 → 更新文档再确认;确认后锁定方案
步骤 1:创建项目骨架
python scripts/create_project.py ./myproject --name myproject --title "我的电路"
步骤 2:把确认后的设计方案写成电路描述 JSON(见下方格式说明)
步骤 3:生成原理图
python scripts/build_schematic.py ./myproject design.json
步骤 4:生成 PCB
python scripts/build_pcb.py ./myproject design.json --board-w 50 --board-h 30
步骤 5:检查与导出
python scripts/run_checks.py ./myproject erc
python scripts/run_checks.py ./myproject drc
python scripts/run_checks.py ./myproject gerber
python scripts/run_checks.py ./myproject all设计文档必备内容(步骤 0b 必须覆盖)
- 需求摘要:用户要什么、有哪些约束(成本、尺寸、供电、接口、认证)
- 系统架构框图:模块划分 + 模块间关系(可 mermaid / SVG 可视化)
- 模块与选型表:每个模块的核心器件型号、来源(参考文件页码 / 需求推导)、
替代选型建议
- 电源树:各路电压 / 电流 / 拓扑(降压/升压/隔离),功耗估算
- 接口分配:主控引脚到各外设的映射(如有引脚列表)
- 关键参数:通信速率、隔离等级、ESD 防护、关键 RC 取值等
- 待确认项:设计假设 / 需用户拍板的取舍点,明确列出
参考:
references/design-workflow.md有完整设计指南;本次 RK3506 载板示例的设计文档见
examples/design-rk3506-carrier.md(含examples/rk3506-architecture.svg架构框图,示范"有参考文件 → 设计文档"的写法)。
电路描述 JSON 格式
{
"title": "LED 指示灯电路",
"company": "MyCompany",
"revision": "1.0",
"paper": "A4",
"groups": [
{"name": "指示", "refs": ["R1", "LED1"]}
],
"components": [
{
"ref": "R1",
"lib": "Device",
"symbol": "R",
"value": "10k",
"footprint": "Resistor_SMD:R_0402_1005Metric",
"at": [101.6, 101.6]
},
{
"ref": "LED1",
"lib": "Device",
"symbol": "LED",
"value": "红色",
"footprint": "LED_SMD:LED_0603_1608Metric",
"at": [127.0, 101.6]
}
],
"nets": [
{
"name": "NET_LED",
"connections": [
{"ref": "R1", "pin": "1"},
{"ref": "LED1", "pin": "1"}
]
}
]
}字段说明:
groups[]: 大类模块分组(推荐)——实现"一个模块一个地方"的整齐布局。
模块按大类划分:电源模块 / 主控模块 / 信号处理模块 / 接口模块等,不要把一个电源芯片拆成五六个小模块。
name: 模块名(显示在原理图虚线边框左上角,支持中文)refs[]: 属于该模块的元件编号列表,组内排列顺序 = refs 列表顺序- 每个模块独占一行区域,组内元件按符号实际尺寸(边界框)排列、垂直居中对齐,
模块间垂直间距 25.4mm,画虚线边框
- 组内列出的元件一律自动布局(忽略其
at);未分组的元件:有at保持不动,
无 at 归入末尾匿名组自动排列(不画边框)
- 不写
groups时自动按符号类型归入默认大类(电源/主控/信号/接口/驱动/无源),
并回写 design.json 供文档/PCB 使用;不想自动归类才需显式提供
- 完整示例见
examples/design_laser_comm.json(电源/主控/信号处理/接口四大模块) components[]: 元件列表ref: 元件编号(R1, C1, U1, #PWR01…)lib: 符号库名(Device, power, Connector, Diode, LED, Transistor_FET…)symbol: 符号名(R, C, LED, GND, VCC…)value: 参数值(10k, 100nF, 红色…)footprint: 封装(格式库名:封装名,如Resistor_SMD:R_0402_1005Metric)at: 元件中心坐标 [x, y](mm,建议落在 1.27mm 网格上)rotation: 旋转角度(0/90/180/270)。可选——不写则自动水平横放
(Device:R/C 等竖放符号自动转 90° 横放,LED/二极管等本就横放的保持 0°);显式指定则尊重用户选择(写 0 可强制竖放)
pcb_at: PCB 上的位置(可选,不指定则自动排列)nets[]: 网络连接name: 网络名connections[]: 引脚连接列表 [{ref, pin}]
原理图重排版(reflow)
把一份已有的、杂乱的 .kicad_sch(AI 生成、手动导入或其它工具导出)重排成整洁、按功能模块分区的专业原理图。保留原有电气连接与导线——不收敛为纯网络标签,而是重新正交布线。
# 单页重排 + 自动 ERC 验证(输出 <input>_reflow.kicad_sch)
python scripts/reflow_schematic.py ./project/messy.kicad_sch
# 指定输出文件 / 项目目录(ERC 需要 .kicad_pro)
python scripts/reflow_schematic.py messy.kicad_sch
--output ./project/clean.kicad_sch --project-dir ./project
# 手动指定模块分组(否则按符号类型自动归入电源/主控/信号/接口/驱动/无源)
python scripts/reflow_schematic.py messy.kicad_sch --groups groups.jsonreflow 做什么:
- 完整解析现有原理图:元件、导线、网络标签、全局标签、层级标签、电源符号、连接点、
No-Connect、文字/矩形/折线/圆弧等图形注释
- 从导线 + 标签 + 连接点 + 电源符号构建连通性网表(并查集),**跨行网络用同名
网络标签桥接**(避免长导线交叉短路)
- 元件按功能模块分组(复用
auto_classify大类:电源/主控/信号/接口/驱动/无源),
每模块独占一行区域并画虚线边框 + 模块名
- 元件在模块行内按符号实际边界框排列、互不重叠、垂直居中对齐
- 保留导线自动布线:对每个网络用 trunk-and-stub 正交布线器重新走线——行内网络
布一条水平干线(trunk),每个引脚经短垂直 stub 连到干线;跨模块网络在模块间布加长 trunk。每个网络独立轨道(间距 2.54mm)避免不同网络导线几何重叠短路,T 型连接点(stub 落在 trunk 上)由布线器直接生成 junction
- 回写
.kicad_sch,保留lib_symbols与所有非连接元素(文字/边框平移随动),
网格对齐到 1.27mm,然后自动运行 ERC 验证电气正确性
质量验证: 重排后用网表一致性工具对比 base 与 reflow 的电气连通性,确认每个引脚的网络归属完全一致、无短路、无断连:
# 输出 "✅ 每个引脚的归属网络一致" 即电气连通性完全保持
py -3.13 scripts/verify_reflow_netlist.py <base.kicad_sch> <reflow.kicad_sch>支持范围: 多页/层级原理图(对每个 .kicad_sch 文件独立重排,跨页通过global/hierarchical label 保持)。
查找可用符号与封装
# 在脚本中查找符号
import sys; sys.path.insert(0, "scripts")
import kicad_env as k
# 搜索符号
print(k.search_symbol("LED")) # -> ['Device:LED']
print(k.search_symbol("STM32")) # -> ['MCU_ST_STM32:STM32F103C8Tx']
# 搜索封装
print(k.search_footprint("R_0402")) # -> ['Resistor_SMD:R_0402_1005Metric']
# 列出库中所有符号
print(k.list_symbols("Device")) # -> ['R', 'C', 'L', 'LED', ...]
# 查看引脚信息
print(k.get_symbol_pins("Device", "R"))
# -> [{'number': '1', 'at': [0, 3.81, 270], 'length': 1.27}, ...]关键约束(经 KiCad 10.0.4 实测验证)
- 连接方式(build_schematic 从 JSON 生成):全网络标签(net label),零导线。
每个引脚(含电源引脚)旁放置与网络同名的 label,同名 label 即电气相连;不画任何 wire/junction。label 锚点与引脚电气点坐标重合即建立连接。这是build_schematic.py 的唯一连接方式(用户约定:连线错误率高、消耗 AI 资源多)。注意:reflow_schematic.py 恰恰相反——它针对已有原理图,是保留导线、重新正交布线的。 两种能力并存,勿混淆。
- power 符号不生成符号实例:KiCad 10 实测
power_in引脚(length=0)必须物理导线
才能建网,纯 label 锚点重合无效。因此 GND/VCC 等 power 库符号一律跳过实例化,电源网络统一由普通引脚处的同名 label 连接。
- 1.27mm 连接网格:原理图中元件中心、引脚、label 锚点必须落在 1.27mm(50mil)
网格上,否则 ERC 报 "off connection grid"。脚本会自动网格对齐。
- lib_symbols 命名:
lib_symbols中的符号名必须用完整lib_id(如Device:R),
与元件实例的 (lib_id "...") 匹配。
- 符号局部坐标系 y 轴向上:KiCad 符号定义(lib_symbols)的局部坐标系与原理图全局
坐标(y 向下)相反。计算引脚世界坐标时必须先翻转局部 y(dy = -dy)再按元件旋转平移,否则引脚电气点错位导致网表连错引脚。
- 引脚连接点:符号 pin 的
(at x y)位置即电气连接点本身,不是引脚线的端点。
label 必须精确放置在该坐标(沿引脚朝外方向)。
- PCB setup 精简:KiCad 10 的
(setup ...)块仅保留pad_to_mask_clearance和
allow_soldermask_bridges_in_footprints,旧版的 solder_mask_to_copper_clearance 等字段已移除,包含它们会导致加载失败。
- 文件格式版本:脚本自动从本机 KiCad 安装探测版本号,不硬编码。
- 元件默认水平横放:KiCad 内置
Device:R/Device:C等符号天生竖向
(pin1 上、pin2 下),脚本在未显式指定 rotation 时自动旋转 90° 转为横放;LED/二极管等本就横放的符号保持 0°。全部元件最终都横着排布,原理图更整齐、引脚 label 落在同一水平线上。想强制竖放时显式写 "rotation": 0 即可。
- 旋转公式(y 向下坐标系):元件实例
(at x y rot)的旋转按「显示坐标系
中逆时针」处理,pin 世界坐标公式为wx = dx·cos(r) + dy·sin(r); wy = -dx·sin(r) + dy·cos(r)(局部 y 先翻转)。用错矩阵(数学 y 向上坐标系)时,旋转 90° 元件的 pin1/pin2 左右对调,网表连错引脚——这是本轮实测抓到的坑。
- 模块化布局(用户约定:一个模块一个地方,且按大类划分):元件必须按功能
模块分组摆放,禁止无差别顺序排列;模块要按大类划分(电源模块 / 主控模块 /信号处理模块 / 接口模块),不要把一个电源拆成五六个小模块。脚本按符号定义中的图形元素(矩形/圆/折线/引脚)计算边界框(symbol_bbox),组内元件按实际尺寸排列(间距 7.62mm,互不重叠)、bbox 垂直中心对齐行中线;每模块一行区域 +虚线边框 + 模块名文字。布局起点 (40.64, 40.64),模块间垂直间距 25.4mm。design.json 未写 groups 时自动按符号类型归入默认大类(auto_classify_groups:电源/主控/信号/接口/驱动/无源),并回写 design.json。
- 未连接焊盘必须写
(net 0 ""):KiCad 10 中内联 footprint 的未连接 pad 必须
写作 (net 0 "")(带空名字符串)。裸 (net 0)(无名字符串)会导致该 footprint解析失败,进而整个 .kicad_pcb 无法加载,Gerber/钻孔/PDF/SVG/STEP 全部报"电路板加载失败"。带未连接引脚的元件(接插件空脚、SOT-223 散热 tab、未用电阻一端)会触发此坑。build_pcb.py 已用 ["net", 0, '""'] 正确生成。
- 层次图根图纸 sheet 引脚必须用 local net label 桥接,禁用 global label:
根图纸中要用同名 local net label((label ...))桥接 Core 输出引脚和外设子图input 引脚(sheet 引脚),建立层级电气通路。用 global label 会触发 ERCsame_local_global_label 冲突(一个网络既有 local 又有 global 标签)。
- 子图的每个接口标签必须在根图纸 sheet 声明对应 pin:子图的 input/passive
hierarchical_label 若在根图纸 sheet 符号里没有对应 (pin ...),根图纸报"无法连接"。
- 多引脚网络必须每个引脚都放 label(D24-D27 教训):一个网络若含多个引脚
在不同物理位置(如端子 pin1 + TVS 二极管 pin1),只把 label 放在一个锚点处,其他引脚会因没有同名标签而 ERC 报 pin_not_connected。KiCad 的 net label只覆盖一个节点,必须对锚点之外每个引脚世界坐标也放同名 net label。
- ERC 分层验证:单子图 standalone ERC 会出现大量预期噪音("无法连接到不存在
的父图纸"、"Input pin not driven"),不能作为真实电气判据。必须跑整图 ERC (kicad-cli sch erc ... 根图纸.kicad_sch)判定真实错误:pin_not_connected是真错误必须修;label_dangling/isolated_pin_label/lib_symbol_* 多为层次图桥接模式与库路径的已知噪音,可接受。
- 先设计文档、用户确认后画图(强制关卡,任何情况下不得跳过):无论用户
是否提供参考文件,第一步都是收集需求并产出「电路设计文档.md」(架构框图/模块划分/选型/电源树/接口分配/关键参数/待确认项),呈现给用户确认后才可进入建工程/画图阶段。有参考文件 → 逐模块复刻并标注来源;无参考文件 →从需求推导完整方案。用户说"直接画"但未看过设计文档时,仍先出文档请其确认。目的:避免方向错误导致整图返工。
脚本清单
| 脚本 | 用途 |
|---|---|
scripts/kicad_env.py | 公共库:环境探测、S-expression 解析、符号/封装提取、坐标工具 |
scripts/create_project.py | 创建项目骨架(.kicad_pro + sym-lib-table + fp-lib-table) |
scripts/build_schematic.py | 从 JSON 生成 .kicad_sch 原理图、运行 ERC、自动生成 md 技术文档 |
scripts/generate_doc.py | 从 JSON 生成 Markdown 技术文档(可独立运行) |
scripts/build_pcb.py | 从 JSON 生成 .kicad_pcb 并运行 DRC |
scripts/reflow_schematic.py | 原理图重排版:把杂乱 .kicad_sch 重排成模块化整洁原理图(保留导线)+ ERC 验证 |
scripts/verify_reflow_netlist.py | 重排质量验证:对比 base 与 reflow 的网表,确认电气连通性完全保持 |
scripts/run_checks.py | ERC/DRC 检查与 Gerber/BOM/PDF/SVG/网表/STEP 导出 |
参考文档
references/kicad-cli.md— kicad-cli 命令行参考references/file-formats.md— KiCad 10 文件格式要点references/design-workflow.md— 电路设计流程指南(含模块化布局、连线规则)references/reflow-workflow.md— 原理图重排版(reflow)指南与电气正确性保障references/hierarchical-workflow.md— 层次化原理图构建工作流(根图纸+子图、
层次标签路由、逐子图 build_*.py 脚本模板、标签四类锚点、ERC 分层验证、SVG/PNG 预览)