Referência

Contrato da placa Arduino Uno R4 Minima (Fase 9)

The RA4M1 on our Cortex-M4 core: the PFS port block, GPT PWM, SCI2 as Serial1 and a fourteen-bit ADC.

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 Arduino Uno R4 Minima e página da placa.

O Arduino Uno R4 Minima é um RA4M1 da Renesas (um Cortex-M4 a 48 MHz) em formato de Uno. Um componente do kernel (unor4 em crates/parts) encapsula um modelo de SoC RA4M1 (crates/unor4) sobre o mesmo núcleo ARMv7-M da Blue Pill e da Black Pill (crates/cortexm-core). O núcleo é compartilhado; o chip ao redor não, e nada sobre os pinos é.

O tipo no catálogo é unor4. Este documento é o contrato, e ele prevalece sobre qualquer comentário no código.

Leia a seção 7 primeiro se você leva uma compilação daqui para silício real. Este modelo é menor que o RA4M1, e vários de seus endereços estão marcados como "acreditado, não verificado": a seção 7 diz quais, e o que está ausente de vez. Nada aqui é adivinhado em silêncio.

Por que isto não é uma Blue Pill com números diferentes

Um RA é um mundo diferente de um STM32, e as diferenças são justamente aquelas nas quais um sketch tropeça:

  • Um pino é um registrador. PmnPFS é uma palavra de 32 bits por pino que guarda direção, o latch de saída, o pull-up, open drain, a chave analógica, "um periférico é dono deste pino agora" e qual periférico. Não há MODER, não há CRL/CRH, não há PUPDR e não há AFR.
  • Esse registrador é protegido contra escrita. PWPR.B0WI precisa ser limpo e PWPR.PFSWE definido antes que qualquer escrita em PmnPFS tenha efeito. Um programa que esquece encontra digitalWrite funcionando e pinMode não fazendo nada. Este modelo impõe isso e conta o que descartou.
  • Um periférico não tem clock até você dizer. Todo bit nos registradores de parada de módulo reseta como "parado". SCI, GPT, ADC14 e USB ficam todos inacessíveis (leituras retornam zero) até que MSTPCRB/MSTPCRD sejam escritos.
  • Há pull-up e não há pull-down. INPUT_PULLDOWN obtém aqui uma entrada flutuante simples, e o modelo avisa isso.
  • Serial é USB, não uma UART. A UART em D0 e D1 é Serial1. Em um Uno, os dois são uma coisa só.
  • O conversor tem quatorze bits. analogRead ainda retorna dez, porque é o que um sketch do Arduino espera; analogReadResolution pede o resto.
  • A flash está no zero. Sem alias, sem pino BOOT, e uma palavra de configuração em 0x400 que um componente real lê ao sair do reset.
  • O LED embutido é ativo em nível alto, como o de um Uno e ao contrário do de uma Blue Pill.

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

Furo a furo, um cabeçalho de Uno R3, e é isso que permite a um R4 receber um shield de Uno. A placa tem 68.6 x 53.3 mm.

Fileira de cima, da esquerda para a direita (14 furos): SCL, SDA, AREF, GND, 13, 12, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0.

Fileira de baixo, da esquerda para a direita (13 furos): IOREF, RESET, 3V3, 5V, GNDb, GNDc, VIN, A0, A1, A2, A3, A4, A5.

31 pinos. Nomes duplicados ganham uma letra porque nomes de pinos no catálogo são únicos.

SCL e SDA ao lado de AREF são os mesmos dois pedaços de metal que A5 e A4: um traço, dois furos, como em um Uno. Acionar qualquer uma das pontas aciona as duas.

O pino do RA4M1 por trás de cada furo:

furo pad também
0 P301 RXD2, recepção do Serial1
1 P302 TXD2, transmissão do 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

Os números de canal de A4 e A5 não foram verificados (seção 7). Os outros quatro não são.

Elétrico: toda E/S aciona push-pull a 5 V através de R_STRONG, fica em alta impedância, ou puxa para cima através de 35 k. Não há pull-down interno. Uma entrada lê alto a 2,5 V; um nó disputado (Unknown) lê 0, e um flutuante lê ruído, como no Uno (docs/uno.md seção 1). 5V e IOREF fornecem 5 V em R_SUPPLY, 3V3 fornece 3,3 V, os três terras fornecem 0 V. RESET tem um pull-up de 10 k para 5 V, e puxá-lo abaixo de 2,5 V mantém o núcleo em reset. VIN e AREF são entradas que o modelo lê e com as quais não faz nada.

O pino 13 carrega o LED embutido: uma carga de 1 k para o terra, adicionada apenas enquanto o pino é uma saída, então pinMode(13, INPUT_PULLUP) ainda se comporta. O cátodo do LED está no terra, então o pino fornece corrente para acendê-lo.

2. Mapa de memória

flash de código 256 KB em 0x0000_0000
memória de configuração 0x0000_0400, duas palavras, armazenadas e não decodificadas
SRAM 32 KB em 0x2000_0000
topo da pilha 0x2000_8000
PORT e PFS 0x4004_0000, seções 3.1 e 3.2
parada de módulo 0x4004_7000, seção 3.7
ADC14 unidade 0 0x4005_C000, seção 3.5 (presumido)
SCI0..SCI9 0x4007_0000, espaçados de 0x20, seção 3.4
GPT0..GPT7 0x4007_8000, espaçados de 0x100, seção 3.3 (presumido)
USBFS 0x4009_0000, seção 3.6 (presumido)

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.

Todo segmento PT_LOAD precisa cair dentro da flash ou da SRAM; qualquer outra coisa é recusada com um motivo, e o chip fica sem programa. A flash de dados (8 KB em 0x4010_0000) e sua interface de programação não são modeladas.

A memória de configuração em 0x0000_0400 é onde um RA4M1 real lê OFS0 ao sair do reset para decidir se os watchdogs iniciam sozinhos. firmware/unor4/crt0.S coloca uma palavra lá e link.ld verifica que ela cai em 0x400; este modelo não tem watchdog e não decodifica nenhuma das palavras. Uma imagem sem isso dá boot aqui e se reseta sozinha numa mesa, por isso não é opcional.

O núcleo é um Cortex-M4 sem FPU aqui. O RA4M1 tem uma FPU de precisão simples; cortexm-core implementa a parte inteira do ARMv7E-M e nada de VFP, CPACR é armazenado e não concede nada, e toda codificação VFP gera UNDEFINSTR. Compile o firmware com -mfloat-abi=soft -mfpu=none. Aritmética de ponto flutuante num sketch funciona e é feita em instruções inteiras; um binário hard-float compilado em outro lugar falha na primeira instrução VFP em vez de retornar um número errado. Quatro bits de prioridade, como no componente.

3. Registradores de periféricos

Somente o subconjunto abaixo está implementado. Qualquer outra coisa dentro de um bloco mapeado lê 0 e conta como acesso estranho; qualquer coisa fora de todos os blocos é uma falha de acesso. Um módulo com o bit de parada ativado (seção 3.7) lê 0 e também conta como acesso estranho, que é como "o clock está desligado" aparece no barramento.

3.1 PORT0..PORT5 (0x4004_0000, espaçados de 0x20)

offset registrador metades
0x00 PCNTR1 PDR 16 bits baixos, PODR 16 bits altos
0x04 PCNTR2 PIDR 16 bits baixos, EIDR 16 bits altos (somente leitura)
0x08 PCNTR3 POSR 16 bits baixos seta, PORR 16 bits altos limpa (somente escrita)
0x0C PCNTR4 EOSR/EORR, armazenados

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 lê o pino, não o latch: uma saída push-pull lê de volta o que está direcionando, uma entrada ou uma saída open-drain lê o que a placa amostrou por último do nó.

As portas 0 a 5 são modeladas, o que cobre todos os pinos que a Minima expõe e toda entrada analógica que o encapsulamento de 64 pinos tem. Os pads são numerados como port * 16 + pin.

3.2 PmnPFS (0x4004_0800, 0x40 por porta, 4 bytes por pino) e PWPR (0x4004_0D03)

Uma palavra de 32 bits por pino em 0x4004_0800 + 0x40*m + 4*n. Os aliases de byte e halfword que o manual fornece (PmnPFS_BY, PmnPFS_HA) são uma union com o registrador de 32 bits, então neste componente little-endian eles são o byte baixo e a halfword baixa dele, e é por isso que pinMode pode ser uma única escrita de byte.

bit nome significado
0 PODR o latch de saída
1 PIDR o nível no pino, somente leitura
2 PDR 1 = saída, 0 = entrada
4 PCR o pull-up interno
6 NCODR open drain de canal N
10..11 DSCR força de direção, armazenado
12..13 EOFR evento em borda, armazenado
14 ISEL habilitação de entrada de IRQ, armazenada (seção 3.8)
15 ASEL habilitação de entrada analógica
16 PMR 1 = um periférico controla o pino
24..28 PSEL qual periférico

Um pino com ASEL ativado está eletricamente em alta impedância não importa o que o resto da palavra diga, e é o único tipo que o conversor pode amostrar. Um pino com PMR ativado segue o periférico modelado que seu PSEL indicar e ignora PODR; um PSEL que este modelo não implementa deixa o pad em paz em vez de inventar um nível.

PSEL valores nos quais este modelo age: 0b00011 GPT e 0b00100 SCI. Ambos são presumidos, não verificados (seção 7).

PWPR é um byte em 0x4004_0D03. B0WI (bit 7) resets set and makes PFSWE (bit 6) não gravável; escrever zero o limpa, e então escrever PFSWE permite escritas em PFS. Uma escrita com B0WI definido deixa PFSWE intacto. Uma PmnPFS escrita enquanto PFSWE está limpo não surte efeito, e o modelo a contabiliza (protected_writes), porque essa é a falha silenciosa pela qual este componente é famoso.

3.3 GPT0..GPT7 (0x4007_8000, 0x100 de distância)

GPT0 e GPT1 contam 32 bits; GPT2 a GPT7 contam 16.

offset registrador
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) é o bit de execução. GTCR.TPCS (bits 24..26) é o prescaler, PCLKD / 4^TPCS, ou seja 1, 4, 16, 64, 256 e 1024; um valor reservado é tratado como 1024. GTCR.MD (bits 16..18) é armazenado; apenas a contagem crescente em dente de serra é modelada. GTSTR, GTSTP e GTCLR recebem uma máscara de bits de canais e os iniciam, param ou zeram. GTPR e GTPBR são escritos juntos, porque a transferência de buffer que este modelo faria no fim de um ciclo carregaria o mesmo valor.

O contador nunca é armazenado como um número que incrementa: ele é calculado a partir do ciclo da CPU como (cycle - started) / divider mod (GTPR + 1), então não pode se desviar do circuito, e uma leitura de GTCNT no meio de uma fatia dá a contagem naquela instrução.

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.

Qual saída GPT corresponde a cada pino PWM:

pino pad saída
3 P105 GTIOC1B
5 P107 GTIOC2B
6 P111 GTIOC3A
9 P304 GTIOC5B
10 P103 GTIOC4B
11 P411 GTIOC6A

Essa tabela não foi verificada (seção 7). Os seis pinos são os pinos PWM documentados da Minima; qual canal e qual saída corresponde a cada um é uma suposição deste modelo. O modelo e o runtime concordam, então o firmware compilado aqui funciona aqui.

GPT0 não é usado de propósito pelo runtime.

3.4 SCI0..SCI9 (0x4007_0000, 0x20 de distância)

Registradores de um byte, um após o outro: endereços adjacentes são registradores diferentes, então um acesso mais largo alcança apenas o byte no endereço dado.

offset registrador
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) e RE (4) são as duas chaves (não há habilitação mestre), além de TIE (7), RIE (6), TEIE (2). SSR: TDRE (7), RDRF (6), ORER (5), FER (4), PER (3), TEND (2). As flags de erro e RDRF são limpas escrevendo zero nelas e, caso contrário, são somente leitura, e RDRF não pode ficar limpo enquanto houver bytes na fila.

Um bit dura 32 * 4^CKS * (BRR + 1) ciclos de PCLKA, a partir do N = PCLKA / (64 * 2^(2n-1) * B) - 1 do manual. SEMR.ABCS (bit 5) divide o divisor por dois e SEMR.BGDM (bit 4) divide de novo; ambos são aplicados. Todo o resto em SEMR, e SCMR, SNFR, SIMR*, SISR e SPMR, é armazenado e lido de volta e não muda nada. O tamanho do quadro segue SMR.CHR, SMR.PE e SMR.STOP.

Os bytes saem na taxa de bits, não instantaneamente: TDR mais o registrador de deslocamento, então TDRE volta assim que um byte começa a sair e TEND quando o último termina. Um Serial1.println custa tempo simulado (86,8 us por byte a 115200), exatamente como custa na bancada.

O SCI2 é o único canal em um pino aqui: TXD2 no D1 e RXD2 no D0. Os outros nove existem para que o número do canal seja o índice; seus bytes são contados e não vão a lugar nenhum.

Um pad com PMR definido e PSEL = SCI que é o transmissor do SCI2 fica em nível alto enquanto SCR.TE está definido, que é o que uma linha TX real faz entre quadros. Os bytes em si vão para o canal do host, não para o fio como forma de onda.

3.5 ADC14 unidade 0 (0x4005_C000)

O endereço base e todo offset nesta seção não foram verificados (seção 7).

offset registrador
0x00 ADCSR (16 bits)
0x04, 0x06 ADANSA0, ADANSA1
0x08, 0x0A ADADS0, ADADS1 (armazenados)
0x0C ADADC (armazenado)
0x0E ADCER
0x10 ADSTRGR (armazenado)
0x12 ADEXICR (armazenado)
0x20 + 2n ADDRn, um resultado por canal
0xE0 + n ADSSTRn, tempo de amostragem em estados do ADC, reinicia em 0x0B

ADCSR.ADST (bit 15) inicia uma varredura e fica definido enquanto ela roda; o firmware faz polling nele, e limpá-lo abandona a varredura. ADCSR.ADCS (bits 13..14): 0 única, 2 contínua; uma varredura contínua se rearma sozinha. ADCER.ADRFMT (bit 15) move o resultado para o topo dos dezesseis bits; alinhado à direita por padrão.

Uma varredura cobre os canais selecionados em ADANSA0/ADANSA1 e leva o tempo de amostragem de cada um mais doze estados de aproximação sucessiva. PCLKC é ICLK / 2, então um estado do ADC são dois ciclos de CPU e uma conversão padrão de um canal dura 23 estados, um pouco menos de um microssegundo, que o firmware realmente precisa esperar.

ADDRn guarda os quatorze bits. Nada no chip os desloca para dez bits; analogRead' a resolução padrão é obra do runtime (seção 6). A escala completa é o trilho de 5 V.

Varreduras em grupo, o sensor de temperatura, a referência interna, a média de dados, a autodiagnose, o modo de disparo duplo e todo trigger exceto o de software não são modelados.

3.6 USBFS (0x4009_0000): um canal de bytes, e nada mais

O endereço base e todos os offsets desta seção não são verificados (seção 7) e, o que é mais importante, também não é a ideia de que isso seja USB de verdade.

offset registrador
0x00 SYSCFG
0x04 SYSSTS0 (somente leitura)
0x08 DVSTCTR0 (armazenado)
0x14 CFIFO
0x20 CFIFOSEL
0x22 CFIFOCTR
0x30 INTENB0 (armazenado)
0x40 INTSTS0 (armazenado)

SYSCFG.USBE (bit 0) liga o controlador, SYSCFG.DPRPU (bit 4) conecta o pull-up de D+ (que é o que significa "plugar") e SYSCFG.SCKE (bit 10) é o clock. Até que o bit de parada de módulo seja limpo e tanto USBE quanto DPRPU sejam definidos, o pipe não carrega nada.

CFIFOSEL.CURPIPE (bits 0..3) escolhe um pipe e CFIFOSEL.ISEL (bit 5) a direção: definido para escrever, limpo para ler. CFIFO move bytes. CFIFOCTR.DTLN (bits 0..8) lê quantos estão lá, BVAL (bit 15) entrega um buffer de escrita e BCLR (bit 14) o descarta. Um buffer que chega a 64 bytes sai por conta própria, porque não há host para esperar.

Nada mais de USB está aqui. Sem host, sem barramento, sem reset, sem pacote SETUP, sem descritor, sem enumeração, sem endereçamento, sem contador de quadros, sem SOF, sem double buffering, sem NAK, sem STALL, sem configuração de pipe e sem interrupção. Um sketch que dirigir isso do jeito que um driver CDC dirige o silício funcionará; um sketch que esperar a enumeração terminar, ou inspecionar uma requisição de descritor, esperará para sempre. É por isso que if (Serial) é verdadeiro aqui assim que begin() roda, e falso por um momento numa mesa real.

Este é o ponto em que o modelo deliberadamente não é o chip, e fingir o contrário seria a única mentira que importa.

3.7 Parada de módulo (0x4004_7000)

endereço registrador o que este modelo decodifica
0x4004_7000 MSTPCRB SCIn no bit 31 - n, USBFS no bit 11
0x4004_7004 MSTPCRC armazenado
0x4004_7008 MSTPCRD GPTn no bit 12 - n, ADC14 unidade 0 no 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, o NVIC e a ICU que não está aqui

O SysTick é do núcleo, com SYST_CALIB = 480.000: o clock de referência é o ICLK, então um tick de 10 ms é 480.000 contagens. Quatro bits de prioridade. A tabela de vetores tem dezesseis entradas de sistema e depois trinta e dois slots da ICU.

Num RA esses trinta e dois não têm significado fixo: qual evento de periférico chega à IRQ n é programado no registrador IELSRn da ICU. Os links de eventos da ICU não são modelados, então nada neste modelo levanta uma interrupção de periférico, IELSRn não é implementado e PmnPFS.ISEL é armazenado e não faz nada. O SysTick, uma exceção do núcleo que não precisa de link, é a única interrupção que dispara. É por isso que não há attachInterrupt no runtime (seção 6), e isso é dito claramente em vez de aproximado: uma ICU com números de evento inventados seria pior que nenhuma.

4. Canal do host

host_write coloca bytes no buffer de recepção do pipe USB e também na fila de recepção do SCI2; host_read retira os bytes que saíram de qualquer um deles. Uma placa tem um canal de host, e um sketch pode estar lendo Serial, Serial1 ou ambos.

Isso é Serial e Serial1 num sketch e o monitor serial na interface. Os bytes são UTF-8 no que diz respeito à interface e opacos para o modelo.

As duas portas não são iguais num aspecto visível: os bytes de Serial1 saem na taxa de bits e os de Serial saem no fim da fatia em que foram entregues, então uma linha USB realmente pode cair dentro de uma linha UART no monitor. Isso é a placa, não um bug.

5. Modelo de tempo e o componente

Picossegundos num u64, como o kernel. A CPU 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 é recalculado a partir de uma contagem de ciclos como cycles * 1_000_000 / 48. Uma fatia de 10 us é exatamente 480 ciclos e exatamente 10.000.000 ps, então os limites das fatias nunca derivam.

O contador de ciclos é ancorado ao tempo do kernel no início de cada fatia, então um timer não pode se afastar do circuito por mais que as fatias caiam, e um núcleo estacionado recupera os ciclos que dormiu (SysTick incluído) sem executá-los.

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 é uma máscara de bits: 1 rodando, 2 dormindo em WFI, 4 o LED embutido do pino 13 aceso, 8 transmissão serial nos últimos 20 ms, 16 recepção serial. 0 sem programa, preso em reset, ou travado.

poke: 1 segura RESET, 0 solta.

Uma queda (um BKPT, ou uma falha da qual o núcleo não consegue retornar) para a placa e coloca uma linha no canal do host nomeando o PC, CFSR e HFSR:

firmware crashed at pc=0x00001000, BKPT #0 (CFSR 0x00000000, HFSR 0x00000000)

crt0.S aponta todo vetor de que não precisa para um handler que executa BKPT, então uma falha diz onde estava em vez de girar em silêncio.

6. Runtime de firmware (firmware/unor4/)

Um runtime em formato Arduino escrito do zero: setup() e loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead, analogReadResolution, analogWrite, millis, micros, delay, delayMicroseconds, map, random, Serial e Serial1. Sem core do Arduino, sem ArduinoCore-renesas, sem FSP, sem CMSIS, sem libc, nada de GPL.

Compilado com clang --target=thumbv7em-none-eabi -mcpu=cortex-m4 -mthumb -mfloat-abi=soft -mfpu=none -Os e ld.lld contra firmware/unor4/link.ld, com --nmagic para que um programa de dois kilobytes não seja preenchido até uma página de 64 KB. BOARD=unor4 é a única placa que este script compila.

  • Pinos. Cada pinMode destrava PWPR, escreve uma palavra PmnPFS e a trava de novo. digitalWrite é um único armazenamento em PCNTR3. INPUT_PULLDOWN é aceito e dá uma entrada simples, porque o componente não tem pull-down.
  • Tempo. SysTick a 1 kHz: reload 47.999, um número inteiro de ciclos a 48 MHz, então millis não sofre desvio. micros é esse contador mais o que resta no próprio contador decrescente do SysTick, então um único timer dá resolução de microssegundo em toda a faixa de 32 bits e todos os canais do GPT ficam livres para analogWrite. delay executa WFI e aguarda; um segundo de tempo simulado custa cerca de mil instruções em vez de quarenta e oito milhões.
  • analogRead retorna dez bits, 0..1023, de um conversor de catorze bits, porque é isso que um sketch do Arduino espera. analogReadResolution(1..14) muda o deslocamento, que fica em src/analog.c e não no chip.
  • analogWrite é 0..255 em 490,0 Hz (48 MHz / 16 / 6123) em D3, D5, D6, D9, D10 e D11. 0 e 255 removem a habilitação de saída do GPT e controlam o pino, então analogWrite(pin, 0) está realmente desligado; um pino que não é um dos seis é controlado em nível baixo ou alto no ponto médio, como os core do Arduino fazem.
  • Serial é o canal do USB e não chega a nenhum pino do cabeçalho. Serial1 é a SCI2 em D0 e D1, 8N1, BRR = PCLKA / (32 * baud) - 1 arredondado. A recepção em Serial1 é feita por polling, porque não há uma ICU para entregar uma interrupção; a fila do modelo atrás de RDR é profunda o suficiente para que digitar enquanto o sketch está ocupado não perca caracteres.
  • Não há attachInterrupt, pelo motivo que a seção 3.8 dá. Um sketch faz polling.
  • Ponto flutuante funciona e é soft float. Serial.print(float) lê o padrão de bits IEEE-754 e nunca faz cálculos com ele.
  • String, o heap e tone() são do core compartilhado (firmware/lib): o heap vai de _end até a pilha, e tone() é PWM de GPT a 50 por cento em D3, D5, D6, D9, D10 e D11, com um fallback bloqueante bit-banged para uma nota temporizada em qualquer outro pino. Sem I2C, sem SPI.

A string de program do catálogo é elf32 arm ra4m1.

Quatro exemplos, cada um com orçamento de 16 KB: blink, button (um botão em D2), serial (as duas portas, e um eco) e analog (um potenciômetro em A0 controlando o brilho de um LED em D9, imprimindo dez bits e catorze).

crates/unor4/tests/runtime.rs executa esses ELFs contra o modelo. Dois de seus casos existem para sustentar os números deste documento em vez de repeti-los: o relógio realmente está a 48 MHz ao longo de dois segundos simulados, e millis chega a menos de 20 ms da verdade três segundos depois.

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.

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.

Acreditado, não verificado. Nomeado aqui para que uma imagem levada ao silício real tenha uma lista curta para conferir, tudo em um único cabeçalho, firmware/unor4/include/ra4m1.h:

  • GPT_BASE = 0x4007_8000 com stride de 0x100, e todo deslocamento de registrador dentro de um canal GPT (seção 3.3).
  • Qual saída de GPT corresponde a cada pino PWM: a tabela de seis linhas na seção 3.3. Esta é a afirmação mais frágil do documento: os pinos estão certos e os canais são uma crença.
  • ADC_BASE = 0x4005_C000 e todo deslocamento dentro do ADC14 (seção 3.5).
  • A4 e A5 em AN021 e AN022. Os outros quatro canais analógicos não estão neste grupo.
  • USB_BASE = 0x4009_0000 e todo deslocamento dentro do USBFS (seção 3.6).
  • As codificações de PSEL 0b00011 para GPT e 0b00100 para SCI (seção 3.2).
  • As posições exatas dos bits de MSTPCRB/MSTPCRD para USBFS (11) e ADC14 (16). Os bits de SCI e GPT seguem a regra de contagem decrescente, que não faz parte deste grupo.

Onde o modelo e este documento divergem do silício, o firmware construído aqui ainda concorda com o modelo: ele roda no simulador e suas escritas de registrador estão em um único cabeçalho para corrigir.

Modelado, mas não preso aos números do manual. Comportamentos em vez de endereços, na ordenação que a seção 7 de docs/esp32c6.md define e que todo contrato de placa aqui agora segue:

  • O relógio é 48 MHz e a árvore de clock não existe. Os bits de parada de módulo são portões; HOCO, MOCO, o PLL e SCKDIVCR não são modelados, então seja lá o que um sketch programe, o core roda a 48 MHz. crates/unor4/tests/runtime.rs mantém isso em relação ao firmware distribuído, e não a esta frase.
  • A saída do GPT fica em nível alto abaixo do seu registrador de comparação e em nível baixo acima dele (seção 3.3). Os campos de cinco bits de seleção de nível do GTIOR são armazenados e não decodificados, então uma saída invertida ou alternada não é reproduzida; o duty cycle do analogWrite é.
  • A fatia tem duas marchas, e o primeiro armazenamento depois de um período parado é adiantado, em até 10,7 µs. Tudo dentro de uma rajada é exato. O raciocínio é o da seção 7 de docs/stm32f411.md.
  • O ADC14 não tem nenhum erro. Uma conversão é a reta pura contra uma referência de 5 V, amostrada no instante em que começou, sem sample-and-hold, sem impedância de entrada, sem não linearidade, sem ruído e sem offset. O autodiagnóstico do ADCER e a média do ADADC são armazenados e não fazem nada.
  • Os pads são três estados e um limiar. Push-pull a 5 V, dreno aberto, alta impedância, ou um pull-up interno de 35 kΩ, lidos contra metade da alimentação, sem histerese, sem ajuste de força de acionamento, sem tempo de subida e sem limite de corrente. DSCR é armazenado.
  • A porta serial é um canal de bytes e o canal nunca enche. Os bytes entregues saem no fim da fatia, e não em uma fronteira de quadro USB, availableForWrite é sempre 1, e if (Serial) é uma decisão que este modelo toma, e não um handshake que ele executa (seção 3.6).
  • The board is an ideal supply: 5V, IOREF and 3V3 at rail impedance for ever, so nothing browns out. Start-up is a microsecond, where a real R4 spends its first moments in the bootloader.
  • Não há botão do usuário, porque a placa não tem nenhum; o único botão mantém RESET em nível baixo e chega através do poke.

Ausentes de propósito. Cada um destes foi deixado de fora em vez de inventado, porque seu layout ou seu comportamento não é algo que este modelo possa reproduzir com honestidade:

  • A ICU e seus links de eventos. Seção 3.8. Com ela vão todas as interrupções de periféricos, o attachInterrupt, e os pinos de IRQ.
  • O circuito de geração de clock: HOCO, MOCO, o PLL, SCKDIVCR. O componente é modelado como se já estivesse rodando a 48 MHz, e um programa que configura a árvore de clocks escreve em um bloco não mapeado.
  • O AGT. O temporizador de baixo consumo do RA4M1, e o que o core do Arduino usa para o millis. O SysTick é suficiente aqui e é exato.
  • Os watchdogs (IWDT e WDT), e é por isso que a memória de configuração de opções é armazenada e não decodificada.
  • I2C (IIC), SPI, CAN, o DTC, a unidade de toque CTSU, o RTC, o DAC, os comparadores, os OPAMPs, as unidades CRC e CAC, e a interface de programação da flash de dados.
  • USB como protocolo. A seção 3.6 é tudo o que há.
  • Programação da flash e a ROM de boot.

É por isso que um binário FSP do fabricante ou do core do Arduino não roda aqui, e um firmware compilado para este documento roda.