Componentes: importar o dibujar

Cada componente de una placa es dos archivos: un símbolo para el esquemático y una huella para el layout, unidos por número de pin. Impórtalos de KiCad siempre que KiCad tenga el componente, y dibújalos desde la hoja de datos cuando no la tenga.

#Buscar

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

Cada palabra debe aparecer en Library:Name, así que añade palabras para acotar una búsqueda: soic 3.9x4.9 encuentra los cuerpos SOIC-8 estrechos y omite los anchos.

#Importar

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 trae la huella predeterminada del símbolo; --footprint elige otra y la enlaza. Los símbolos van a symbols/ y las huellas a footprints/. --force sobrescribe un archivo que ya tengas. Una ruta a un .kicad_sym (con :Name) o un .kicad_mod funciona en lugar de Library:Name para bibliotecas de fabricantes.

Ejecuta la comprobación justo después. El hallazgo habitual es la serigrafía:

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 dibuja la serigrafía a 0,12 mm y JLCPCB imprime a 0,15 mm. Amplía el width de los gráficos de serigrafía de la huella. La otra común es el courtyard o el espaciado de pads frente a un fabricante grueso; corrígelo en la huella, donde corresponde, no con una anulación de regla.

#Las piezas genéricas son compartidas

Un símbolo R sirve para cada resistencia y un símbolo C para cada condensador. El valor y la huella van en la pieza del esquemático:

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

Si un esquemático nombra un símbolo que el proyecto no tiene pero da una huella que algún símbolo ya usa, add toma ese símbolo, así que un agente que escribe --footprint C_0402_1005Metric para un condensador obtiene el correcto.

#Dibujar un símbolo

agentee new symbol STM32F103C8

Para un símbolo de caja, lista los pines por lado y deja que agentee los coloque en la cuadrícula y dimensione el cuerpo. Este es el ejemplo de la referencia, recortado:

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 } deja N huecos vacíos. Los pines también se pueden colocar a mano con [[pins]] (number, name, type, at, side), y se pueden mezclar ambos. Mantén los puntos de conexión en la cuadrícula de 1,27 mm; los pines fuera de la cuadrícula se marcan. Los símbolos de varias unidades dan a los pines y a los gráficos un unit.

Los tipos de pin importan: la comprobación los usa para las comprobaciones de red, y las salidas open_collector y los pines input participan en la comprobación de nivel de señal.

#Niveles lógicos

Para piezas de lógica y MCU, copia los umbrales de la hoja de datos en una tabla [levels]. La comprobación entonces calcula el voltaje que cada entrada ve a través de sus raíles, resistencias e interruptores, e informa de una entrada que puede quedarse entre VIL y VIH, flotar o pasar de sus límites:

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

La tabla levels propia de un pin anula la del símbolo, por ejemplo para un pin de restablecimiento con una resistencia de arrastre interna. La guía de esquemáticos muestra la otra mitad, la tabla rails.

#Dibujar una huella

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

Escribe los pads como filas en lugar de una entrada cada uno. El SOIC-8 de la referencia:

[[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]

La segunda fila cuenta de 5 a 8 hacia arriba por el otro lado. Las filas cuentan hacia arriba los dígitos finales, así que las bolas BGA funcionan igual (A1, A2, ...), y number_step = 2 cuenta de dos en dos.

Dibuja el courtyard en F.CrtYd y el contorno del cuerpo en F.Fab: la comprobación necesita un courtyard que encierre los pads, el colocador mantiene los courtyards separados, y las reglas de borde y de montaje miden desde el cuerpo. Fija height para que la vista 3D y la regla de piezas altas tengan una altura sin un modelo.

Claves útiles de huella:

• edge = true en un pad cuyo cobre está destinado a llegar al borde de la placa (conectores de lanzamiento por el borde, castelaciones).
• overhang = true en un conector destinado a colgar sobre el borde.
• mask_web = false cuando el fabricante abre la máscara sobre todos los pads de una pieza de paso fino como una sola ventana.
• zone_connect = "solid" o "relief" en un pad, sobre la configuración propia de la zona.
• model que nombra un archivo STEP o VRML, una ruta de KiCad, o una URL https:// fijada a un commit.

#Cada pin necesita un pad

Las redes de los pads vienen del esquemático por número: el pin 3 del símbolo es el pad 3 de la huella. La comprobación informa de cualquier pin sin pad. Un pin de símbolo llamado EP o numerado 17 para un pad expuesto necesita ese número de pad en la huella también.

#Números de pieza

Da a cada pieza en el esquemático campos mfr y mpn, y un campo lcsc para el montaje de JLCPCB:

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

Cada set añade a la tabla fields de la pieza y conserva lo que hay. En el archivo se lee fields = { mfr = "Qorvo", mpn = "SPF5189Z" }.

La BOM los agrupa, y agentee parts busca existencias, precio y equivalentes más baratos por mpn. Ver Paquete de fabricante, BOM y precios.