agentee

Componentes

Símbolos

O ficheiro *.sym.toml: pinos, gráficos, corpos de caixa gerados, símbolos de múltiplas unidades e níveis lógicos para a verificação de sinais.

name = "LM358"
reference = "U"                # designator prefix
value = "LM358"                # default: name
description = "Dual op amp"
datasheet = "https://..."
keywords = ["opamp", "dual"]
footprint = "SOIC-8_3.9x4.9mm_P1.27mm"
footprint_filters = ["SOIC*3.9x4.9mm*"]
pin_names = "inside"           # inside | outside | hidden
# pin_name_offset = 0.508
# hide_pin_numbers = true
# power = true                 # a power flag symbol like GND

[[graphics]]
kind = "polygon"
points = [[-5.08, -5.08], [5.08, 0], [-5.08, 5.08]]
fill = "background"            # none | solid | background
unit = 1                       # 0 or absent: drawn in every unit

[[pins]]
number = "3"
name = "+"
type = "input"
at = [-7.62, -2.54]            # the connection point, where wires land
side = "left"                  # left | right | top | bottom of the body
length = 2.54                  # default 2.54
unit = 1
# shape = "inverted"           # line | inverted | clock | inverted_clock | input_low | clock_low | output_low | edge_clock_high | non_logic
# hidden = true

side indica de que aresta do corpo o pino sai. Um pino left corre de at para a direita até ao corpo. Mantenha os pontos de ligação na grelha de 1,27 mm (2,54 mm é melhor).

Tipos de pino: input, output, bidirectional, tri_state, passive, free, unspecified, power_in, power_out, open_collector, open_emitter, no_connect.

Os nomes aceitam ~{...} para uma barra superior: ~{RESET}.

Corpos gerados

Para um símbolo em caixa, liste os pinos por lado e deixe o agentee posicioná-los na grelha e dimensionar o corpo. Cada entrada é um pino, ou { gap = N } para deixar N espaços vazios.

name = "STM32F103C8"
reference = "U"

[[bodies]]
unit = 1                       # optional, one [[bodies]] per unit
# width = 20.32                # minimum body width
# pin_length = 2.54
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" } ]

Corpos e [[pins]] / [[graphics]] posicionados manualmente podem ser misturados.

Símbolos multiunidade: dê a pinos e gráficos um unit. O mesmo número de pino pode aparecer em mais do que uma unidade apenas quando tem o mesmo nome (um pino partilhado).

Níveis de lógica

Um símbolo pode declarar os limiares de entrada dos seus pinos, para a verificação do nível de sinal do esquema. [levels] aplica-se a todos os pinos input e bidirectional; a tabela levels própria de um pino sobrepõe-a campo a campo, e submete qualquer tipo de pino à verificação.

[levels]
supply = "VDD"                 # pin name or number whose rail the % levels scale with
vih = "75%"                    # of the supply; or volts, "2.0V"
vil = "25%"
min = "-0.3V"                  # absolute limits, sums allowed: "100%+0.3V"
max = "100%+0.3V"
leakage = "50nA"               # input leakage, either way
# pull_up = "45k"              # a fixed internal pull to the supply
# pull_down = "45k"

[[pins]]
number = "12"
name = "NRST"
type = "input"
at = [-7.62, 0.0]
side = "left"
levels = { vih = "70%", pull_up = "45k" }

Apenas pinos com níveis são verificados; nada é assumido para um símbolo sem eles.

docs/format.md · Markdown para agentes