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áPUPDRe não háAFR. - Esse registrador é protegido contra escrita.
PWPR.B0WIprecisa ser limpo ePWPR.PFSWEdefinido antes que qualquer escrita emPmnPFStenha efeito. Um programa que esquece encontradigitalWritefuncionando epinModenã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/MSTPCRDsejam escritos. - Há pull-up e não há pull-down.
INPUT_PULLDOWNobté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.
analogReadainda retorna dez, porque é o que um sketch do Arduino espera;analogReadResolutionpede o resto. - A flash está no zero. Sem alias, sem pino BOOT, e uma palavra de configuração em
0x400que 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
pinModedestravaPWPR, escreve uma palavraPmnPFSe a trava de novo.digitalWriteé um único armazenamento emPCNTR3.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
millisnã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 paraanalogWrite.delayexecutaWFIe aguarda; um segundo de tempo simulado custa cerca de mil instruções em vez de quarenta e oito milhões. analogReadretorna 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 emsrc/analog.ce 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ãoanalogWrite(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) - 1arredondado. A recepção emSerial1é feita por polling, porque não há uma ICU para entregar uma interrupção; a fila do modelo atrás deRDRé 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 etone()são do core compartilhado (firmware/lib): o heap vai de_endaté a pilha, etone()é 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_8000com 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_C000e todo deslocamento dentro do ADC14 (seção 3.5).A4eA5emAN021eAN022. Os outros quatro canais analógicos não estão neste grupo.USB_BASE=0x4009_0000e todo deslocamento dentro do USBFS (seção 3.6).- As codificações de
PSEL0b00011para GPT e0b00100para SCI (seção 3.2). - As posições exatas dos bits de
MSTPCRB/MSTPCRDpara 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
SCKDIVCRnão são modelados, então seja lá o que um sketch programe, o core roda a 48 MHz.crates/unor4/tests/runtime.rsmanté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
GTIORsão armazenados e não decodificados, então uma saída invertida ou alternada não é reproduzida; o duty cycle doanalogWriteé. - 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
ADCERe a média doADADCsã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, eif (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,IOREFand3V3at rail impedance for ever, so nothing browns out. Start-up is a microsecond, where a real R4 spends its first moments in the bootloader. - Não há botão do usuário, porque a placa não tem nenhum; o único botão mantém
RESETem nível baixo e chega através dopoke.
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.