Breadboard / Cableado físico

Acerca de los diagramas breadboard

Un diagrama breadboard muestra cómo cablear físicamente componentes en una placa de prototipado sin soldadura — el género visual icónico de cada tutorial de Arduino / ESP32 / Raspberry Pi. El lector replica lo que ve, orificio por orificio, en hardware real. Esto es complementario a el esquemático de circuito abstracto (circuit, IEEE 315): el esquemático es la vista de razonamiento del ingeniero; el breadboard es la vista de replicación del maker.

Schematex implementa el renderizado de breadboard estilizado estilo Fritzing. Los componentes se dibujan como cuerpos reconocibles (resistencias con bandas de color, LEDs como cúpulas de color, DIPs con muescas, PCBs de MCU con headers de pines etiquetados). Los cables puente se dibujan como arcos Bézier cúbicos suaves entre tie-points específicos — no ángulos rectos Manhattan. El DSL direcciona cada parte y cada cable por coordenadas nativas del breadboard (@col-fila, p. ej., @5e), no posiciones en píxeles, por lo que el archivo se puede escribir a mano y gestionar con control de versiones.

Nota — este motor no es un esquemático de circuito y no hace cumplir reglas eléctricas. Úsalo para tutoriales, guías de laboratorio, READMEs y material de aprendizaje. Para análisis nodal o esquemáticos formales, usa el motor circuit en su lugar.

1. Tu primer breadboard

Tres secciones: una línea de encabezado breadboard, un bloque parts, y un bloque wires. Las líneas opcionales board: y title: van justo después del encabezado.

Cada parte es id: tipo [args] @ubicación. Cada cable es <endpoint> --color-- <endpoint>. Esa es toda la gramática.

2. Coordenadas

Los breadboards tienen una cuadrícula de direcciones 2D. Las coordenadas de Schematex siempre comienzan con @.

Los mini boards (board: mini) no tienen rieles de alimentación — @+t… / @-b… son rechazados por el parser.

3. Tamaños de board

breadboard
board: half          // por defecto — 30 columnas, 400 tie-points, rieles (continuos)

Trampa — en los boards de tamaño completo los rieles se cortan en el medio. Si tu circuito usa ambas mitades debes conectar los rieles explícitamente con cables puente.

4. Catálogo de partes

Cada parte es id: <tipo> [args] @<ubicación>. El catálogo cubre los componentes maker de Arduino / ESP32 más comunes:

Componentes discretos (se colocan en el breadboard):

Placas de microcontrolador (colocadas al lado / encima / debajo del sustrato):

Sensores / pantallas / actuadores (módulos que se colocan en el breadboard con la fila de pines anclada en la coordenada suministrada):

Las bandas de color de las resistencias se decoran automáticamente desde value — 220 → rojo-rojo-marrón-oro, 10000 → marrón-negro-naranja-oro.

5. Cables

Cada cable conecta dos endpoints. Un endpoint es un pin de parte (partId:nombrePin) o una coordenada de breadboard (@…).

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

El color es puramente visual — el motor no lo valida contra el rol eléctrico.

Para boards visualmente congestionadas, via @<coord> te permite fijar un orificio intermedio que sesga los puntos de control de Bézier:

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

La mayoría de los cables no necesitan via — el motor de layout produce un arco natural por sí solo.

6. Sensor con resistencia pull-up (patrón DHT11)

El patrón icónico del tutorial de Arduino: un pull-up de 10 kΩ entre VCC y la línea de datos del sensor.

7. ESP32 + OLED I²C

El ESP32 funciona a 3.3 V (no 5 V). Convención I²C: verde = SDA, blanco = SCL.

8. Limitaciones de v0.1

• Sin callouts de línea guía — los designadores de referencia (R1, C2) se dibujan cerca del cuerpo de la parte. Las cajas de callout fuera del board están diferidas.
• Sin importación .fzz — Schematex consume solo su propio DSL; los archivos Fritzing no se parsean.
• Sin simulación — este es un renderer, no un simulador estilo Wokwi. La validación de valores de componentes (Ley de Ohm, límites de corriente) está fuera del alcance.
• Sin round-trip PCB / esquemático — breadboard y circuit son motores independientes. Actualmente, crear dos vistas del mismo prototipo significa escribir dos DSLs.
• Catálogo de partes fijo — los tipos de partes definidos por el usuario están diferidos. v0.1 incluye el catálogo del 80% de los tutoriales maker (resistencias, LEDs, capacitores, DIPs, headers, cuatro familias de MCU, seis módulos de sensor / pantalla / actuador).
• Visual del corte de riel de alimentación — los boards de tamaño completo marcan el corte 30/31 con una brecha del ancho de un orificio; las franjas del riel aún se dibujan a través de la brecha (cosmético).

Ejemplos relacionados

Escenarios listos para usar de la galería de ejemplos: