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:
D0no 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.D4no tiene interrupción externa ordinaria. PA08 es el pin NMI del chip.attachInterrupt(4, ...)no hace nada, ni aquí ni en un escritorio.D5yD7compartenEXTINT9, así que solo uno de los dos puede llevar una interrupción a la vez; el segundoattachInterruptle 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: escribiranalogWriteen uno deD1/D4,D9/D5,D10/D2oD8/D3mueve 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.DFLLSYNClee 0. Así quewhile (!(SYSCTRL->PCLKSR.reg & DFLLRDY)) {}pasa de inmediato. - GCLK (
0x4000_0C00):CTRLen0x00(bit 0SWRST),STATUSen0x01(bit 7SYNCBUSY, nunca se activa),CLKCTRLen0x02,GENCTRLen0x04,GENDIVen0x08. 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):AHBMASK0x14,APBAMASK0x18,APBBMASK0x1C,APBCMASK0x20, todos almacenados y leídos con sus valores de reinicio, yRCAUSEen0x38, 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
PCKSIZEdel banco 1 y activaEPSTATUS.BK1RDY. El modelo lee esos bytes de la SRAM, los entrega al monitor serie, limpiaBK1RDYy activaEPINTFLAG.TRCPT1. - OUT. El firmware limpia
EPSTATUS.BK0RDYpara indicar que el banco 0 está libre. El modelo copia lo que el monitor haya tecleado en elADDRdel banco 0, escribe la longitud en suPCKSIZE, activaBK0RDYy generaEPINTFLAG.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:
CTRLA0x00,READREQ0x02,CTRLBCLR/CTRLBSET0x04/0x05,CTRLC0x06,DBGCTRL0x08,EVCTRL0x0A,INTENCLR/INTENSET0x0C/0x0D,INTFLAG0x0E,STATUS0x0F,COUNT0x10,PER0x14,CC0x18. Los desfases del TCC sí los puede afirmar este modelo; los del TC son su mejor lectura de un bloque cuyo diseño cambia conMODE, y son los números contra los que se compilafirmware/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
PMUXen cada pad lleva qué pad de SERCOM, qué línea deEXTINTy 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.rses 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
WireySPIno 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
EVCTRLde 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í.