Empieza aquí
Si vienes de KiCad
Lo que agentee toma de KiCad y lo que hace de forma diferente: las bibliotecas de las que importa, la importación de una placa completa, y cómo se mapean los conceptos.
agentee no es un sustituto de KiCad con un formato de archivo diferente. Es una herramienta de diseño para agentes que toma prestadas las bibliotecas de KiCad y lee las placas de KiCad. Si conoces KiCad, la mayoría de los conceptos se trasladan; lo que cambia es que los archivos son la interfaz, y una persona edita a través de un agente y un visor, no a través de un editor.
Las bibliotecas
agentee no tiene su propia biblioteca de componentes. agentee search y agentee import leen las bibliotecas de símbolos y huellas de KiCad de:
/usr/share/kicady/usr/local/share/kicaden Linux,/Applications/KiCad/KiCad.app/Contents/SharedSupporten macOS,KICAD9_SYMBOL_DIRyKICAD9_FOOTPRINT_DIRen cualquier otro sitio, incluido Windows.KICAD8_*yKICAD_*también funcionan.
agentee search symbol lm358
agentee import symbol Amplifier_Operational:LM358 --with-footprint
agentee import footprint Package_TO_SOT_SMD:SOT-89-3Una importación escribe un .sym.toml o .fp.toml en symbols/ o footprints/. A partir de entonces el proyecto lo posee: no hay enlace de vuelta a la biblioteca, así que un componente nunca cambia bajo tus pies cuando KiCad se actualiza. Una ruta .kicad_sym o .kicad_mod funciona en lugar de Library:Name para componentes fuera de las bibliotecas estándar.
Los modelos 3D proceden de KICAD9_3DMODEL_DIR y similares, 3dmodels/ en el proyecto, o una caché que agentee models rellena desde el repositorio kicad-packages3D.
Cómo se mapean los conceptos
| KiCad | agentee |
|---|---|
Configuración de placa .kicad_pro: capas, reglas, clases de red | *.board.toml: preset de fabricante, preset de apilamiento, [rules], [[netclasses]], [[vias]] |
| entrada de biblioteca de símbolos | *.sym.toml, uno por símbolo |
| huella | *.fp.toml, con filas de pads en lugar de una entrada por pad |
| hoja de esquemático con cables | *.sch.toml: componentes y redes como listas de pines; cables opcionales |
| hojas jerárquicas | sheets = [...] en un esquemático superior, redes unidas por nombre |
.kicad_pcb | *.pcb.toml: colocaciones, pistas, vías, zonas, serigrafía |
| DRC | agentee check, con cada regla listada por agentee drc NAME --list |
| relleno de zona | automático al cargar, con caché; agentee fill lo guarda en el archivo |
| generar Gerbers y archivos de taladro | agentee fab |
campos de huella mpn, lcsc | los mismos campos en el componente del esquemático, leídos por la BOM y agentee parts |
Cosas que se comportan de forma diferente:
- Los anchos de clase de red son mínimos. En KiCad, el ancho de una clase es el valor predeterminado para las nuevas pistas; en agentee, una pista más estrecha que su clase es un error, a menos que sea un estrechamiento corto hacia un pad.
- La impedancia y la corriente viven en la clase. Da a una clase
impedance = "50ohm"ocurrent = "2A"y la verificación resuelve el ancho para cada capa del apilamiento. - Los apilamientos son los propios del fabricante. Elige
JLC04161H-7628o una construcción de PCBWay desdeagentee stackupsen lugar de escribir espesores. - Y crece hacia abajo en todos los archivos, como en el editor de huellas de KiCad, y la rotación es antihoraria en pantalla.
- Las claves desconocidas son errores. Un error tipográfico en una clave se informa, no se ignora.
- Cada placa lleva una marca de agua de versión en su serigrafía: la versión de agentee y el commit que construyó el paquete de fabricación.
Importar una placa completa
agentee import board path/to/NAME.kicad_pcb --dir NAME
cd NAME
agentee check
agentee render pcb:NAME -o NAME.pngLa importación escribe:
| archivo | de |
|---|---|
NAME.board.toml | el contorno de Edge.Cuts y sus recortes, el apilamiento con espesor, permitividad y tangente de pérdida, el acabado y el color de la máscara, las reglas de diseño y las clases de red de NAME.kicad_pro |
NAME.pcb.toml | colocaciones de huellas, pistas (arcos como segmentos cortos), vías y zonas con sus rellenos guardados, y el texto y las líneas de serigrafía y de fabricación, con ${TITLE} y las variables de texto del proyecto rellenas |
NAME.sch.toml | cada componente con su valor, y cada red como una lista de pines, dibujada con etiquetas de red |
footprints/ | cada huella tal como está en la placa, con las de la cara inferior volteadas de vuelta a la superior |
symbols/ | un símbolo de caja por huella, con un pin por número de pad |
El esquemático es una lista de redes, no tu dibujo: el esquemático de KiCad no se lee, por lo que los nombres de pines, el arte del símbolo y la estructura de hojas no se trasladan. Eso es suficiente para verificar, renderizar, simular y fabricar la placa, y para que un agente cambie el layout.
Las vías conservan su tipo. Una vía micro de KiCad se convierte en una microvía, blind en una vía ciega o enterrada según su alcance, y cada taladro, pad, alcance, relleno y retrotaladro distinto se convierte en un tipo de vía de placa. Las coordenadas se mueven para que el contorno comience en 0, 0.
Excluidos e informados: lágrimas, áreas de exclusión y bucles en Edge.Cuts fuera del contorno. Una clase cuyas pistas corren más estrechas que su ancho toma la más estrecha, ya que agentee trata el ancho como un mínimo. Los despejes se verifican con la tolerancia de 0,5 um de KiCad.
En las propias demostraciones de video y complex_hierarchy de KiCad, cada pad del diseño importado cae donde la exportación IPC-D-356 de KiCad lo coloca: 2089 y 165 pads. El ejemplo HackRF Pro es una placa completa importada de esta manera.
Volver atrás
No hay exportación a archivos de KiCad. Lo que sale de agentee es el paquete de fabricación (Gerbers con atributos X2, taladros Excellon, BOM, colocación y una lista de redes IPC-D-356) y un STEP de la placa ensamblada, que cualquier fabricante y cualquier herramienta MCAD lee.