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 Leonardo e página da placa.
O Leonardo é o Arduino cujo soquete USB vai direto ao microcontrolador. Um componente do kernel (leonardo em crates/parts) envolve um modelo de SoC ATmega32U4 (crates/atmega32u4) sobre o mesmo core AVR do Uno e do Mega (crates/avr-core). O core é compartilhado; o chip ao redor dele, não. Este documento é o contrato, e ele prevalece sobre qualquer comentário no código.
O tipo no catálogo é leonardo. Onde uma seção diz "como docs/uno.md", aquele documento é o contrato desse componente.
O único fato que torna esta placa diferente de todos os outros AVR aqui: Serial não é uma UART. O ATmega32U4 tem um dispositivo USB full-speed no chip, o único soquete da placa está ligado a ele, e o monitor serial é um endpoint CDC que o próprio firmware do sketch abre. Serial1 (a USART de verdade) está nos pinos 0 e 1 do header e não alcança nada, a menos que algo esteja ligado a ela. A seção 3.6 é explícita sobre quanto do USB é modelado, e a resposta é: o canal de bytes, e nada acima dele.
1. Pinos da placa (ordem do catálogo)
Vista de cima, o soquete micro-USB e o conector barrel na borda esquerda. A placa tem 68,6 x 53,3 mm e os headers de shield são os de um Uno, furo por furo, incluindo o vão de 0,16 polegada do Uno entre os dois blocos do header digital.
Fileira de cima, da esquerda para a direita (18 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 a A5.
Header ICSP, o bloco 2x3 na borda direita, em sua própria ordem de pinos de 1 a 6 (6 furos): MISO, 5Vb, SCK, MOSI, RESETb, GNDd. Na placa, os pinos 1, 3 e 5 formam uma coluna e 2, 4 e 6 a outra.
37 pinos. O header ICSP é o único lugar onde um Leonardo expõe o SPI: MISO, SCK e MOSI são PB3, PB1 e PB2, os pinos 14, 15 e 16 do core, e nenhum outro furo alcança esses pads. O SPI.h (que faz bit-bang do barramento) coloca SCK, MISO e MOSI nos pads do ICSP, 15, 14 e 16, como a variante leonardo do core do Arduino faz; SS é 17, que é PB0, o pino da lâmpada RX, e não tem furo, então o sketch usa qualquer pino livre para o chip select. Os pinos 11, 12 e 13 não são SPI nesta placa. 5Vb e GNDd são os trilhos de 5 V e terra, e RESETb é o mesmo traço que RESET: qualquer dos furos em nível baixo segura o chip, e o outro acompanha através de R_STRAP.
Mapeamento de ports, que é a razão de a tabela de pinos desta placa existir:
| pinos | porta |
|---|---|
0, 1 |
PD2, PD3 |
2, 3 |
PD1, PD0 |
4 |
PD4 |
5 |
PC6 |
6 |
PD7 |
7 |
PE6 |
8 a 11 |
PB4 a PB7 |
12 |
PD6 |
13 |
PC7 |
A0 a A3 |
PF7 até PF4 |
A4, A5 |
PF1, PF0 |
MISO, SCK, MOSI (14, 15, 16, ICSP) |
PB3, PB1, PB2 |
Cinco ports, B a F. Não há port A nem port G neste componente. No encapsulamento de 44 pinos que o Leonardo usa, o port B e o port D estão completos, o port C expõe só PC6 e PC7, o port E expõe PE2 e PE6, e o port F não tem PF2 e PF3. Um pad que o encapsulamento não tem nunca aciona nada e lê 0.
Elétrico:
- Cada GPIO fornece push-pull a 5 V através de
R_STRONG, fica em alta impedância ou puxa para cima através de 35 k, exatamente como a seção 1 dedocs/uno.mddetermina. Uma entrada lê nível alto com 2,5 V; um nó em disputa (Desconhecido) lê 0, e um nó flutuante lê ruído, como no Uno (docs/uno.md, seção 1). SCL/SDAbesideAREFare the same two pieces of metal as pins3and2, e nãoA5eA4como num Uno, porque neste chip o I2C está no port D. Esse é o único lugar onde o footprint de shield compartilhado não é o chip compartilhado, e é o que verificar ao mover um sketch de uma placa para outra. Os dois furos de cada par carregam o que o pino está acionando mais o que o nó do outro lado está fazendo, através deR_STRAP.5VeIOREFfornecem 5 V emR_SUPPLY;3V3fornece 3,3 V;GND,GNDbeGNDcfornecem 0 V.VINé uma entrada que a placa ignora: ela é sempre alimentada por USB.RESET(eRESETb, o mesmo traço) tem um pull-up de 10 k para 5 V. Puxá-lo abaixo de 2,5 V mantém a CPU em reset; soltá-lo é um reset externo, que é o queMCUSRrelata.AREFsó é lido, nunca fornecido. Com uma referência interna selecionada, o pino fica intocado.- O pino
13tem o LEDLda placa através de 1 k para o terra. A0aA5são pinos digitais comuns além de entradas analógicas.
2. Mapa de memória
| flash | 32 KB, 16 K palavras de instrução, PC de 14 bits |
| SRAM | 2560 bytes em 0x0100 a 0x0AFF, RAMEND = 0x0AFF |
| EEPROM | 1 KB |
| I/O | 0x20 a 0x5F, alcançados por IN/OUT/SBI/CBI |
| E/S estendida | 0x60 a 0xFF, alcançados só por LDS/STS e os loads por ponteiro |
Não há RAMPZ nem EIND: os 32 KB de flash cabem em Z, então LPM alcança tudo e um endereço de retorno tem dois bytes. Uma imagem pura maior que a flash é recusada pelo nome.
Em uma placa real, os 4 KB superiores da flash guardam o bootloader USB, que é como ela se reprograma pelo mesmo soquete pelo qual o sketch se comunica. Nada aqui é carregado por um bootloader (uma imagem é colocada na flash), então os 32 KB inteiros ficam disponíveis, e firmware/leonardo/link.ld confirma isso.
3. Periféricos
Todo endereço abaixo é um endereço do espaço de dados, do jeito que LDS/STS e um ponteiro volatile os veem. Todo registrador não citado aqui lê seu valor de reset e conta como um acesso disperso.
3.1 Portas
Cinco portas, três registradores cada, PINx depois DDRx depois PORTx, tudo na janela de E/S baixa:
| porta | PINx |
|---|---|
| B | 0x23 |
| C | 0x26 |
| D | 0x29 |
| E | 0x2C |
| F | 0x2F |
0x20 a 0x22 é onde ficaria a porta A em um componente que a tivesse, e este não tem: esses três endereços são dispersos. O bit 4 PUD de MCUCR (0x55) desabilita todos os pull-ups de uma vez. Escrever um em um bit de PINx inverte o bit de PORTx.
3.2 Timer/contador 0
Oito bits, dois canais de comparação, a tabela de prescaler comum. TCCR0A 0x44, TCCR0B 0x45, TCNT0 0x46, OCR0A 0x47, OCR0B 0x48, TIMSK0 0x6E, TIFR0 0x35, GTCCR 0x43. Todos os modos de forma de onda conforme a seção 3.2 de docs/uno.md. OC0A é PB7 (pino 11) e OC0B é PD0 (pino 3).
3.3 Timers/contadores 1 e 3
Dezesseis bits, dezesseis modos de forma de onda, o mesmo bloco de quatorze registros duas vezes: TCCRnA na base, depois +1 TCCRnB, +2 TCCRnC, +4 TCNTnL, +5 TCNTnH, +6 ICRnL, +7 ICRnH, +8..+13 de OCRnAL até OCRnCH. O timer 1 está em 0x80 e o timer 3 em 0x90. TIMSK1 0x6F, TIMSK3 0x71, TIFR1 0x36, TIFR3 0x38.
O Timer 3 tem um canal de comparação. TCCR3A contém COM3A1:0 e os bits WGM3 e nada mais, OCR3B e OCR3C não são registradores, e 0x9A a 0x9D são dispersos. TIMSK3 aceita apenas TOIE3, OCIE3A e ICIE3.
OC1A é PB5 (pino 9), OC1B é PB6 (pino 10), OC1C é PB7 (pino 11, compartilhado com OC0A), e OC3A é PC6 (pino 5). Captura de entrada: ICP1 é PD4, ICP3 é PC7.
Dois periféricos ligados a um só pad é obra do próprio componente, e o datasheet deixa para o firmware a tarefa de não habilitar os dois. Aqui, o que liga sua saída é o dono do pad, e só o dono pode devolvê-lo.
3.4 Timer/contador 4, o de dez bits
Este é o periférico que não é uma versão mais larga ou mais estreita de algo do ATmega328P. Dez bits atrás de um byte alto compartilhado, TOP em um registrador em vez de em um modo, e três canais de comparação chamados A, B e D. Não existe canal C, porque OCR4C é o TOP.
| registrador | endereço |
|---|---|
TCNT4 |
0xBE |
TC4H |
0xBF |
TCCR4A |
0xC0 |
TCCR4B |
0xC1 |
TCCR4C |
0xC2 |
TCCR4D |
0xC3 |
TCCR4E |
0xC4 |
OCR4A |
0xCF |
OCR4B |
0xD0 |
OCR4C (TOP) |
0xD1 |
OCR4D |
0xD2 |
DT4 |
0xD4 |
TIMSK4 |
0x72 |
TIFR4 |
0x39 |
Bits de TIFR4 e TIMSK4: TOV4/TOIE4 bit 2, OCF4B/OCIE4B bit 5, OCF4A/OCIE4A bit 6, OCF4D/OCIE4D bit 7. CS43:0 em TCCR4B para o contador em 0 e, caso contrário, divide por 2^(n-1), até 16384. OCR4C reseta em 0xFF, e é por isso que um duty cycle de oito bits funciona sem escrever o TOP. Todo registro de dez bits passa pelo TC4H, que é um latch separado do TEMP dos timers de 16 bits.
Modelado: fast PWM (WGM41:0 = 0) e PWM fase e frequência corretas (WGM41:0 = 1), as três saídas de comparação em OC4A (PC7, pino 13), OC4B (PB6, pino 10) e OC4D (PD7, pino 6), e as quatro flags com suas habilitações. Um canal precisa do seu bit PWM4x além dos bits COM4x; COM4x sozinho não faz nada.
Not modeled, and this is the list to read before trusting a waveform: the clock is CK, the 16 MHz system clock, which is what PLLFRQ.PINMUX selects at reset. The 48 or 64 MHz PCK path through the PLL is not there. PLLCSR (0x49) and PLLFRQ (0x52) are stored, and PLOCK reads back set once PLLE is set so firmware that waits for a lock does not spin. The complementary outputs (!OC4A, !OC4B, !OC4D), the dead-time generator in DT4, the output-enable bits in TCCR4E, the enhanced-resolution mode, the fault-protection unit and the two PWM6 modes are all absent. COM4x = 1 and COM4x = 2 both behave as non-inverting here, because the complementary output that tells them apart is what is missing.
3.5 USART1
Uma USART, e ela é a Serial1. Sete registradores a partir de 0xC8: UCSR1A, +1 UCSR1B, +2 UCSR1C, +3 UCSR1D, +4 UBRR1L, +5 UBRR1H, +6 UDR1. As posições dos bits são as do Uno (docs/uno.md seção 3.4). UCSR1D é armazenado e lido como 0; o controle de fluxo por hardware não é modelado.
Ele está ligado aos seus pinos e a nada mais: RXD1 é PD2 (pino 0) e TXD1 é PD3 (pino 1). Um quadro é enviado pelo pad um bit por vez (um bit de início em nível baixo, oito bits de dados do menos significativo primeiro, um bit de parada em nível alto, cada um durando 16 (UBRR + 1) ciclos de CPU, metade disso com U2X1), então um jumper do pino 1 ao pino 0 realmente carrega um caractere. A recepção amostra o meio de cada bit, e é por isso que um baud rate desajustado embaralha texto aqui do mesmo jeito que embaralharia na mesa.
TXEN1 toma conta de TXD1 aconteça o que acontecer com DDRD, e RXEN1 mantém RXD1 como entrada: essa é a regra do datasheet, e é por isso que Serial1.begin() não precisa de pinMode.
3.6 O dispositivo USB: um stub que carrega bytes
Este é o ponto em que o modelo deliberadamente não é o chip, e isso importa o suficiente para ser dito claramente.
Modelado, nos endereços reais: UHWCON 0xD7, USBCON 0xD8, USBSTA 0xD9, USBINT 0xDA, UDCON 0xE0, UDINT 0xE1, UDIEN 0xE2, UDADDR 0xE3, UDFNUML 0xE4, UDFNUMH 0xE5, UEINTX 0xE8, UENUM 0xE9, UERST 0xEA, UECONX 0xEB, UECFG0X 0xEC, UECFG1X 0xED, UESTA0X 0xEE, UESTA1X 0xEF, UEIENX 0xF0, UEDATX 0xF1, UEBCLX 0xF2, UEBCHX 0xF3, UEINT 0xF4. Sete endpoints, de 0 a 6.
O que funciona:
USBCON.USBEliga o controlador;UDCON.DETACHzerado o anexa. Até que ambos aconteçam, todo registroUExlê 0 e as escritas não vão a lugar algum.UENUMselects an endpoint.UECONX.EPENenables it andUECFG0X.EPDIRgives it a direction: set is IN (device to host), clear is OUT.UEINTXé calculado, não armazenado. Em um endpoint IN habilitado ele lêTXINI | FIFOCON, maisRWALenquanto o banco de 64 bytes tem espaço. Em um endpoint OUT habilitado ele lêRXOUTI | FIFOCON | RWALexatamente enquanto o monitor enviou algo que ninguém leu, e 0 caso contrário.- Writing
UEINTXfollows the AVR USB convention: a bit is cleared by writing a zero to it. ClearingFIFOCONorTXINIon an IN endpoint hands the staged bank to the serial monitor. A bank that reaches 64 bytes goes out on its own. UEDATXmove bytes: uma escrita prepara um byte no endpoint IN selecionado, uma leitura retira um do endpoint OUT selecionado.UEBCLXconta o que está preparado ou esperando, saturando em 255.UEINTtem um bit por endpoint com algo a fazer.USBSTAreadsVBUSset andUESTA0XreadsCFGOKset: the board is plugged in and an endpoint this model has is always allocated, because there is no FIFO memory to run out of.
O que não está lá: o host, o barramento, o reset do barramento, pacotes SETUP, descritores, enumeração, endereçamento, o contador de quadros, o start-of-frame de 1 ms, o banking de endpoints, NAK, STALL, double buffering e as duas interrupções de USB. USB_GENERAL e USB_ENDPOINT nunca são acionadas, então um runtime CDC neste modelo usa polling.
Duas consequências que um sketch pode ver. while (!Serial) {} retorna imediatamente aqui e espera numa mesa, porque não há host para enumerar o dispositivo. E um sketch que inspeciona uma transferência de controle não tem com o que trabalhar.
Keyboard.h, Mouse.h e Joystick.h (firmware/lib, sobre mokxi_hid.h) compilam e rodam aqui normalmente. Um sketch que inclui uma delas também liga firmware/leonardo/src/usb_hid.c, um membro da biblioteca puxado apenas por esse tipo de sketch, o que torna o dispositivo um dispositivo composto: as interfaces CDC como antes, mais uma interface HID com um endpoint IN por interrupção 4 e os descritores de relatório de todas as bibliotecas unidos, cada um com seu próprio report ID (Mouse 1, Keyboard 2, Joystick 3). Numa placa, é isso que o host enumera. Aqui não há host, então cada biblioteca imprime em Serial, no lugar, o que teria enviado, uma linha entre colchetes por mudança ([Keyboard] press Ctrl, [Joystick] buttons 0 3 | hat 90 | x 512 y 0). Um sketch sem nenhuma delas é o dispositivo CDC puro, e a saída dele aqui é o que sempre foi.
Bibliotecas escritas para o PluggableUSB do core do AVR, a MIDIUSB primeiro, encontram PluggableUSB.h, USBAPI.h, USBCore.h e USBDesc.h ao lado de arduino.h (escritas a partir da especificação USB 2.0 com os nomes do core), então compilam e rodam sem mudanças. A própria MIDIUSB está incluída (firmware/lib/MIDIUSB.h, com MIDIUSB_Defs.h e pitchToNote.h), na Leonardo, na Micro e na Pro Micro. PluggableUSB().plug() entrega a um módulo os números de interface e endpoint seguintes aos da porta CDC, como o core faria (interface 2, endpoint 4 para o primeiro), mas nada apresenta o módulo a um host, aqui ou numa placa: os endpoints dele nunca são configurados, então USB_Send() retorna -1 como o do core retorna antes da enumeração, USB_Recv() retorna -1 e USB_Available() é 0. Um sketch de controlador MIDI roda, e suas notas não vão a lugar nenhum: o primeiro sendMIDI() da MIDIUSB avisa isso uma vez no monitor serial ([Mokxi] MIDIUSB: no USB host is simulated, so these MIDI messages go nowhere. ...), e a saída Serial do próprio sketch continua normalmente ao redor disso. Nenhum painel do editor mostra as mensagens, porque os endpoints de um módulo conectado nunca chegam ao motor.
O runtime em si não se limita ao stub. firmware/leonardo/src/usb.c é um dispositivo CDC ACM de verdade (endpoint de controle 0, um endpoint de notificação 1, bulk OUT 2 e bulk IN 3, os descritores, VID e PID do core do Arduino, orientado a interrupções, com o toque de 1200 baud no Caterina), e está em toda imagem. No reset ele libera um bank IN vazio no endpoint 3 e lê FIFOCON de volta: o silício mantém o bank até um host lê-lo, e nenhum host sequer resetou o barramento ainda, enquanto este modelo libera na hora um bank que foi liberado. Essa única leitura decide o modo de vez. Aqui o runtime dirige o pipe exatamente como descrito acima e a pilha USB fica inerte; numa placa ele roda a pilha. Uma mudança no modelo que mantivesse ocupado um bank liberado levaria todo sketch de Leonardo para o caminho do hardware, onde Serial não diz nada até um host configurar o dispositivo, então crates/atmega32u4/src/usb.rs tem um teste que fixa esse comportamento.
3.7 ADC
Dez bits, quatorze canais, ADCL 0x78, ADCH 0x79, ADCSRA 0x7A, ADCSRB 0x7B, ADMUX 0x7C, DIDR2 0x7D, DIDR0 0x7E, DIDR1 0x7F. Prescaler, ADSC, ADIF, ADIE, ADATE em modo free-running e ADLAR se comportam todos como descrito na seção 3.3 de docs/uno.md; uma conversão leva 13 clocks do ADC, 25 para a primeira após ADEN.
Duas coisas diferem de um ATmega328P e uma de um ATmega2560:
- O seletor de canal tem seis bits, e o bit mais alto,
MUX5, éADCSRBbit 5, not bit 3, which is where an ATmega2560 puts it. - Os canais acima de sete não são uma segunda porta.
ADC8aADC13são PD4, PD6, PD7, PB4, PB5 e PB6, e é por isso que A6 a A11 num Arduino Leonardo também são os pinos digitais 4, 12, 6, 8, 9 e 10. Esta placa trazA0aA5no cabeçalho analógico; os demais são acessados pelos seus números de pino digitais. - Não há referência de 1,1 V.
REFS1:0é 0 paraAREF, 1 para AVCC, 3 para os 2,56 V internos, e 2 é reservado. O bandgap de 1,1 V continua disponível como canal emMUX5:0= 0x1E.
Canal para pino: ADC0 PF0, ADC1 PF1, ADC4 PF4, ADC5 PF5, ADC6 PF6, ADC7 PF7, ADC8 PD4, ADC9 PD6, ADC10 PD7, ADC11 PB4, ADC12 PB5, ADC13 PB6. ADC2 e ADC3 estão no mux e não são conectados neste encapsulamento; selecionar um deles lê 0. Os canais diferenciais e com ganho e o sensor de temperatura não são modelados e leem 0.
3.8 Interrupções externas e de mudança de pino
EICRA 0x69, EICRB 0x6A, EIMSK 0x3D, EIFR 0x3C, PCICR 0x68, PCIFR 0x3B, PCMSK0 0x6B.
Cinco interrupções externas e três lacunas: INT0 PD0 (pino 3), INT1 PD1 (pino 2), INT2 PD2 (pino 0), INT3 PD3 (pino 1), INT6 PE6 (pino 7). INT4, INT5 e INT7 são posições reservadas sem pino atrás delas; habilitar uma delas nunca dispara nada. Os bits de detecção estão em EICRA para 0 a 3 e em EICRB para 4 a 7, dois bits cada: 0 nível baixo, 1 qualquer borda, 2 descida, 3 subida. Uma interrupção de nível baixo fica ativa enquanto o pino está baixo e não levanta flag.
Um grupo de mudança de pino, PCINT0, e ele é toda a porta B.
3.9 Sleep e EEPROM
SMCR 0x53 com o bit SE em 0, e todos os modos de sleep se comportam como idle: o clock da CPU para, os periféricos continuam rodando e qualquer interrupção habilitada a traz de volta. MCUSR 0x54 informa PORF após um reset de energia e EXTRF após o pino de reset ter sido mantido. WDTCSR é o watchdog, como no Uno (docs/uno.md seção 3.8, vetor 12), exceto que, como o bootloader Caterina faz, o modelo do chip limpa WDRF e para o watchdog após um reset de watchdog, antes do setup(). CLKPR, PRR0, PRR1, OSCCAL, RCCTRL, SPMCSR e GPIOR0..2 são armazenados e lidos de volta.
A EEPROM tem 1 KB em EECR 0x3F, EEDR 0x40, EEARL 0x41, EEARH 0x42, com EEARH de dois bits. Uma leitura completa imediatamente; uma escrita leva 3,3 ms (26.368 ciclos do oscilador RC de 8 MHz; 1,8 ms no modo somente apagar ou somente gravar), durante os quais EEPE lê 1, e EERIE levanta EE_READY como nível assim que termina.
3.10 Vetores
Quarenta e três vetores, a duas palavras de distância a partir do endereço de palavra 0, numerados em ordem de prioridade. crates/atmega32u4/src/vectors.rs e firmware/leonardo/include/leonardo.h carregam a tabela; o formato que importa aqui é que os slots 5, 6, 8, 13, 14 e 15 estão reservados neste componente, e que os dois vetores USB ficam entre o grupo de pin-change e o watchdog, uma ordem que nenhum outro AVR aqui tem.
Os que o runtime usa: INT0..INT3 são 1 a 4, INT6 é 7, PCINT0 é 9, TIMER0_OVF é 23, USART1_RX é 25, ADC é 29, e os quatro do timer 4 são 38 a 41.
4. Canal do host
host_write coloca bytes no endpoint USB OUT que o firmware lê; host_read pega os bytes que o firmware enviou no endpoint IN. Isso é Serial em um sketch e o monitor serial na interface. Os bytes são UTF-8 do ponto de vista da interface e opacos para o modelo.
Serial1 não está neste canal e nunca estará: são dois pinos do cabeçalho.
5. Modelo de tempo e o componente
Como a seção 5 do docs/uno.md. 16 MHz, um ciclo é exatamente 62,5 ns, uma fatia é 10 us e exatamente 160 ciclos, e o contador de ciclos é ancorado ao tempo do kernel no início de cada fatia. Dentro de uma fatia o núcleo avança uma instrução por vez com o barramento informado do ciclo em que cada instrução começa, então uma mudança de pino carrega o ciclo que a causou.
probe é uma máscara de bits: 1 rodando, 2 dormindo, 4 o LED L da placa no pino 13, 8 transmissão USB nos últimos 20 ms, 16 recepção USB. 0 sem programa.
poke: 2 segura RESET, 3 libera.
6. Firmware (firmware/leonardo/)
Um runtime no formato do Arduino escrito a partir deste documento: setup() e loop(), pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, delayMicroseconds, attachInterrupt, Serial e Serial1. Sem core do Arduino, sem avr-libc, sem libc.
Compilado com clang --target=avr -mmcu=atmega32u4, linkado por ld.lld contra firmware/leonardo/link.ld. Cinco dos arquivos do runtime são os do Uno, compilados de novo para este componente em vez de copiados: a formatação de números, os auxiliares matemáticos, o floor freestanding e sua metade em assembly, e Print. A string program do catálogo é elf32 avr atmega32u4.
Pinos de PWM e seus timers:
| pino | saída | temporizador | frequência |
|---|---|---|---|
| 3 | OC0B |
0, fast PWM | 976,5625 Hz |
| 11 | OC0A |
0, fast PWM | 976,5625 Hz |
| 13 | OC4A |
4, phase e frequency correct, TOP = OCR4C |
490,196 Hz |
| 6 | OC4D |
4, phase e frequency correct, TOP = OCR4C |
490,196 Hz |
| 9 | OC1A |
1, phase correct de 8 bits | 490,196 Hz |
| 10 | OC1B |
1, phase correct de 8 bits | 490,196 Hz |
| 5 | OC3A |
3, phase correct de 8 bits | 490,196 Hz |
Serial é o dispositivo USB em src/usb.c e Serial1 é a USART1. mokxi_init() inicia o dispositivo USB antes de qualquer outra coisa, como o USBDevice.attach() do core do Arduino faz, então a placa aparece como uma porta serial e recebe o toque de 1200 baud esteja o sketch chamando Serial.begin() ou não. Sua espera pelo PLL é limitada (10 ms; um PLL que nunca trava deixa o USB desligado), e o milissegundo gasto ali vem antes do timer 0 começar, então ele desloca tudo para depois junto. Numa placa, escritas em Serial são descartadas até o host ter configurado o dispositivo e um programa ter aberto a porta, um byte espera no máximo 250 ms por um host que não está lendo, e while (!Serial) espera por DTR, tudo como no core do Arduino. A imagem carrega o VID e o PID da Leonardo (0x2341:0x8036) e as strings; o uploader os reescreve para uma Micro (0x2341:0x8037) ou uma Pro Micro (0x1B4F:0x9206) ao gravar a placa. A pilha custa cerca de 2 KB de flash e uma dúzia de bytes de SRAM.
digitalPinToInterrupt: pino 3 é 0, pino 2 é 1, pino 0 é 2, pino 1 é 3, pino 7 é 4. Qualquer outro é -1.
Quatro exemplos: blink, button (uma chave no pino 7, que é INT6), serial (que imprime em ambas as portas para a diferença entre elas aparecer na tela) e fade (que controla o pino 13 pelo timer 4 e o pino 9 pelo timer 1, para os dois tipos de hardware de PWM rodarem ao mesmo tempo). Um exemplo tem orçamento de 8 KB dos 32 KB de flash.
7. O que não é modelado
SPI, TWI, o comparador analógico, o sensor de temperatura, a seção do bootloader e seus fuses, o prescaler de clock, o PLL e o clock rápido que alimenta o timer 4, as saídas complementares do timer 4 e o gerador de dead-time, e tudo acima do canal de bytes USB listado na seção 3.6. Esses registradores leem seu valor de reset e contam como perdidos.
8. O que este modelo sabe com certeza, e o que não sabe
Tirados do data sheet, e verificados por firmware real. Todo endereço, posição de bit e valor de reset na seção 3 vem do ATmega16U4/ATmega32U4 Data Sheet, na numeração do espaço de dados, incluindo a janela de E/S estendida de 0x60 a 0xFF que decide quais registradores IN/OUT alcançam e quais precisam de sts. Cinco portas, timers 0, 1, 3 e o timer 4 de dez bits com OCR4C como TOP, USART1, os quatorze canais do ADC, INT0 a INT3 e INT6, e o único grupo de pin-change são do data sheet. crates/atmega32u4/tests/runtime.rs roda os ELFs blink, serial e fade inclusos através das portas, das duas larguras de timer e do canal de bytes USB.
Modelado, mas não cobrado pelos números da folha de dados. Comportamentos em vez de endereços:
- O controlador de dispositivo USB é um stub que carrega bytes, como a seção 3.6 diz claramente. Não há enumeração, troca de descritores, configuração de endpoints, temporização de SOF, suspend, resume nem reset por toque de 1200 baud.
Serialé um canal de bytes para o canal do host que responde aSerialeSerial.dtr()como uma porta CDC conectada responderia. Então a única coisa que faz uma Leonardo ser uma Leonardo (um sketch poder bloquear para sempre esperandowhile (!Serial)) é uma decisão que este modelo toma, e não um protocolo que ele executa. - O resto é a lista do Uno. O grupo do meio da seção 7 do
docs/uno.mdse aplica sem mudanças: um ADC sem erro, um clock exato de 16 MHz, três estados de pad e um limiar com pull-up de 35 kΩ, uma alimentação ideal que não sofre brown out, um start-up de um microssegundo e uma fatia de 10 us.
Deliberadamente ausente, como a seção 7 lista: SPI, TWI, o comparador analógico, o sensor de temperatura, a seção do bootloader e seus fusíveis, o prescaler de clock, o PLL e o clock rápido que alimenta o timer 4, as saídas complementares e o gerador de tempo morto do timer 4, e tudo acima do canal de bytes do USB. Esses registradores leem seu valor de reset e contam como perdidos.