les vencimos · offline
L36. Depurar: no enciende, pin mal, masa, USB
Maestro
Cuando no funciona, se mira en orden y se cambia una sola cosa. Casi nunca es la placa en abstracto. Es el pin que no es, la masa que no llega, el USB que no alimenta, la lógica al revés, o una placa de 3,3 tratada como si fuera un Uno.
No enciende nada, ni el LED del 13 con el parpadeo más simple. Mira el USB: hay alimentación, el entorno dice que subió. Prueba ese parpadeo antes de probar el proyecto entero. Si el 13 tampoco vive, no sigas con el sensor.
Pin mal. El cable está en el 12 y el programa habla del 11. El pin 13 además lleva el LED de la placa: si esperabas ese agujero libre para otra señal, no lo está. Cuenta los agujeros en la serigrafía, no en la memoria.
Masa. El LED, el botón y el sensor necesitan el mismo GND que la placa. Un circuito casi completo, sin masa, está apagado con razón. En pull-up, apretar es LOW. Si tu if espera HIGH, la luz irá al revés y te parecerá rota.
Tensión. Uno y Nano clásico, 5 voltios. Nano 33, ESP, MKR y mucha placa nueva, 3,3. Un divisor o un eco pensado a 5 voltios no se condena por no funcionar en la otra familia: se aparta. Y si algo huele o quema, se desconecta. No se reintenta.
Montaje
Pines de esta lección
Por qué
Un fallo en un proyecto propio da más vergüenza y es el mismo de siempre. Se vuelve al LED del 13 con un sketch de parpadeo que ya conoces. Si el 13 no parpadea, no mires el sensor nuevo: la placa, el cable USB o el puerto están mal. Si parpadea, la placa vive y el bicho está en lo que añadiste.
Se añade una pieza cada vez, con el parpadeo aún dentro, o con un println de setup. La pieza nueva que mata el parpadeo es la culpable: un servo que reinicia, un pin 0 ocupado, una masa que ya no es común. Se quita esa pieza y se confirma que el parpadeo vuelve.
Los números se anotan. Umbral, pin, velocidad del monitor. Dentro de una semana el sketch no recuerda por qué 400. Un comentario de una línea y el papel de la mesa sí. Depurar sin notas es repetir la noche.
Soldar viene después de depurar, no antes. Estaño sobre un circuito que no funciona es un fallo permanente. La protoboard es el lugar donde se permite el error.
Práctica
- Carga el parpadeo simple del pin 13, sin el resto del proyecto conectado.
- Si no parpadea, para aquí: cable, puerto, placa. Lista de la lección de cuando no responde.
- Conecta solo la masa y la alimentación del sensor. RESET. ¿Sigue el parpadeo?
- Conecta la señal. ¿Sigue? Si la placa se reinicia, esa señal o esa carga pide de más.
- Anota en el papel la pieza que lo rompió.
- Corrígela sola. No aproveches para cambiar el umbral.
- Cuando el parpadeo sobreviva a todas las piezas, ya puedes quitarlo y dejar el programa de verdad.
Anota el montaje
Escribe qué cable va a qué pin, o qué has entendido del paso. Se guarda en este aparato.
Ejemplos resueltos
Se depuró el sensor con la placa muerta
El USB estaba en un puerto que no carga. Se recalibró el LDR una hora. El 13 nunca llegó a parpadear con el sketch de prueba, y nadie lo miró.
Primero el 13, siempre. Un minuto de parpadeo conocido ahorra la hora.
Se soldó para que no se soltara el cable sospechoso
El cable se soltaba y se llevó a estaño el circuito entero, incluido el error de pin. Ahora el pin equivocado está fijo.
Se prueba en protoboard hasta que sobrevive a un RESET y a un golpecito en la mesa. Luego se suelda, copiando, no inventando.
Soldadura y seguridad
Regla de esta lección: no hay soldador hasta que el parpadeo testigo convive con el circuito. Si sueldas, placa apagada, una unión brillante, sin puentes, y sin ningún hilo hacia un enchufe de pared.
Un circuito soldado que no funciona se depura igual, con la lista, no con más estaño. Añadir estaño a una soldadura fría está bien; añadirlo a un pin equivocado lo empeora.
En la mesa
Desmonta el proyecto hasta dejar solo el pin 13 y su parpadeo conocido. Es violento y es el método. Si no parpadea, no vuelvas a montar nada: arreglo de cable, puerto y placa. Si parpadea, añade la alimentación y la masa del sensor, sin la señal. RESET. Sigue. Añade la señal. RESET. El paso que mate el parpadeo es el culpable, y se anota con su nombre, no con la palabra raro.
No soldarás en esta prueba. Si una mano sujeta un cable para que pase, ese cable es el fallo, no un asistente. Se cambia el cable. Cuando el parpadeo sobrevive a un golpecito en la mesa, puedes pensar en estaño, en otra sesión, con la placa apagada.
Guarda el sketch del parpadeo testigo con un nombre claro en el ordenador. Va a ser la primera herramienta cada vez que un proyecto propio se calle. No lo mezcles con el proyecto hasta perderlo.
Ejercicio
Coge un fallo que ya tuviste, o el más probable. Escríbelo en cinco pasos: ¿sube el parpadeo del 13?, ¿el número de pin coincide?, ¿hay masa común?, ¿la lógica HIGH/LOW es la del montaje?, ¿la placa es de 5 voltios?
Autoevaluación
1. Si el proyecto no va, ¿qué sketch pruebas primero?
El parpadeo del LED del pin 13. Si ese no vive, no sigas.
2. En el montaje del curso, apretar el botón a GND con pull-up, ¿qué valor es el dedo?
LOW. Si el if espera HIGH, la luz va al revés.
3. ¿Qué haces si un chip quema?
Desconectar. No insistir.