Ini adalah referensi teknis untuk modelnya: apa yang diimplementasikan, register demi register, untuk orang yang menulis firmware menggunakannya. Untuk memakai board ini di editor, mulai dari Arduino Leonardo dan halaman board.
Leonardo adalah Arduino yang soket USB-nya tersambung langsung ke mikrokontroler. Satu komponen kernel (leonardo di crates/parts) membungkus model SoC ATmega32U4 (crates/atmega32u4) di atas inti AVR yang sama dengan Uno dan Mega (crates/avr-core). Intinya dibagikan; chip di sekitarnya tidak. Dokumen ini adalah kontraknya, dan ia menang atas komentar apa pun di kode.
Tipe di katalog adalah leonardo. Jika suatu bagian mengatakan "seperti docs/uno.md", dokumen itu adalah kontrak untuk bagian tersebut.
Satu fakta yang membuat board ini berbeda dari semua AVR lain di sini: Serial bukan UART. ATmega32U4 memiliki perangkat USB full-speed di die-nya, satu-satunya soket board terhubung ke sana, dan serial monitor adalah endpoint CDC yang dibuka oleh firmware sketch itu sendiri. Serial1 (USART yang sebenarnya) ada di pin header 0 dan 1 serta tidak menyambung ke mana pun kecuali ada yang disambungkan kabelnya. Bagian 3.6 menjelaskan secara eksplisit seberapa banyak USB yang dimodelkan, dan jawabannya: pipa byte, dan tidak ada di atasnya.
1. Pin board (urutan katalog)
Tampak atas, soket micro-USB dan jack barrel di sisi kiri. Board berukuran 68.6 x 53.3 mm dan header shield-nya sama dengan milik Uno, lubang demi lubang, termasuk jarak 0,16 inci milik Uno antara dua blok header digital.
Baris atas, kiri ke kanan (18 lubang): SCL, SDA, AREF, GND, 13, 12, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0.
Baris bawah, kiri ke kanan (13 lubang): IOREF, RESET, 3V3, 5V, GNDb, GNDc, VIN, A0 sampai A5.
Header ICSP, blok 2x3 di sisi kanan, dalam urutan pinnya sendiri 1 sampai 6 (6 lubang): MISO, 5Vb, SCK, MOSI, RESETb, GNDd. Di board, pin 1, 3 dan 5 berada di satu kolom dan 2, 4 serta 6 di kolom lainnya.
37 pin. Header ICSP adalah satu-satunya tempat Leonardo mengeluarkan SPI: MISO, SCK dan MOSI adalah PB3, PB1 dan PB2, pin inti 14, 15 dan 16, dan tidak ada lubang lain yang mencapai pad tersebut. SPI.h (yang melakukan bit-bang pada bus) menempatkan SCK, MISO dan MOSI di pad ICSP, 15, 14 dan 16, seperti yang dilakukan varian leonardo inti Arduino; SS adalah 17, yaitu PB0, pin lampu RX, dan tidak punya lubang, jadi sketch memakai pin bebas mana pun untuk chip select. Pin 11, 12 dan 13 bukan SPI di board ini. 5Vb dan GNDd adalah rel 5 V dan ground, dan RESETb adalah jalur yang sama dengan RESET: salah satu lubang ditahan rendah akan menahan chip, dan yang lain mengikuti melalui R_STRAP.
Pemetaan port, yang merupakan alasan tabel pin board ini ada:
| pins | port |
|---|---|
0, 1 |
PD2, PD3 |
2, 3 |
PD1, PD0 |
4 |
PD4 |
5 |
PC6 |
6 |
PD7 |
7 |
PE6 |
8 sampai 11 |
PB4 sampai PB7 |
12 |
PD6 |
13 |
PC7 |
A0 sampai A3 |
PF7 turun ke PF4 |
A4, A5 |
PF1, PF0 |
MISO, SCK, MOSI (14, 15, 16, ICSP) |
PB3, PB1, PB2 |
Lima port, B sampai F. Tidak ada port A dan tidak ada port G pada komponen ini. Pada kemasan 44 pin yang dipakai Leonardo, port B dan port D utuh, port C hanya mengeluarkan PC6 dan PC7, port E mengeluarkan PE2 dan PE6, dan port F tidak memiliki PF2 dan PF3. Pad yang tidak dimiliki kemasan tidak pernah menggerakkan apa pun dan terbaca 0.
Kelistrikan:
- Setiap GPIO menggerakkan push-pull pada 5 V melalui
R_STRONG, berada di high-Z, atau menarik ke atas melalui 35 k, persis seperti yang diatur di bagian 1docs/uno.md. Sebuah input terbaca tinggi pada 2,5 V; net yang bergolak (Unknown) terbaca 0, dan yang mengambang terbaca noise, seperti pada Uno (docs/uno.mdbagian 1). SCL/SDAbesideAREFare the same two pieces of metal as pins3and2, bukanA5danA4seperti pada Uno, karena pada chip ini I2C ada di port D. Itu satu-satunya tempat di mana footprint shield bersama tidak sama dengan chip bersama, dan itu hal yang perlu kamu cek saat memindahkan sketch antar board. Kedua lubang pada tiap pasangan membawa apa yang digerakkan oleh pin tersebut ditambah apa pun yang terjadi pada net di sisi lainnya, melaluiR_STRAP.5VdanIOREFmemasok 5 V padaR_SUPPLY;3V3memasok 3,3 V;GND,GNDbdanGNDcmemasok 0 V.VINadalah input yang diabaikan board: board ini selalu ditenagai lewat USB.RESET(danRESETb, jalur yang sama) memiliki pull-up 10 k ke 5 V. Menariknya turun di bawah 2,5 V membuat CPU tetap dalam kondisi reset; melepaskannya menjadi reset eksternal, dan itulah yang dilaporkan olehMCUSR.AREFhanya pernah dibaca, tidak pernah digerakkan. Saat referensi internal dipilih, pin ini dibiarkan saja.- Pin
13punya LEDLbawaan board melalui 1 k ke ground. A0sampaiA5adalah pin digital biasa sekaligus input analog.
2. Peta memori
| flash | 32 KB, 16 K kata instruksi, PC 14 bit |
| SRAM | 2560 byte di 0x0100 sampai 0x0AFF, RAMEND = 0x0AFF |
| EEPROM | 1 KB |
| I/O | 0x20 sampai 0x5F, diakses dengan IN/OUT/SBI/CBI |
| I/O extended | 0x60 sampai 0xFF, hanya bisa diakses dengan LDS/STS dan load pointer |
Tidak ada RAMPZ dan tidak ada EIND: flash 32 KB cukup di dalam Z, jadi LPM bisa menjangkau semuanya dan alamat return berukuran dua byte. Image mentah yang lebih besar dari flash akan ditolak berdasarkan namanya.
Pada board sungguhan, 4 KB teratas flash menyimpan bootloader USB, cara board memprogram ulang dirinya sendiri lewat soket yang sama dengan yang dipakai sketch untuk berkomunikasi. Tidak ada di sini yang dimuat lewat bootloader (image ditempatkan langsung di flash), jadi seluruh 32 KB tersedia dan firmware/leonardo/link.ld menyatakan hal itu.
3. Periferal
Setiap alamat di bawah ini adalah alamat data-space, seperti yang dilihat LDS/STS dan pointer volatile. Setiap register yang tidak disebutkan di sini membaca nilai reset-nya dan dihitung sebagai akses liar.
3.1 Port
Lima port, tiga register masing-masing, PINx lalu DDRx lalu PORTx, semuanya di jendela I/O rendah:
| port | PINx |
|---|---|
| B | 0x23 |
| C | 0x26 |
| D | 0x29 |
| E | 0x2C |
| F | 0x2F |
0x20 sampai 0x22 adalah tempat port A berada pada komponen yang memilikinya, dan komponen ini tidak memilikinya: tiga alamat itu adalah akses liar. Bit 4 PUD pada MCUCR (0x55) menonaktifkan semua pull-up sekaligus. Menulis satu ke bit PINx akan toggle bit PORTx.
3.2 Timer/counter 0
Delapan bit, dua kanal compare, tabel prescaler biasa. TCCR0A 0x44, TCCR0B 0x45, TCNT0 0x46, OCR0A 0x47, OCR0B 0x48, TIMSK0 0x6E, TIFR0 0x35, GTCCR 0x43. Semua mode gelombang seperti yang diberikan bagian 3.2 docs/uno.md. OC0A adalah PB7 (pin 11) dan OC0B adalah PD0 (pin 3).
3.3 Timer/counter 1 dan 3
Enam belas bit, enam belas mode gelombang, blok empat belas register yang sama dua kali: TCCRnA di alamat dasar, lalu +1 TCCRnB, +2 TCCRnC, +4 TCNTnL, +5 TCNTnH, +6 ICRnL, +7 ICRnH, +8..+13 OCRnAL sampai OCRnCH. Timer 1 ada di 0x80 dan timer 3 di 0x90. TIMSK1 0x6F, TIMSK3 0x71, TIFR1 0x36, TIFR3 0x38.
Timer 3 punya satu kanal compare. TCCR3A memuat COM3A1:0 dan bit WGM3 saja, OCR3B dan OCR3C bukan register, dan 0x9A sampai 0x9D adalah alamat liar. TIMSK3 hanya menerima TOIE3, OCIE3A dan ICIE3.
OC1A adalah PB5 (pin 9), OC1B adalah PB6 (pin 10), OC1C adalah PB7 (pin 11, dibagi dengan OC0A), dan OC3A adalah PC6 (pin 5). Input capture: ICP1 adalah PD4, ICP3 adalah PC7.
Dua periferal yang terhubung ke satu pad adalah keputusan komponen itu sendiri, dan datasheet menyerahkannya pada firmware agar tidak mengaktifkan keduanya. Di sini, yang mengaktifkan output-nya memiliki pad itu, dan hanya pemiliknya yang bisa melepaskannya kembali.
3.4 Timer/counter 4, yang sepuluh bit
Ini periferal yang bukan versi lebih lebar atau lebih sempit dari sesuatu di ATmega328P. Sepuluh bit di belakang high byte bersama, TOP ada di register bukan di mode, dan tiga kanal compare bernama A, B dan D. Tidak ada kanal C, karena OCR4C adalah TOP.
| register | alamat |
|---|---|
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 |
Bit TIFR4 dan TIMSK4: TOV4/TOIE4 bit 2, OCF4B/OCIE4B bit 5, OCF4A/OCIE4A bit 6, OCF4D/OCIE4D bit 7. CS43:0 pada TCCR4B menghentikan counter di 0 dan selain itu membagi dengan 2^(n-1), sampai 16384. OCR4C di-reset ke 0xFF, itulah sebabnya duty delapan bit bekerja tanpa menulis TOP. Setiap register sepuluh bit melewati TC4H, yang merupakan latch terpisah dari TEMP milik timer 16 bit.
Dimodelkan: fast PWM (WGM41:0 = 0) dan phase-and-frequency-correct PWM (WGM41:0 = 1), tiga output compare pada OC4A (PC7, pin 13), OC4B (PB6, pin 10) dan OC4D (PD7, pin 6), serta empat flag dengan enable-nya. Sebuah kanal membutuhkan bit PWM4x selain bit COM4x-nya; COM4x saja tidak melakukan apa-apa.
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
Satu USART, dan itu adalah Serial1. Tujuh register mulai dari 0xC8: UCSR1A, +1 UCSR1B, +2 UCSR1C, +3 UCSR1D, +4 UBRR1L, +5 UBRR1H, +6 UDR1. Posisi bit-nya sama dengan milik Uno (bagian 3.4 docs/uno.md). UCSR1D disimpan dan terbaca sebagai 0; hardware flow control tidak dimodelkan.
Ia terhubung ke pin-pinnya dan tidak ke yang lain: RXD1 adalah PD2 (pin 0) dan TXD1 adalah PD3 (pin 1). Sebuah frame dikirim melalui pad satu bit demi satu bit (start bit rendah, delapan bit data mulai dari yang paling tidak signifikan, stop bit tinggi, masing-masing 16 (UBRR + 1) siklus CPU, setengahnya dengan U2X1), jadi kabel jumper dari pin 1 ke pin 0 benar-benar dapat mengirim sebuah karakter. Penerimaan menyampel di tengah setiap bit, itulah sebabnya baud rate yang tidak cocok merusak teks di sini dengan cara yang sama seperti di meja kerja sungguhan.
TXEN1 mengambil alih TXD1 apa pun kata DDRD, dan RXEN1 menahan RXD1 sebagai input: itu aturan datasheet, dan itu sebabnya Serial1.begin() tidak memerlukan pinMode.
3.6 Perangkat USB: stub yang membawa byte
Inilah bagian yang modelnya sengaja tidak sama dengan chip-nya, dan ini cukup penting untuk dikatakan dengan jelas.
Dimodelkan pada alamat aslinya: 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. Tujuh endpoint, 0 sampai 6.
Yang berperilaku benar:
USBCON.USBEmenyalakan controller;UDCON.DETACHyang di-clear akan menghubungkannya. Sebelum keduanya, setiap registerUExterbaca 0 dan penulisan tidak menuju ke mana pun.UENUMselects an endpoint.UECONX.EPENenables it andUECFG0X.EPDIRgives it a direction: set is IN (device to host), clear is OUT.UEINTXdihitung, bukan disimpan. Pada endpoint IN yang aktif ia terbacaTXINI | FIFOCON, plusRWALselama bank 64 byte masih punya ruang. Pada endpoint OUT yang aktif ia terbacaRXOUTI | FIFOCON | RWALtepat saat monitor telah mengirim sesuatu yang belum dibaca siapa pun, dan 0 selain itu.- 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. UEDATXmemindahkan byte: menulis menyiapkan satu byte di endpoint IN terpilih, membaca mengambil satu byte dari endpoint OUT terpilih.UEBCLXmenghitung yang sudah disiapkan atau menunggu, dengan batas maksimum 255.UEINTpunya satu bit per endpoint yang punya sesuatu untuk dikerjakan.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.
Yang tidak ada: host, bus, reset bus, paket SETUP, deskriptor, enumerasi, pengalamatan, penghitung frame, start-of-frame 1 ms, banking endpoint, NAK, STALL, double buffering, dan kedua interupsi USB. USB_GENERAL dan USB_ENDPOINT tidak pernah dinaikkan, jadi runtime CDC di model ini memakai polling.
Dua konsekuensi yang bisa dilihat sketch. while (!Serial) {} langsung selesai di sini dan menunggu di meja nyata, karena tidak ada host yang mengenumerasi perangkat. Dan sketch yang memeriksa control transfer tidak punya apa pun untuk dikerjakan.
Keyboard.h, Mouse.h dan Joystick.h (firmware/lib, di atas mokxi_hid.h) tetap dikompilasi dan berjalan di sini. Sketch yang menyertakan salah satunya juga menautkan firmware/leonardo/src/usb_hid.c, anggota library yang hanya ditarik oleh sketch seperti itu, yang membuat perangkat menjadi komposit: antarmuka CDC seperti sebelumnya, plus satu antarmuka HID dengan endpoint IN interupsi 4 dan deskriptor report setiap library digabung, masing-masing dengan report ID sendiri (Mouse 1, Keyboard 2, Joystick 3). Di board sungguhan itulah yang dienumerasi host. Di sini tidak ada host, jadi setiap library mencetak apa yang seharusnya dikirim ke Serial, satu baris berkurung siku per perubahan ([Keyboard] press Ctrl, [Joystick] buttons 0 3 | hat 90 | x 512 y 0). Sketch tanpa salah satunya adalah perangkat CDC biasa, dan keluarannya di sini sama seperti sebelumnya.
Library yang ditulis untuk PluggableUSB inti AVR, MIDIUSB yang pertama, menemukan PluggableUSB.h, USBAPI.h, USBCore.h dan USBDesc.h di samping arduino.h (ditulis dari spesifikasi USB 2.0 dengan nama inti), jadi library itu dikompilasi dan berjalan tanpa perubahan. MIDIUSB sendiri sudah bawaan (firmware/lib/MIDIUSB.h, dengan MIDIUSB_Defs.h dan pitchToNote.h), di Leonardo, Micro dan Pro Micro. PluggableUSB().plug() memberikan kepada modul nomor antarmuka dan endpoint setelah port CDC, seperti yang inti berikan (antarmuka 2, endpoint 4 untuk yang pertama), tapi tidak ada yang menampilkan modul ke host, di sini maupun di board: endpoint-nya tidak pernah dikonfigurasi, jadi USB_Send() mengembalikan -1 seperti inti sebelum enumerasi, USB_Recv() mengembalikan -1 dan USB_Available() bernilai 0. Sketch kontroler MIDI berjalan, dan notnya tidak menuju ke mana pun: sendMIDI() pertama MIDIUSB mengatakannya sekali di serial monitor ([Mokxi] MIDIUSB: no USB host is simulated, so these MIDI messages go nowhere. ...), dan keluaran Serial milik sketch sendiri tetap berjalan di sekitarnya. Tidak ada panel editor yang menampilkan pesan itu, karena endpoint modul yang dipasang tidak pernah sampai ke engine.
Runtime-nya sendiri tidak terbatas pada stub. firmware/leonardo/src/usb.c adalah perangkat CDC ACM yang sesungguhnya (control endpoint 0, notification endpoint 1, bulk OUT 2 dan bulk IN 3, deskriptor core Arduino beserta VID dan PID, berbasis interrupt, dengan sentuhan 1200 baud ke Caterina), dan ada di setiap image. Saat reset ia melepaskan bank IN kosong di endpoint 3 dan membaca FIFOCON kembali: silikon menyimpan bank sampai host membacanya, dan belum ada host yang mereset bus, sedangkan model ini langsung membebaskan bank yang dilepas. Satu pembacaan itu menentukan mode secara permanen. Di sini runtime menggerakkan pipe persis seperti dijelaskan di atas dan stack USB tetap nonaktif; di board sungguhan ia menjalankan stack-nya. Perubahan model yang membuat bank yang dilepas tetap sibuk akan memindahkan semua sketch Leonardo ke jalur hardware, di mana Serial tidak mengirim apa pun sampai sebuah host mengonfigurasi perangkat, karena itu crates/atmega32u4/src/usb.rs punya test yang mengunci perilaku ini.
3.7 ADC
Sepuluh bit, empat belas kanal, ADCL 0x78, ADCH 0x79, ADCSRA 0x7A, ADCSRB 0x7B, ADMUX 0x7C, DIDR2 0x7D, DIDR0 0x7E, DIDR1 0x7F. Prescaler, ADSC, ADIF, ADIE, ADATE dalam mode free-running dan ADLAR semuanya berperilaku seperti bagian 3.3 docs/uno.md; satu konversi memakan 13 clock ADC, 25 untuk yang pertama setelah ADEN.
Dua hal berbeda dari ATmega328P dan satu dari ATmega2560:
- Pemilih kanalnya enam bit dan bit teratasnya,
MUX5, adalah bit 5ADCSRB, not bit 3, which is where an ATmega2560 puts it. - Kanal di atas tujuh bukan port kedua.
ADC8sampaiADC13adalah PD4, PD6, PD7, PB4, PB5 dan PB6, itulah mengapa A6 sampai A11 di Arduino Leonardo juga pin digital 4, 12, 6, 8, 9 dan 10. Board ini mengeluarkanA0sampaiA5di header analog; sisanya diakses lewat nomor pin digitalnya. - Tidak ada referensi 1,1 V.
REFS1:0bernilai 0 untukAREF, 1 untuk AVCC, 3 untuk 2,56 V internal, dan 2 dicadangkan. Bandgap 1,1 V tetap tersedia sebagai kanal diMUX5:0= 0x1E.
Kanal ke pad: 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 dan ADC3 ada di mux tapi tidak dikeluarkan pada paket ini; memilih salah satunya membaca 0. Kanal diferensial dan gain serta sensor suhu tidak dimodelkan dan membaca 0.
3.8 Interupsi eksternal dan pin-change
EICRA 0x69, EICRB 0x6A, EIMSK 0x3D, EIFR 0x3C, PCICR 0x68, PCIFR 0x3B, PCMSK0 0x6B.
Lima interrupt eksternal dan tiga celah: INT0 PD0 (pin 3), INT1 PD1 (pin 2), INT2 PD2 (pin 0), INT3 PD3 (pin 1), INT6 PE6 (pin 7). INT4, INT5 dan INT7 adalah slot cadangan tanpa pin di belakangnya; mengaktifkan salah satunya tidak akan pernah menghasilkan apa pun. Bit sense ada di EICRA untuk 0 sampai 3 dan EICRB untuk 4 sampai 7, dua bit masing-masing: 0 level rendah, 1 semua edge, 2 falling, 3 rising. Interrupt level rendah aktif selama pin dalam keadaan rendah dan tidak menyetel flag apa pun.
Satu grup pin-change, PCINT0, dan itu seluruh port B.
3.9 Sleep dan EEPROM
SMCR 0x53 dengan bit SE 0, dan setiap mode sleep berperilaku seperti idle: clock CPU berhenti, peripheral tetap berjalan, dan interrupt yang diaktifkan mana pun membangunkannya. MCUSR 0x54 melaporkan PORF setelah power-on reset dan EXTRF setelah pin reset ditahan. WDTCSR adalah watchdog, sama seperti pada Uno (docs/uno.md bagian 3.8, vektor 12), kecuali bahwa, seperti yang dilakukan bootloader Caterina, model chip ini menghapus WDRF dan menghentikan watchdog setelah watchdog reset, sebelum setup(). CLKPR, PRR0, PRR1, OSCCAL, RCCTRL, SPMCSR dan GPIOR0..2 disimpan dan dapat dibaca kembali.
EEPROM berukuran 1 KB di EECR 0x3F, EEDR 0x40, EEARL 0x41, EEARH 0x42, dengan EEARH selebar dua bit. Pembacaan selesai seketika; penulisan memakan 3,3 ms (26.368 siklus osilator RC 8 MHz; 1,8 ms dalam mode hapus-saja atau tulis-saja), dan selama itu EEPE terbaca 1, lalu EERIE menaikkan EE_READY sebagai level begitu selesai.
3.10 Vektor
Empat puluh tiga vektor, berjarak dua kata mulai dari alamat kata 0, dinomori sesuai urutan prioritas. crates/atmega32u4/src/vectors.rs dan firmware/leonardo/include/leonardo.h memuat tabelnya; bentuk yang penting di sini adalah slot 5, 6, 8, 13, 14 dan 15 direservasi pada komponen ini, dan kedua vektor USB berada di antara grup pin-change dan watchdog, urutan yang tidak dimiliki AVR lain di sini.
Yang dipakai runtime: INT0..INT3 adalah 1 sampai 4, INT6 adalah 7, PCINT0 adalah 9, TIMER0_OVF adalah 23, USART1_RX adalah 25, ADC adalah 29, dan empat vektor timer 4 adalah 38 sampai 41.
4. Kanal host
host_write memasukkan byte ke endpoint USB OUT yang dibaca firmware; host_read mengambil byte yang dikirim firmware pada endpoint IN. Itulah Serial dalam sebuah sketch dan serial monitor di UI. Bagi UI, byte berupa UTF-8, dan bagi model byte itu opaque.
Serial1 tidak berada di kanal ini dan tidak akan pernah: ia adalah dua pin header.
5. Model waktu dan komponen
Sesuai docs/uno.md bagian 5. 16 MHz, satu siklus tepat 62,5 ns, satu slice 10 us dan tepat 160 siklus, dan penghitung siklus dijangkarkan ke waktu kernel di awal setiap slice. Di dalam sebuah slice, core dijalankan satu instruksi demi satu instruksi dengan bus diberi tahu siklus saat setiap instruksi dimulai, sehingga perubahan pin membawa siklus yang menyebabkannya.
probe adalah bitmask: 1 berjalan, 2 sleep, 4 LED L bawaan board di pin 13, 8 transmisi USB dalam 20 ms terakhir, 16 penerimaan USB. 0 tanpa program.
poke: 2 menahan RESET, 3 melepaskannya.
6. Firmware (firmware/leonardo/)
Runtime berbentuk Arduino yang ditulis dari dokumen ini: setup() dan loop(), pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, delayMicroseconds, attachInterrupt, Serial dan Serial1. Tanpa Arduino core, tanpa avr-libc, tanpa libc.
Dibangun dengan clang --target=avr -mmcu=atmega32u4, di-link oleh ld.lld terhadap firmware/leonardo/link.ld. Lima file runtime milik Uno, dikompilasi ulang untuk komponen ini alih-alih disalin: format angka, helper matematika, floor freestanding dan setengah assembly-nya, serta Print. String katalog program adalah elf32 avr atmega32u4.
Pin PWM dan timer-nya:
| pin | output | timer | frekuensi |
|---|---|---|---|
| 3 | OC0B |
0, fast PWM | 976,5625 Hz |
| 11 | OC0A |
0, fast PWM | 976,5625 Hz |
| 13 | OC4A |
4, phase dan frequency correct, TOP = OCR4C |
490,196 Hz |
| 6 | OC4D |
4, phase dan frequency correct, TOP = OCR4C |
490,196 Hz |
| 9 | OC1A |
1, phase correct 8-bit | 490,196 Hz |
| 10 | OC1B |
1, phase correct 8-bit | 490,196 Hz |
| 5 | OC3A |
3, phase correct 8-bit | 490,196 Hz |
Serial adalah perangkat USB di src/usb.c dan Serial1 adalah USART1. mokxi_init() memulai perangkat USB sebelum hal lain, seperti USBDevice.attach() pada Arduino core, jadi board muncul sebagai serial port dan menerima sentuhan 1200 baud entah sketch memanggil Serial.begin() atau tidak. Tunggu PLL-nya dibatasi (10 ms; PLL yang tidak pernah terkunci membiarkan USB mati), dan satu milidetik yang dihabiskan di situ terjadi sebelum timer 0 dimulai, jadi ia menggeser semuanya bersama-sama. Di board, tulisan Serial dibuang sampai host mengonfigurasi perangkat dan sebuah program membuka port, satu byte menunggu paling lama 250 ms untuk host yang tidak membaca, dan while (!Serial) menunggu DTR, semua seperti pada Arduino core. Image ini membawa VID dan PID Leonardo (0x2341:0x8036) beserta string-nya; uploader menulis ulang untuk Micro (0x2341:0x8037) atau Pro Micro (0x1B4F:0x9206) saat menulis board. Stack ini memakan sekitar 2 KB flash dan belasan byte SRAM.
digitalPinToInterrupt: pin 3 adalah 0, pin 2 adalah 1, pin 0 adalah 2, pin 1 adalah 3, pin 7 adalah 4. Selain itu -1.
Empat contoh: blink, button (sebuah saklar di pin 7, yaitu INT6), serial (yang mencetak ke kedua port sehingga bedanya terlihat di layar), dan fade (yang menggerakkan pin 13 lewat timer 4 dan pin 9 lewat timer 1, sehingga dua jenis hardware PWM berjalan bersamaan). Sebuah contoh dianggarkan 8 KB dari 32 KB flash.
7. Apa yang tidak dimodelkan
SPI, TWI, analog comparator, sensor suhu, bagian bootloader dan fuse-nya, clock prescaler, PLL dan clock cepat yang memberi makan timer 4, output komplemen dan dead-time generator timer 4, dan semua di atas pipa byte USB yang tercantum di bagian 3.6. Register-register itu terbaca nilai reset-nya dan dihitung sebagai stray.
8. Hal yang pasti dari model ini, dan yang belum
Diambil dari data sheet, dan dijalankan oleh firmware sungguhan. Setiap alamat, posisi bit, dan nilai reset di bagian 3 berasal dari ATmega16U4/ATmega32U4 Data Sheet, dengan penomoran data-space, termasuk jendela I/O extended dari 0x60 sampai 0xFF yang menentukan register mana yang bisa dijangkau IN/OUT dan mana yang perlu sts. Lima port, timer 0, 1, 3, dan timer 4 sepuluh bit dengan OCR4C sebagai TOP, USART1, empat belas kanal ADC, INT0 sampai INT3 dan INT6, serta satu grup pin-change semuanya sesuai data sheet. crates/atmega32u4/tests/runtime.rs menjalankan ELF blink, serial, dan fade bawaan melalui port, kedua lebar timer, dan pipa byte USB.
Dimodelkan, tetapi tidak diikat ke angka data sheet. Perilaku, bukan alamat:
- Controller perangkat USB adalah stub yang membawa byte, seperti dinyatakan gamblang di bagian 3.6. Tidak ada enumerasi, tidak ada pertukaran deskriptor, tidak ada konfigurasi endpoint, tidak ada timing SOF, tidak ada suspend atau resume, dan tidak ada reset sentuhan 1200 baud.
Serialadalah pipa byte ke kanal host yang menjawabSerialdanSerial.dtr()seperti port CDC yang tersambung. Jadi satu hal yang membuat Leonardo menjadi Leonardo (bahwa sebuah sketch bisa memblokir selamanya menungguwhile (!Serial)) adalah keputusan model ini, bukan protokol yang dijalankannya. - Sisanya adalah daftar milik Uno. Grup tengah bagian 7
docs/uno.mdberlaku tanpa perubahan: ADC tanpa error, clock 16 MHz yang tepat, tiga state pad dan threshold dengan pull-up 35 kΩ, catu daya ideal yang tidak bisa brown out, start-up satu mikrodetik, dan slice 10 us.
Sengaja tidak ada, seperti yang didaftar di bagian 7: SPI, TWI, komparator analog, sensor suhu, seksi bootloader beserta fuse-nya, prescaler clock, PLL dan clock cepat yang mengisi timer 4, output komplemen timer 4 beserta generator dead-time, dan semua yang berada di atas pipe byte USB. Register-register itu membaca nilai reset-nya dan dihitung sebagai stray.