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 esscl=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.