从这里开始
从 KiCad 迁移
agentee 从 KiCad 继承的内容及其不同之处:导入的库、导入整个电路板,以及概念映射。
agentee 不是具有不同文件格式的 KiCad 替代品。它是为智能体设计的设计工具,借用 KiCad 的库并读取 KiCad 的电路板。如果你熟悉 KiCad,大多数概念都可以沿用;变化的是文件即接口,人通过智能体和查看器而不是编辑器进行编辑。
库
agentee 没有自己的元件库。agentee search 和 agentee import 从以下位置读取 KiCad 符号和封装库:
- Linux 上的
/usr/share/kicad和/usr/local/share/kicad, - macOS 上的
/Applications/KiCad/KiCad.app/Contents/SharedSupport, - 其他任何地方,包括 Windows,使用
KICAD9_SYMBOL_DIR和KICAD9_FOOTPRINT_DIR。KICAD8_*和KICAD_*也有效。
agentee search symbol lm358
agentee import symbol Amplifier_Operational:LM358 --with-footprint
agentee import footprint Package_TO_SOT_SMD:SOT-89-3导入将 .sym.toml 或 .fp.toml 写入 symbols/ 或 footprints/。从此项目拥有它:没有与库的链接,因此当 KiCad 更新时元件不会在你脚下改变。.kicad_sym 或 .kicad_mod 路径可以代替 Library:Name 用于标准库之外的元件。
3D 模型来自 KICAD9_3DMODEL_DIR 等、项目中的 3dmodels/,或 agentee models 从 kicad-packages3D 仓库填充的缓存。
概念如何映射
| KiCad | agentee |
|---|---|
.kicad_pro 电路板设置:层、规则、网络类 | *.board.toml:板厂预设、叠层预设、[rules]、[[netclasses]]、[[vias]] |
| 符号库条目 | *.sym.toml,每个符号一个 |
| 封装 | *.fp.toml,用焊盘行代替每个焊盘一个条目 |
| 带连线的原理图页 | *.sch.toml:元件和网络作为引脚列表;连线可选 |
| 层次化原理图页 | 顶层原理图中的 sheets = [...],网络按名称连接 |
.kicad_pcb | *.pcb.toml:放置、走线、过孔、铺铜、丝印 |
| DRC | agentee check,所有规则可通过 agentee drc NAME --list 列出 |
| 铺铜填充 | 加载时自动执行并缓存;agentee fill 将其存入文件 |
| 输出 Gerber 和钻孔文件 | agentee fab |
封装字段 mpn、lcsc | 原理图元件上的相同字段,由 BOM 和 agentee parts 读取 |
行为不同的地方:
- 网络类宽度是最小值。在 KiCad 中,类宽度是新走线的默认值;在 agentee 中,比其网络类窄的走线是错误,除非它是进入焊盘的短颈缩。
- 阻抗和电流位于网络类上。给网络类设置
impedance = "50ohm"或current = "2A",检查会为叠层的每一层求解宽度。 - 叠层是板厂自己的。从
agentee stackups中选择JLC04161H-7628或 PCBWay 的构建,而不是手动输入厚度。 - Y 轴向下增长,在所有文件中均如此,与 KiCad 的封装编辑器相同,且屏幕上的旋转方向为逆时针。
- 未知键是错误。键名拼写错误会被报告,而不是被忽略。
- 每块电路板都在丝印上带有版本水印:agentee 版本和构建板厂文件的提交。
导入整块电路板
agentee import board path/to/NAME.kicad_pcb --dir NAME
cd NAME
agentee check
agentee render pcb:NAME -o NAME.png导入会写入:
| 文件 | 来源 |
|---|---|
NAME.board.toml | Edge.Cuts 轮廓及其切口、带厚度、介电常数和损耗因子的叠层、表面处理颜色和阻焊颜色、来自 NAME.kicad_pro 的设计规则和网络类 |
NAME.pcb.toml | 封装放置、走线(圆弧作为短段)、过孔和铺铜及其存储的填充,以及丝印和板厂文本和线条,其中 ${TITLE} 和项目文本变量已填充 |
NAME.sch.toml | 每个元件及其值,每个网络作为引脚列表,使用网络标签绘制 |
footprints/ | 每个封装在电路板上的状态,底部封装翻转回顶部 |
symbols/ | 每个封装一个框形符号,每个焊盘编号一个引脚 |
原理图是网表,不是你的绘图:KiCad 的原理图不会被读取,因此引脚名称、符号图形和页结构不会保留。这足以检查、渲染、模拟和制造电路板,并让智能体更改 PCB 布局。
过孔保留其类型。KiCad 的 micro 过孔变为微过孔,blind 根据其跨度变为盲孔或埋孔,每个不同的钻孔、焊盘、跨度、填充和背钻成为电路板过孔类型。坐标移动使轮廓从 0, 0 开始。
遗漏并报告的:泪滴、禁布区,以及轮廓外 Edge.Cuts 中的环路。走线比其宽度窄的类采用最窄的一个,因为 agentee 将宽度视为最小值。间距使用 KiCad 的 0.5 um 容差进行检查。
在 KiCad 自己的 video 和 complex_hierarchy 演示中,导入布局的每个焊盘都落在 KiCad 的 IPC-D-356 导出放置的位置:2089 和 165 个焊盘。HackRF Pro 示例 是以这种方式导入的完整电路板。
返回
没有导出到 KiCad 文件的功能。从 agentee 输出的是板厂文件(带 X2 属性的 Gerber、Excellon 钻孔、BOM、放置和 IPC-D-356 网表)以及组装电路板的 STEP,任何板厂和任何 MCAD 工具都可以读取。