Esta es la referencia de ingeniería del modelo: qué implementa, registro por registro, para quienes escriben firmware sobre él. Para usar la placa en el editor, empieza por El Arduino Uno R4 Minima y la página de la placa.
El Arduino Uno R4 Minima es un RA4M1 de Renesas (un Cortex-M4 a 48 MHz) con la forma de un Uno. Un componente del kernel (unor4 en crates/parts) envuelve un modelo del SoC RA4M1 (crates/unor4) sobre el mismo núcleo ARMv7-M que la Blue Pill y la Black Pill (crates/cortexm-core). El núcleo se comparte; el chip que lo rodea no, y nada sobre los pines tampoco.
El tipo de catálogo es unor4. Este documento es el contrato, y prevalece sobre cualquier comentario en el código.
Lee primero la sección 7 si vas a llevar una compilación de aquí a silicio real. Este modelo es más pequeño que el RA4M1, y varias de sus direcciones están marcadas como "creídas, no verificadas": la sección 7 dice cuáles, y qué falta por completo. Aquí nada se supone en silencio.
Por qué esto no es una Blue Pill con números distintos
Un RA es un mundo distinto a un STM32, y las diferencias son justo las que hacen tropezar a un sketch:
- Un pin es un registro.
PmnPFSes una palabra de 32 bits por pin que contiene la dirección, el latch de salida, la pull-up, el drenaje abierto, el interruptor analógico, "un periférico es dueño de este pin ahora" y qué periférico. No hayMODER, no hayCRL/CRH, no hayPUPDRniAFR. - Ese registro está protegido contra escritura.
PWPR.B0WIdebe ir en cero yPWPR.PFSWEen uno antes de que cualquier escritura enPmnPFSsurta efecto. Un programa que lo olvida encuentra quedigitalWritefunciona y quepinModeno hace nada. Este modelo lo aplica y cuenta lo que descartó. - Un periférico no tiene reloj hasta que tú lo dices. Cada bit en los registros de parada de módulos se restablece a "detenido". SCI, GPT, ADC14 y USB son inaccesibles (las lecturas devuelven cero) hasta que se escriba
MSTPCRB/MSTPCRD. - Hay pull-up y no hay pull-down.
INPUT_PULLDOWNobtiene aquí una entrada flotante común, y lo avisa. Seriales USB, no un UART. El UART en D0 y D1 esSerial1. En un Uno los dos son lo mismo.- El convertidor es de catorce bits.
analogReadsigue devolviendo diez, porque eso es lo que espera un sketch de Arduino;analogReadResolutionpide el resto. - La flash está en cero. Sin alias, sin pin BOOT, y una palabra de configuración de opciones en
0x400que una pieza real lee al salir del reset. - El LED integrado está activo en alto, como el de un Uno y a diferencia del de una Blue Pill.
1. Pines de la placa (orden del catálogo)
Agujero por agujero, un header de Uno R3, que es lo que permite que un R4 acepte un shield de Uno. La placa mide 68.6 x 53.3 mm.
Fila superior, de izquierda a derecha (14 agujeros): SCL, SDA, AREF, GND, 13, 12, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0.
Fila inferior, de izquierda a derecha (13 agujeros): IOREF, RESET, 3V3, 5V, GNDb, GNDc, VIN, A0, A1, A2, A3, A4, A5.
31 pines. Los nombres duplicados llevan una letra porque los nombres de pines del catálogo son únicos.
SCL y SDA junto a AREF son las mismas dos piezas de metal que A5 y A4: una pista, dos agujeros, como en un Uno. Al manejar cualquier extremo se manejan ambos.
El pin del RA4M1 detrás de cada agujero:
| agujero | pad | además |
|---|---|---|
0 |
P301 | recepción de RXD2, Serial1 |
1 |
P302 | transmisión de TXD2, Serial1 |
2 |
P104 | |
3 |
P105 | PWM |
4 |
P106 | |
5 |
P107 | PWM |
6 |
P111 | PWM |
7 |
P112 | |
8 |
P303 | |
9 |
P304 | PWM |
10 |
P103 | PWM, SS |
11 |
P411 | PWM, MOSI |
12 |
P410 | MISO |
13 |
P102 | SCK, LED_BUILTIN |
A0 |
P014 | AN009 |
A1 |
P000 | AN000 |
A2 |
P001 | AN001 |
A3 |
P002 | AN002 |
A4 |
P101 | AN021, SDA |
A5 |
P100 | AN022, SCL |
Los números de canal de A4 y A5 no están verificados (sección 7). Los otros cuatro sí.
Eléctrico: cada E/S maneja push-pull a 5 V a través de R_STRONG, queda en alta impedancia, o tira hacia arriba a través de 35 k. No hay pull-down interna. Una entrada lee alto a 2.5 V; una red en contención (Unknown) lee 0, y una flotante lee ruido, como en el Uno (docs/uno.md sección 1). 5V y IOREF manejan 5 V a R_SUPPLY, 3V3 maneja 3.3 V, las tres tierras manejan 0 V. RESET lleva una pull-up de 10 k a 5 V, y bajarla de 2.5 V mantiene el núcleo en reset. VIN y AREF son entradas que el modelo lee y con las que no hace nada.
El pin 13 lleva el LED integrado: una carga de 1 k a tierra, añadida solo mientras el pin es una salida, de modo que pinMode(13, INPUT_PULLUP) sigue comportándose bien. El cátodo del LED está en tierra, así que el pin entrega corriente para encenderlo.
2. Mapa de memoria
| flash de código | 256 KB en 0x0000_0000 |
| memoria de configuración de opciones | 0x0000_0400, dos palabras, se almacenan y no se decodifican |
| SRAM | 32 KB en 0x2000_0000 |
| tope de la pila | 0x2000_8000 |
| PORT y PFS | 0x4004_0000, secciones 3.1 y 3.2 |
| parada de módulo | 0x4004_7000, sección 3.7 |
| unidad ADC14 0 | 0x4005_C000, sección 3.5 (presunto) |
| SCI0..SCI9 | 0x4007_0000, cada 0x20, sección 3.4 |
| GPT0..GPT7 | 0x4007_8000, cada 0x100, sección 3.3 (presunto) |
| USBFS | 0x4009_0000, sección 3.6 (presunto) |
The code flash really is at zero. There is no alias and no boot pin to choose one, so the vector table is at address 0 and VTOR's reset value is already right. A flash address that looks like a null pointer is the vector table, not a bug.
Cada segmento PT_LOAD debe caer dentro de la flash o de la SRAM; cualquier otra cosa se rechaza con un motivo y la placa se queda sin programa. La flash de datos (8 KB en 0x4010_0000) y su interfaz de programación no se modelan.
La memoria de configuración de opciones en 0x0000_0400 es donde un RA4M1 real lee OFS0 al salir del reinicio para decidir si los perros guardianes arrancan solos. firmware/unor4/crt0.S pone una palabra ahí y link.ld comprueba que caiga en 0x400; este modelo no tiene perro guardián y no decodifica ninguna de las dos palabras. Una imagen sin esto arranca aquí y se reinicia sola sobre la mesa, y por eso no es opcional.
El núcleo aquí es un Cortex-M4 sin FPU. El RA4M1 tiene una FPU de precisión simple; cortexm-core implementa la parte entera de ARMv7E-M y nada de VFP, CPACR se almacena y no concede nada, y cada codificación VFP genera UNDEFINSTR. Compila el firmware con -mfloat-abi=soft -mfpu=none. La aritmética de punto flotante en un sketch funciona y se hace con instrucciones enteras; un binario con hardware flotante compilado en otra parte falla en su primera instrucción VFP en lugar de devolver un número incorrecto. Cuatro bits de prioridad, como en el chip.
3. Registros de periféricos
Solo se implementa el subconjunto de abajo. Cualquier otra cosa dentro de un bloque mapeado lee 0 y cuenta como acceso errante; cualquier cosa fuera de todo bloque es una falta de acceso. Un módulo con su bit de parada activado (sección 3.7) lee 0 y también cuenta como acceso errante, que es como se ve "el reloj está apagado" desde el bus.
3.1 PORT0..PORT5 (0x4004_0000, cada 0x20)
| offset | registro | mitades |
|---|---|---|
0x00 |
PCNTR1 |
PDR en los 16 bajos, PODR en los 16 altos |
0x04 |
PCNTR2 |
PIDR en los 16 bajos, EIDR en los 16 altos (solo lectura) |
0x08 |
PCNTR3 |
POSR en los 16 bajos activa, PORR en los 16 altos desactiva (solo escritura) |
0x0C |
PCNTR4 |
EOSR/EORR, se almacenan |
PCNTR3 is this part's BSRR, with the halves the other way around from an STM32's: the low half sets. A bit set in both halves of one write ends up clear. digitalWrite is one store to it and cannot race an interrupt handler touching another bit.
PIDR lee el pin, no el registro: una salida push-pull devuelve lo que está impulsando, una entrada o una salida de drenaje abierto devuelve lo último que la placa muestreó de la red.
Se modelan los puertos 0 a 5, lo que cubre todos los pines que la Minima expone y todas las entradas analógicas que tiene el paquete de 64 pines. Las patillas se numeran como puerto * 16 + pin.
3.2 PmnPFS (0x4004_0800, 0x40 por puerto, 4 bytes por pin) y PWPR (0x4004_0D03)
Una palabra de 32 bits por pin en 0x4004_0800 + 0x40*m + 4*n. Los alias de byte y media palabra que da el manual (PmnPFS_BY, PmnPFS_HA) son una unión con el registro de 32 bits, así que en este chip little-endian son su byte bajo y su media palabra baja, y por eso pinMode puede ser una sola escritura de byte.
| bit | nombre | significado |
|---|---|---|
| 0 | PODR |
el registro de salida |
| 1 | PIDR |
el nivel en el pin, solo lectura |
| 2 | PDR |
1 = salida, 0 = entrada |
| 4 | PCR |
la resistencia pull-up interna |
| 6 | NCODR |
drenaje abierto de canal N |
| 10..11 | DSCR |
fuerza de excitación, se almacena |
| 12..13 | EOFR |
evento por flanco, se almacena |
| 14 | ISEL |
habilitación de entrada IRQ, se almacena (sección 3.8) |
| 15 | ASEL |
habilitación de entrada analógica |
| 16 | PMR |
1 = un periférico es dueño del pin |
| 24..28 | PSEL |
qué periférico |
Un pin con ASEL activado está eléctricamente en alta impedancia sin importar lo demás que diga la palabra, y es el único tipo que el convertidor puede muestrear. Un pin con PMR activado sigue al periférico modelado que su PSEL indique e ignora PODR; un PSEL que este modelo no implementa deja el pin sin cambios en lugar de inventar un nivel.
PSEL valores en los que actúa este modelo: 0b00011 GPT y 0b00100 SCI. Ambos son presuntos, no verificados (sección 7).
PWPR es un byte en 0x4004_0D03. B0WI (bit 7) resets set and makes PFSWE (bit 6) no se puede escribir; escribir un cero lo limpia, y luego escribir PFSWE permite escrituras en PFS. Una escritura con B0WI activado deja PFSWE sin cambios. Una escritura PmnPFS mientras PFSWE está en cero no surte efecto, y el modelo la cuenta (protected_writes), porque ese es el fallo silencioso por el que este chip es famoso.
3.3 GPT0..GPT7 (0x4007_8000, cada 0x100)
GPT0 y GPT1 cuentan 32 bits; GPT2 a GPT7 cuentan 16.
| offset | registro |
|---|---|
0x00 |
GTWP |
0x04 |
GTSTR |
0x08 |
GTSTP |
0x0C |
GTCLR |
0x2C |
GTCR |
0x30 |
GTUDDTYC |
0x34 |
GTIOR |
0x38 |
GTINTAD |
0x3C |
GTST |
0x40 |
GTBER |
0x48 |
GTCNT |
0x4C |
GTCCRA |
0x50 |
GTCCRB |
0x54 |
GTCCRC |
0x58 |
GTCCRE |
0x5C |
GTCCRD |
0x60 |
GTCCRF |
0x64 |
GTPR |
0x68 |
GTPBR |
GTCR.CST (bit 0) es el bit de ejecución. GTCR.TPCS (bits 24..26) es el prescaler, PCLKD / 4^TPCS, es decir 1, 4, 16, 64, 256 y 1024; un valor reservado se trata como 1024. GTCR.MD (bits 16..18) se guarda; solo se modela el conteo ascendente en onda sierra. GTSTR, GTSTP y GTCLR reciben una máscara de bits de canales y los inician, detienen o ponen en cero. GTPR y GTPBR se escriben juntos, porque la transferencia del buffer que este modelo haría al final de un ciclo llevaría el mismo valor.
El contador nunca se guarda como un número que avanza: se calcula a partir del ciclo de CPU como (cycle - started) / divider mod (GTPR + 1), así que no puede desviarse del circuito, y una lectura de GTCNT a mitad de un tramo devuelve el conteo en esa instrucción.
The output is this model's own rule, and a simplification. GTIOR.OAE (bit 8) and GTIOR.OBE (bit 24) decide whether GTIOCnA and GTIOCnB are driven; the level is high while the count is below the channel's compare register and low otherwise. A compare of zero is permanently low and a compare above GTPR permanently high, which is what analogWrite(pin, 0) and analogWrite(pin, 255) need. The five-bit GTIOA and GTIOB level-select fields in GTIOR, which on silicon can produce an inverted output or a toggle, are stored and read back and not decoded. firmware/unor4/src/pwm.c writes the setting a real GPT would need anyway, so a build taken to a desk is configured and not merely enabled.
Qué salida GPT corresponde a cada pin PWM:
| pin | pad | salida |
|---|---|---|
3 |
P105 | GTIOC1B |
5 |
P107 | GTIOC2B |
6 |
P111 | GTIOC3A |
9 |
P304 | GTIOC5B |
10 |
P103 | GTIOC4B |
11 |
P411 | GTIOC6A |
Esa tabla no está verificada (sección 7). Los seis pines son los pines PWM documentados de la Minima; qué canal y qué salida corresponde a cada uno es una suposición de este modelo. El modelo y el entorno de ejecución coinciden, así que el firmware compilado aquí funciona aquí.
GPT0 se deja deliberadamente sin usar por el entorno de ejecución.
3.4 SCI0..SCI9 (0x4007_0000, cada 0x20)
Registros de un byte, uno tras otro: las direcciones adyacentes son registros distintos, así que un acceso más ancho alcanza solo el byte en la dirección indicada.
| offset | registro |
|---|---|
0x00 |
SMR |
0x01 |
BRR |
0x02 |
SCR |
0x03 |
TDR |
0x04 |
SSR |
0x05 |
RDR |
0x06 |
SCMR |
0x07 |
SEMR |
0x08 |
SNFR |
0x09..0x0B |
SIMR1..SIMR3 |
0x0C |
SISR |
0x0D |
SPMR |
SCR: TE (5) y RE (4) son los dos interruptores (no hay habilitación maestra), más TIE (7), RIE (6), TEIE (2). SSR: TDRE (7), RDRF (6), ORER (5), FER (4), PER (3), TEND (2). Las banderas de error y RDRF se limpian escribiéndoles un cero y por lo demás son de solo lectura, y RDRF no puede quedarse en cero mientras haya bytes en cola.
Un bit dura 32 * 4^CKS * (BRR + 1) ciclos de PCLKA, según la fórmula del manual N = PCLKA / (64 * 2^(2n-1) * B) - 1. SEMR.ABCS (bit 5) divide el divisor entre dos y SEMR.BGDM (bit 4) lo vuelve a dividir entre dos; ambos se aplican. Todo lo demás en SEMR, y SCMR, SNFR, SIMR*, SISR y SPMR, se guarda y se lee de vuelta sin cambiar nada. La longitud de trama sigue a SMR.CHR, SMR.PE y SMR.STOP.
Los bytes salen a la velocidad de bits, no al instante: TDR más el registro de desplazamiento, así que TDRE regresa en cuanto un byte empieza a salir y TEND cuando termina el último. Un Serial1.println consume tiempo simulado (86.8 us por byte a 115200), exactamente como en el escritorio.
SCI2 es el único canal conectado a un pin aquí: TXD2 en D1 y RXD2 en D0. Los otros nueve existen para que el número de canal sea el índice; sus bytes se cuentan y no van a ninguna parte.
Un pad con PMR activado y PSEL = SCI que es el transmisor de SCI2 se mantiene en alto mientras SCR.TE está activado, que es lo que hace una línea TX real entre tramas. Los bytes en sí van al canal del host, no al cable como forma de onda.
3.5 ADC14 unidad 0 (0x4005_C000)
La dirección base y cada offset de esta sección no están verificados (sección 7).
| offset | registro |
|---|---|
0x00 |
ADCSR (16 bits) |
0x04, 0x06 |
ADANSA0, ADANSA1 |
0x08, 0x0A |
ADADS0, ADADS1 (guardados) |
0x0C |
ADADC (guardado) |
0x0E |
ADCER |
0x10 |
ADSTRGR (guardado) |
0x12 |
ADEXICR (guardado) |
0x20 + 2n |
ADDRn, un resultado por canal |
0xE0 + n |
ADSSTRn, tiempo de muestreo en estados de ADC, se restablece a 0x0B |
ADCSR.ADST (bit 15) inicia un escaneo y permanece activado mientras corre; el firmware lo consulta, y desactivarlo abandona el escaneo. ADCSR.ADCS (bits 13..14): 0 único, 2 continuo; un escaneo continuo se rearma solo. ADCER.ADRFMT (bit 15) mueve el resultado a la parte alta de los dieciséis bits; alineado a la derecha por defecto.
Un escaneo cubre los canales seleccionados en ADANSA0/ADANSA1 y tarda el tiempo de muestreo de cada uno más doce estados de aproximación sucesiva. PCLKC es ICLK / 2, así que un estado de ADC son dos ciclos de CPU y una conversión de un canal con valores por defecto son 23 estados, apenas por debajo de un microsegundo, tiempo que el firmware realmente tiene que esperar.
ADDRn contiene los catorce bits completos. Nada en el chip los desplaza a diez; analogRead tiene una resolución por defecto que elige el entorno de ejecución (sección 6). La escala completa es el riel de 5 V.
Los escaneos por grupos, el sensor de temperatura, la referencia interna, el promediado de datos, el autodiagnóstico, el modo de doble disparo y todos los disparos excepto el de software no están modelados.
3.6 USBFS (0x4009_0000): una tubería de bytes, y nada más
La dirección base y cada offset de esta sección no están verificados (sección 7), y lo mismo, más importante aún, ocurre con la idea de que esto sea USB.
| offset | registro |
|---|---|
0x00 |
SYSCFG |
0x04 |
SYSSTS0 (solo lectura) |
0x08 |
DVSTCTR0 (guardado) |
0x14 |
CFIFO |
0x20 |
CFIFOSEL |
0x22 |
CFIFOCTR |
0x30 |
INTENB0 (guardado) |
0x40 |
INTSTS0 (guardado) |
SYSCFG.USBE (bit 0) enciende el controlador, SYSCFG.DPRPU (bit 4) conecta la pull-up de D+ (que es lo que significa "conectar el cable") y SYSCFG.SCKE (bit 10) es el reloj. Hasta que el bit de parada de módulo se borre y tanto USBE como DPRPU estén activados, la tubería no transporta nada.
CFIFOSEL.CURPIPE (bits 0..3) elige una tubería y CFIFOSEL.ISEL (bit 5) la dirección: activado para escribir, borrado para leer. CFIFO mueve bytes. CFIFOCTR.DTLN (bits 0..8) lee cuántos hay, BVAL (bit 15) entrega un búfer de escritura y BCLR (bit 14) lo descarta. Un búfer que llega a 64 bytes sale por sí solo, porque no hay un host que deba esperar.
No hay nada más de USB aquí. Sin host, sin bus, sin reset, sin paquete SETUP, sin descriptor, sin enumeración, sin direccionamiento, sin contador de tramas, sin SOF, sin doble búfer, sin NAK, sin STALL, sin configuración de tuberías y sin interrupciones. Un sketch que maneje esto como un driver CDC maneja el silicio funcionará; un sketch que espere a que termine la enumeración, o que inspeccione una solicitud de descriptor, esperará para siempre. Por eso if (Serial) aquí es cierto en cuanto begin() se ha ejecutado, y falso por un momento en un escritorio.
Este es el punto donde el modelo deliberadamente no es el chip, y fingir lo contrario sería la única mentira que importa.
3.7 Parada de módulos (0x4004_7000)
| dirección | registro | lo que este modelo decodifica |
|---|---|---|
0x4004_7000 |
MSTPCRB |
SCIn en el bit 31 - n, USBFS en el bit 11 |
0x4004_7004 |
MSTPCRC |
guardado |
0x4004_7008 |
MSTPCRD |
GPTn en el bit 12 - n, ADC14 unidad 0 en el bit 16 |
A set bit stops the module, and every one of them resets set. The numbering counts down, which is the thing that surprises people. A stopped module's registers read 0 and the access is counted as stray; the port block and these registers themselves are always reachable, because something has to be.
3.8 SysTick, el NVIC y el ICU que no está aquí
SysTick es del núcleo, con SYST_CALIB = 480,000: el reloj de referencia es ICLK, así que un tick de 10 ms son 480,000 cuentas. Cuatro bits de prioridad. La tabla de vectores tiene dieciséis entradas de sistema y luego treinta y dos espacios del ICU.
En una RA esos treinta y dos no tienen un significado fijo: qué evento de periférico llega a la IRQ n se programa en el registro IELSRn del ICU. Los enlaces de eventos del ICU no están modelados, así que nada en este modelo genera una interrupción de periférico, IELSRn no está implementado y PmnPFS.ISEL se guarda y no hace nada. SysTick, una excepción del núcleo que no necesita enlace, es la única interrupción que se dispara. Por eso no existe attachInterrupt en el runtime (sección 6), y se dice con claridad en vez de aproximar: un ICU con números de evento inventados sería peor que ninguno.
4. Canal del host
host_write pone bytes en ambos, el búfer de recepción de la tubería USB y la cola de recepción de SCI2; host_read toma los bytes que han salido de cualquiera de los dos. Una placa tiene un canal del host, y un sketch puede estar leyendo Serial, Serial1 o ambos.
Eso es Serial y Serial1 en un sketch y el monitor serie en la interfaz. Los bytes son UTF-8 en lo que toca a la interfaz y opacos para el modelo.
Los dos puertos no son iguales en algo visible: los bytes de Serial1 salen a la velocidad de bits y los de Serial salen al final de la porción en que se entregaron, así que una línea USB de verdad puede caer dentro de una UART en el monitor. Eso es la placa, no un error.
5. Modelo de tiempo y el componente
Picososegundos en un u64, como el kernel. La CPU corre a 48 MHz, así que un ciclo son 20833.33 ps, no un número entero, y por eso el tiempo nunca se acumula: se recalcula a partir de un conteo de ciclos como cycles * 1_000_000 / 48. Una porción de 10 us es exactamente 480 ciclos y exactamente 10,000,000 ps, así que los límites de las porciones nunca se desvían.
El contador de ciclos se ancla al tiempo del kernel al inicio de cada porción, así que un temporizador no puede alejarse del circuito sin importar cómo caigan las porciones, y un núcleo en reposo se pone al corriente con los ciclos que durmió (incluido SysTick) sin ejecutarlos.
A slice runs in two gears. Coarse is Cpu::run in chunks bounded by the next peripheral deadline; fine is one instruction at a time with the bus told the cycle each one starts at, which is what lets a pin change carry the cycle that caused it. A store to a port, GPT, SCI or USB register drops the slice into fine for the next 4,800 cycles.
probe es una máscara de bits: 1 en ejecución, 2 dormido en WFI, 4 el LED integrado del pin 13 encendido, 8 transmisión serie en los últimos 20 ms, 16 recepción serie. 0 sin programa, retenido en reset o colgado.
poke: 1 retiene RESET, 0 lo libera.
Un bloqueo (un BKPT, o una falla de la que el núcleo no puede regresar) detiene la placa y pone una línea en el canal del host que indica el PC, el CFSR y el HFSR:
firmware crashed at pc=0x00001000, BKPT #0 (CFSR 0x00000000, HFSR 0x00000000)
crt0.S apunta cada vector que no necesita a un manejador que ejecuta BKPT, así que una falla dice dónde estaba en lugar de girar en silencio.
6. Runtime del firmware (firmware/unor4/)
Un runtime con forma de Arduino escrito desde cero: setup() y loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead, analogReadResolution, analogWrite, millis, micros, delay, delayMicroseconds, map, random, Serial y Serial1. Sin núcleo de Arduino, sin ArduinoCore-renesas, sin FSP, sin CMSIS, sin libc, nada de GPL.
Se compila con clang --target=thumbv7em-none-eabi -mcpu=cortex-m4 -mthumb -mfloat-abi=soft -mfpu=none -Os y ld.lld contra firmware/unor4/link.ld, con --nmagic para que un programa de dos kilobytes no se rellene a una página de 64 KB. BOARD=unor4 es la única placa que este script compila.
- Pines. Cada
pinModedesbloqueaPWPR, escribe una palabra dePmnPFSy lo vuelve a bloquear.digitalWritees una sola escritura enPCNTR3.INPUT_PULLDOWNse acepta y da una entrada simple, porque el componente no tiene pull-down. - Tiempo. SysTick a 1 kHz: recarga de 47,999, un número entero de ciclos a 48 MHz, así que
millisno se desvía.microses ese contador más lo que queda en el propio contador descendente de SysTick, así que un solo temporizador da resolución de microsegundos en todo el rango de 32 bits y cada canal GPT queda libre paraanalogWrite.delayejecutaWFIy se detiene; un segundo de tiempo simulado cuesta alrededor de mil instrucciones en lugar de cuarenta y ocho millones. analogReaddevuelve diez bits, 0..1023, de un convertidor de catorce bits, porque eso es lo que espera un sketch de Arduino.analogReadResolution(1..14)cambia el desplazamiento, que vive ensrc/analog.cy no en el chip.analogWritees 0..255 a 490.0 Hz (48 MHz / 16 / 6123) en D3, D5, D6, D9, D10 y D11. 0 y 255 quitan la habilitación de salida del GPT y controlan el pin, así queanalogWrite(pin, 0)de verdad está apagado; un pin que no es uno de los seis se controla bajo o alto en el punto medio, como lo hacen los núcleos de Arduino.Seriales la tubería USB y no llega a ningún pin del header.Serial1es SCI2 en D0 y D1, 8N1,BRR = PCLKA / (32 * baud) - 1redondeado. La recepción enSerial1se consulta por sondeo, porque no hay un ICU que entregue una interrupción; la cola del modelo detrás deRDRes lo bastante profundo para que escribir mientras el sketch está ocupado no pierda caracteres.- No hay
attachInterrupt, por la razón que da la sección 3.8. Un sketch hace sondeo. - El punto flotante funciona y es soft float.
Serial.print(float)lee el patrón de bits IEEE-754 y nunca calcula con él. String, el heap ytone()son del núcleo compartido (firmware/lib): el heap va desde_endhasta la pila, ytone()es PWM de GPT al 50 por ciento en D3, D5, D6, D9, D10 y D11, con un respaldo bloqueante por bit-bang para una nota temporizada en cualquier otro pin. No hay I2C, no hay SPI.
La cadena program del catálogo es elf32 arm ra4m1.
Cuatro ejemplos, cada uno con presupuesto de 16 KB: blink, button (un botón pulsador en D2), serial (ambos puertos, y un eco) y analog (una perilla en A0 que desvanece un LED en D9, imprimiendo diez bits y catorce).
crates/unor4/tests/runtime.rs ejecuta estos ELF contra el modelo. Dos de sus casos existen para respaldar los números de este documento en lugar de repetirlos: el reloj de verdad es de 48 MHz a lo largo de dos segundos simulados, y millis queda a menos de 20 ms de la verdad a los tres segundos.
7. Lo que este modelo sabe con certeza, y lo que no
Tres grupos. Esta sección existe porque un modelo de placa que adivina silenciosamente una dirección es peor que uno que dice que no lo sabía.
Taken from the RA4M1 group user's manual and the Minima's own documentation. The core: a Cortex-M4 at 48 MHz with four priority bits. 256 KB of code flash at zero, 32 KB of SRAM at 0x2000_0000, 8 KB of data flash at 0x4010_0000. The option-setting memory at 0x0000_0400. PORT_BASE = 0x4004_0000 with a 0x20 stride, and PCNTR1..PCNTR4 at 0x00, 0x04, 0x08, 0x0C with the half-word meanings section 3.1 gives. PFS_BASE = 0x4004_0800 with a 0x40 stride and four bytes a pin, and the PmnPFS bit positions in section 3.2. PWPR at 0x4004_0D03 with B0WI at bit 7 and PFSWE at bit 6. MSTP_BASE = 0x4004_7000, that a set bit stops the module, and that the numbering counts down. SCI_BASE = 0x4007_0000 with a 0x20 stride, the byte-register layout in section 3.4, and the SCR/SSR/SMR bit positions and the bit-rate formula. That SCI2 is the Minima's Serial1 on D0 and D1, and that Serial is the on-die USB. The Uno R3 header and the RA4M1 pad behind each hole in section 1, less the two noted below. That A0 is AN009 and A1..A3 are AN000..AN002. That D3, D5, D6, D9, D10 and D11 are the PWM pins. That the board is 68.6 x 53.3 mm.
Creído, no verificado. Se nombra aquí para que una imagen que se lleve al silicio real tenga una lista corta que revisar, toda en un solo header, firmware/unor4/include/ra4m1.h:
GPT_BASE=0x4007_8000con un paso de 0x100, y cada desplazamiento de registro dentro de un canal GPT (sección 3.3).- Qué salida GPT es cada pin PWM: la tabla de seis filas de la sección 3.3. Esta es la afirmación más débil del documento: los pines son correctos y los canales son una creencia.
ADC_BASE=0x4005_C000y cada desplazamiento dentro del ADC14 (sección 3.5).A4yA5enAN021yAN022. Los otros cuatro canales analógicos no están en este grupo.USB_BASE=0x4009_0000y cada desplazamiento dentro del USBFS (sección 3.6).- Las codificaciones
PSEL0b00011para GPT y0b00100para SCI (sección 3.2). - Las posiciones exactas de bits de
MSTPCRB/MSTPCRDpara USBFS (11) y ADC14 (16). Los bits de SCI y GPT siguen la regla de contar hacia abajo, que no está en este grupo.
Donde el modelo y este documento discrepan del silicio, el firmware compilado aquí sigue concordando con el modelo: corre en el simulador y sus escrituras de registro están en un solo header para corregir.
Modelado, pero no sujeto a los números del manual. Comportamientos en lugar de direcciones, en el orden que establece la sección 7 de docs/esp32c6.md y que todo contrato de placa aquí ahora sigue:
- El reloj es de 48 MHz y el árbol de reloj no está. Los bits de parada de módulo son compuertas; HOCO, MOCO, el PLL y
SCKDIVCRno están modelados, así que sin importar lo que programe un sketch, el núcleo corre a 48 MHz.crates/unor4/tests/runtime.rssostiene eso respecto al firmware incluido, no respecto a esta frase. - La salida GPT está en alto por debajo de su registro de comparación y en bajo por encima (sección 3.3). Los campos de cinco bits de selección de nivel de
GTIORse guardan y no se decodifican, así que una salida invertida o conmutada no se reproduce; el ciclo útil deanalogWritesí. - El segmento tiene dos engranajes, y la primera escritura tras un periodo de quietud es temprana, hasta 10.7 us. Todo dentro de una ráfaga es exacto. El razonamiento es el de la sección 7 de
docs/stm32f411.md. - El ADC14 no tiene error. Una conversión es la línea recta contra una referencia de 5 V, muestreada en el instante en que empezó, sin muestra y retención, sin impedancia de entrada, sin no linealidad, sin ruido y sin desplazamiento. El autodiagnóstico de
ADCERy el promediado deADADCse guardan y no hacen nada. - Las pastillas son tres estados y un umbral. Push-pull a 5 V, drenaje abierto, alta impedancia, o una pull-up interna de 35 kΩ, leídas contra la mitad de la alimentación, sin histéresis, sin ajuste de fuerza de conducción, sin tiempo de subida y sin límite de corriente.
DSCRse guarda. Seriales una tubería de bytes y la tubería nunca se llena. Los bytes entregados salen al final del segmento en lugar de en un límite de trama USB,availableForWritesiempre es 1, yif (Serial)es una decisión que este modelo toma en lugar de un protocolo de enlace que ejecuta (sección 3.6).- The board is an ideal supply:
5V,IOREFand3V3at rail impedance for ever, so nothing browns out. Start-up is a microsecond, where a real R4 spends its first moments in the bootloader. - No hay botón de usuario, porque la placa no tiene; el único botón mantiene
RESETen bajo y llega a través depoke.
Ausentes a propósito. Cada uno de estos se dejó fuera en lugar de inventarse, porque su disposición o su comportamiento no es algo que este modelo pueda reproducir con honestidad:
- La ICU y sus enlaces de eventos. Sección 3.8. Con ella se van todas las interrupciones de periféricos,
attachInterrupty los pines IRQ. - El circuito de generación de reloj: HOCO, MOCO, el PLL,
SCKDIVCR. El componente se modela como si ya corriera a 48 MHz, y un programa que configure el árbol de reloj escribe en un bloque sin mapear. - La AGT. El temporizador de bajo consumo del RA4M1, y el que el núcleo de Arduino usa para
millis. Aquí el SysTick basta y es exacto. - Los watchdogs (IWDT y WDT), razón por la que la memoria de configuración de opciones se guarda y no se decodifica.
- I2C (IIC), SPI, CAN, el DTC, la unidad táctil CTSU, el RTC, el DAC, los comparadores, los OPAMP, las unidades CRC y CAC, y la interfaz de programación del flash de datos.
- USB como protocolo. La sección 3.6 es todo lo que hay.
- La programación de flash y la ROM de arranque.
Por eso un binario FSP del fabricante o del núcleo Arduino no corre aquí, y el firmware compilado para este documento sí.