Placas

La Arduino Uno R4 Minima

El Uno que todos compran hoy: la misma placa, los mismos pines de 5 V, con un Arm Cortex-M4 debajo en lugar de un AVR de 8 bits.

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

Qué es

Una Renesas RA4M1 a 48 MHz: un Arm Cortex-M4 con 256 KB de flash y 32 KB de SRAM, donde una Uno R3 trae una ATmega328P a 16 MHz con 32 KB y 2 KB. La placa mide 68.6 por 53.3 mm, el contorno de la Uno a la décima de milímetro, así que acepta un shield de Uno y no entra en una protoboard: conéctala con jumpers desde los headers. La página de referencia es El modelo de Arduino Uno R4 Minima.

Esta es la Minima, la del socket USB-C y sin WiFi. La Uno R4 WiFi, con su matriz de LED y su WiFi, es una placa aparte en la caja de componentes: consulta la Uno R4 WiFi.

Serial es el USB

Esto es lo primero que sorprende a quien llega de una Uno R3.

En una Uno un segundo chip convierte el USB en un UART, y Serial es el USART0 del microcontrolador en los pines 0 y 1. En una R4 no hay segundo chip: el dispositivo USB está en la propia RA4M1. Serial es el socket, y Serial1 es el UART en los pines 0 y 1, un puerto propio.

Así que en el editor:

  • Lo que imprimes en Serial aparece en el monitor serie.
  • Lo que imprimas en Serial1 también aparece en el monitor (aquí una placa tiene un canal hacia el host), y sale por el pin 1 como bits, así que un osciloscopio o una segunda placa conectada a ese pin lo ve.

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

Mokxi modela el USB como una tubería de bytes con los nombres de los registros: 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 pausa un momento en el escritorio.

Pins

Veinte, contados como los cuenta la serigrafía:

  • 0 a 13 a lo largo del header digital, con el LED integrado en el 13.
  • A0 a A5 por la parte de abajo, que también son los pines digitales 14 a 19.

El LED del 13 es activo en alto: digitalWrite(LED_BUILTIN, HIGH) lo enciende, como en una Uno.

Seis pines hacen PWM por hardware con analogWrite, a 490 Hz: 3, 5, 6, 9, 10 y 11: los seis con una virgulilla en la serigrafía, los mismos seis que una Uno.

SDA y SCL junto a AREF son A4 y A5, como en una Uno. Una sola pista, dos agujeros.

No hay INPUT_PULLDOWN en este chip. Un pin de la RA4M1 tiene una pull-up y nada más; pedir una pull-down da una entrada flotante común, y el runtime lo dice en lugar de fingir.

El ADC es de catorce bits y analogRead te da diez

El convertidor de la RA4M1 es de catorce bits, de 0 a 16383. analogRead devuelve diez (0 a 1023) porque eso es lo que hace el núcleo de Arduino y lo que espera todo sketch escrito para una Uno: analogRead(A0) > 512 tiene que significar lo mismo en ambas placas.

Llama a analogReadResolution(14) y obtienes los catorce completos. El programa integrado Analog imprime ambos desde el mismo pin, con medio segundo de diferencia, para que la diferencia se vea.

La escala completa es el riel de 5 V, no de 3.3, y por eso un sensor escrito para una Uno pasa sin un divisor.

No hay attachInterrupt

En una RA4M1, qué evento de periférico llega a qué interrupción se programa en los registros de enlace de eventos de la ICU. La ICU no se modela aquí, y sus números de evento no son algo que este modelo pueda afirmar con honestidad, así que se omitió en lugar de inventarse. Nada levanta una interrupción de periférico; el SysTick, que es una excepción del núcleo y no necesita enlace, es toda la historia de las interrupciones.

Así que el sketch hace sondeo. Para un botón (que es lo que son la mayoría de los sketches con attachInterrupt), eso es lo que la mayoría de los sketches hacen de todos modos, y el programa integrado Button está escrito así.

El punto flotante funciona, y es soft float

La RA4M1 real tiene una FPU de precisión simple. El núcleo en el que corre este modelo no, así que el runtime está compilado para soft float: la aritmética de float da los resultados correctos y se hace en instrucciones enteras. Un binario compilado en otra parte con un ABI de hard float falla en su primera instrucción VFP en lugar de devolver un número equivocado.

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 A4 (SDA) y A5 (SCL).
  • EEPROM.h funciona, pero el modelo no tiene la data flash de la RA4M1, así que los bytes viven en 4 KB de RAM: se leen de vuelta dentro de una ejecución y desaparecen al reiniciar.
  • Adafruit_NeoPixel.h controla una tira WS2812. El núcleo temporiza cada bit con el SysTick a 48 MHz, dentro de las ventanas de la hoja de datos, con las interrupciones desactivadas durante el fotograma.

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 Analog.

El código fuente de un sketch de un Uno normalmente compila para la R4. Un ELF compilado de un Uno no funciona en ella: arquitectura distinta, mapa de registros distinto, tabla de vectores distinta. Compílalo para la R4 y funciona.

Qué es exacto y qué no

Algunas de las direcciones de este modelo provienen del manual de usuario de la RA4M1 y otras son suposiciones del propio modelo. Esa distinción está escrita en lugar de pasarse por alto: la sección 7 de el contrato enumera, una por una, qué números son cuáles.

Y qué es aproximado, en contraste con lo no verificado. El núcleo corre a 48 MHz sin importar cómo estén programados los registros de reloj, porque el árbol de relojes no está modelado. El ADC14 no tiene error alguno: sin muestreo y retención, sin no linealidad, sin ruido y sin desplazamiento. Los pines son tres estados y un umbral, sin histéresis y sin configuración de fuerza de señal. El riel de 5 V es una fuente ideal que no puede caer. Y el conducto de Serial nunca se llena, así que un sketch que en un escritorio se atascaría contra un límite de fotograma USB aquí nunca espera.

En resumen: el núcleo, el reloj, el mapa de memoria, los registros de puerto y PFS, el SCI y el mapa de pines son del manual. La dirección base del GPT y sus desplazamientos de registros, los desplazamientos del ADC14, los registros USB, los canales del convertidor de A4 y A5, y qué canal GPT corresponde a cada pin PWM, son supuestos y están marcados como no verificados. El reloj y millis los comprueba una prueba que ejecuta el firmware de fábrica (crates/unor4/tests/runtime.rs), no es solo una afirmación.

Lo que no está modelado

Una pila USB por encima del conducto de bytes. La ICU y, con ella, todas las interrupciones de periféricos. La AGT, el circuito de generación de reloj, los watchdog, I2C, SPI, CAN, la DTC, la RTC, la DAC, los comparadores y la unidad táctil. Los binarios del fabricante (el Renesas FSP y el núcleo de Arduino R4) no corren aquí; el entorno de ejecución del firmware es nuestro. Los shields no son componentes físicos aquí; conecta el mismo circuito en la protoboard.