Para qué sirve
Un LED parpadeante te dice que la placa está viva. No te dice cuánto valía count cuando la luz se apagó, ni si se tomó la rama que acabas de escribir. El depurador sí: presiona Ejecutar, detén la placa en una línea y lee los registros y tus propias variables en ese instante.
Mientras la placa está detenida, todo lo demás también lo está. El LED conserva el brillo que tenía, el servo se queda en su ángulo, los temporizadores del chip se detienen donde estaban. Así que al presionar Continuar, millis() continúa desde la instrucción que estabas mirando y no salta hacia adelante por todo el tiempo que pasaste leyendo.
Poner un punto de interrupción
Haz clic en el margen estrecho a la izquierda de los números de línea. Aparece un punto rojo, y la placa se detendrá antes de que se ejecute esa línea: lo que ves en pantalla todavía no ha ocurrido.
Presiona Ejecutar. Una placa con un punto de interrupción siempre se compila a partir de los archivos que tienes frente a ti, aunque la sección Firmware de la placa nombre un programa integrado. Un punto de interrupción está en una línea de este código, y los programas integrados se distribuyen sin la información que dice a qué instrucción corresponde cada línea.
Haz clic en el punto otra vez para quitarlo. Quitar todos en la pestaña Depurar quita todos los puntos de interrupción de esa placa a la vez.
Una pestaña de ensamblador tiene el mismo margen y funciona igual. Un punto de interrupción en una línea de un archivo .S se detiene en esa línea, porque los números de línea que registra la compilación son los de la propia pestaña y no los de la copia preprocesada.
Un punto hueco
Un punto hueco significa que el punto de interrupción está donde lo pusiste y no hace nada: el compilador no generó ninguna instrucción para esa línea. Las líneas en blanco, los comentarios, las declaraciones sin código y las líneas que el optimizador eliminó se ven así. Muévelo a la siguiente línea que haga algo.
La barra junto a Ejecutar
Pausa detiene la placa donde esté. Se convierte en Continuar, que la deja seguir.
Saltar línea ejecuta una línea de código fuente, llamadas incluidas: una línea que llama a delay(500) tarda 500 ms de tiempo simulado y el resto del circuito vive todo eso, porque es lo que ocurre en realidad.
Entrar ejecuta hasta la siguiente línea que alcanza la placa, que es la primera línea de una función que llama la línea actual.
Un paso puede acortarse por un punto de interrupción más adelante, y ahí se detiene y lo avisa. El único punto de interrupción que nunca acorta un paso es aquel desde donde empezó el paso: una interrupción tomada en ese instante (un temporizador, un pin, el tick que cuenta millis()) ejecuta su rutina y devuelve la placa justo a la línea en que estabas, y detenerse ahí significaría que la presión no hizo nada.
Salir está en gris, y su tooltip dice por qué: tendría que averiguar a dónde regresa la función actual, y el depurador no lee la pila de llamadas. Pon un punto de interrupción en la línea siguiente a la llamada.
Paso de instrucción, en la sección Desensamblado de la pestaña Depurar, ejecuta exactamente una instrucción de máquina en lugar de una línea completa.
En un celular la barra se muda a la pestaña Depurar, donde hay espacio para ella.
La pestaña Depurar
Junto al monitor serie en la parte inferior de la ventana (su propia pestaña en la hoja en un celular), con cinco cosas dentro.
Dónde se detuvo, en una línea: el archivo y la línea, la dirección, y por qué se detuvo: un punto de interrupción, un paso o Pausa. Cuando la tabla de líneas no cubre la dirección, muestra la dirección y lo avisa, en lugar de nombrar una línea de la que no está seguro. "Dentro de sketch.ino:14" significa que la placa está a mitad de esa línea, no al inicio, y el resaltado en el panel de código se dibuja más tenue para reflejarlo.
Registros, con los nombres que el propio núcleo usa: a0 y sp en un ESP32-C3, r24 y sreg en un Uno. Se leen del núcleo en la detención, así que son lo que contiene ahora y no lo que contenía la última vez. El pc va primero, y es la instrucción que se ejecutará después.
Un registro de estado también se escribe junto a su número, porque ocho bits no son un solo valor. En un AVR, sreg muestra sus banderas como ITHSVNZC, con un punto en lugar de cada bandera que está en cero, así que una detención justo después de un cp muestra de un vistazo si se tomará la rama. En una placa ARM, xpsr muestra N Z C V Q de la misma forma.
Desensamblado es el código de máquina alrededor de la detención. Cada fila es una instrucción: su dirección, sus bytes, la instrucción misma con la ortografía que usa llvm-objdump, y la línea de código fuente donde empieza, que es un botón que te lleva a esa línea en el panel de código. La instrucción que está por ejecutarse queda marcada. Paso de instrucción, arriba de la sección, ejecuta esa instrucción y redibuja la lista.
Esta es la vista para abrir en una pestaña .S: la línea que escribiste está junto a los bytes a los que se ensambló. Funciona igual de bien en un sketch, donde muestra lo que el compilador hizo con una línea de C++. Una placa que no se ha compilado desde sus archivos lo avisa, porque no hay programa que leer hasta que presiones Ejecutar.
Observar toma el nombre de una variable global. Empieza a escribir y ofrece las que tiene tu programa. Cada fila muestra el tipo tal como lo registró el compilador y cuántos bytes ocupa ese tipo, luego el valor, leído de la memoria de la placa en cada detención. Un nombre que el programa no tiene lo avisa en lugar de mostrar un cero. Un struct o un arreglo muestra sus bytes, dirección baja primero, porque son bytes y no un solo número.
Puntos de interrupción lista todos los de esta placa con la dirección a la que se resolvieron. Haz clic en uno para saltar a él en el código.
Lo que hace el monitor serie mientras tanto
Nada cambia. Todo lo que una placa imprimió antes de la detención sigue ahí, y lo que imprima después de continuar aparece debajo. Detener una placa no es detener la ejecución.
Dos placas
Cada placa tiene sus propios puntos de interrupción, su propia lista de observación y su propia detención. El depurador actúa sobre la placa que muestra el panel de código, que es la que nombra el selector encima de las pestañas.
En qué placas funciona
En todas. Cada placa que tiene Mokxi responde al depurador: la ESP32-C3 y la ESP32-C6, la ESP32 y la ESP8266, la Arduino Uno, Nano, Mega, Leonardo y Uno R4 Minima, la ATtiny85, la Raspberry Pi Pico y Pico W, la STM32 Black Pill y Blue Pill, la BBC micro:bit y la Seeed XIAO SAMD21.
Los registros son los que tiene el núcleo de cada placa, con los nombres que usa su propia documentación: a0 y sp en una ESP32-C3, r24 y sreg en una AVR, r0, lr y xpsr en cualquier cosa con un ARM dentro, a0 a a15 en las placas Xtensa (la ESP32, la ESP32-S3 y la ESP8266). Así que lo que lees en el panel es lo que leerías en el componente real.
Salir del paso está en gris en todas las placas, por la razón que da su tooltip.
La barra todavía puede ponerse en gris, por una razón que no tiene nada que ver con la placa: aún no hay nada en ejecución, o el componente que muestra el panel de código no corre ningún programa (una resistencia no se puede detener). Una placa que el depurador de verdad no pudiera alcanzar se nombraría a sí misma ("El depurador aún no es compatible con mega1."), y ya ninguna placa hace eso. Una placa a la que sí alcanza nunca está en gris por falta de un punto de interrupción: Pausa funciona en cuanto la placa está en ejecución, haya o no un punto de interrupción.
Related
- El editor de código y la compilación
- Escribir en ensamblador
- Ejecutar y el monitor serie
- No aparece nada en el monitor serie
- Cómo depurar código de Arduino: un método, impresiones por Serial y el plóter, con un ejemplo resuelto