A visão geral, com exemplos rodando, está na página da placa e O modelo do Arduino Uno (todos os registradores).
O que é
O Arduino Uno R3, com um ATmega328P completo por trás rodando no nosso próprio core AVR. O core carrega as contagens de ciclos do datasheet para todas as 131 instruções, e é por isso que o tempo se comporta como no chip real, e não de forma aproximada.
O firmware conversa com os periféricos nos endereços reais do ATmega328P, então um programa compilado aqui roda em um Uno de verdade.
Os pinos
31 deles, na ordem que a placa real os tem.
Cabeçalho de cima, da esquerda para a direita: SCL, SDA, AREF, GND, 13 até 0. Cabeçalho de baixo: IOREF, RESET, 3V3, 5V, GNDb, GNDc, VIN, depois A0 até A5. Nomes duplicados ganham uma letra, porque o nome de um pino precisa ser único.
Os pinos digitais 0 a 13 e A0 a A5 são GPIO. Eles são mapeados para as portas do mesmo jeito que o chip faz: 0..7 é PD0 a PD7, 8..13 é PB0 a PB5, A0..A5 é PC0 a PC5. SDA está ligado a A4 e SCL a A5, então eles são o mesmo nó.
Uma saída fornece 5 V ou 0 V. Uma entrada tem alta impedância, com um pull-up de 35 k para 5 V quando você pede. O limiar é 2,5 V.
O pino 13 tem o LED da placa, e é por isso que LED_BUILTIN é 13 e que o blink não precisa de ligação nenhuma.
5V e IOREF fornecem 5 V, 3V3 fornece 3,3 V, os terras fornecem 0 V, e VIN é ignorado porque a placa é sempre alimentada por USB.
Por que ela fica ao lado da protoboard
Os cabeçalhos dela ficam a duas polegadas de distância, mais largos que o canal central de uma protoboard. Um Uno de verdade é ligado a uma protoboard com jumpers, e este também.
What is modeled
Os três timers em todos os modos de forma de onda, a USART0, o ADC em A0 a A5 com dez bits, interrupções externas e de mudança de pino, sleep, EEPROM e SPM. Esse é o conjunto de que a API do Arduino precisa para pinMode, digitalWrite, analogWrite, analogRead, millis, delay, Serial e attachInterrupt.
analogWrite usa os timers do mesmo jeito que o core do Arduino: pinos 5 e 6 a 976 Hz, pinos 3, 9, 10 e 11 a 490 Hz.
A Serial envia por um buffer circular de 64 bytes, como o HardwareSerial do core faz: o print retorna assim que seus bytes são enfileirados e a interrupção da USART os envia por trás do sketch na taxa de baud, então uma linha mais curta que o buffer custa quase nada ao sketch. O sketch espera apenas quando o buffer está cheio, e Serial.flush() espera o último bit de parada. Serial.availableForWrite() é o espaço restante, 63 quando está vazio. O mesmo vale para o Nano e o Pro Mini.
O que não é
SPI e I2C como periféricos, a seção de boot e seus fuses, o comparador analógico, o prescaler do clock, o timer 2 assíncrono e a ponte USB-para-serial.
O watchdog é modelado: wdt_enable() sem um wdt_reset() em tempo reseta a placa, e o MCUSR mostra WDRF depois. Nenhum bootloader roda antes, então limpe o MCUSR antes de wdt_disable() após esse reset.
Cada endereço de registrador aqui vem do data sheet do ATmega328P e nada é adivinhado, mas vários comportamentos são aproximações, e a seção 7 do modelo do Arduino Uno lista todos. Os três que valem conhecer na bancada: o ADC não tem erro nenhum (sem sample-and-hold, sem não linearidade, sem ruído, sem offset), então um divisor lê a mesma contagem toda vez, onde um real oscila uma ou duas contagens; o cristal de 16 MHz é exato, sem desvio nem jitter; e o trilho de 5 V é uma fonte ideal que não pode sofrer queda, então um circuito que daria brownout numa placa real roda limpo aqui.
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 emA4(SDA) eA5(SCL), aos quais os pinosSDAeSCLdo cabeçalho estão ligados.- O
EEPROM.husa o próprio 1 KB de EEPROM do chip, através de seus registradores reais. Ele mantém o que você escreveu através de um aperto no reset da placa, e um novo Rodar o inicia apagado, cada byte255, porque um Rodar é uma placa nova. - O
SoftwareSerial.hdá uma segunda porta serial em quaisquer dois pinos, para um HC-05 ou um GPS, como a biblioteca do Arduino faz: uma interrupção de mudança de pino captura cada bit de início e loops contados cronometram o resto, com as contagens de ciclos reais deste modelo. Uma porta escuta por vez, e ela não pode receber enquanto envia. - O
Adafruit_NeoPixel.haciona uma fita WS2812. O bit é cronometrado em assembly AVR, do jeito que toda biblioteca NeoPixel para AVR faz, e a 16 MHz cada nível alto cai dentro da janela do data sheet. As interrupções ficam desligadas enquanto um quadro sai, então omillis()perde um tick por cada milissegundo que uma fita longa leva para enviar, como na bancada. As cores ocupam três bytes por LED dos 2 KB de RAM do chip.
O editor de código e a compilação lista o que cada uma cobre e como difere da biblioteca upstream.
Os exemplos
O Uno vem com mais sketches prontos que qualquer outra placa: Blink, Button, Serial, Fade, Analog, Counter e Interrupt para começar, depois Dimmer, Night lamp, Thermometer, Parking sensor, Matrix ball, OLED text and shapes, Pong console, D-pad pong, Bar graph, Chaser, Commands, Electronic dice, Reaction duel, Keypad lock, Listener, Metronome, Motor ramp, Night light, PWM steps, Reaction timer, Servo fader, Snake, Tilt alarm, Toggle, Traffic light, Two lamps, Two rates e Watchful, além de treze aulas de C++.
Pick one in the Firmware section of the board's painel de propriedades da placa, ou escreva o seu e aperte Rodar.
Assembly
A mesma seção Firmware tem um grupo chamado Assembly (sem Arduino), com um Blink, um Button to LED, um UART hello e uma interrupção de Timer escritos em assembly AVR. Escolha um e os arquivos da placa viram um único main.S sem o core do Arduino embaixo, linkado apenas ao código de inicialização, do jeito que
avr-gcc main.S é. Uma aba .S ao lado de um sketch comum também funciona. Veja
Escrevendo em assembly.
Em outros lugares
- A página da placa: /boards/arduino-uno
- O documento do contrato: o modelo do Arduino Uno
- A trilha de aprendizado: Embedded on the Arduino Uno, em /learn
- O mesmo chip numa protoboard: o Arduino Nano e o ATmega328P puro
- O Uno de Arm: o Uno R4 Minima