Placas

A Arduino Uno R4 Minima

O Uno que todo mundo compra hoje: a mesma placa, os mesmos pinos de 5 V, um Arm Cortex-M4 por baixo em vez de um AVR de 8 bits.

A visão geral, com exemplos rodando, está na página da placa e O modelo da Arduino Uno R4 Minima (todos os registradores).

O que é

Um Renesas RA4M1 a 48 MHz: um Arm Cortex-M4 com 256 KB de flash e 32 KB de SRAM, enquanto uma Uno R3 tem um ATmega328P a 16 MHz com 32 KB e 2 KB. A placa mede 68,6 por 53,3 mm, o contorno da Uno com precisão de décimo de milímetro, então ela aceita um shield de Uno e não entra numa protoboard: ligue-a com jumpers a partir dos headers. A página de referência é O modelo do Arduino Uno R4 Minima.

Esta é a Minima, a que tem o conector USB-C e sem WiFi. A Uno R4 WiFi, com sua matriz de LEDs e o WiFi, é uma placa separada na caixa de componentes: veja a Uno R4 WiFi.

Serial é o USB

Esta é a primeira coisa que surpreende quem chega de uma Uno R3.

Numa Uno, um segundo chip converte USB em UART, e Serial é a USART0 do microcontrolador nos pinos 0 e 1. Numa R4 não há segundo chip: o dispositivo USB está no próprio RA4M1. Serial é o conector, e Serial1 é a UART nos pinos 0 e 1, uma porta própria.

Então, no editor:

  • O que você imprime em Serial aparece no monitor serial.
  • O que você imprimir em Serial1 também aparece no monitor (uma placa tem um canal de host aqui), e sai pelo pino 1 como bits também, então um osciloscópio ou uma segunda placa ligada a esse pino vê tudo.

O programa pronto de Serial imprime nos dois, então a diferença aparece na tela.

O Mokxi modela o USB como um tubo de bytes com os nomes dos registradores nele: o bastante para uma porta serial, e nada além disso. Não há enumeração, nem descritores, nem host, então while (!Serial) {} retorna imediatamente aqui e faz uma pequena pausa numa mesa.

Pins

Vinte deles, contados do jeito que a serigrafia conta:

  • 0 a 13 ao longo do header digital, com o LED embutido no 13.
  • A0 a A5 na parte de baixo, que também são os pinos digitais 14 a 19.

O LED no 13 é ativo em nível alto: digitalWrite(LED_BUILTIN, HIGH) acende, como numa Uno.

Seis pinos fazem PWM por hardware com analogWrite, a 490 Hz: 3, 5, 6, 9, 10 e 11: os seis com um til na serigrafia, os mesmos seis de uma Uno.

SDA e SCL ao lado de AREF são A4 e A5, como numa Uno. Um traço, dois furos.

Não há INPUT_PULLDOWN neste chip. Um pino do RA4M1 tem pull-up e nada mais; pedir um pull-down dá uma entrada flutuante comum, e o runtime avisa isso em vez de fingir.

O ADC é de quatorze bits e analogRead te dá dez

O conversor do RA4M1 tem quatorze bits, de 0 a 16383. analogRead retorna dez (0 a 1023) porque é isso que o core do Arduino faz e o que todo sketch escrito para uma Uno espera: analogRead(A0) > 512 precisa significar a mesma coisa nas duas placas.

Chame analogReadResolution(14) e você recebe os quatorze. O programa pronto Analógico imprime os dois a partir do mesmo pino, com meio segundo de intervalo, para a diferença ficar visível.

A escala cheia é o trilho de 5 V, não 3,3, e por isso um sensor escrito para uma Uno migra sem divisor de tensão.

Não há attachInterrupt

Num RA4M1, qual evento de periférico chega em qual interrupção é programado nos registradores de link de eventos da ICU. A ICU não é modelada aqui, e os números de eventos dela não são algo que este modelo possa afirmar com honestidade, então foi deixada de fora em vez de inventada. Nada gera uma interrupção de periférico; o SysTick, que é uma exceção do núcleo e não precisa de link, é toda a história de interrupções.

Então o sketch usa polling. Para um botão (que é o que a maioria dos sketches com attachInterrupt faz), é o que a maioria dos sketches faz de qualquer jeito, e o programa pronto Button é escrito assim.

Ponto flutuante funciona, e é soft float

O RA4M1 real tem uma FPU de precisão simples. O núcleo em que este modelo roda não tem, então o runtime é compilado para soft float: a aritmética de float dá as respostas certas e é feita em instruções de inteiro. Um binário compilado em outro lugar com ABI de hard float gera uma falta na primeira instrução VFP em vez de retornar um número errado.

Bibliotecas do Arduino

Um tutorial que inclua Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h com Adafruit_SSD1306.h e DHT.h compila aqui como está. Cada uma é um cabeçalho próprio do Mokxi sob o nome upstream, escrito sobre os drivers dos componentes da caixa de componentes, e nada disso é o código da biblioteca upstream.

  • Wire.begin() coloca o barramento I2C em A4 (SDA) e A5 (SCL).
  • EEPROM.h funciona, mas o modelo não tem o data flash do RA4M1, então os bytes vivem em 4 KB de RAM: eles são lidos de volta enquanto a simulação roda e somem num reset.
  • Adafruit_NeoPixel.h controla uma fita WS2812. O core cronometra cada bit no SysTick a 48 MHz, dentro das janelas da folha de dados, com interrupções desligadas durante o quadro.

O editor de código e a compilação lista o que cada uma cobre e como difere da biblioteca upstream.

The firmware

Quatro programas prontos: Blink, Button, Serial e Analog.

O código-fonte de um sketch de Uno normalmente compila para o R4. Um ELF compilado para o Uno não roda nele: arquitetura diferente, mapa de registradores diferente, tabela de vetores diferente. Compile para o R4 e ele roda.

O que é preciso e o que não é

Alguns endereços deste modelo vêm do manual do usuário da RA4M1 e outros são suposição do próprio modelo. Essa distinção está documentada em vez de encoberta: seção 7 de o contrato lista, um por um, quais números são quais.

E o que é aproximado, em vez de não verificado. O core roda a 48 MHz independentemente do que estiver programado nos registradores de clock, porque a árvore de clock não é modelada. O ADC14 não tem erro algum: sem sample-and-hold, sem não linearidade, sem ruído e sem offset. Os pads são três estados e um limiar, sem histerese e sem configuração de força de acionamento. O trilho de 5 V é uma fonte ideal que não sofre queda. E o pipe do Serial nunca enche, então um sketch que travaria num limite de quadro USB na mesa real nunca espera aqui.

Em resumo: o core, o clock, o mapa de memória, os registradores de porta e PFS, a SCI e o mapa de pinos são do manual. O endereço base do GPT e seus offsets de registradores, os offsets do ADC14, os registradores USB, os canais do conversor de A4 e A5, e qual canal GPT corresponde a cada pino PWM são supostos e marcados como não verificados. O clock e o millis são verificados por um teste que roda o firmware de fábrica (crates/unor4/tests/runtime.rs), não apenas afirmados.

O que não é modelado

Uma pilha USB acima do pipe de bytes. A ICU e, portanto, toda interrupção de periférico. A AGT, o circuito de geração de clock, os watchdogs, I2C, SPI, CAN, o DTC, o RTC, o DAC, os comparadores e a unidade de touch. Binários do fabricante (o Renesas FSP e o core do Arduino R4) não rodam aqui; o runtime do firmware é nosso. Shields não são componentes físicos aqui; ligue o mesmo circuito na protoboard.