breadboard
documentación

15 · Cuando algo falla

Solución de problemas

Qué significan los diagnósticos, los errores habituales del montaje y cómo corregirlos.

Entender los diagnósticos

floating pin
Entrada sin conexión. Las entradas lógicas y los pines del microcontrolador necesitan un nivel definido. Conéctala o añade una resistencia pull-up.
short circuit
La fuente encuentra un camino de casi cero ohmios. Sigue el riel + con el cursor hasta ver dónde cae el voltaje.
bus contention
Dos salidas push-pull fuerzan niveles distintos en el mismo nodo. Una debe ser entrada (o usa una resistencia).
component burned out
Se superó su límite demasiado tiempo. Corrige el diseño (¿resistencia en serie?, ¿mayor potencia nominal?) y pulsa ⟲ Restart para reponer el componente.
firmware error
Abre Engine status en la cabecera para ver los detalles y revisa Serial. Comprueba que el archivo corresponda a esta placa y perfil de firmware; una demostración que parpadea no prueba que tu archivo se haya ejecutado.
convergence failure
El cálculo no se estabilizó, normalmente por un circuito extremo (bucles ideales, ganancia enorme). Añade resistencia realista.

Los problemas habituales

  • «El LED no enciende». Ánodo y cátodo invertidos, falta la conexión de la resistencia en serie o la simulación está en pausa, por orden de probabilidad.
  • «Mi script MicroPython no se ejecutó». Primero comprueba que la placa tenga firmware MicroPython, alimentación y una simulación activa. Abre Serial, espera el indicador >>> y pulsa Run on board. Los proyectos compartidos esperan ese clic. Un traceback es un error de Python: léelo en Serial. Consulta cargar firmware en Pico (página en inglés) y el flujo de Code (página en inglés).
  • «El botón no hace nada en el firmware». La entrada necesita un nivel definido. Las resistencias internas funcionan en ESP32-C3, S3 y C6 (Pin(n, Pin.IN, Pin.PULL_UP)) y en las placas AVR (INPUT_PULLUP); el ESP32 clásico no las modela, así que añade una resistencia pull-up externa de ~10 kΩ como en sus ejemplos.
  • «I²C no encuentra nada». Haz una búsqueda primero: I2C(0, scl=Pin(9), sda=Pin(8)).scan() en C3 y S3 (el bus predeterminado del C6 es scl=Pin(22), sda=Pin(23)). ¿Ningún dispositivo? Comprueba la alimentación del sensor (3V3) y que SDA/SCL no estén intercambiados.
  • «El MQ-2 da alarma enseguida o marca un valor alto». Es el calentamiento inicial; los sensores MQ reales lo hacen. Espera aproximadamente 5 s; la alarma se suprime hasta que se estabiliza.
  • «El papel electrónico no muestra nada». Escribir en RAM no se ve hasta que Master Activation (0x20) completa la actualización (~1.38 s para la secuencia OTP completa de 1.54″), así que consulta BUSY como en el ejemplo de la credencial.

El proyecto se abre, pero faltan el firmware o los archivos

Selecciona la placa o tarjeta microSD afectada y revisa el Inspector. El proyecto puede referenciar archivos cargados que no están en este navegador. Vuelve a cargar el original o compila el código Arduino guardado para la placa correcta. Consulta qué contiene un proyecto guardado.

Rendimiento

El indicador bajo Build · Code · Test compara el tiempo simulado con el real cuando el banco se retrasa: 1× equivale a un segundo simulado por segundo real; 0.5× significa que un segundo simulado tarda dos reales. El arranque del firmware, los bucles de espera activa y muchos componentes conmutando pueden reducir la relación. Los retardos del script siguen el tiempo simulado y pueden tardar más en tu reloj. Pausa cuando no necesites ejecutar el circuito (editar el circuito ya la pausa) y cierra otros montajes que consuman recursos.

Informar de un problema de traducción