Referência

Contrato da placa Arduino Nano (Fase 9)

O chip do Uno numa placa que cabe na protoboard, com dois pinos só analógicos.

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 O Arduino Nano e página da placa.

O Nano é o chip do Arduino Uno numa placa que cabe numa protoboard. Um componente do kernel (nano em crates/parts) envolve o mesmo modelo de SoC ATmega328P (crates/atmega328p) que o Uno usa, sobre o mesmo core AVR (crates/avr-core). Nada muda no chip: os registradores, os timers, a USART, o ADC, os vetores de interrupção e as contagens de ciclo são os que docs/uno.md expõe, e aquele documento é o contrato para todos eles. Este diz apenas o que é diferente, ou seja, o encapsulamento e os furos.

O tipo no catálogo é nano (Arduino Nano v3). Tudo em docs/uno.md se aplica, exceto quando uma seção aqui disser o contrário.

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

Top view, the mini-USB socket at the top. Two fifteen-pin headers 0.6 inch apart, so the board pushes into a breadboard and straddles the center channel with three spare holes on each side.

Coluna esquerda, de cima para baixo (pinos 1 a 15 da placa): 1, 0, RESET, GND, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12.

Coluna direita, de cima para baixo (pinos 30 a 16 da placa): VIN, GNDb, RESETb, 5V, A7, A6, A5, A4, A3, A2, A1, A0, AREF, 3V3, 13.

30 pinos. O conector ICSP não é um pino.

Elétrico, onde difere da seção 1 de docs/uno.md:

  • Port mapping is the Uno's: 0..7 = PD0..PD7, 8..13 = PB0..PB5, A0..A5 = PC0..PC5. There is no IOREF and there are no separate SDA/SCL holes, so A4 and A5 are each one hole rather than two.
  • A6 e A7 são os canais 6 e 7 do ADC e nada mais. O Nano é o encapsulamento TQFP-32, que conecta ADC6 e ADC7 como entradas analógicas sem pino de porta por trás: sem driver de saída, sem pull-up, sem PINx bit, e sem leitura digital. A placa lê a tensão do nó em cada um desses dois furos e a entrega ao ADC; a máscara de entrada digital nunca carrega um bit para eles. ADMUX os valores 6 e 7 os selecionam. Num Uno (um DIP de 28 pinos) não há pad nenhum, então o mesmo ADMUX valor lê 0.
  • RESET e RESETb são uma única peça de metal. A placa expõe o trilho de reset nas duas pontas. Os dois furos carregam o pull-up de 10 k para 5 V, puxar qualquer um abaixo de 2.5 V mantém a CPU em reset, e cada furo mostra o que o nó do outro está fazendo através R_STRAP, exatamente como o par A4/SDA do Uno faz. GND e GNDb são igualmente o mesmo trilho, e ambos simplesmente fornecem 0 V.
  • 5V fornece 5 V em R_SUPPLY, 3V3 fornece 3.3 V, VIN é uma entrada que a placa ignora (sempre alimentado por USB).
  • O pino 13 tem o LED L da placa através de 1 k para o terra, como no Uno.

2. Mapa de memória

Inalterado da seção 2 de docs/uno.md: 32 KB de flash, 2 KB de SRAM em 0x0100..0x08FF, 1 KB de EEPROM, SP em 0x08FF após o reset. É o mesmo chip.

3. Periféricos

Inalterado em relação à seção 3 de docs/uno.md, com uma adição: o multiplexador do ADC tem oito canais externos em vez de seis. MUX3:0 de 0 a 5 selecionam A0 a A5 como antes; 6 e 7 selecionam A6 e A7. 8 é o sensor de temperatura, 14 é a banda de referência de 1,1 V e 15 é o terra, como antes. DIDR0 ainda cobre apenas os bits 0 a 5: ADC6 e ADC7 também não têm buffer de entrada digital para desligar no silício.

4. Canal do host

host = "bytes utf-8 na USART0", como no Uno.

5. Modelo de tempo e o componente

Inalterado em relação à seção 5 de docs/uno.md: 16 MHz, fatias de 10 us, mudanças de pino no seu ciclo exato, SLEEP pausa o núcleo.

Ponta de prova: a mesma máscara de bits. Bit 0 rodando, bit 1 dormindo, bit 2 o LED embutido no pino 13, bit 3 atividade de TX nos últimos 20 ms, bit 4 atividade de RX. Escrita: 2 = pressionar RESET, 3 = soltar. O tratamento de crashes é o mesmo.

6. Firmware (firmware/nano/)

Não há um segundo runtime. firmware/nano/build.sh executa firmware/uno/build.sh com BOARD=nano, o que adiciona uma flag, -DMOKXI_BOARD_NANO, e essa flag faz três coisas em firmware/uno/include/uno.h e nada mais:

Uno Nano
MOKXI_BOARD "uno" "nano"
NUM_ANALOG_INPUTS 6 8
A6, A7 não definido 20, 21

A6 and A7 are past NUM_DIGITAL_PINS, so pinMode, digitalWrite and digitalRead ignore them and analogRead reaches them as channels 6 and 7. Every other line of the runtime, including crt0.S and link.ld, is the same file, so an image built for one of these boards runs on the other, which is what the two boards being one chip means.

Exemplos em firmware/nano/examples/<name>/sketch.ino, compilados para web/public/firmware/nano/<name>.elf com web/public/firmware/nano/index.json: blink (pino 13), button (pino 2 com INPUT_PULLUP para o pino 13), serial, dial (um potenciômetro em A7 controlando o brilho de um LED no pino 9 com PWM por hardware).

O campo program do índice é "elf32 avr atmega328p nano", e a entrada do catálogo diz o mesmo. Ele difere do "elf32 avr atmega328p" do Uno apenas para que o editor ofereça a cada placa a sua própria lista de exemplos; o formato ELF por trás das duas strings é idêntico.

7. O que não é modelado

Tudo o que docs/uno.md não modela, e mais uma coisa: a ponte USB-serial do Nano (uma FT232RL no original, uma CH340 na maioria dos clones) não é um componente. Serial chega ao monitor serial pelo canal do host, como em todas as outras placas aqui, e os pinos 0 e 1 continuam GPIO comum em vez de ligados a uma ponte.

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

O chip é o do Uno, então a seção 7 de docs/uno.md também vale como ordenação desta placa: o mesmo data sheet, o mesmo mapa de registradores, os mesmos testes e a mesma lista de comportamentos que são aproximações em vez de números do data sheet: um ADC sem erro, um clock exato de 16 MHz sem deriva, três estados de pad e um limiar, uma alimentação ideal que não sofre brown out e uma fatia de 10 us. A inicialização também é a do Uno: os mesmos fuses, então setup() inicia 66 ms depois da alimentação.

Duas coisas são exclusivas desta placa e nenhuma delas é um chute: a ordem do cabeçalho de trinta pinos da seção 1, e A6/A7, que são os canais 6 e 7 do ADC no encapsulamento TQFP e são apenas analógicos. Eles não têm bit de porta, então digitalRead, digitalWrite, pinMode e o pull-up interno não fazem nada neles, exatamente como num Nano real. A seção 7 lista o que está ausente além da lista do Uno.