Placas

La Arduino Leonardo

La Arduino cuyo conector USB va directo al chip: una ATmega32U4 a 16 MHz, con Serial en el USB y Serial1 un puerto propio en los pines 0 y 1.

La descripción general, con ejemplos en ejecución, está en la página de la placa y El modelo de Arduino Leonardo (todos los registros).

Qué es

Un ATmega32U4 en su encapsulado de 44 pines, sobre el mismo núcleo AVR que el Uno, con 32 KB de flash, 2560 bytes de SRAM y 1 KB de EEPROM. Los registros están en sus direcciones reales, así que un sketch compilado aquí funciona en la placa que tienes sobre la mesa. La página de referencia es El modelo de Arduino Leonardo.

La placa mide 68.6 por 53.3 mm (el contorno de un Uno a la décima de milímetro), y los headers para shields coinciden agujero por agujero con los de un Uno. Como un Uno, no entra en una protoboard: conéctala con jumpers desde los headers.

Serial es el USB

Esto es lo que hay que entender de un Leonardo, y lo que sorprende a quienes llegan desde un Uno.

En un Uno un segundo chip convierte el USB en un UART, y Serial es el USART0 del microcontrolador. En un Leonardo no hay segundo chip: el dispositivo USB está en el propio ATmega32U4, y Serial es un endpoint CDC que el firmware del propio sketch abre. Serial1 es el UART real, y sale por los pines 0 y 1 del header.

Así que en el editor:

  • Lo que imprimes en Serial aparece en el monitor serie.
  • Lo que imprimes en Serial1 sale por el pin 1 como bits. Conéctalo a algo (el pin 0, un osciloscopio, otra placa) o no llega a ningún lado.

El programa Serial integrado imprime en ambos, así que la diferencia se ve en pantalla.

Mokxi modela el USB como un tubo de bytes en los registros reales del endpoint: suficiente para un puerto serie, y nada por encima. No hay enumeración, ni descriptores, ni host, así que while (!Serial) {} regresa de inmediato aquí y se queda esperando en una mesa real.

Keyboard.h, Mouse.h y Joystick.h compilan y funcionan. Como no hay una computadora al otro lado del cable, cada pulsación, movimiento o cambio de botón se imprime en el monitor serie como una línea en su lugar ([Keyboard] press Ctrl). En la placa de tu mesa el mismo programa es un teclado, ratón o control de videojuegos USB real.

El programa que Mokxi compila lleva un dispositivo USB serie real para la placa de tu mesa. Enviado a un Leonardo, un Micro o un Pro Micro, aparece como un puerto serie, Serial llega al monitor serie del Arduino IDE o a cualquier terminal, while (!Serial) espera a que alguien abra el puerto, y Cargar puede reiniciarlo hacia su bootloader como lo hace el Arduino IDE.

Pins

Veinte en los headers del shield y tres en el header ICSP, numerados como los numera el serigrafiado y el núcleo de Arduino:

  • 0 a 13 a lo largo del header digital, con el LED L en el 13.
  • A0 a A5 en la parte de abajo.
  • 14, 15 y 16 en el header ICSP: MISO, SCK y MOSI (abajo).
  • A6 a A11 son segundos nombres para los pines digitales 4, 12, 6, 8, 9 y 10, porque en este chip el ADC llega a los puertos B y D además del puerto F.

Siete pines hacen PWM por hardware con analogWrite: 3, 5, 6, 9, 10, 11 y 13.

SDA y SCL son los pines 2 y 3, no A4 y A5 como en un Uno. Los dos agujeros junto a AREF son el mismo metal que los pines 3 y 2. Ese es el único lugar donde la huella de shield compartida no es el chip compartido, y es lo primero que hay que revisar cuando un sketch pasa de una placa a otra.

SPI solo está en el header ICSP, el bloque de 2x3 pads del borde derecho, como en la placa real. Sus pads MISO, SCK y MOSI son los pines 14, 15 y 16, y sus otros tres pads son un segundo 5V, RESET y GND. Los pines 11, 12 y 13 no son SPI en un Leonardo, así que un módulo SPI conectado ahí como en un Uno no responde: mueve sus tres cables de bus a los pads del ICSP.

Un temporizador que ningún otro tiene

El Timer 4 de este chip mide diez bits, su TOP es un registro y no un modo, y sus canales de comparación son A, B y D. No hay canal C, porque OCR4C es TOP. Maneja los pines 6 y 13.

analogWrite hides all of that, so the sketch looks ordinary. The built-in Fade program puts an LED on pin 13 and another on pin 9, which is an ordinary 16-bit timer, so both kinds of PWM hardware are running at once: 976 Hz on 13 and 490 Hz on 9.

Interrupts

Cinco pines tienen interrupción externa: 3, 2, 0, 1 y 7. El pin 7 es el interesante. Es INT6, el único que esta placa saca que no es uno de los primeros cuatro pines, y el programa integrado Button lo usa.

Pasa un pin por digitalPinToInterrupt() y attachInterrupt() hace el resto, como en la placa real.

Bibliotecas estándar de Arduino

Un tutorial que incluya Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h con Adafruit_SSD1306.h y DHT.h se compila aquí tal cual. Cada uno es un header propio de Mokxi con el nombre original, escrito sobre los controladores de los componentes de la caja, y nada de eso es código de la biblioteca original.

  • Wire.begin() pone el bus I2C en 2 (SDA) y 3 (SCL).
  • SPI.begin() pone el bus SPI en el header ICSP: SCK es 15, MISO 14 y MOSI 16. SS es 17, el pin del indicador RX, que no tiene pad, así que dale al chip select del módulo cualquier pin libre.
  • EEPROM.h usa el propio 1 KB de EEPROM del chip, a través de sus registros reales. Conserva lo que escribiste tras presionar el botón de reset de la placa, y una nueva ejecución la inicia borrada, cada byte en 255, porque una ejecución es una placa nueva.
  • Adafruit_NeoPixel.h maneja una tira de WS2812. El bit se cronometra en ensamblador AVR, como lo hace toda biblioteca NeoPixel para AVR, y a 16 MHz cada nivel alto cae dentro de la ventana de la hoja de datos. Las interrupciones se apagan mientras sale un fotograma, así que millis() pierde un tick por cada milisegundo que tarda el envío de una tira larga, como en el banco de trabajo. Los colores ocupan tres bytes por LED de los 2560 bytes de RAM del chip.

El editor de código y la compilación enumera lo que cubre cada una y en qué difiere de la biblioteca original.

The firmware

Cuatro programas integrados: Blink, Button, Serial y Fade.

El código fuente de un sketch de Uno normalmente compila para el Leonardo. Un ELF compilado de un Uno no funciona en él: chip distinto, mapa de registros distinto, tabla de vectores distinta. Compílalo para el Leonardo y funciona.

Lo que no está modelado

La pila USB sobre el tubo de bytes: Keyboard, Mouse y Joystick imprimen sus reportes en el monitor serie en lugar de llegar a una computadora. Serial aquí es un tubo de bytes sin protocolo debajo: no hay enumeración, ni descriptores, ni configuración de endpoints, ni suspensión ni reanudación, ni reinicio por conexión a 1200 baudios, así que lo que hace de un Leonardo un Leonardo (un sketch esperando en while (!Serial)) es una decisión que este modelo toma y no un saludo que ejecuta.

SPI, TWI/I2C, el comparador analógico, el sensor de temperatura y el PLL que haría correr el Timer 4 más rápido que 16 MHz. Los shields no son componentes físicos aquí; conecta el mismo circuito en la protoboard. El Leonardo ETH no está modelado. El Micro y el Pro Micro son el mismo chip con otras distribuciones de pines, y están en la caja de componentes como placas propias.

Las direcciones son las de la hoja de datos y ninguna se adivina; las aproximaciones son de comportamiento, y la sección 8 de el modelo de Arduino Leonardo clasifica cada una. Las tres que se notan en el banco de trabajo: el ADC no tiene error (sin muestreo y retención, sin no linealidad, sin ruido, sin desviación), así que un divisor entrega la misma cuenta cada vez donde uno real titubea; el cristal de 16 MHz es exacto, sin deriva ni jitter; y el riel de 5 V es una fuente ideal que no puede caer, así que un circuito que dejaría fuera de operación a una placa real corre limpio aquí.