agentee

Hier anfangen

Umstieg von KiCad

Was agentee von KiCad übernimmt und was es anders macht: die Bibliotheken, aus denen es importiert, das Importieren einer ganzen Platine und wie die Konzepte zueinander passen.

agentee ist kein KiCad-Ersatz mit einem anderen Dateiformat. Es ist ein Design-Tool für Agenten, das die Bibliotheken von KiCad übernimmt und Platinen von KiCad liest. Wenn du KiCad kennst, tragen sich die meisten Konzepte über; was sich ändert, ist, dass die Dateien die Schnittstelle sind, und eine Person über einen Agenten und einen Viewer statt über einen Editor bearbeitet.

Die Bibliotheken

agentee hat keine eigene Bauteilbibliothek. agentee search und agentee import lesen die KiCad-Symbol- und Footprint-Bibliotheken von:

  • /usr/share/kicad und /usr/local/share/kicad auf Linux,
  • /Applications/KiCad/KiCad.app/Contents/SharedSupport auf macOS,
  • KICAD9_SYMBOL_DIR und KICAD9_FOOTPRINT_DIR überall sonst, einschließlich Windows. KICAD8_* und KICAD_* funktionieren ebenfalls.
agentee search symbol lm358
agentee import symbol Amplifier_Operational:LM358 --with-footprint
agentee import footprint Package_TO_SOT_SMD:SOT-89-3

Ein Import schreibt eine .sym.toml oder .fp.toml in symbols/ oder footprints/. Ab dann gehört sie dem Projekt: Es gibt keinen Link zurück zur Bibliothek, sodass ein Bauteil nie unter dir ändert, wenn KiCad aktualisiert wird. Ein .kicad_sym- oder .kicad_mod-Pfad funktioniert anstelle von Library:Name für Bauteile außerhalb der Standardbibliotheken.

3D-Modelle stammen von KICAD9_3DMODEL_DIR und Freunden, 3dmodels/ im Projekt, oder einem Cache, den agentee models aus dem kicad-packages3D-Repository füllt.

Wie sich die Konzepte abbilden

KiCadagentee
.kicad_pro Platineneinrichtung: Lagen, Regeln, Netzklassen*.board.toml: Fertiger-Preset, Lagenaufbau-Preset, [rules], [[netclasses]], [[vias]]
Eintrag in der Symbolbibliothek*.sym.toml, je eines pro Symbol
Footprint*.fp.toml, mit Pad-Zeilen statt einem Eintrag pro Pad
Schaltplanblatt mit Leitungen*.sch.toml: Bauteile und Netze als Listen von Pins; Leitungen optional
hierarchische Blättersheets = [...] in einem übergeordneten Schaltplan, Netze über den Namen verbunden
.kicad_pcb*.pcb.toml: Platzierungen, Leiterbahnen, Vias, Kupferflächen, Bestückungsdruck
DRCagentee check, jede Regel wird von agentee drc NAME --list aufgelistet
Kupferflächen-Ausfüllungautomatisch beim Laden, zwischengespeichert; agentee fill speichert sie in der Datei
Gerber- und Bohrdateien ausgebenagentee fab
Footprint-Felder mpn, lcscdieselben Felder am Schaltplanbauteil, gelesen von der BOM und agentee parts

Dinge, die sich anders verhalten:

  • Netzklassen-Breiten sind Mindestwerte. In KiCad ist die Klassenbreite der Standard für neue Leiterbahnen; in agentee ist eine Leiterbahn schmaler als ihre Klasse ein Fehler, es sei denn, es handelt sich um eine kurze Engstelle zu einem Pad.
  • Impedanz und Strom liegen auf der Klasse. Gib einer Klasse impedance = "50ohm" oder current = "2A" und die Prüfung berechnet die Breite für jede Schicht des Lagenaufbaus.
  • Lagenaufbauten sind die des Fertigers. Wähle JLC04161H-7628 oder einen PCBWay-Aufbau aus agentee stackups statt Dicken einzutippen.
  • Y wächst nach unten in jeder Datei, wie im Footprint-Editor von KiCad, und die Drehung ist auf dem Bildschirm gegen den Uhrzeigersinn.
  • Unbekannte Schlüssel sind Fehler. Ein Tippfehler in einem Schlüssel wird gemeldet, nicht ignoriert.
  • Jede Platine trägt ein Versions-Wasserzeichen in ihrem Bestückungsdruck: die agentee-Version und der Commit, der das Fertigerpaket erstellt hat.

Eine ganze Platine importieren

agentee import board path/to/NAME.kicad_pcb --dir NAME
cd NAME
agentee check
agentee render pcb:NAME -o NAME.png

Der Import schreibt:

Dateiaus
NAME.board.tomldie Edge.Cuts-Umrisslinie und ihre Ausschnitte, der Lagenaufbau mit Dicke, Dielektrizitätskonstante und Verlustfaktor, die Oberfläche und die Lötstoppmaske-Farbe, die Designregeln und Netzklassen aus NAME.kicad_pro
NAME.pcb.tomlFootprint-Platzierungen, Leiterbahnen (Bögen als kurze Segmente), Vias und Kupferflächen mit ihren gespeicherten Füllungen, sowie der Bestückungsdruck- und Fertigungstext und -linien, mit ${TITLE} und den Textvariablen des Projekts ausgefüllt
NAME.sch.tomljedes Bauteil mit seinem Wert und jedes Netz als Liste von Pins, gezeichnet mit Netzbeschriftungen
footprints/jeder Footprint so, wie er auf der Platine liegt, untere nach oben umgedreht
symbols/ein Box-Symbol pro Footprint, mit einem Pin pro Pad-Nummer

Der Schaltplan ist eine Netlist, nicht deine Zeichnung: Der Schaltplan von KiCad wird nicht gelesen, daher werden Pin-Namen, die Symbolgrafik und die Blattstruktur nicht übernommen. Das reicht, um die Platine zu prüfen, zu rendern, zu simulieren und zu fertigen, und damit ein Agent das Layout ändert.

Vias behalten ihren Typ. Ein KiCad-micro-Via wird zu einem Microvia, blind zu einem Blind- oder Durchbruch-Via je nach Spannweite, und jeder einzelne Bohrdurchmesser, Pad, Spannweite, Ausfüllung und Rückbohrung wird zu einem Platinen-Via-Typ. Die Koordinaten werden verschoben, damit der Umriss bei 0, 0 beginnt.

Ausgelassen und gemeldet: Tränen, Ausschlussbereiche und Schleifen in Edge.Cuts außerhalb des Umrisses. Eine Klasse, deren Leiterbahnen schmaler als ihre Breite laufen, nimmt die schmalste, da agentee die Breite als Mindestwert behandelt. Abstände werden mit der 0,5-um-Toleranz von KiCad geprüft.

Bei den eigenen video- und complex_hierarchy-Demos von KiCad landet jedes Pad des importierten Layouts dort, wo der IPC-D-356-Export von KiCad es platziert: 2089 und 165 Pads. Das HackRF Pro-Beispiel ist eine vollständige Platine, die auf diese Weise importiert wurde.

Zurückkehren

Es gibt keinen Export in KiCad-Dateien. Was agentee verlässt, ist das Fertigerpaket (Gerber mit X2-Attributen, Excellon-Bohrungen, BOM, Platzierung und eine IPC-D-356-Netlist) und ein STEP der bestückten Platine, das jeder Fertiger und jedes MCAD-Tool liest.

Diese Anleitung verbessern · Markdown für Agenten