Referência

Contrato da placa Seeed XIAO SAMD21 (Fase 9)

A ATSAMD21G18A: dois grupos de PORT, SERCOMs como USARTs, PWM em TCC e TC, o ADC em cada pad, e o USB como um canal de bytes.

Esta é a referência de engenharia do modelo: o que ele implementa, registrador por registrador, para quem escreve firmware para ele. Para usar a placa no editor, comece por A Seeed XIAO SAMD21 e página da placa.

O XIAO SAMD21 é a menor placa daqui e a terceira com Cortex-M0+. Um componente do kernel (xiao em crates/parts) envolve um modelo de SoC ATSAMD21G18A (crates/atsamd21) no mesmo núcleo do Raspberry Pi Pico (crates/cortexm-core, Profile::V6M). O núcleo é compartilhado; o chip ao redor dele não é. Este documento é o contrato, e ele prevalece sobre qualquer comentário no código.

O tipo no catálogo é xiao.

Leia a seção 7 primeiro se você está levando uma compilação daqui para o silício real. Cada endereço base neste modelo é um endereço que este documento pode declarar a partir do SAM D21 Family Datasheet, e a maioria dos offsets de registradores também, mas os offsets do bloco TC e a tabela de multiplexação de periféricos são uma interpretação deste modelo, e não uma página citada de volta, e a seção 7 nomeia cada um deles. Nada aqui é adivinhado em silêncio.

1. Pinos da placa (ordem do catálogo)

Vista de cima, com o conector USB-C no topo e o ATSAMD21G18A sob a serigrafia no meio. A placa tem 21 x 17,8 mm e suas duas fileiras de sete pads castelados ficam a 15,24 mm (exatamente 0,6 polegada) de distância, então ela atravessa o canal central de uma protoboard.

Coluna esquerda, de cima a baixo (7 pads): D0, D1, D2, D3, D4, D5, D6.

Coluna direita, de cima a baixo (7 pads): 5V, GND, 3V3, D10, D9, D8, D7.

14 pads. Onze são de E/S e três são de alimentação. Cada um dos onze também é uma entrada analógica, e A0 a A10 são os mesmos pads de D0 a D10; a serigrafia imprime ambos.

O pad por trás de cada pino, e o que mais ele pode ser:

pino pad AIN EXTINT PWM (função E) outro
D0 / A0 PA02 0 2 nenhum a saída do 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 Serial1 TX
D7 / A7 PB09 3 9 TC4 CC1 Serial1 RX
D8 / A8 PA07 7 7 TCC1 CC1 SCK
D9 / A9 PA05 5 5 TCC0 CC1 MISO
D10 / A10 PA06 6 6 TCC1 CC0 MOSI

Três coisas nessa tabela merecem ser lidas duas vezes, e as três são do hardware, não do modelo:

  • D0 não tem PWM. PA02 é o pino do DAC e não alcança nenhuma saída de forma de onda. analogWrite(0, x) aqui liga ou desliga o pad na metade do percurso, em vez de fingir um fade.
  • D4 não tem interrupção externa comum. PA08 é o pino de NMI do chip. attachInterrupt(4, ...) não faz nada, aqui nem numa mesa.
  • D5 e D7 compartilham EXTINT9, então só um dos dois pode carregar uma interrupção por vez; o segundo attachInterrupt tira a linha do primeiro. E como a TCC1 e a TCC2 têm dois registradores de comparação cada, alguns pinos compartilham um duty: escrever analogWrite em um de D1/D4, D9/D5, D10/D2 ou D8/D3 move ambos.

Três LEDs estão na placa e em nenhum pad: o LED do usuário no PA17, o LED de RX no PA18 e o LED de TX no PA19. Os três são ativos em nível baixo, então digitalWrite(LED_BUILTIN, LOW) acende o do usuário. Eles aparecem na ponta de prova e no visual, e em nenhum outro lugar. O runtime os numera como 13, 12 e 11 e define LED_BUILTIN como 13.

Elétrica. Cada pad de E/S driveia push-pull a 3,3 V através de R_STRONG, fica em alta impedância, ou faz pull up ou pull down através de 40 k. Uma entrada lê nível alto a 1,65 V; um nó em contenção (Unknown) lê 0, e um flutuante lê ruído, como no Uno (docs/uno.md seção 1). 3V3 driveia 3,3 V em R_SUPPLY, 5V driveia 5 V e GND driveia 0 V, sempre, porque a placa está conectada ao USB. Não há pad de reset no header: os dois pads de reset ficam na parte de baixo de um XIAO de verdade, e aqui o reset é um toque (seção 5).

2. Mapa de memória

flash 256 KB em 0x0000_0000
SRAM 32 KB de 0x2000_0000 a 0x2000_7FFF
topo da pilha 0x2000_8000
PM 0x4000_0400, seção 3.2
SYSCTRL 0x4000_0800, seção 3.2
GCLK 0x4000_0C00, seção 3.2
EIC 0x4000_1800, seção 3.6
PORT 0x4100_4400, seção 3.1
USB 0x4100_5000, seção 3.7
SERCOM0..5 0x4200_0800, espaçados de 0x400, seção 3.3
TCC0..2 0x4200_2000, espaçados de 0x400, seção 3.4
TC3..TC7 0x4200_2C00, espaçados de 0x400, seção 3.4
ADC 0x4200_4000, seção 3.5

Todo segmento PT_LOAD precisa cair dentro da flash ou da SRAM; qualquer outra coisa é recusada com o endereço problemático na mensagem, e o chip fica sem 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.

Blocos que o datasheet tem e este modelo não (PAC0-2, DSU, NVMCTRL, DMAC, MTB, WDT, RTC, EVSYS, AC, DAC, PTC, I2S) estão mapeados e inertes: ler um deles dá 0 e conta como acesso perdido, em vez de causar uma falha. Um startup que mexe nos wait states do controlador NVM não deve travar a placa. Qualquer coisa fora de todos os blocos é uma falha de acesso, que no ARMv6-M é uma HardFault e que a placa relata como um crash no canal do host.

3. Registradores de periféricos

Apenas o subconjunto abaixo está implementado. Um registrador do SAM D21 tem oito, dezesseis ou trinta e dois bits de largura, e o barramento atende cada um na sua própria largura: um acesso mais estreito que o registrador é o read-modify-write que a matriz de barramento teria feito, e um mais largo é respondido a partir do registrador em que começa. Assim, firmware escrito com os tipos do próprio datasheet funciona sem mudanças.

3.1 PORT (0x4100_4400)

Dois grupos, PA e PB, espaçados de 0x80. Os pads são numerados de 0..63 neste modelo: 0..31 são PA00..PA31 e 32..63 PB00..PB31.

offset registrador
0x00 DIR
0x04 DIRCLR
0x08 DIRSET
0x0C DIRTGL
0x10 OUT
0x14 OUTCLR
0x18 OUTSET
0x1C OUTTGL
0x20 IN
0x24 CTRL (armazenado, lido de volta)
0x28 WRCONFIG
0x30 + n PMUXn, um byte por par de pinos
0x40 + n PINCFGn, um byte por pino

PINCFG bit 0 PMUXEN, bit 1 INEN, bit 2 PULLEN, bit 6 DRVSTR (armazenado, eletricamente ignorado).

OUT tem função dupla e é a única verdadeira pegadinha deste componente. Com DIR set it is the driven level; with DIR clear it is the direção do pull. Então INPUT_PULLUP é DIRCLR, depois OUTSET, depois PINCFG.PULLEN, e PULLEN sem OUT dá um pull-para baixo. Com dois dos três o pino faz a coisa errada silenciosamente.

WRCONFIG grava os PINCFG e PMUX de dezesseis pinos em uma única escrita: PINMASK nos bits 0..15, PMUXEN 16, INEN 17, PULLEN 18, DRVSTR 22, PMUX 24..27, WRPMUX 28, WRPINCFG 30, HWSEL 31 (que desloca a máscara para os pinos 16..31).

Com PMUXEN definido, PMUX escolhe uma das oito funções de periférico A..H e o pad sai das mãos do PORT. O modelo age sobre as que ele tem (SERCOM no modo USART e as saídas de onda do TC/TCC, a tabela da seção 1) e trata qualquer outra escolha como um periférico que não tem, que não pede nada e deixa o pad em alta impedância em vez de inventar um nível. O pull do pad continua sendo do pad, e é assim que um pino RX do SERCOM mantém seu pull-up.

IN lê 0 em um pino cujo INEN está zerado, que é o que o hardware faz. Um pad que este chip está dirigindo lê de volta o que está dirigindo.

3.2 PM, GCLK e SYSCTRL: a árvore de clocks não é modelada

O core roda a 48 MHz desde a primeira instrução. Não há árvore de clocks aqui: sem DFLL, sem osciladores, sem divisores, sem geradores que gerem algo de fato. Esses três blocos existem para que um código de inicialização escrito contra os registradores reais rode até o fim em vez de travar em um bit de pronto.

  • SYSCTRL (0x4000_0800) é uma sombra de trinta e duas palavras, com duas exceções. PCLKSR (0x0C) lê todos os bits de pronto e de trava definidos (XOSCRDY, XOSC32KRDY, OSC32KRDY, OSC8MRDY, DFLLRDY, DFLLLCKF, DFLLLCKC, DFLLRCS, BOD33RDY, DPLLLCKF, DPLLLCKT) e todos os bits de falha zerados. DFLLSYNC lê 0. Então while (!(SYSCTRL->PCLKSR.reg & DFLLRDY)) {} passa direto.
  • GCLK (0x4000_0C00): CTRL em 0x00 (SWRST bit 0), STATUS em 0x01 (SYNCBUSY bit 7, nunca definido), CLKCTRL em 0x02, GENCTRL em 0x04, GENDIV em 0x08. Os três últimos são endereçados pelo ID no valor escrito, como no componente, e uma leitura responde para o ID que foi escrito por último. Nada é condicionado a eles.
  • PM (0x4000_0400): AHBMASK 0x14, APBAMASK 0x18, APBBMASK 0x1C, APBCMASK 0x20, todos armazenados e lidos de volta com seus valores de reset, e RCAUSE em 0x38, que aqui é somente leitura e carrega o bit de power-on, o bit de reset externo ou o bit de reset do sistema, dependendo do que resetou o componente por último. Nada é condicionado às máscaras de clock: um periférico funciona tendo ou não o firmware ligado seu clock. O runtime liga-os mesmo assim, porque um componente real precisa disso.

O tempo em si vem do SysTick, que está no cortexm-core em seu endereço de arquitetura. O runtime o recarrega a cada 48 000 ciclos (exatamente um milissegundo a 48 MHz), e SYST_CALIB informa isso como um décimo exato de dez milissegundos.

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

Seis SERCOMs, cada um modelado em modo USART com clock interno (CTRLA.MODE = 1), assíncrono 8N1, e em nenhum outro modo. SPI e I2C não são modelados; um SERCOM colocado em um desses modos não faz nada.

offset registrador
0x00 CTRLA
0x04 CTRLB
0x08 DBGCTRL (armazenado)
0x0C BAUD
0x0E RXPL (armazenado)
0x14 INTENCLR
0x16 INTENSET
0x18 INTFLAG
0x1A STATUS (armazenado; nenhum erro é gerado nunca)
0x1C SYNCBUSY (sempre 0)
0x28 DATA

CTRLA bit 0 SWRST, bit 1 ENABLE, bits 2..4 MODE, bits 16..17 TXPO (0 aciona PAD[0], qualquer outro valor PAD[2]), bits 20..21 RXPO (o pad em que o receptor escuta), bit 30 DORD. CTRLB bit 16 TXEN, bit 17 RXEN. INTFLAG bit 0 DRE, bit 1 TXC (travado, escreva 1 para limpar), bit 2 RXC.

BAUD é o gerador aritmético assíncrono: BAUD = 65536 (1 - 16 f / f_ref), então um tempo de bit é 16 x 65536 / (65536 - BAUD) clocks de referência. A referência é considerada o clock de 48 MHz do core, porque não há árvore de clocks para consultar (seção 3.2). Um BAUD de 0 (o que um programa que não chamou begin() deixa para trás) volta para 115200. Não há modo fracionário.

Um transmissor habilitado com TXEN definido é dono do seu pad e desloca bits reais por ele: um bit de início em nível baixo, oito bits de dados começando pelo menos significativo, um bit de parada em nível alto, cada um com a duração de um tempo de bit, cada borda marcada com o ciclo em que o hardware a teria movido. Um receptor com RXEN definido inicia um quadro em uma borda de descida e amostra cada bit de dados no meio do seu tempo de bit. Assim, um jumper de D6 para D7 transporta um caractere, e uma taxa de baud incompatível embaralha o texto aqui da mesma forma que embaralharia numa mesa.

Nesta placa, Serial1 é o SERCOM4 com TXPO 0 e RXPO 1, ou seja, PAD[0] no PB08 e PAD[1] no PB09 (D6 e D7), ambos na função de periférico C.

3.4 TCC0-2 e TC3-7, até o PWM

Três TCCs e cinco TCs. Um contador aqui nunca é incrementado passo a passo: ele é uma função em forma fechada do ciclo da CPU, e o mesmo vale para o instante de sua próxima borda, o que permite que um núcleo parado em WFI não custe nada durante um delay() inteiro enquanto um PWM continua rodando.

PRESCALER são os bits 8..10 de CTRLA nos dois tipos, e ele não é uma potência de dois até o fim: 0 a 4 são DIV1, DIV2, DIV4, DIV8 e DIV16, depois 5 é DIV64, 6 DIV256 e 7 DIV1024. Esse salto é uma verdadeira armadilha, e errá-lo deixa um PWM quatro vezes lento demais.

TCC (0x4200_2000 + 0x400 n):

offset registrador
0x00 CTRLA: bit 0 SWRST, bit 1 ENABLE, bits 8..10 PRESCALER
0x04/0x05 CTRLBCLR/CTRLBSET (armazenados)
0x08 SYNCBUSY (sempre 0)
0x24/0x28 INTENCLR/INTENSET
0x2C INTFLAG: bit 0 OVF
0x30 STATUS (sempre 0)
0x34 COUNT
0x3C WAVE: bits 0..2 WAVEGEN, dos quais 2 é PWM normal
0x40 PER, o período
0x44 + 4c CC0..CC3, os duties
0x68/0x6C/0x70 + 4c WAVEB/PERB/CCBn, que aqui surtem efeito imediatamente

TCC0 tem quatro canais de comparação; TCC1 e TCC2 têm dois, então seus WO[2] e WO[3] repetem WO[0] e WO[1]. É por isso que a tabela da seção 1 emparelha alguns pinos.

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

offset registrador
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 (aceito, não faz nada: a contagem é sempre atual)
0x04/0x05 CTRLBCLR/CTRLBSET (armazenados)
0x0C/0x0D INTENCLR/INTENSET
0x0E INTFLAG: bit 0 OVF
0x0F STATUS (sempre 0)
0x10 COUNT, na largura que MODE indicar
0x14 PER, apenas em COUNT8
0x18 + c CC0, CC1, separados por um byte em COUNT8, dois em COUNT16, quatro em COUNT32

No PWM normal (WAVEGEN = 2), o topo de um TC é PER em COUNT8 e a largura completa do contador caso contrário; no PWM por comparação (WAVEGEN = 3), CC0 é o período e CC1 o ciclo ativo. Uma saída de forma de onda fica alta do início do período até a comparação coincidente e baixa depois dela, então uma comparação de 0 é um nível baixo constante e uma comparação acima do topo é um nível alto constante, sem nenhuma transição. Esse é o formato que analogWrite espera e o único formato que este modelo produz.

A flag de overflow chega ao NVIC quando seu bit INTENSET está definido. Captura, o sistema de eventos, one-shot e a rampa, dithering, inserção de dead-time, geração de padrões e as entradas de falta estão ausentes.

3.5 ADC (0x4200_4000)

Conversões únicas disparadas por software, que é o único caminho que analogRead usa.

offset registrador
0x00 CTRLA bit 0 SWRST, bit 1 ENABLE
0x01 REFCTRL armazenado, lido de volta
0x02 AVGCTRL armazenado, lido de volta
0x03 SAMPCTRL armazenado, lido de volta
0x04 CTRLB bits 4..5 RESSEL: 0 doze bits, 2 dez, 3 oito
0x06 WINCTRL armazenado, lido de volta
0x08 SWTRIG bit 0 FLUSH, bit 1 START
0x0C INPUTCTRL bits 0..4 MUXPOS; MUXNEG e GAIN armazenados
0x10 EVCTRL armazenado
0x12/0x13 INTENCLR/INTENSET
0x14 INTFLAG bit 0 RESRDY, bit 1 OVERRUN
0x15 STATUS sempre 0
0x16 RESULT ler limpa RESRDY
0x18..0x22 WINLT, WINUT, GAINCORR, OFFSETCORR, CALIB, DBGCTRL armazenado, lido de volta

Uma conversão: aponte MUXPOS para o canal, escreva SWTRIG.START, espere RESRDY, leia RESULT. Isso leva um tempo fixo de 6 microssegundos de tempo simulado, que o firmware realmente espera. O resultado é round(4095 x Vin / 3.3) da tensão do pino no momento em que a conversão começou, deslocado para baixo para um RESSEL abaixo de doze bits. Um canal sem nada segurando seu pino lê 0.

A referência e o ganho não fazem nada aqui. REFCTRL.REFSEL e INPUTCTRL.GAIN são armazenados e lidos de volta, e o modelo sempre mede em relação ao trilho de 3.3 V, que é o resultado das próprias configurações dos cores do Arduino, INTVCC1 com ganho DIV2, nesta placa. Um sketch que muda para a referência interna de 1.0 V obtém aqui os mesmos números que obteria em INTVCC1, e este documento diz isso em vez de inventar uma escala. Média, o monitor de janela, as correções, o modo free-run, o modo diferencial e o sistema de eventos estão ausentes.

Os canais 0..19 existem. A tabela da seção 1 os mapeia para os pinos.

3.6 EIC (0x4000_1800)

Dezesseis linhas EXTINT, que é a base do attachInterrupt. Um pad chega ao controlador assumindo a função de periférico A, e em qual linha ele cai é fixado pelo pad (seção 1).

offset registrador
0x00 CTRL: bit 0 SWRST, bit 1 ENABLE
0x01 STATUS: bit 7 SYNCBUSY, sempre 0
0x02/0x03 NMICTRL/NMIFLAG (armazenados; a própria NMI não é gerada)
0x04 EVCTRL (armazenado)
0x08/0x0C INTENCLR/INTENSET
0x10 INTFLAG
0x14 WAKEUP (armazenado)
0x18/0x1C CONFIG0/CONFIG1: quatro bits de SENSE e um FILTEN por linha

SENSE: 0 nenhum, 1 borda de subida, 2 borda de descida, 3 ambas, 4 nível alto, 5 nível baixo. Uma borda é registrada em INTFLAG e é escrita para limpar. Um nível mantém INTFLAG definido por todo o tempo em que o pino estiver naquele nível, então um manipulador que não remove a condição executa de novo, exatamente como no componente. FILTEN é armazenado e não filtra nada.

As dezesseis linhas compartilham um vetor NVIC; o runtime lê INTFLAG e chama os manipuladores que estiverem anexados.

3.7 O dispositivo USB (0x4100_5000): um stub que transporta bytes

Numa XIAO, o único socket da placa vai para o próprio USB do SAM D21, e o monitor serial na sua mesa conversa com uma interface CDC ACM que o firmware do sketch enumera. Esse é o fato que faz a placa ser o que ela é, e é o fato que a torna complicada: não existe Serial até o firmware responder a uma dúzia de transferências de controle.

O que existe aqui é um tubo com os nomes dos registradores nele, e o caminho de transferência é o real do componente.

offset registrador
0x00 CTRLA: bit 0 SWRST, bit 1 ENABLE, bit 7 MODE
0x02 SYNCBUSY (sempre 0)
0x03 QOSCTRL (armazenado)
0x08 CTRLB: bit 0 DETACH, definido no reset
0x0A DADD (armazenado)
0x0C/0x0D/0x10 STATUS, FSMSTATUS, FNUM: todos leem 0; não há barramento para ter um estado
0x14/0x18/0x1C INTENCLR/INTENSET/INTFLAG (armazenados; nada é jamais gerado)
0x20 EPINTSMRY
0x24 DESCADD
0x28 PADCAL (armazenado)
0x100 + 0x20 n endpoint n: EPCFG +0, EPSTATUSCLR +4, EPSTATUSSET +5, EPSTATUS +6, EPINTFLAG +7, EPINTENCLR +8, EPINTENSET +9

A tabela de descritores em DESCADD é a real: dois bancos por endpoint, dezesseis bytes cada, ADDR em +0 e PCKSIZE em +4 com BYTE_COUNT nos bits 0..13 e SIZE nos bits 28..30.

  • IN. O firmware preenche um buffer, escreve o comprimento no PCKSIZE do banco 1 e define EPSTATUS.BK1RDY. O modelo lê esses bytes da SRAM, entrega-os ao monitor serial, limpa BK1RDY e levanta EPINTFLAG.TRCPT1.
  • OUT. O firmware limpa EPSTATUS.BK0RDY para dizer que o banco 0 está livre. O modelo copia o que o monitor tiver digitado para o ADDR do banco 0, escreve o comprimento em seu PCKSIZE, define BK0RDY e levanta EPINTFLAG.TRCPT0.

Nada mais sobre USB está aqui. Não há host, nem barramento, nem reset, nem pacote SETUP, nem descritor, nem enumeração, nem endereçamento, nem contador de quadros, nem start-of-frame de 1 ms, nem NAK, nem STALL e nem LPM. O INTFLAG nunca é acionado e a interrupção do USB nunca chega ao NVIC, então o runtime faz polling. Um sketch que dirige isso do jeito que o core do Arduino dirige o silício real ainda funciona (ele faz polling nos bits de banco pronto, que se comportam), mas um sketch que espera pela enumeração vai esperar para sempre, então while (!Serial) {} retorna imediatamente aqui e fica esperando numa mesa real. Keyboard e Mouse, que são a outra metade do propósito de uma placa com USB nativo, não estão disponíveis de forma alguma.

Não há baud rate neste canal, e isso não é um atalho: uma porta CDC ACM não tem baud rate próprio. Serial.begin(115200) passa um número que chegaria ao host como uma requisição de line coding, e o host pode ignorá-lo à vontade.

3.8 Interrupções

O NVIC está no núcleo no seu endereço arquitetural, com dois bits de prioridade. A tabela de vetores é a do 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.

Linhas que este modelo realmente aciona: EIC, SERCOM0..5, o ADC, TCC0..2 e TC3..TC7. A do USB não é acionada (seção 3.7) e nenhuma outra também.

4. Canal do host

host_write coloca bytes na fila de recepção do USB; host_read pega os bytes que saíram dele. Isso é o Serial num sketch e o monitor serial na interface. Os bytes são UTF-8 do ponto de vista da interface e opacos para o modelo.

Serial1 não é o canal do host. Ele vai para D6 e D7 e mais nenhum lugar, então o que um sketch imprime lá chega ao monitor serial somente se algo na protoboard trouxer de volta.

5. Modelo de tempo e o componente

Picossegundos num u64, como o kernel. O núcleo roda a 48 MHz, então um ciclo é 20833,33 ps, não um número inteiro, e é por isso que o tempo nunca é acumulado: ele é sempre recalculado a partir de uma contagem de ciclos como cycles x 1_000_000 / 48. Uma fatia de 10 us é exatamente 480 ciclos e exatamente 10.000.000 ps, então os limites de fatia nunca derivam. O contador de ciclos é ancorado ao tempo do kernel no início de cada fatia, então um timer nunca se afasta do circuito por mais que as fatias caiam, e um núcleo estacionado recupera os ciclos que dormiu, incluindo o SysTick, que é o que millis() conta.

A fatia roda em duas marchas, como os modelos STM32: lotes grossos limitados pelo próximo prazo de periférico, e uma instrução por vez durante 100 us depois de qualquer store que caia num registrador de PORT, SERCOM, timer ou USB. Então um programa que toca um pino roda fino e um programa que calcula roda grosso.

probe é uma bitmask: 1 rodando, 2 estacionado em WFI, 4 o LED do usuário aceso, 8 o LED de RX, 16 o LED de TX, 32 transmissão serial nos últimos 20 ms, 64 recepção serial; 0 sem programa. Os três bits de LED já estão do lado certo: os pads são ativos em nível baixo e o componente os inverteu.

poke: 1 mantém o reset, 0 o libera.

6. Runtime de firmware (firmware/xiao/)

Um runtime em formato Arduino escrito para esta placa: setup() e loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead (com analogReadResolution), analogWrite, millis, micros, micros64, delay, delayMicroseconds, attachInterrupt, detachInterrupt, interrupts, noInterrupts, Serial e Serial1. Sem Atmel Software Framework, sem core do Arduino, sem CMSIS, sem newlib, sem libgcc e sem compiler-rt.

delay() estaciona: ele executa WFI e a próxima interrupção do SysTick o acorda. Um núcleo estacionado não conclui instruções e o kernel salta direto para o momento do despertar, então o blink gasta seu segundo de tempo simulado em mil interrupções em vez de quarenta e oito milhões de ciclos. Um delay dentro de noInterrupts() faz busy-wait em vez disso, porque um núcleo estacionado com PRIMASK ativado nunca executaria o handler que avança o relógio.

analogWrite é de oito bits a 732,42 Hz (256 contagens, PER 255, do clock de 48 MHz dividido por 256: 48 MHz / 256 / 256, a frequência do Arduino Zero) nos dez pads que chegam a um timer. 0 e 255 não são PWM: eles devolvem o pad ao PORT e o conduzem para baixo ou para cima, então analogWrite(pin, 0) realmente desliga.

Compilado com clang --target=thumbv6m-none-eabi -mcpu=cortex-m0plus -mthumb, ligado a firmware/xiao/link.ld com ld.lld. Cinco dos arquivos do runtime são os do Raspberry Pi Pico, compilados de novo para esta placa em vez de copiados: a formatação de números, os auxiliares de matemática, o floor freestanding e o Print. Ambos os componentes são Cortex-M0+ e nada em nenhum desses arquivos depende de onde um periférico mora. Próprios desta placa são o cabeçalho de registradores, a tabela de pinos, o código de inicialização, o script do linker, as duas classes seriais e os drivers de GPIO, analógico, tempo, SERCOM, USB e interrupções. Os auxiliares AEABI de divisão, multiplicação e deslocamento em crt0.S são os do Pico instrução por instrução, porque os contratos de registrador deles são da ABI, não do chip.

A string program do catálogo é elf32 arm samd21. Ela difere da do Pico, elf32 arm rp2040, porque o ELF realmente difere: o mesmo conjunto de instruções, um mapa de memória diferente, e uma imagem ligada para um não roda no outro.

Quatro exemplos: blink (o LED do usuário e um no D10), button (uma chave no D2, no EXTINT10), serial (as duas portas, com um jumper de D6 a D7) e analog (um botão giratório no A10 e um fade no D9). Um exemplo tem orçamento de 32 KB, e o teto real que o script do linker impõe são os 32 KB de SRAM.

7. O que este modelo sabe com certeza, e o que não sabe

Três grupos. Esta seção existe porque um modelo de placa que adivinha um endereço em silêncio é pior do que um que diz que não sabia.

Tirado do datasheet. O mapa de memória da seção 2: 256 KB de flash no zero, 32 KB de SRAM em 0x2000_0000 e os endereços base de PM, SYSCTRL, GCLK, EIC, PORT, USB, os seis SERCOMs, TCC0-2, TC3-7 e o ADC, com os passos de 0x400 entre instâncias. O layout de registradores do PORT e seu passo de grupo de 0x80, incluindo a regra de OUT-escolhe-o-pull e as posições dos campos de WRCONFIG. O layout USART do SERCOM e a fórmula aritmética de baud. O layout do TCC. O layout do ADC. O layout do EIC e seus campos SENSE de quatro bits. Os registradores de dispositivo do USB, o passo de endpoint de 0x20 e o banco de descritores de dezesseis bytes com ADDR e PCKSIZE. A codificação do PRESCALER, incluindo o salto de DIV16 para DIV64. Os números de vetor de interrupção da seção 3.8. Dois bits de prioridade no NVIC.

Acreditado, não verificado. Duas coisas, e um programa levado ao silício real deveria conferir ambas:

  • Os deslocamentos de registradores do bloco TC na seção 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. Os deslocamentos do TCC este modelo pode afirmar; os do TC são a sua melhor leitura de um bloco cujo layout muda com MODE, e são os números com os quais firmware/xiao/include/samd21.h é construído, de modo que o firmware compilado aqui concorda com o modelo, quer concorde ou não com o silício.
  • A tabela de multiplexação de periféricos da seção 1: qual coluna PMUX em cada pad carrega qual pad de SERCOM, qual linha EXTINT e qual saída de forma de onda. Os números de pad por trás de cada pino do XIAO são os da placa e são deles que o firmware depende; a que canal de timer um pad pode chegar é o que um sketch de PWM depende, e um erro ali aparece como um pino que não faz fade, e não como um número errado. crates/atsamd21/src/mux.rs é a tabela inteira em um só lugar.

Os IDs de cliente de clock genérico em samd21.h (GCLK_ID_EIC e os demais) estão no mesmo grupo. Nada aqui depende deles (seção 3.2), então um erro em um deles é invisível no Mokxi e pararia um periférico por completo em uma bancada real.

Ausentes de propósito. Cada um destes foi deixado de fora em vez de inventado:

  • A árvore de clocks. Sem DFLL, sem osciladores, sem PLL, sem geradores. A seção 3.2 diz o que ocupa o lugar dela.
  • SPI e I2C nos SERCOMs. A seção 3.3 é modo USART e nada mais, então Wire e SPI não estão disponíveis.
  • O DAC, que é para o que o PA02 realmente serve, os comparadores analógicos, o PTC e o I2S.
  • DMAC e EVSYS. Sem DMA e sem ligações de eventos entre periféricos, que é o que os registradores EVCTRL dos timers teriam usado.
  • NVMCTRL e a gravação da flash, o watchdog, o RTC e o DSU. Mapeados e inertes (seção 2).
  • Todo o USB acima de um canal de bytes, que a seção 3.7 descreve em detalhe, e com ele Keyboard e Mouse.
  • The UF2 bootloader. An image here starts at zero; a real XIAO's starts at 0x2000 (section 2).

É por isso que binários do core Arduino do fornecedor não rodam aqui, e o firmware compilado para este documento roda.