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
Serialaparece en el monitor serie. - Lo que imprimes en
Serial1sale 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:
0a13a lo largo del header digital, con el LEDLen el 13.A0aA5en la parte de abajo.14,15y16en el header ICSP:MISO,SCKyMOSI(abajo).A6aA11son 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 en2(SDA) y3(SCL).SPI.begin()pone el bus SPI en el header ICSP:SCKes 15,MISO14 yMOSI16.SSes 17, el pin del indicadorRX, que no tiene pad, asà que dale al chip select del módulo cualquier pin libre.EEPROM.husa 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 en255, porque una ejecución es una placa nueva.Adafruit_NeoPixel.hmaneja 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à quemillis()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Ã.
Related
- La página de la placa: /boards/leonardo
- El documento del contrato: el modelo de Arduino Leonardo
- El mismo chip en una protoboard: el Arduino Micro y el Pro Micro
- Proyecto inicial: Leonardo fade