Componentes: importar ou desenhar

Cada peça numa placa é dois ficheiros: um símbolo para o esquema e um footprint para o layout, unidos por número de pin. Importe-os do KiCad sempre que o KiCad tiver a peça, e desenhe-os a partir da folha de dados quando não tiver.

#Pesquisa

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

Cada palavra tem de aparecer em Library:Name, por isso adicione palavras para afinar uma pesquisa: soic 3.9x4.9 encontra os corpos SOIC-8 estreitos e ignora os largos.

#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 traz o footprint predefinido do símbolo; --footprint escolhe outro e liga-o. Os símbolos ficam em symbols/, os footprints em footprints/. --force substitui um ficheiro que já tem. Um caminho para um .kicad_sym (com :Name) ou um .kicad_mod funciona no lugar de Library:Name para bibliotecas de fornecedores.

Execute a verificação logo a seguir. O achado habitual é a serigrafia:

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

O KiCad desenha serigrafia a 0,12 mm e a JLCPCB imprime a 0,15 mm. Alargue o width dos gráficos de serigrafia do footprint. O outro comum é o courtyard ou o espaçamento de pads contra um fabricante grosseiro; corrija-o no footprint, onde pertence, e não com uma sobreposição de regra.

#Peças genéricas são partilhadas

Um símbolo R serve todos os resistores e um símbolo C todos os condensadores. O valor e o footprint ficam na peça no esquema:

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

Se um esquema nomeia um símbolo que o projeto não tem, mas dá um footprint que algum símbolo já usa, o add toma esse símbolo, por isso um agente que escreve --footprint C_0402_1005Metric para um condensador recebe o certo.

#Desenhar um símbolo

agentee new symbol STM32F103C8

Para um símbolo em caixa, liste os pins por lado e deixe o agentee posicioná-los na grelha e dimensionar o corpo. Este é o exemplo da referência, reduzido:

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 } deixa N slots vazios. Os pins também podem ser posicionados à mão com [[pins]] (number, name, type, at, side), e os dois podem ser misturados. Mantenha os pontos de ligação na grelha de 1,27 mm; pins fora da grelha são assinalados. Símbolos multi-unidade dão aos pins e gráficos um unit.

Os tipos de pin importam: a verificação usa-os para as verificações de rede, e as saídas open_collector e os pins input participam na verificação de nível de sinal.

#Níveis de lógica

Para peças de lógica e MCU, copie os limiares da folha de dados para uma tabela [levels]. A verificação então calcula a tensão que cada entrada vê através dos seus rails, resistores e interruptores, e reporta uma entrada que pode ficar entre VIL e VIH, flutuar, ou passar dos seus limites:

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

A própria tabela levels de um pin sobrepõe a do símbolo, por exemplo para um pin de reset com pull-up interno. O guia de esquemas mostra a outra metade, a tabela rails.

#Desenhar um footprint

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

Escreva pads como linhas em vez de uma entrada cada. O SOIC-8 da referência:

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

A segunda linha conta de 5 a 8 de volta pelo outro lado. As linhas contam os dígitos finais, por isso as bolas BGA funcionam da mesma forma (A1, A2, ...), e number_step = 2 conta de dois em dois.

Desenhe o courtyard em F.CrtYd e o contorno do corpo em F.Fab: a verificação precisa de um courtyard que envolva os pads, o posicionador mantém os courtyards separados, e as regras de borda e montagem medem a partir do corpo. Defina height para que a vista 3D e a regra de peças altas tenham uma altura sem um modelo.

Chaves úteis de footprint:

• edge = true num pad cujo cobre deve chegar à borda da placa (conectores edge-launch, castelados).
• overhang = true num conector que deve pendurar sobre a borda.
• mask_web = false quando o fabricante abre a máscara sobre todos os pads de uma peça de passo fino como uma janela única.
• zone_connect = "solid" ou "relief" num pad, por cima da configuração própria da área de cobre.
• model nomeando um ficheiro STEP ou VRML, um caminho KiCad, ou um URL https:// fixado a um commit.

#Cada pin precisa de um pad

As redes dos pads vêm do esquema por número: o pin 3 do símbolo é o pad 3 do footprint. A verificação reporta qualquer pin sem pad. Um pin de símbolo chamado EP ou numerado 17 para um pad exposto precisa desse número de pad no footprint também.

#Números de peça

Dê a cada peça no esquema os campos mfr e mpn, e um campo lcsc para montagem JLCPCB:

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

Cada set adiciona à tabela fields da peça e mantém o que lá está. No ficheiro lê-se fields = { mfr = "Qorvo", mpn = "SPF5189Z" }.

A BOM agrupa por eles, e o agentee parts procura stock, preço e equivalentes mais baratos por mpn. Veja Pacote de fabricante, BOM e preços.