Breadboard / Fiação Física

Sobre diagramas de breadboard

Um diagrama de breadboard mostra como conectar fisicamente componentes em uma placa de prototipagem sem solda — o gênero visual icônico de todo tutorial de Arduino / ESP32 / Raspberry Pi. O leitor replica o que vê, furo por furo, no hardware real. Isso é complementar ao esquemático de circuito abstrato (circuit, IEEE 315): o esquemático é a visão de raciocínio do engenheiro; o breadboard é a visão de replicação do maker.

O Schematex implementa renderização de breadboard no estilo Fritzing. Os componentes são desenhados como corpos reconhecíveis (resistores com faixas de cor, LEDs como domes coloridos, DIPs com entalhes, PCBs de MCU com headers de pinos rotulados). Os fios jumper são desenhados como arcos Bézier cúbicos suaves entre pontos de conexão específicos — não ângulos retos Manhattan. O DSL endereça cada parte e cada fio por coordenadas nativas do breadboard (@col-linha, por ex. @5e), não por posições em pixels, então o arquivo pode ser escrito manualmente e versionado.

Nota — este motor não é um esquemático de circuito e não aplica regras elétricas. Use-o para tutoriais, apostilas de laboratório, READMEs e material didático. Para análise nodal ou esquemáticos formais, use o motor circuit.

1. Seu primeiro breadboard

Três seções: uma linha de cabeçalho breadboard, um bloco parts e um bloco wires. As linhas opcionais board: e title: vêm logo após o cabeçalho.

Cada parte é id: kind [args] @placement. Cada fio é <endpoint> --color-- <endpoint>. Essa é a gramática completa.

2. Coordenadas

Breadboards têm uma grade de endereçamento 2D. As coordenadas do Schematex sempre começam com @.

Mini placas (board: mini) não têm trilhos de alimentação — @+t… / @-b… são rejeitados pelo parser.

3. Tamanhos de placa

breadboard
board: half          // padrão — 30 colunas, 400 pontos de conexão, trilhos (contínuos)

Atenção — em placas de tamanho completo, os trilhos se interrompem no meio. Se o seu circuito usar ambas as metades, você deve conectar os trilhos com jumpers explicitamente.

4. Catálogo de partes

Cada parte é id: <kind> [args] @<placement>. O catálogo cobre os componentes maker mais comuns para Arduino / ESP32:

Componentes discretos (ficam no breadboard):

Placas microcontroladoras (posicionadas ao lado / acima / abaixo do substrato):

Sensores / displays / atuadores (módulos ficam no breadboard com a fileira de pinos ancorada na coordenada fornecida):

As faixas de cor dos resistores são decoradas automaticamente a partir do value — 220 → vermelho-vermelho-marrom-ouro, 10000 → marrom-preto-laranja-ouro.

5. Fios

Cada fio conecta dois endpoints. Um endpoint é um pino de parte (partId:pinName) ou uma coordenada do breadboard (@…).

wires
  uno:5V  --red--    @+t1
  uno:GND --black--  @-t1
  uno:D9  --yellow-- @9c
  @9a     --green--  @+t9

A cor é puramente visual — o motor não a valida contra a função elétrica.

Para placas visualmente congestionadas, via @<coord> permite fixar um furo intermediário que influencia os pontos de controle do Bézier:

wires
  uno:D13 --yellow-- @9a via @8c

A maioria dos fios não precisa de via — o motor de layout produz um arco natural por conta própria.

6. Sensor com resistor pull-up (motivo DHT11)

O padrão icônico de tutoriais de Arduino: um pull-up de 10 kΩ entre VCC e a linha de dados do sensor.

7. ESP32 + I²C OLED

O ESP32 opera a 3,3 V (não 5 V). Convenção I²C: verde = SDA, branco = SCL.

8. Limitações da v0.1

• Sem callouts com linha guia — os designadores de referência (R1, C2) são desenhados próximos ao corpo da parte. Caixas de callout fora da placa estão adiadas.
• Sem importação de .fzz — o Schematex consome apenas seu próprio DSL; arquivos Fritzing não são analisados.
• Sem simulação — este é um renderizador, não um simulador no estilo Wokwi. A validação de valores de componentes (lei de Ohm, limites de corrente) está fora do escopo.
• Sem round-trip PCB / esquemático — breadboard e circuit são motores independentes. Criar duas visões do mesmo protótipo atualmente significa escrever dois DSLs.
• Catálogo de partes fixo — tipos de partes definidos pelo usuário estão adiados. A v0.1 inclui o catálogo de 80% de tutoriais maker (resistores, LEDs, capacitores, DIPs, headers, quatro famílias de MCU, seis módulos de sensor / display / atuador).
• Visual de interrupção do trilho de alimentação — placas de tamanho completo marcam a interrupção 30/31 com um espaço da largura de um furo; as faixas do trilho ainda são desenhadas através do espaço (cosmético).

Exemplos relacionados

Cenários prontos para uso da galeria de exemplos: