Onderdelen: importeren of tekenen

Elk onderdeel op een printplaat is twee bestanden: een symbool voor het schema en een footprint voor het layout, verbonden via pinnummer. Importeer ze uit KiCad wanneer KiCad het onderdeel heeft, en teken ze uit de datasheet wanneer dat niet zo is.

#Zoeken

agentee search symbol lm358
agentee search footprint soic 3.9x4.9

Elk woord moet voorkomen in Library:Name, dus voeg woorden toe om een zoekopdracht te verfijnen: soic 3.9x4.9 vindt de smalle SOIC-8-lichamen en slaat de brede over.

#Importeren

agentee import symbol Amplifier_Operational:LM358 --with-footprint
agentee import symbol Device:R --footprint Resistor_SMD:R_0402_1005Metric
agentee import footprint Package_TO_SOT_SMD:SOT-89-3

--with-footprint neemt de standaard-footprint van het symbool mee; --footprint kiest een andere en koppelt die. Symbolen komen in symbols/, footprints in footprints/. --force overschrijft een bestand dat je al hebt. Een pad naar een .kicad_sym (met :Name) of een .kicad_mod werkt in plaats van Library:Name voor leveranciersbibliotheken.

Voer de controle direct daarna uit. De gebruikelijke bevinding is zeefdruk:

warning: ./footprints/R_0603_1608Metric.fp.toml: R_0603_1608Metric silk: silk lines under the fab minimum width 0.15mm: 2, thinnest 0.12mm

KiCad tekent zeefdruk op 0,12 mm en JLCPCB drukt op 0,15 mm. Maak de width van de zeefdrukgraphics van de footprint groter. De andere veelvoorkomende is courtyard of pad-afstand tegen een grove fabrikant; los dat op in de footprint, waar het hoort, niet met een regeloverschrijving.

#Generieke onderdelen worden gedeeld

Eén R-symbool dekt elke weerstand en één C-symbool elke condensator. De waarde en de footprint komen op het onderdeel in het schema:

agentee edit sch NAME add R1 R 10k --footprint R_0402_1005Metric
agentee edit sch NAME add C1 C 100n --footprint C_0402_1005Metric

Als een schema een symbool noemt dat het project mist, maar een footprint geeft die een symbool al gebruikt, neemt add dat symbool, zodat een agent die --footprint C_0402_1005Metric schrijft voor een condensator het juiste krijgt.

#Een symbool tekenen

agentee new symbol STM32F103C8

Voor een blok-symbool, lijst je de pinnen per zijde op en laat je agentee ze op het raster plaatsen en het lichaam dimensioneren. Dit is het voorbeeld uit de referentie, ingekort:

name = "STM32F103C8"
reference = "U"

[[bodies]]
left = [
  { number = "7", name = "NRST", type = "input" },
  { gap = 1 },
  { number = "10", name = "PA0", type = "bidirectional" },
]
right = [ { number = "30", name = "PA9", type = "bidirectional" } ]
top = [ { number = "1", name = "VBAT", type = "power_in" } ]
bottom = [ { number = "8", name = "VSS", type = "power_in" } ]

{ gap = N } laat N lege plekken over. Pinnen kunnen ook handmatig worden geplaatst met [[pins]] (number, name, type, at, side), en de twee kunnen worden gemengd. Houd aansluitpunten op het raster van 1,27 mm; pinnen buiten het raster worden gemarkeerd. Symbolen met meerdere eenheden geven pinnen en graphics een unit.

Pintypes tellen: de controle gebruikt ze voor de netcontroles, en open_collector-uitgangen en input-pinnen doen mee aan de signaalniveaucontrole.

#Logicaniveaus

Voor logiek- en MCU-onderdelen, kopieer de drempels uit de datasheet naar een [levels]-tabel. De controle berekent dan de spanning die elke ingang ziet over zijn rails, weerstanden en schakelaars, en rapporteert een ingang die tussen VIL en VIH kan zitten, zweven kan, of buiten zijn limieten kan gaan:

[levels]
supply = "VDD"
vih = "70%"
vil = "30%"
min = "-0.3V"
max = "100%+0.3V"
leakage = "1uA"

De eigen levels-tabel van een pin overschrijft die van het symbool, bijvoorbeeld voor een reset-pin met een interne pull-up. De schema-handleiding toont de andere helft, de rails-tabel.

#Een footprint tekenen

agentee new footprint SOIC-8_3.9x4.9mm_P1.27mm

Schrijf pads als rijen in plaats van één per item. De SOIC-8 uit de referentie:

[[pads]]
number = "1"
kind = "smd"
shape = "roundrect"
at = [-2.475, -1.905]
size = [1.95, 0.6]
count = 4
pitch = [0, 1.27]

[[pads]]
number = "5"
kind = "smd"
shape = "roundrect"
at = [2.475, 1.905]
size = [1.95, 0.6]
count = 4
pitch = [0, -1.27]

De tweede rij telt 5 tot 8 terug aan de andere zijde. Rijen tellen op met de achterste cijfers, dus BGA-ballen werken op dezelfde manier (A1, A2, ...), en number_step = 2 telt per twee.

Teken de courtyard op F.CrtYd en de behuizingscontour op F.Fab: de controle heeft een courtyard nodig die de pads omsluit, de placer houdt courtyards uit elkaar, en de rand- en assemblageregels meten vanaf de behuizing. Stel height in zodat het 3D-weergave en de regel voor hoge onderdelen een hoogte hebben zonder model.

Handige footprint-sleutels:

• edge = true op een pad waarvan het koper tot aan de rand van de printplaat moet reiken (edge-launch-connectoren, castellations).
• overhang = true op een connector die over de rand moet hangen.
• mask_web = false wanneer de fabrikant het soldeermasker over alle pads van een fijngepitcht onderdeel als één venster opent.
• zone_connect = "solid" of "relief" op een pad, boven de eigen instelling van het kopervlak.
• model met de naam van een STEP- of VRML-bestand, een KiCad-pad, of een https://-URL vastgezet op een commit.

#Elke pin heeft een pad nodig

Padnets komen uit het schema via nummer: pin 3 van het symbool is pad 3 van de footprint. De controle rapporteert elke pin zonder pad. Een symboolpin met de naam EP of het nummer 17 voor een blootliggend pad heeft dat padnummer ook in de footprint nodig.

#Onderdeelnummers

Geef elk onderdeel in het schema mfr- en mpn-velden, en een lcsc-veld voor JLCPCB-montage:

agentee edit sch NAME set U1 --field mfr=Qorvo
agentee edit sch NAME set U1 --field mpn=SPF5189Z

Elke set voegt toe aan de fields-tabel van het onderdeel en behoudt wat er al staat. In het bestand leest het fields = { mfr = "Qorvo", mpn = "SPF5189Z" }.

De BOM groepeert op deze velden, en agentee parts zoekt voorraad, prijs en goedkopere equivalenten op mpn. Zie Fab-pakket, BOM en prijzen.