Por qué molestarse
Porque algunas cosas solo son ciertas una instrucción a la vez. Un curso que enseña el AVR o el Cortex-M pide un ciclo de espera contado en ciclos, una tabla de vectores escrita a mano y un conjunto de registros que puedes leer en una pausa. Todo eso funciona en el navegador, sobre los mismos chips simulados en los que corren los sketches, sin nada que instalar.
Dos formas de entrar:
- Ensamblador junto a un sketch. Agrega una pestaña
.So.sy llámalo desde C conextern "C". El núcleo de Arduino sigue ahí, así queSerial,millis()ypinMode()siguen funcionando. - Ensamblador sin el núcleo de Arduino. Elige una plantilla en Assembly (no
Arduino) en la sección Firmware de las propiedades de la placa. Los archivos de la placa pasan a ser un solo
main.S, y no se enlaza nada más que tu propio código y el código de arranque.
Pestañas .S y .s
Presiona el + en la tira de archivos y nombra el archivo. El mensaje te dice lo que acepta: "Nombre del nuevo archivo, como config.h, helpers.cpp o delay.S". Todo lo que termine en .S o .s es ensamblador, y se compila y se enlaza con las pestañas .ino y .cpp de la misma placa, exactamente como el IDE de Arduino compila un .S junto a un sketch.
Las dos escrituras no son el mismo archivo:
.S, con S mayúscula, pasa primero por el preprocesador de C.#include <avr/io.h>,#define,#ify//los comentarios funcionan, y__ASSEMBLER__está definido. Este es el que conviene usar..s, con s minúscula, se entrega al ensamblador tal cual. Sin includes, sin macros.
Una pestaña nueva .S o .s no empieza vacía. Se abre con una función que funciona y que el sketch puede llamar, en el conjunto de instrucciones de la propia placa: AVR en el Uno, el Nano, el Mega, el Leonardo y el ATtiny85, y ARM Thumb en la Pico, las placas STM32, el Uno R4, el micro:bit y la XIAO. El comentario que está encima enumera la convención de llamadas, para que tengas las reglas a la vista mientras escribes. Bórrala o construye sobre ella.
Las pestañas de ensamblador tienen su propio resaltado de sintaxis y el margen de puntos de interrupción junto a los números de línea, igual que un sketch.
Llamadas entre C y ensamblador
Una función escrita en ensamblador es una etiqueta .global, y C la alcanza mediante extern "C" para que el nombre no se modifique. Funciona en ambos sentidos: el ensamblador puede llamar a una función de C de la misma forma.
// sketch.ino
extern "C" uint8_t add_bytes(uint8_t a, uint8_t b);
void setup() {
Serial.begin(9600);
Serial.println(add_bytes(2, 40)); // 42
}
void loop() {}
; add.S
.global add_bytes
add_bytes:
add r24, r22 ; a is in r24, b in r22
ret ; the result goes back in r24
Las reglas son las del propio chip, no las de Mokxi, así que una función que las siga también funciona en una placa real.
En las placas AVR (el compilador llama a esto la convención de llamadas de GCC AVR):
- Los argumentos van en
r24, luegor22, luegor20, y así bajando de dos en dos. Un argumento de dos bytes ocupa un par, primero el byte bajo: unintenr25:r24. - El resultado regresa en
r24para un byte,r25:r24para dos bytes yr25:r22para cuatro. r1debe ser cero al regresar. El compilador lo asume en todas partes, así que unmulque lo ensucie necesita unclr r1después.r2ar17,r28yr29pertenecen a quien llama. Empújalos si los usas, y sácalos antes delret. Todo lo demás es tuyo para usar a gusto.
En las placas ARM (el estándar de llamadas de procedimiento de Arm):
- Los argumentos van en
r0ar3, y el resultado regresa enr0. r4ar11pertenecen a quien llama: empújalos a la pila y luego sácalos.- Regresa con
bx lr, y marca la etiqueta.thumb_func.
avr/io.h en un archivo .S
En una placa AVR, #include <avr/io.h> en un .S da los nombres de los registros y de los bits, y se comporta exactamente igual que el de avr-libc. Eso importa, porque una regla les juega una mala pasada a casi todos:
Un nombre de registro es una dirección de datos, no una dirección de E/S. PORTB es 0x25. La dirección de E/S es 32 menos, así que in, out, sbi, cbi, sbic y sbis quieren _SFR_IO_ADDR(PORTB), que es 0x05:
sbi _SFR_IO_ADDR(DDRB), DDB5 ; PB5 is an output
sts TCCR1B, r16 ; a high register, by its data address
Si prefieres escribir los nombres simples en todas partes, pon una línea antes del include y se convierten en direcciones de E/S, tal como lo hace el propio código de arranque de avr-gcc:
#define __SFR_OFFSET 0
#include <avr/io.h>
sbi DDRB, DDB5
El resto del header también funciona:
- Nombres de bits.
DDB5,PINB5,TXEN0,WGM12,OCIE1Ay los demás son sus números de bit, así que(1 << TXEN0)se lee como en la hoja de datos. - Nombres de vectores.
TIMER1_COMPA_vectes__vector_11, así que.global TIMER1_COMPA_vectseguido de la etiqueta crea un controlador de interrupciones al que salta la tabla de vectores. Termínalo conreti. __zero_reg__esr1y__tmp_reg__esr0, bajo esos nombres.- Los registros más allá de los primeros 64, como
UCSR0ByTIMSK1, están mapeados en memoria: léelos conldsy escríbelos consts.
Ensamblador en línea
Algunas instrucciones dentro de una función de C no necesitan una pestaña propia. asm volatile con restricciones funciona en las placas AVR y en las ARM:
uint8_t x = 5;
asm volatile ("lsl %0" : "+r" (x)); // x is 10
El simulador cuenta ciclos, así que un retardo escrito a mano dura exactamente lo que dice la hoja de datos. Un bucle de nop, dec y brne, cronometrado con el Timer 1 al reloj completo, da exactamente la cuenta que la hoja de datos del ATmega328P da a sus instrucciones: un lds, un ldi y 50 vueltas del bucle miden 202 ciclos, ni 201 ni 203. Eso es lo que hace que enseñar a contar ciclos valga la pena aquí.
Ensamblador sin núcleo de Arduino
Abre el panel de propiedades de la placa y mira en la sección de Firmware. En el Arduino Uno, el Nano, el Pro Mini a 16 MHz, la Raspberry Pi Pico y la STM32F411 Black Pill hay un grupo llamado Assembly (no Arduino) con cuatro puntos de partida:
| Punto de partida | Qué hace |
|---|---|
| Blink en ensamblador | Alterna el LED de la placa cada 250 ms con un bucle de retardo contado. |
| De botón a LED en ensamblador | El LED sigue a un botón mantenido a tierra por su resistencia pull-up. |
| Hola por UART en ensamblador | Imprime una línea en el monitor serie dos veces por segundo. |
| Interrupción de timer en ensamblador | Una interrupción de timer alterna el LED, y el bucle principal solo se queda esperando. |
Elige uno y los archivos de la placa se convierten en un solo main.S. Si tienes trabajo propio en la placa, primero se te pregunta. Después de eso la lista de programas conserva el punto de partida del que partiste, y la nota debajo dice que Ejecutar ensambla main.S sin núcleo de Arduino, así que la placa se queda en ensamblador cuando vuelvas.
No hay núcleo de Arduino en la compilación: no hay setup(), ni loop(), ni el tic de millis(), ni Serial. Lo único que se enlaza es esto:
- En una placa AVR, tu archivo más el código de arranque, que es lo que el
gcrt1.ode avr-libc es paraavr-gcc main.S. Es la tabla de vectores con cada__vector_ncomo unretidébil que puedes sobrescribir, luegor1en cero, la pila puesta en RAMEND,.datacopiado desde la flash,.bssen cero, y uncalla tumain. Así que tú escribesmainy los controladores que quieras, bajo los nombres de vectores de avr-libc. Si tu archivo define su propia sección.vectors, no obtienes código de arranque en absoluto y todo el programa es tuyo. - En la Pico y la Black Pill, nada más que tu archivo. Tu archivo es la tabla de vectores:
.word _stack_topen la Pico o.word _estacken la Black Pill, luego.word Reset_Handler, y luego los controladores que quieras, cada uno.thumb_func.
Lo que configuran los puntos de partida, por si quieres leer los registros junto con ellos:
- AVR blink alterna PB5 escribiendo un 1 en
PINB5, que el ATmega328P interpreta como "alternar", y se demora con un bucle externo y uno interno: "250 ms a 16 MHz son 4,000,000 ciclos: 40 por 100,000", y el bucle interno son cuatro ciclos por vuelta. - AVR button lee PD2 con su pull-up activado, así que una pulsación lee 0, y usa
sbicpara saltarse una línea. - AVR UART configura USART0 a 9600 baudios con
UBRR103, guarda el texto en.progmemy lo lee byte por byte conlpm. - AVR timer corre el Timer 1 en modo CTC al reloj entre 256 con
OCR1Aen 31,249, o sea cada 0.5 s, y alterna el LED enTIMER1_COMPA_vect. - Pico saca
IO_BANK0yPADS_BANK0(yUART0para el de UART) deRESETS, maneja GPIO25 por SIO en0xD0000000, se demora conTIMERAWL, se comunica por UART0 en GPIO0 a 115200, y usa la interrupción de la alarma 0 del TIMER para el punto de partida del timer. - Black Pill enciende los relojes en
RCC_AHB1ENR, maneja PC13, que está encendido cuando está en bajo, lee PA0 con su pull-up, imprime por USART1 en PA9 a 115200 conBRR729, y corre SysTick a 1 kHz.
Presiona Ejecutar y la placa lo ejecuta. El monitor serie, el osciloscopio, el analizador lógico y los componentes en el lienzo funcionan como siempre, porque el chip simulado no sabe ni le importa qué lenguaje generó la imagen.
Cuando no ensambla
Los errores del ensamblador caen en la pestaña y la línea correctas, con una frase en español sencillo debajo que dice qué escribir en su lugar. Algunos de ellos:
ldi r3, 5dice que LDI solo funciona con los registros altos, r16 a r31, y que hagasmovdel valor hacia abajo después si lo necesitas en un registro bajo.lid r16, 5dice"lid" no es una instrucción AVR, y te recuerda que una etiqueta termina en dos puntos y una directiva empieza con punto.- Una etiqueta escrita sin sus dos puntos se te devuelve con el nombre y los dos puntos agregados.
- Un salto condicional que no alcanza su destino es colocado en su línea por el enlazador, con la solución:
brne 1f,rjmp far,1:.
Cuatro de ellos son verificaciones que hace avr-as y que el ensamblador de LLVM no hace, así que Mokxi las hace por sí mismo, antes de que corra cualquier herramienta. Sin ellas, un error se ensamblaría en silencio como el programa equivocado:
ldi r16, 300no cabe en un byte. Carga las mitades conlo8()yhi8().sbi PORTB, 5usa la dirección de datos0x25dondesbiquiere una dirección de E/S. Escribe_SFR_IO_ADDR(PORTB).add r16, 5se lee comoadd r16, r5, porque ADD toma dos registros. No existe ADDI: resta el negativo consubi r16, -5.out PORTB, r16sin__SFR_OFFSET 0es una advertencia y no un error, porque sí ensambla: solo escribe un registro distinto del que se nombra.
in y out más allá de la dirección de E/S 63, sbiw y adiw más allá de 63, y un número de bit mayor que 7 se detectan igual, cada uno con la instrucción que se debe usar en su lugar.
En las placas Thumb las comunes son un registro alto en un Cortex-M0+, que alcanza solo de r0 a r7, una forma Thumb-2 de 32 bits en un Cortex-M0+, que tiene solo el conjunto de 16 bits, un salto fuera de rango, un Reset_Handler faltante y un main faltante.
Ejecutando instrucciones paso a paso
Todo en el depurador funciona sobre el ensamblador. Los puntos de interrupción van en el margen de una pestaña .S y se detienen en esa línea, porque los números de línea que registra el ensamblador son los de la propia pestaña, no los de la copia preprocesada.
La pestaña Debug tiene una sección Desensamblado. En una pausa lista las instrucciones alrededor del contador de programa: la dirección, los bytes, la instrucción con la ortografía de llvm-objdump y la línea de código fuente donde empieza cada una, que es un botón que te lleva a ella. La instrucción que está por ejecutarse queda marcada. Paso por instrucción ejecuta exactamente una instrucción de máquina, mientras que Paso por encima y Paso hacia dentro todavía avanzan una línea de código fuente completa a la vez.
Los registros se leen como los del propio núcleo. sreg en un AVR también se escribe con sus banderas, ITHSVNZC, con un punto por cada una que esté en cero, y xpsr en un ARM se escribe como N Z C V Q, porque ocho bits no son un número.
Límites
- Ensamblador sin núcleo Arduino se ofrece en la Uno, la Nano, la Pro Mini, la Pico y la STM32F411 Black Pill. Todas las demás placas todavía aceptan pestañas
.Sy.sjunto a un sketch. - La familia ESP32 no está incluida. El ensamblador Xtensa del propio Clang no está completo para archivos escritos a mano, así que esas placas compilan solo C y C++.
- La Pico W no tiene proyectos iniciales. Su LED está en el chip inalámbrico y no en un pin GPIO. Usa una Pico normal.
- Un proyecto es plano. Los nombres de archivo no llevan directorios, así que una ruta de include tiene un directorio de profundidad.
Related
- El editor de código y la compilación
- El depurador
- El panel de propiedades
- Ensamblador AVR en el navegador: el proyecto inicial de parpadeo línea por línea, conteo de ciclos y una interrupción de temporizador
- Compilando en el navegador: cómo el
.Sis preprocessed, assembled and linked