Referencia

Contrato de la placa Seeed XIAO SAMD21 (Fase 9)

La ATSAMD21G18A: dos grupos de PORT, SERCOM como USART, PWM de TCC y TC, el ADC en cada pad, y el USB como un canal de bytes.

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 La Seeed XIAO SAMD21 y la página de la placa.

El XIAO SAMD21 es la placa más pequeña de aquí y la tercera con Cortex-M0+. Un componente del kernel (xiao en crates/parts) envuelve un modelo del SoC ATSAMD21G18A (crates/atsamd21) sobre el mismo núcleo que la Raspberry Pi Pico (crates/cortexm-core, Profile::V6M). El núcleo se comparte; el chip que lo rodea, no. Este documento es el contrato, y prevalece sobre cualquier comentario en el código.

El tipo en el catálogo es xiao.

Lee primero la sección 7 si vas a llevar una compilación de aquí al silicio real. Cada dirección base de este modelo es una que este documento puede afirmar a partir del SAM D21 Family Datasheet, y la mayoría de los desplazamientos de registros también, pero los desplazamientos del bloque TC y la tabla de multiplexación de periféricos son la interpretación de este modelo y no una página citada textualmente, y la sección 7 nombra cada uno. Aquí nada se inventa en silencio.

1. Pines de la placa (orden del catálogo)

Vista superior, con el conector USB-C arriba y el ATSAMD21G18A debajo de la serigrafía, al centro. La placa mide 21 x 17.8 mm y sus dos filas de siete pads achaflanados están separadas 15.24 mm (exactamente 0.6 pulgadas), así que abarca el canal central de una protoboard.

Columna izquierda, de arriba abajo (7 pads): D0, D1, D2, D3, D4, D5, D6.

Columna derecha, de arriba abajo (7 pads): 5V, GND, 3V3, D10, D9, D8, D7.

14 pads. Once son de entrada/salida y tres son de alimentación. Cada uno de los once también es una entrada analógica, y A0 a A10 son los mismos pads que D0 a D10; la serigrafía muestra ambos.

El pad detrás de cada pin, y qué más puede ser:

pin pad AIN EXTINT PWM (función E) otro
D0 / A0 PA02 0 2 ninguno la salida del DAC
D1 / A1 PA04 4 4 TCC0 CC0
D2 / A2 PA10 18 10 TCC1 CC0
D3 / A3 PA11 19 11 TCC1 CC1
D4 / A4 PA08 16 NMI TCC0 CC0 SDA
D5 / A5 PA09 17 9 TCC0 CC1 SCL
D6 / A6 PB08 2 8 TC4 CC0 TX de Serial1
D7 / A7 PB09 3 9 TC4 CC1 RX de Serial1
D8 / A8 PA07 7 7 TCC1 CC1 SCK
D9 / A9 PA05 5 5 TCC0 CC1 MISO
D10 / A10 PA06 6 6 TCC1 CC0 MOSI

Tres cosas en esa tabla valen la pena leerse dos veces, y las tres son del hardware y no del modelo:

  • D0 no tiene PWM. PA02 es el pin del DAC y no logra ninguna salida de forma de onda. analogWrite(0, x) aquí enciende o apaga el pad a la mitad en lugar de fingir un fundido.
  • D4 no tiene interrupción externa ordinaria. PA08 es el pin NMI del chip. attachInterrupt(4, ...) no hace nada, ni aquí ni en un escritorio.
  • D5 y D7 comparten EXTINT9, así que solo uno de los dos puede llevar una interrupción a la vez; el segundo attachInterrupt le quita la línea al primero. Y como TCC1 y TCC2 tienen dos registros de comparación cada uno, algunos pines comparten un ciclo útil: escribir analogWrite en uno de D1/D4, D9/D5, D10/D2 o D8/D3 mueve ambos.

Tres LEDs están en la placa y en ningún pad: el LED del usuario en PA17, el LED RX en PA18 y el LED TX en PA19. Los tres son activos en bajo, así que digitalWrite(LED_BUILTIN, LOW) enciende el del usuario. Se ven a través de la sonda y del visual, y en ningún otro lado. El runtime los numera 13, 12 y 11 y define LED_BUILTIN como 13.

Eléctrico. Cada pad de E/S maneja push-pull a 3.3 V a través de R_STRONG, queda en alta impedancia, o hace pull up o pull down a través de 40 k. Una entrada lee alto a 1.65 V; una red en conflicto (Unknown) lee 0, y una flotante lee ruido, como en el Uno (docs/uno.md sección 1). 3V3 entrega 3.3 V con R_SUPPLY, 5V entrega 5 V y GND entrega 0 V, siempre, porque la placa está conectada por USB. No hay pad de reset en el header: los dos pads de reset están en la parte de abajo de un XIAO real, y aquí el reset es un toque (sección 5).

2. Mapa de memoria

flash 256 KB en 0x0000_0000
SRAM 32 KB de 0x2000_0000 a 0x2000_7FFF
tope de la pila 0x2000_8000
PM 0x4000_0400, sección 3.2
SYSCTRL 0x4000_0800, sección 3.2
GCLK 0x4000_0C00, sección 3.2
EIC 0x4000_1800, sección 3.6
PORT 0x4100_4400, sección 3.1
USB 0x4100_5000, sección 3.7
SERCOM0..5 0x4200_0800, cada 0x400, sección 3.3
TCC0..2 0x4200_2000, cada 0x400, sección 3.4
TC3..TC7 0x4200_2C00, cada 0x400, sección 3.4
ADC 0x4200_4000, sección 3.5

Cada segmento PT_LOAD debe caer dentro de la flash o de la SRAM; cualquier otra cosa se rechaza con la dirección problemática en el mensaje, y el chip queda sin programa.

The vector table goes at zero and nothing goes before it. A real XIAO ships with the UF2 bootloader in the first 8 KB and the application linked at 0x2000; an image built here therefore runs in Mokxi and under a debugger, and needs relinking at 0x2000 to go in over that bootloader. That is a one-line change to ORIGIN in firmware/xiao/link.ld, not a code change.

Los bloques que tiene la hoja de datos y que este modelo no (PAC0-2, DSU, NVMCTRL, DMAC, MTB, WDT, RTC, EVSYS, AC, DAC, PTC, I2S) están mapeados e inertes: leer uno da 0 y cuenta como un acceso perdido, en lugar de generar una falla. Un arranque que toque los wait states del controlador NVM no debería bloquear la placa. Cualquier cosa fuera de todos los bloques es una falla de acceso, que en ARMv6-M es un HardFault y que la placa reporta como un crasheo en el canal del host.

3. Registros de periféricos

Solo se implementa el subconjunto de abajo. Un registro del SAM D21 mide ocho, dieciséis o treinta y dos bits, y el bus atiende cada uno a su propio ancho: un acceso más angosto que su registro es la lectura-modificación-escritura que habría hecho la matriz del bus, y uno más ancho se responde desde el registro en el que empieza. Así que el firmware escrito con los tipos de la propia hoja de datos funciona sin cambios.

3.1 PORT (0x4100_4400)

Dos grupos, PA y PB, a 0x80 de distancia. Los pads se numeran 0..63 en este modelo: 0..31 son PA00..PA31 y 32..63 PB00..PB31.

offset registro
0x00 DIR
0x04 DIRCLR
0x08 DIRSET
0x0C DIRTGL
0x10 OUT
0x14 OUTCLR
0x18 OUTSET
0x1C OUTTGL
0x20 IN
0x24 CTRL (guardado, legible de vuelta)
0x28 WRCONFIG
0x30 + n PMUXn, un byte por cada par de pines
0x40 + n PINCFGn, un byte por pin

PINCFG bit 0 PMUXEN, bit 1 INEN, bit 2 PULLEN, bit 6 DRVSTR (guardado, ignorado eléctricamente).

OUT hace doble trabajo y es la única trampa real de este componente. Con DIR set it is the driven level; with DIR clear it is the dirección de la resistencia de pull. Así que INPUT_PULLUP es DIRCLR, luego OUTSET, luego PINCFG.PULLEN, y PULLEN sin OUT da una resistencia de pull-abajo. Con dos de los tres, el pin hace lo incorrecto en silencio.

WRCONFIG escribe el PINCFG y el PMUX de dieciséis pines en una sola escritura: PINMASK en los bits 0..15, PMUXEN 16, INEN 17, PULLEN 18, DRVSTR 22, PMUX 24..27, WRPMUX 28, WRPINCFG 30, HWSEL 31 (que desplaza la máscara a los pines 16..31).

Con PMUXEN activado, PMUX elige una de las ocho funciones periféricas A..H y el pad sale de las manos del PORT. El modelo actúa sobre las que tiene (SERCOM en modo USART y las salidas de onda de TC/TCC, la tabla de la sección 1) y trata cualquier otra selección como un periférico que no tiene, que no pide nada y deja el pad en alta impedancia en lugar de inventar un nivel. La pull del pad sigue siendo del pad, y así es como un pin RX de SERCOM conserva su pull-up.

IN lee 0 en un pin cuyo INEN está en cero, que es lo que hace el hardware. Un pad que este chip está manejando devuelve en lectura lo que está manejando.

3.2 PM, GCLK y SYSCTRL: el árbol de relojes no está modelado

El núcleo corre a 48 MHz desde la primera instrucción. Aquí no hay árbol de relojes: no hay DFLL, ni osciladores, ni divisores, ni generadores que generen algo. Estos tres bloques existen para que un código de arranque escrito contra los registros reales llegue hasta el final en lugar de colgarse en un bit de listo.

  • SYSCTRL (0x4000_0800) es una copia fantasma de treinta y dos palabras, con dos excepciones. PCLKSR (0x0C) lee todos los bits de listo y de bloqueo como establecidos (XOSCRDY, XOSC32KRDY, OSC32KRDY, OSC8MRDY, DFLLRDY, DFLLLCKF, DFLLLCKC, DFLLRCS, BOD33RDY, DPLLLCKF, DPLLLCKT) y todos los bits de falla como borrados. DFLLSYNC lee 0. Así que while (!(SYSCTRL->PCLKSR.reg & DFLLRDY)) {} pasa de inmediato.
  • GCLK (0x4000_0C00): CTRL en 0x00 (bit 0 SWRST), STATUS en 0x01 (bit 7 SYNCBUSY, nunca se activa), CLKCTRL en 0x02, GENCTRL en 0x04, GENDIV en 0x08. Los últimos tres se direccionan por el ID en el valor escrito, como en el componente real, y una lectura responde con el último ID escrito. Nada depende de ellos.
  • PM (0x4000_0400): AHBMASK 0x14, APBAMASK 0x18, APBBMASK 0x1C, APBCMASK 0x20, todos almacenados y leídos con sus valores de reinicio, y RCAUSE en 0x38, que aquí es de solo lectura y lleva el bit de encendido, el de reinicio externo o el de reinicio del sistema según lo que haya reiniciado el componente por última vez. Nada depende de las máscaras de reloj: un periférico funciona tanto si el firmware encendió su reloj como si no. El entorno de ejecución las enciende de todos modos, porque un componente real lo necesita.

El tiempo mismo viene de SysTick, que está en cortexm-core en su dirección arquitectónica. El entorno de ejecución lo recarga cada 48 000 ciclos (exactamente un milisegundo a 48 MHz), y SYST_CALIB reporta eso como una décima exacta de diez milisegundos.

3.3 SERCOM como USART (0x4200_0800 + 0x400 n)

Seis SERCOM, cada uno modelado en modo USART con reloj interno (CTRLA.MODE = 1), asíncrono 8N1, y en ningún otro modo. SPI e I2C no están modelados; un SERCOM puesto en uno de esos modos no hace nada.

offset registro
0x00 CTRLA
0x04 CTRLB
0x08 DBGCTRL (almacenado)
0x0C BAUD
0x0E RXPL (almacenado)
0x14 INTENCLR
0x16 INTENSET
0x18 INTFLAG
0x1A STATUS (almacenado; nunca se genera ningún error)
0x1C SYNCBUSY (siempre 0)
0x28 DATA

CTRLA bit 0 SWRST, bit 1 ENABLE, bits 2..4 MODE, bits 16..17 TXPO (0 maneja PAD[0], cualquier otro valor PAD[2]), bits 20..21 RXPO (el pad en el que escucha el receptor), bit 30 DORD. CTRLB bit 16 TXEN, bit 17 RXEN. INTFLAG bit 0 DRE, bit 1 TXC (fijado, escribir 1 para limpiar), bit 2 RXC.

BAUD es el generador aritmético asíncrono: BAUD = 65536 (1 - 16 f / f_ref), así que un tiempo de bit es 16 x 65536 / (65536 - BAUD) relojes de referencia. La referencia se toma como el reloj del núcleo de 48 MHz, porque no hay árbol de relojes al cual preguntar (sección 3.2). Un BAUD de 0 (lo que deja un programa que no llamó a begin()) cae a 115200. No hay modo fraccional.

Un transmisor habilitado con TXEN activado es dueño de su pad y desplaza bits reales por él: un bit de inicio en bajo, ocho bits de datos con el menos significativo primero, un bit de parada en alto, cada uno de un tiempo de bit, y cada flanco sellado con el ciclo en que el hardware lo habría movido. Un receptor con RXEN activado empieza una trama en un flanco de bajada y muestrea cada bit de datos a la mitad de su tiempo de bit. Así, un jumper de D6 a D7 transporta un carácter, y un baud rate desapareado distorsiona el texto aquí igual que lo hace en una mesa de trabajo.

En esta placa Serial1 es el SERCOM4 con TXPO 0 y RXPO 1, que es PAD[0] en PB08 y PAD[1] en PB09 (D6 y D7), ambos en la función periférica C.

3.4 TCC0-2 y TC3-7, en lo que toca al PWM

Tres TCC y cinco TC. Aquí un contador nunca avanza paso a paso: es una función de forma cerrada del ciclo de CPU, y también lo es el momento de su próximo flanco, y eso es lo que permite que un núcleo detenido en WFI no cueste nada durante todo un delay() mientras un PWM sigue corriendo.

PRESCALER son los bits 8..10 de CTRLA en ambos tipos, y no es potencia de dos hasta arriba: 0 a 4 son DIV1, DIV2, DIV4, DIV8 y DIV16, luego 5 es DIV64, 6 DIV256 y 7 DIV1024. Ese salto es una trampa real, y equivocarse hace un PWM cuatro veces más lento.

TCC (0x4200_2000 + 0x400 n):

offset registro
0x00 CTRLA: bit 0 SWRST, bit 1 ENABLE, bits 8..10 PRESCALER
0x04/0x05 CTRLBCLR/CTRLBSET (almacenado)
0x08 SYNCBUSY (siempre 0)
0x24/0x28 INTENCLR/INTENSET
0x2C INTFLAG: bit 0 OVF
0x30 STATUS (siempre 0)
0x34 COUNT
0x3C WAVE: bits 0..2 WAVEGEN, de los cuales 2 es PWM normal
0x40 PER, el período
0x44 + 4c CC0..CC3, los ciclos útiles
0x68/0x6C/0x70 + 4c WAVEB/PERB/CCBn, que aquí surten efecto de inmediato

TCC0 tiene cuatro canales de comparación; TCC1 y TCC2 tienen dos, así que sus WO[2] y WO[3] repiten WO[0] y WO[1]. Por eso la tabla de la sección 1 empareja algunos pines.

TC (0x4200_2C00 + 0x400 n, para TC3 a TC7):

offset registro
0x00 CTRLA: bit 0 SWRST, bit 1 ENABLE, bits 2..3 MODE (0 COUNT16, 1 COUNT8, 2 COUNT32), bits 5..6 WAVEGEN, bits 8..10 PRESCALER
0x02 READREQ (aceptado, no hace nada: el conteo siempre está actualizado)
0x04/0x05 CTRLBCLR/CTRLBSET (almacenado)
0x0C/0x0D INTENCLR/INTENSET
0x0E INTFLAG: bit 0 OVF
0x0F STATUS (siempre 0)
0x10 COUNT, con el ancho que indique MODE
0x14 PER, solo en COUNT8
0x18 + c CC0, CC1, a un byte de distancia en COUNT8, dos en COUNT16, cuatro en COUNT32

En PWM normal (WAVEGEN = 2) el tope de un TC es PER en COUNT8 y el ancho completo del contador en los demás modos; en PWM por comparación (WAVEGEN = 3) CC0 es el período y CC1 el ciclo útil. Una salida de forma de onda está en alto desde el inicio del período hasta la coincidencia de comparación y en bajo después, así que una comparación de 0 es un bajo continuo y una comparación por encima del tope un alto continuo, sin ningún flanco. Esa es la forma que analogWrite espera y la única que este modelo produce.

La bandera de desbordamiento llega al NVIC cuando su bit INTENSET está activado. La captura, el sistema de eventos, el modo de una sola vez y la rampa, el dithering, la inserción de tiempo muerto, la generación de patrones y las entradas de falla están ausentes.

3.5 ADC (0x4200_4000)

Conversiones únicas por disparo de software, que es la única ruta que toma analogRead.

offset registro
0x00 CTRLA bit 0 SWRST, bit 1 ENABLE
0x01 REFCTRL se guarda, se lee de vuelta
0x02 AVGCTRL se guarda, se lee de vuelta
0x03 SAMPCTRL se guarda, se lee de vuelta
0x04 CTRLB bits 4..5 RESSEL: 0 doce bits, 2 diez, 3 ocho
0x06 WINCTRL se guarda, se lee de vuelta
0x08 SWTRIG bit 0 FLUSH, bit 1 START
0x0C INPUTCTRL bits 0..4 MUXPOS; MUXNEG y GAIN se guardan
0x10 EVCTRL guardado
0x12/0x13 INTENCLR/INTENSET
0x14 INTFLAG bit 0 RESRDY, bit 1 OVERRUN
0x15 STATUS siempre 0
0x16 RESULT leerlo limpia RESRDY
0x18..0x22 WINLT, WINUT, GAINCORR, OFFSETCORR, CALIB, DBGCTRL se guarda, se lee de vuelta

Una conversión: apunta MUXPOS al canal, escribe SWTRIG.START, espera RESRDY, lee RESULT. Toma 6 microsegundos fijos de tiempo simulado, que el firmware realmente sí espera. El resultado es round(4095 x Vin / 3.3) del voltaje del pad en el momento en que empezó la conversión, desplazado hacia abajo para un RESSEL menor a doce bits. Un canal con nada sujetando su pin lee 0.

La referencia y la ganancia no hacen nada aquí. REFCTRL.REFSEL y INPUTCTRL.GAIN se guardan y se leen de vuelta, y el modelo siempre mide contra el riel de 3.3 V, que es lo que dan los ajustes propios de los núcleos de Arduino, INTVCC1 con ganancia DIV2, en esta placa. Un sketch que cambie a la referencia interna de 1.0 V obtiene aquí los mismos números que obtendría con INTVCC1, y este documento lo dice así en lugar de inventar una escala. El promediado, el monitor de ventana, las correcciones, el modo de ejecución libre, el modo diferencial y el sistema de eventos están ausentes.

Existen los canales 0..19. La tabla de la sección 1 los mapea a pads.

3.6 EIC (0x4000_1800)

Dieciséis líneas EXTINT, que es en lo que se basa attachInterrupt. Un pad llega al controlador tomando la función de periférico A, y en qué línea cae lo fija el pad (sección 1).

offset registro
0x00 CTRL: bit 0 SWRST, bit 1 ENABLE
0x01 STATUS: bit 7 SYNCBUSY, siempre 0
0x02/0x03 NMICTRL/NMIFLAG (se guardan; la NMI en sí no se genera)
0x04 EVCTRL (se guarda)
0x08/0x0C INTENCLR/INTENSET
0x10 INTFLAG
0x14 WAKEUP (se guarda)
0x18/0x1C CONFIG0/CONFIG1: cuatro bits de SENSE y un FILTEN por línea

SENSE: 0 ninguno, 1 flanco de subida, 2 flanco de bajada, 3 ambos, 4 nivel alto, 5 nivel bajo. Un flanco se fija en INTFLAG y se escribe para limpiarlo. Un nivel mantiene INTFLAG activado mientras el pin esté en ese nivel, así que un manejador que no elimine la condición se ejecuta de nuevo, exactamente como en el componente. FILTEN se guarda y no filtra nada.

Las dieciséis líneas comparten un vector NVIC; el entorno de ejecución lee INTFLAG y llama a los manejadores que estén adjuntos.

3.7 El dispositivo USB (0x4100_5000): un stub que transporta bytes

En una XIAO el único socket de la placa va al USB propio del SAM D21, y el monitor serie en tu escritorio habla con una interfaz CDC ACM que el firmware del sketch enumera. Ese es el hecho que hace a la placa lo que es, y es el hecho que la vuelve incómoda: no hay Serial hasta que el firmware ha respondido una docena de transferencias de control.

Lo que hay aquí es una tubería con los nombres de registros puestos encima, y la ruta de transferencia es la real del componente.

offset registro
0x00 CTRLA: bit 0 SWRST, bit 1 ENABLE, bit 7 MODE
0x02 SYNCBUSY (siempre 0)
0x03 QOSCTRL (se guarda)
0x08 CTRLB: bit 0 DETACH, activado al reiniciar
0x0A DADD (se guarda)
0x0C/0x0D/0x10 STATUS, FSMSTATUS, FNUM: todos leen 0; no hay bus que tenga estado
0x14/0x18/0x1C INTENCLR/INTENSET/INTFLAG (se guardan; nunca se genera nada)
0x20 EPINTSMRY
0x24 DESCADD
0x28 PADCAL (se guarda)
0x100 + 0x20 n endpoint n: EPCFG +0, EPSTATUSCLR +4, EPSTATUSSET +5, EPSTATUS +6, EPINTFLAG +7, EPINTENCLR +8, EPINTENSET +9

La tabla de descriptores en DESCADD es la real: dos bancos por endpoint, dieciséis bytes cada uno, ADDR en +0 y PCKSIZE en +4 con BYTE_COUNT en los bits 0..13 y SIZE en los bits 28..30.

  • IN. El firmware llena un búfer, escribe la longitud en el PCKSIZE del banco 1 y activa EPSTATUS.BK1RDY. El modelo lee esos bytes de la SRAM, los entrega al monitor serie, limpia BK1RDY y activa EPINTFLAG.TRCPT1.
  • OUT. El firmware limpia EPSTATUS.BK0RDY para indicar que el banco 0 está libre. El modelo copia lo que el monitor haya tecleado en el ADDR del banco 0, escribe la longitud en su PCKSIZE, activa BK0RDY y genera EPINTFLAG.TRCPT0.

No hay nada más sobre USB aquí. No hay host, ni bus, ni reset, ni paquete SETUP, ni descriptor, ni enumeración, ni direccionamiento, ni contador de tramas, ni inicio de trama de 1 ms, ni NAK, ni STALL, ni LPM. INTFLAG nunca se activa y la interrupción de USB nunca llega al NVIC, así que el runtime hace sondeo. Un sketch que maneje esto como lo hace el núcleo de Arduino con el silicio real seguirá funcionando (sondea los bits de banco listo, que sí se comportan), pero un sketch que espere la enumeración esperará para siempre, así que while (!Serial) {} regresa de inmediato aquí y se queda esperando en una mesa. Keyboard y Mouse, que son la otra mitad de para lo que sirve una placa con USB nativo, no están disponibles en absoluto.

No hay velocidad de baudios en este canal, y eso no es un atajo: un puerto CDC ACM no tiene una propia. Serial.begin(115200) pasa un número que llegaría al host como una solicitud de line coding, y el host puede ignorarlo.

3.8 Interrupciones

El NVIC está en el núcleo en su dirección arquitectónica, con dos bits de prioridad. La tabla de vectores es la del SAM D21: 0 PM, 1 SYSCTRL, 2 WDT, 3 RTC, 4 EIC, 5 NVMCTRL, 6 DMAC, 7 USB, 8 EVSYS, 9..14 SERCOM0..5, 15..17 TCC0..2, 18..22 TC3..TC7, 23 ADC, 24 AC, 25 DAC, 26 PTC, 27 I2S.

Líneas que este modelo sí activa: EIC, SERCOM0..5, el ADC, TCC0..2 y TC3..TC7. La del USB no se activa (sección 3.7) y tampoco la de ningún otro.

4. Canal del host

host_write pone bytes en la cola de recepción del USB; host_read toma los bytes que han salido de ella. Eso es Serial en un sketch y el monitor serie en la interfaz. Los bytes son UTF-8 en lo que concierne a la interfaz y opacos para el modelo.

Serial1 no es el canal del host. Va a D6 y D7 y a ningún otro lugar, así que lo que un sketch imprima ahí llega al monitor serie solo si algo en la protoboard lo regresa.

5. Modelo de tiempo y el componente

Picosegundos en un u64, como el kernel. El núcleo corre a 48 MHz, así que un ciclo es 20833.33 ps, no un número entero, y por eso el tiempo nunca se acumula: siempre se recalcula a partir de un conteo de ciclos como cycles x 1_000_000 / 48. Un intervalo de 10 us son exactamente 480 ciclos y exactamente 10,000,000 ps, así que los límites de los intervalos nunca se desfasan. El contador de ciclos se ancla al tiempo del kernel al inicio de cada intervalo, así que un temporizador nunca puede desfasarse del circuito sin importar cómo caigan los intervalos, y un núcleo en reposo se pone al día con los ciclos que durmió, incluido SysTick, que es lo que cuenta millis().

El intervalo corre en dos marchas, como los modelos de STM32: lotes gruesos limitados por el próximo plazo de un periférico, y una instrucción a la vez durante 100 us después de cualquier escritura que caiga en un registro de PORT, SERCOM, temporizador o USB. Así que un programa que toca un pin corre en fino y un programa que solo calcula corre en grueso.

probe es una máscara de bits: 1 en ejecución, 2 en reposo en WFI, 4 el LED del usuario encendido, 8 el LED RX, 16 el LED TX, 32 transmisión serie en los últimos 20 ms, 64 recepción serie; 0 sin programa. Los tres bits de LED ya están en el orden correcto: las patillas son activas en bajo y el componente las invirtió.

poke: 1 mantiene el reset, 0 lo libera.

6. Runtime de firmware (firmware/xiao/)

Un runtime con forma de Arduino escrito para esta placa: setup() y loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead (con analogReadResolution), analogWrite, millis, micros, micros64, delay, delayMicroseconds, attachInterrupt, detachInterrupt, interrupts, noInterrupts, Serial y Serial1. Sin Atmel Software Framework, sin núcleo de Arduino, sin CMSIS, sin newlib, sin libgcc y sin compiler-rt.

delay() pone en reposo: ejecuta WFI y la siguiente interrupción de SysTick lo despierta. Un núcleo en reposo no retira instrucciones y el kernel salta directo al momento del despertar, así que blink gasta su segundo de tiempo simulado en mil interrupciones en lugar de cuarenta y ocho millones de ciclos. Un delay dentro de noInterrupts() hace espera activa en su lugar, porque un núcleo en reposo con PRIMASK activado nunca ejecutaría el manejador que avanza el reloj.

analogWrite es de ocho bits a 732.42 Hz (256 conteos, PER 255, del reloj de 48 MHz dividido entre 256: 48 MHz / 256 / 256, la frecuencia del Arduino Zero) en las diez patillas que llegan a un temporizador. 0 y 255 no son PWM: devuelven la patilla al PORT y la llevan a bajo o alto, así que analogWrite(pin, 0) de verdad está apagado.

Compilado con clang --target=thumbv6m-none-eabi -mcpu=cortex-m0plus -mthumb, enlazado contra firmware/xiao/link.ld con ld.lld. Cinco de los archivos del runtime son los de la Raspberry Pi Pico, compilados de nuevo para esta placa en lugar de copiados: el formato de números, los auxiliares matemáticos, el floor freestanding y Print. Ambas partes son Cortex-M0+ y nada en esos archivos depende de dónde viva un periférico. Los propios de esta placa son el header de registros, la tabla de pines, el código de arranque, el script del enlazador, las dos clases serie y los controladores de GPIO, analógico, tiempo, SERCOM, USB e interrupciones. Los auxiliares AEABI de división, multiplicación y corrimiento en crt0.S son los del Pico instrucción por instrucción, porque sus contratos de registros son de la ABI, no del chip.

La cadena program del catálogo es elf32 arm samd21. Difiere de la elf32 arm rp2040 del Pico porque el ELF realmente lo hace: el mismo conjunto de instrucciones, un mapa de memoria distinto, y una imagen enlazada para uno no correrá en el otro.

Cuatro ejemplos: blink (el LED del usuario y uno en D10), button (un interruptor en D2, en EXTINT10), serial (ambos puertos, con un puente de D6 a D7) y analog (una perilla en A10 y un fundido en D9). Un ejemplo tiene un presupuesto de 32 KB, y el techo real que impone el script del enlazador son los 32 KB de SRAM.

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.

Tomado de la hoja de datos. El mapa de memoria de la sección 2: 256 KB de flash en cero, 32 KB de SRAM en 0x2000_0000, y las direcciones base de PM, SYSCTRL, GCLK, EIC, PORT, USB, los seis SERCOM, TCC0-2, TC3-7 y el ADC, con los pasos de 0x400 entre instancias. La distribución de registros del PORT y su paso de grupo de 0x80, incluida la regla de que OUT elige la pull y las posiciones de los campos de WRCONFIG. La distribución USART del SERCOM y la fórmula aritmética de baudios. La distribución del TCC. La del ADC. La del EIC y sus campos SENSE de cuatro bits. Los registros de dispositivo USB, el paso de endpoint de 0x20 y el banco de descriptores de dieciséis bytes con ADDR y PCKSIZE. La codificación del PRESCALER, incluido el salto de DIV16 a DIV64. Los números de vector de interrupción de la sección 3.8. Dos bits de prioridad del NVIC.

Creído, no verificado. Dos cosas, y un programa que se lleve a silicio real debería verificar ambas:

  • Los desfases de registros del bloque TC en la sección 3.4: CTRLA 0x00, READREQ 0x02, CTRLBCLR/CTRLBSET 0x04/0x05, CTRLC 0x06, DBGCTRL 0x08, EVCTRL 0x0A, INTENCLR/INTENSET 0x0C/0x0D, INTFLAG 0x0E, STATUS 0x0F, COUNT 0x10, PER 0x14, CC 0x18. Los desfases del TCC sí los puede afirmar este modelo; los del TC son su mejor lectura de un bloque cuyo diseño cambia con MODE, y son los números contra los que se compila firmware/xiao/include/samd21.h, de modo que el firmware compilado aquí coincide con el modelo, coincida o no con el silicio.
  • La tabla de multiplexación de periféricos de la sección 1: qué columna de PMUX en cada pad lleva qué pad de SERCOM, qué línea de EXTINT y qué salida de onda. Los números de pad detrás de cada pin XIAO son los de la placa y son de los que depende el firmware; a qué canal de temporizador puede llegar un pad es de lo que depende un sketch de PWM, y un error ahí se manifiesta como un pin que no hace el fundido y no como un número equivocado. crates/atsamd21/src/mux.rs es toda la tabla en un solo lugar.

Los IDs de cliente de reloj genérico en samd21.h (GCLK_ID_EIC y los demás) están en el mismo grupo. Aquí nada depende de ellos (sección 3.2), así que un error en uno es invisible en Mokxi pero dejaría un periférico totalmente muerto en un escritorio.

Ausentes a propósito. Cada uno de estos se omitió en lugar de inventarse:

  • El árbol de relojes. Sin DFLL, sin osciladores, sin PLL, sin generadores. La sección 3.2 dice qué ocupa su lugar.
  • SPI e I2C en los SERCOM. La sección 3.3 es modo USART y nada más, así que Wire y SPI no están disponibles.
  • El DAC, que es para lo que realmente sirve PA02, los comparadores analógicos, el PTC y el I2S.
  • DMAC y EVSYS. Sin DMA y sin enlaces de eventos entre periféricos, que es lo que habrían usado los registros EVCTRL de los temporizadores.
  • NVMCTRL y la programación de flash, el watchdog, el RTC y el DSU. Mapeados e inertes (sección 2).
  • Todo el USB por encima de un conducto de bytes, que la sección 3.7 describe con detalle, y con ello Keyboard y Mouse.
  • The UF2 bootloader. An image here starts at zero; a real XIAO's starts at 0x2000 (section 2).

Por eso los binarios del núcleo Arduino del fabricante no funcionan aquí, y el firmware compilado para este documento sí.