Zacznij tutaj
Przejście z KiCada
Co agentee przejmuje z KiCada i co robi inaczej: biblioteki, z których importuje, importowanie całej płytki oraz mapowanie pojęć.
agentee to nie zamiennik KiCad z innym formatem plików. To narzędzie projektowe dla agentów, które pożycza biblioteki KiCad i czyta płytki KiCad. Jeśli znasz KiCad, większość pojęć się przenosi; co się zmienia, to to, że pliki są interfejsem, a osoba edytuje przez agenta i podgląd, a nie przez edytor.
Biblioteki
agentee nie ma własnej biblioteki elementów. agentee search i agentee import czytają biblioteki symboli i footprintów KiCad z:
/usr/share/kicadi/usr/local/share/kicadna Linuksie,/Applications/KiCad/KiCad.app/Contents/SharedSupportna macOS,KICAD9_SYMBOL_DIRiKICAD9_FOOTPRINT_DIRwszędzie indziej, w tym na Windows.KICAD8_*iKICAD_*też działają.
agentee search symbol lm358
agentee import symbol Amplifier_Operational:LM358 --with-footprint
agentee import footprint Package_TO_SOT_SMD:SOT-89-3Import zapisuje .sym.toml albo .fp.toml do symbols/ albo footprints/. Od tego momentu projekt nim włada: nie ma linku z powrotem do biblioteki, więc element nigdy się nie zmieni pod tobą, gdy KiCad się zaktualizuje. Ścieżka do .kicad_sym albo .kicad_mod działa w miejscu Library:Name dla elementów spoza standardowych bibliotek.
Modele 3D pochodzą z KICAD9_3DMODEL_DIR i pokrewnych, 3dmodels/ w projekcie albo z cache, który agentee models wypełnia z repozytorium kicad-packages3D.
Jak mapują się pojęcia
| KiCad | agentee |
|---|---|
Ustawienia płytki .kicad_pro: warstwy, reguły, klasy sieci | *.board.toml: preset producenta, preset stackupu, [rules], [[netclasses]], [[vias]] |
| wpis w bibliotece symboli | *.sym.toml, po jednym na symbol |
| footprint | *.fp.toml, z wierszami padów zamiast jednego wpisu na pad |
| arkusz schematu z przewodami | *.sch.toml: części i sieci jako listy pinów; przewody opcjonalne |
| hierarchiczne arkusze | sheets = [...] w schemacie nadrzędnym, sieci łączone po nazwie |
.kicad_pcb | *.pcb.toml: rozmieszczenia, ścieżki, przelotki, wylewki, opisy |
| DRC | agentee check, z każdą regułą wymienioną przez agentee drc NAME --list |
| wypełnianie wylewek | automatyczne przy wczytywaniu, z cache; agentee fill zapisuje je w pliku |
| wygenerowanie plików Gerber i otworów | agentee fab |
pola footprintu mpn, lcsc | te same pola na części schematu, odczytywane przez BOM i agentee parts |
Rzeczy, które zachowują się inaczej:
- Szerokości klas sieci to wartości minimalne. W KiCad szerokość klasy jest domyślna dla nowych ścieżek; w agentee ścieżka węższa niż jej klasa to błąd, chyba że to krótkie zwężenie do padu.
- Impedancja i prąd żyją na klasie. Nadaj klasie
impedance = "50ohm"lubcurrent = "2A", a sprawdzanie rozwiąże szerokość dla każdej warstwy stackupu. - Stackupy pochodzą od producenta. Wybierz
JLC04161H-7628lub konfigurację PCBWay zagentee stackupszamiast wpisywać grubości. - Y rośnie w dół we wszystkich plikach, jak w edytorze footprintów KiCad, a obrót jest przeciwny do ruchu wskazówek zegara na ekranie.
- Nieznane klucze to błędy. Literówka w kluczu jest zgłaszana, a nie ignorowana.
- Każda płytka ma znak wodny wersji w opisach: wersję agentee i commit, z którego zbudowano pakiet produkcyjny.
Importowanie całej płytki
agentee import board path/to/NAME.kicad_pcb --dir NAME
cd NAME
agentee check
agentee render pcb:NAME -o NAME.pngImport zapisuje:
| plik | z |
|---|---|
NAME.board.toml | kontur Edge.Cuts i jego wycięcia, stackup z grubością, przenikalnością i stratnością, wykończenie i kolor soldermaski, reguły projektowe i klasy sieci z NAME.kicad_pro |
NAME.pcb.toml | rozmieszczenia footprintów, ścieżki (łuki jako krótkie odcinki), przelotki i wylewki z zapisanym wypełnieniem, oraz opisy i teksty producenta, z uzupełnionymi zmiennymi ${TITLE} i projektu |
NAME.sch.toml | każdą część z jej wartością i każdą sieć jako listę pinów, rysowaną etykietami sieci |
footprints/ | każdy footprint tak, jak leży na płytce, z dolnymi odwróconymi z powrotem na górę |
symbols/ | jeden symbol pudełkowy na footprint, z pinem na każdy numer padu |
Schemat to lista połączeń, nie twój rysunek: schemat KiCad nie jest odczytywany, więc nazwy pinów, grafika symboli i struktura arkuszy nie są przenoszone. To wystarcza, aby sprawdzić, wyrenderować, zasymulować i wyprodukować płytkę oraz pozwolić agentowi zmienić projekt PCB.
Przelotki zachowują swój typ. Przelotka micro z KiCad staje się mikroprzelotką, blind staje się przelotką ślepa lub ukryta w zależności od zakresu, a każdy odrębny otwór, pad, zakres, wypełnienie i backdrill staje się typem przelotki płytki. Współrzędne są przesuwane tak, aby kontur zaczynał się od 0, 0.
Pominięte i zgłoszone: łzy, obszary keepout oraz pętle w Edge.Cuts poza konturem. Klasa, której ścieżki są węższe niż jej szerokość, przyjmuje najwęższą, ponieważ agentee traktuje szerokość jako minimum. Odległości są sprawdzane z tolerancją 0,5 um z KiCad.
Na własnych demo video i complex_hierarchy z KiCad każdy pad zaimportowanego projektu PCB ląduje tam, gdzie eksport IPC-D-356 z KiCad go umieszcza: 2089 i 165 padów. Przykład HackRF Pro to kompletna płytka zaimportowana w ten sposób.
Powrót
Nie ma eksportu do plików KiCad. Co opuszcza agentee, to pakiet produkcyjny (pliki Gerber z atrybutami X2, otwory Excellon, BOM, rozmieszczenie i lista połączeń IPC-D-356) oraz model STEP złożonej płytki, który odczyta każdy producent i każde narzędzie MCAD.