Commencer ici
Si vous venez de KiCad
Ce que agentee reprend de KiCad et ce qu'il fait différemment : les bibliothèques d'où il importe, l'importation d'une carte entière, et la correspondance des concepts.
agentee n'est pas un remplacement de KiCad avec un format de fichier différent. C'est un outil de conception pour agents qui emprunte les bibliothèques de KiCad et lit les cartes de KiCad. Si vous connaissez KiCad, la plupart des concepts s'appliquent ; ce qui change, c'est que les fichiers sont l'interface, et qu'une personne édite par le biais d'un agent et d'un visualiseur plutôt que par le biais d'un éditeur.
Les bibliothèques
agentee n'a pas de bibliothèque de composants propre. agentee search et agentee import lisent les bibliothèques de symboles et d'empreintes KiCad depuis :
/usr/share/kicadet/usr/local/share/kicadsur Linux,/Applications/KiCad/KiCad.app/Contents/SharedSupportsur macOS,KICAD9_SYMBOL_DIRetKICAD9_FOOTPRINT_DIRailleurs, y compris Windows.KICAD8_*etKICAD_*fonctionnent aussi.
agentee search symbol lm358
agentee import symbol Amplifier_Operational:LM358 --with-footprint
agentee import footprint Package_TO_SOT_SMD:SOT-89-3Une importation écrit un .sym.toml ou .fp.toml dans symbols/ ou footprints/. Dès lors, le projet en est propriétaire : il n'y a pas de lien vers la bibliothèque, donc un composant ne change jamais sous vos yeux quand KiCad se met à jour. Un chemin .kicad_sym ou .kicad_mod fonctionne à la place de Library:Name pour les composants hors des bibliothèques standard.
Les modèles 3D proviennent de KICAD9_3DMODEL_DIR et similaires, de 3dmodels/ dans le projet, ou d'un cache que agentee models remplit depuis le dépôt kicad-packages3D.
Comment les concepts correspondent
| KiCad | agentee |
|---|---|
Configuration de la carte .kicad_pro : couches, règles, classes de nets | *.board.toml : préréglage du fabricant, préréglage d'empilement, [rules], [[netclasses]], [[vias]] |
| entrée de bibliothèque de symboles | *.sym.toml, un par symbole |
| empreinte | *.fp.toml, avec des lignes de pastilles au lieu d'une entrée par pastille |
| feuille de schéma avec des fils | *.sch.toml : composants et nets sous forme de listes de broches ; fils optionnels |
| feuilles hiérarchiques | sheets = [...] dans un schéma racine, nets joints par nom |
.kicad_pcb | *.pcb.toml : placements, pistes, vias, zones, sérigraphie |
| DRC | agentee check, avec chaque règle listée par agentee drc NAME --list |
| remplissage de zone | automatique au chargement, mis en cache ; agentee fill le stocke dans le fichier |
| tracer les Gerbers et les fichiers de perçage | agentee fab |
champs d'empreinte mpn, lcsc | les mêmes champs sur le composant du schéma, lus par la BOM et agentee parts |
Ce qui se comporte différemment :
- Les largeurs de classe de nets sont des minimums. Dans KiCad, la largeur d'une classe est la valeur par défaut pour les nouvelles pistes ; dans agentee, une piste plus étroite que sa classe est une erreur, sauf s'il s'agit d'un rétrécissement court vers une pastille.
- L'impédance et le courant sont sur la classe. Donnez à une classe
impedance = "50ohm"oucurrent = "2A"et la vérification résout la largeur pour chaque couche de l'empilement. - Les empilements sont ceux du fabricant. Choisissez
JLC04161H-7628ou une construction PCBWay depuisagentee stackupsau lieu de saisir des épaisseurs. - Y augmente vers le bas dans chaque fichier, comme dans l'éditeur d'empreintes de KiCad, et la rotation est anti-horaire à l'écran.
- Les clés inconnues sont des erreurs. Une faute de frappe dans une clé est signalée, pas ignorée.
- Chaque carte porte un filigrane de version dans sa sérigraphie : la version d'agentee et le commit qui a construit le paquet de fabrication.
Importer une carte entière
agentee import board path/to/NAME.kicad_pcb --dir NAME
cd NAME
agentee check
agentee render pcb:NAME -o NAME.pngL'importation écrit :
| fichier | depuis |
|---|---|
NAME.board.toml | le contour Edge.Cuts et ses découpes, l'empilement avec épaisseur, permittivité et tangente de pertes, la finition et la couleur du vernis épargne, les règles de conception et les classes de nets depuis NAME.kicad_pro |
NAME.pcb.toml | placements d'empreintes, pistes (arcs en segments courts), vias et zones avec leurs remplissages stockés, ainsi que le texte et les lignes de sérigraphie et de fabrication, avec ${TITLE} et les variables de texte du projet remplies |
NAME.sch.toml | chaque composant avec sa valeur, et chaque net sous forme de liste de broches, dessiné avec des étiquettes de nets |
footprints/ | chaque empreinte telle qu'elle est sur la carte, celles du bas retournées vers le haut |
symbols/ | un symbole en boîte par empreinte, avec une broche par numéro de pastille |
Le schéma est une liste de nets, pas votre dessin : le schéma de KiCad n'est pas lu, donc les noms de broches, les graphismes des symboles et la structure des feuilles ne sont pas repris. C'est suffisant pour vérifier, rendre, simuler et fabriquer la carte, et pour qu'un agent modifie le routage.
Les vias conservent leur type. Un via micro de KiCad devient un microvia, blind un via aveugle ou enfoui selon sa portée, et chaque perçage, pastille, portée, remplissage et contre-perçage distinct devient un type de via de carte. Les coordonnées sont décalées pour que le contour commence à 0, 0.
Exclus et signalés : gouttelettes, zones de garde, et boucles dans Edge.Cuts hors du contour. Une classe dont les pistes sont plus étroites que sa largeur prend la plus étroite, car agentee traite la largeur comme un minimum. Les espacements sont vérifiés avec la tolérance de 0,5 um de KiCad.
Sur les démos video et complex_hierarchy de KiCad, chaque pastille du routage importé se place là où l'export IPC-D-356 de KiCad la met : 2089 et 165 pastilles. L'exemple HackRF Pro est une carte complète importée ainsi.
Retour en arrière
Il n'y a pas d'export vers des fichiers KiCad. Ce qui sort d'agentee est le paquet de fabrication (Gerbers avec attributs X2, perçages Excellon, BOM, placement et liste de nets IPC-D-356) et un STEP de la carte assemblée, que tout fabricant et tout outil MCAD lit.