Nuestro workflow con IA para construir hardware

De software a un robot verificable.

Este es el resultado que vamos a construir.

Un robot de dos ruedas que mide, decide y gira.

Plan del robot de dos ruedas

Primero definimos comportamiento, no componentes.

1Avanza
→
2Mide distancia
→
3Se detiene a 20 cm
→
4Gira y continúa

Estas son las piezas sobre la mesa.

Placa de desarrollo ESP32
ESP32Control y código
Sensor ultrasónico HC-SR04
HC-SR04Distancia
TB6612FNGDriver para dos motores
2 motores DCMovimiento diferencial
4 pilas AAAlimentación de motores
ResistenciasProtección de ECHO

Cada pieza tiene una responsabilidad.

ENTRADAHC-SR04distancia
→
DECISIÓNESP32lógica
→
POTENCIATB6612FNGcorriente
→
SALIDAMotoresmovimiento

El robot tiene dos dominios de energía.

LÓGICA USB → ESP32 → 3.3 V

GPIO, señales y control.

MOTORES 4 × AA → VM → motores

Corriente y movimiento.

Ambos comparten GND. No comparten la misma carga.

Construimos el robot por etapas.

1Sin energía

Revisar continuidad.

2Sensor

Leer distancia.

3Motores

Girar elevados.

4Integración

Unir decisiones.

5Movimiento

Probar en el piso.

El agente empieza con contexto.

Fuentes

Datasheets exactos y pinout de la placa.

Inventario

Componentes y resistencias disponibles.

Restricciones

Voltajes, corriente, pines y alimentación.

Estado real

Conexiones y mediciones confirmadas.

Reservamos los pines antes de pedir código.

SEÑALGPIOREGLA
TRIG17Salida digital
ECHO18Entrada protegida
PWMA / PWMB25 / 13PWM
AIN1 / AIN226 / 27Dirección A
BIN1 / BIN214 / 32Dirección B
STBY33Debe estar alto

En Cursor, pedimos arquitectura antes de código.

CURSOR · GPT-5.6 SOL HIGH 
Usa solo este inventario.

Devuelve conexiones, voltajes,
fuentes, riesgos y una prueba
sin energía.

Detente antes de generar código.
SALIDA REQUERIDA

Mapa Origen → destino

Fuente Datasheet exacto

Riesgo Conexión bloqueada

Prueba Siguiente evidencia

El agente propone un mapa de conexiones.

GPIO 17→TRIGPROPUESTO
ECHO · 5 V→GPIO 18 · 3.3 VRIESGO
GPIO 25 / 13→PWMA / PWMBPROPUESTO
GPIO 33→STBYPROPUESTO

Validamos cada conexión con la misma plantilla.

1Origen

Voltaje y tipo de salida.

2Destino

Límite y dirección del pin.

3Fuente

Documento y revisión exacta.

4Prueba

Continuidad o medición segura.

ECHO entrega 5 V. El GPIO trabaja a 3.3 V.

HC-SR04 ECHO5 V
≠
ESP32 GPIO3.3 V
Conectar directamente puede dañar la entrada.

Corregimos la señal antes de conectarla.

HC-SR04ECHO · 5 V
→
R11 kΩ
→
GPIO 18≈ 3.3 V
→
R22 kΩ → GND
Vout = Vin × R2 / (R1 + R2)

Cursor genera la prueba más pequeña del sensor.

INSTRUCCIÓN

Lee distancia por serial. Usa los pines aprobados. Excluye motores.

const distance = readDistanceCm();
Serial.println(distance);

delay(100);
SERIAL · 115200 46.2 cm 31.8 cm 19.6 cm

Probamos los motores con las ruedas elevadas.

digitalWrite(STBY, HIGH);
setMotorA(80);
setMotorB(80);

1 Medir VM

2 Confirmar STBY alto

3 Girar un motor a la vez

4 Verificar dirección

Ahora unimos medición y movimiento.

const distance = readDistanceCm();

if (distance < 20) {
  stop();
  turnRight();
} else {
  forward();
}

distancia ≥ 20avanzar

distancia < 20detener + girar

Cada estado tiene una evidencia visible.

LEYENDO

La distancia cambia en serial.

AVANZANDO

Ambas ruedas giran al frente.

DETENIDO

PWM llega a cero.

GIRANDO

Las ruedas giran en sentidos distintos.

El sensor funciona. Las ruedas siguen detenidas.

Medimos antes de cambiar código.

Ordenamos hipótesis por costo y riesgo.

H1No llega alimentación a VM.Medir voltaje.

H2STBY sigue en bajo.Medir nivel lógico.

H3PWM o dirección están mal.Revisar señales.

Medimos VM antes de tocar el firmware.

PUNTA ROJAVM
+
PUNTA NEGRAGND
0.0 V Esperábamos aproximadamente 6 V

Con una medición, el agente propone una prueba concreta.

NOSOTROS

VM = 0.0 V. USB activo. Sensor estable. Prioriza una prueba sin cambiar firmware.

CURSOR · GPT-5.6 SOL HIGH

Mide batería antes y después del switch. Corrige el primer punto que pierda voltaje.

VM ≈ 6 V → habilitamos motores → las ruedas giran

El síntoma solo produce respuestas genéricas.

SÍNTOMA SOLO “El robot se reinicia. Arréglalo.”

Delay, reintentos y cambios de librería.

SÍNTOMA + EVIDENCIA Brownout al arrancar motores. La línea de 3.3 V cae.

Revisar alimentación antes de cambiar firmware.

Potencia separada → GND común → medir otra vez

Antes de energizar, verificamos seis cosas.

01Polaridad

02Voltajes

03GND común

04Continuidad

05Pines exactos

06Ruedas elevadas

El robot termina cuando cumple cuatro pruebas.

Lee una distancia real

Avanza recto

Se detiene a 20 cm

Gira y continúa

Robot completo y verificado

Vibecoding hardware = cambiar, medir y actualizar.

1Contexto

Fuentes y montaje.

2Propuesta

Conexiones y código.

3Verificación

Antes de energizar.

4Medición

La realidad responde.

5Actualización

El agente recibe evidencia.

La IA propone.
La realidad responde.

Construye con contexto. Verifica antes de conectar.

QR a crafters.chat
Recursos y comunidad