Başvuru

Arduino Leonardo kart sözleşmesi (Faz 9)

USB'si çipe giden ATmega32U4: Serial bir CDC uç noktasıdır ve Serial1 UART'tır.

Bu, modelin mühendislik referansıdır: neyi uyguladığını, yazmaç yazmaç, ona karşı firmware yazan kişiler için. Kartı düzenleyicide kullanmak için başlangıç noktan Arduino Leonardo ve kart sayfası.

Leonardo, USB yuvası doğrudan mikrodenetleyiciye giden Arduino'dur. Bir çekirdek bileşeni (crates/parts içindeki leonardo), Uno ve Mega ile aynı AVR çekirdeği üzerinde bir ATmega32U4 SoC modelini (crates/atmega32u4) sarar (crates/avr-core). Çekirdek paylaşılandır; etrafındaki çip değildir. Bu belge sözleşmedir ve koddaki herhangi bir yorumdan önce gelir.

Katalog türü leonardo'dur. Bir bölüm "docs/uno.md gibi" dediğinde, o belge o bölüm için sözleşmedir.

Bu kartı buradaki diğer tüm AVR'lerden farklı kılan tek gerçek: Serial bir UART değildir. ATmega32U4'nün üzerinde tam hızlı bir USB aygıtı vardır, kartın tek yuvası ona bağlıdır ve seri monitör, kodun kendi firmware'inin açtığı bir CDC uç noktasıdır. Serial1 (gerçek USART) 0 ve 1 başlık pinlerindedir ve kendisine bir şey bağlanmadıkça hiçbir yere ulaşmaz. Bölüm 3.6 USB'nin ne kadarının modellendiğini açıktır ve cevap şudur: bayt boru hattı ve onun üstünde hiçbir şey.

1. Kart pinleri (katalog sırası)

Üstten görünüm, sol kenarda micro-USB yuvası ve barrel jakı. Kart 68.6 x 53.3 mm'dir ve shield başlıkları bir Uno'nunkilerle delik delik aynıdır; dijital başlığın iki bloğu arasındaki Uno'nun 0.16 inçlik boşluğu dahil.

Üst sıra, soldan sağa (18 delik): SCL, SDA, AREF, GND, 13, 12, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0.

Alt sıra, soldan sağa (13 delik): IOREF, RESET, 3V3, 5V, GNDb, GNDc, VIN, A0 ile A5 arası.

ICSP başlığı, sağ kenardaki 2x3 blok, kendi pin sırasıyla 1'den 6'ya (6 delik): MISO, 5Vb, SCK, MOSI, RESETb, GNDd. Kartta 1, 3 ve 5 numaralı pinler bir sütundadır; 2, 4 ve 6 ise diğerinde.

37 pin. ICSP başlığı, bir Leonardo'nun SPI'yi dışarı çıkardığı tek yer: MISO, SCK ve MOSI PB3, PB1 ve PB2'dir, çekirdeğin 14, 15 ve 16 numaralı pinleridir ve başka hiçbir delik bu pedlere ulaşmaz. SPI.h (veriyolunu yazılımla süren) SCK, MISO ve MOSI'yi Arduino çekirdeğinin leonardo varyantının yaptığı gibi ICSP pedlerine, 15, 14 ve 16'ya yerleştirir; SS 17'dir, yani PB0'dır, RX lambasının pinidir ve deliği yoktur, bu yüzden kod çip seçimi için boşta olan herhangi bir pini kullanır. 11, 12 ve 13 pinleri bu kartta SPI değildir. 5Vb ve GNDd 5 V ve toprak hatlarıdır, RESETb ise RESET ile aynı izedir: herhangi bir delik low'a çekilirse çipi tutar ve diğeri R_STRAP üzerinden onu izler.

Bu kartın pin tablosunun var olma nedeni olan port eşlemesi:

pins port
0, 1 PD2, PD3
2, 3 PD1, PD0
4 PD4
5 PC6
6 PD7
7 PE6
8 ile 11 arası PB4 ile PB7 arası
12 PD6
13 PC7
A0 ile A3 PF7'den PF4'e
A4, A5 PF1, PF0
MISO, SCK, MOSI (14, 15, 16, ICSP) PB3, PB1, PB2

B'den F'ye beş port. Bu parçada port A ve port G yoktur. Leonardo'nun kullandığı 44 pinlik pakette B ve D portları tamdır, C portu yalnızca PC6 ve PC7'yi dışarı çıkarır, E portu PE2 ve PE6'yı, F portunda PF2 ve PF3 eksiktir. Paketin sahip olmadığı bir uç hiçbir şeyi sürmez ve geri 0 okur.

Elektriksel:

  • Her GPIO, tıpkı docs/uno.md bölüm 1'de belirtildiği gibi, R_STRONG üzerinden 5 V'ta push-pull sürer, yüksek empedansta (high-Z) kalır ya da 35 k üzerinden pull-up yapar. Bir giriş 2,5 Volttta yüksek okur; çekişmeli (Bilinmeyen) bir ağ 0 okur, boşta süzülen bir giriş ise Uno'daki gibi gürültü okur (docs/uno.md bölüm 1).
  • SCL/SDA beside AREF are the same two pieces of metal as pins 3 and 2, bir Uno'daki gibi değil. A5 ve A4 bir Uno'daki gibi, çünkü bu çipte I2C D portundadır. Paylaşılan shield ayak izinin paylaşılan çip olmadığı tek yer orasıdır ve bir kodu karttan karta taşırken kontrol edilecek şey budur. Her çiftin iki deliği de pinin sürdüğünü, diğer tarafın ağının yaptığı her şeyle birlikte taşır, üzerinden geçtiği yer: R_STRAP.
  • 5V ve IOREF, R_SUPPLY üzerinden 5 V sürer; 3V3 3.3 V sürer; GND, GNDb ve GNDc 0 V sürer. VIN kartın yok saydığı bir giriştir: kart her zaman USB ile beslenir.
  • RESET (ve aynı iz olan RESETb), 5 V'a 10 k pull-up taşır. 2.5 V'un altına çekmek CPU'yu sıfırlamada tutar; bırakmak bir harici sıfırlamadır ve MCUSR'nin bildirdiği de budur.
  • AREF yalnızca okunur, asla sürülmez. Dahili referans seçiliyken pin olduğu gibi bırakılır.
  • 13 pininde, karta yerleşik L LED'i 1 k üzerinden toprağa bağlıdır.
  • A0 ile A5 arası, analog girişlerin yanı sıra sıradan dijital pinlerdir.

2. Bellek haritası

flash 32 KB, 16 K komut kelimesi, PC 14 bit
SRAM 0x0100 ile 0x0AFF arası 2560 bayt, RAMEND = 0x0AFF
EEPROM 1 KB
I/O 0x20 ile 0x5F arası, IN/OUT/SBI/CBI ile erişilir
genişletilmiş I/O 0x60 ile 0xFF arası, yalnızca LDS/STS ve işaretçi yüklemeleriyle erişilir

RAMPZ ve EIND yoktur: 32 KB flash Z içine sığar, dolayısıyla LPM hepsine ulaşır ve dönüş adresi iki bayttır. Flash'tan büyük bir ham kalıntı, ada göre reddedilir.

Gerçek bir kartta flash belleğin üst 4 KB'lık kısmı USB bootloader'ı barındırır; kart, kodun konuştuğu soket üzerinden kendini yeniden programlamayı böyle yapar. Burada hiçbir şey bootloader üzerinden yüklenmez (bir imge flash'e yerleştirilir), dolayısıyla 32 KB'ın tamamı kullanılabilir ve firmware/leonardo/link.ld bunu belirtir.

3. Çevre birimleri

Aşağıdaki her adres bir data-space adresidir; LDS/STS ve volatile bir işaretçinin gördüğü şekilde. Burada adı geçmeyen her kayıt defteri sıfırlama değerini okur ve başıboş erişim olarak sayılır.

3.1 Portlar

Beş port, her birinde üç kayıt defteri, önce PINx, sonra DDRx, sonra PORTx, hepsi düşük G/Ç penceresinde:

port PINx
B 0x23
C 0x26
D 0x29
E 0x2C
F 0x2F

0x20 ile 0x22 arası, portu olan bir parçada port A'nın bulunacağı yerdir ve bu parçada yoktur: bu üç adres başıboştur. MCUCR (0x55) 4. biti PUD, tüm pull-up'ları tek seferde devre dışı bırakır. Bir PINx bitine bir yazmak PORTx bitini ters çevirir.

3.2 Zamanlayıcı/sayıcı 0

Sekiz bit, iki karşılaştırma kanalı, olağan prescaler tablosu. TCCR0A 0x44, TCCR0B 0x45, TCNT0 0x46, OCR0A 0x47, OCR0B 0x48, TIMSK0 0x6E, TIFR0 0x35, GTCCR 0x43. Her dalga formu modu docs/uno.md bölüm 3.2'de verildiği gibidir. OC0A PB7'dir (pin 11) ve OC0B PD0'dır (pin 3).

3.3 Zamanlayıcı/sayıcılar 1 ve 3

On altı bit, on altı dalga biçimi modu, aynı on dört kayıtlık blok iki kez: tabanda TCCRnA, sonra +1 TCCRnB, +2 TCCRnC, +4 TCNTnL, +5 TCNTnH, +6 ICRnL, +7 ICRnH, +8..+13 arası OCRnAL ile OCRnCH. Timer 1, 0x80 adresinde ve Timer 3, 0x90 adresinde. TIMSK1 0x6F, TIMSK3 0x71, TIFR1 0x36, TIFR3 0x38.

Timer 3'ün tek karşılaştırma kanalı var. TCCR3A yalnızca COM3A1:0 ve WGM3 bitlerini taşır, başka hiçbir şey taşımaz; OCR3B ve OCR3C kayıt değildir ve 0x9A ile 0x9D arası boştur. TIMSK3 yalnızca TOIE3, OCIE3A ve ICIE3 kabul eder.

OC1A PB5'tir (pin 9), OC1B PB6'dır (pin 10), OC1C PB7'dir (pin 11, OC0A ile paylaşımlı) ve OC3A PC6'dır (pin 5). Giriş yakalama: ICP1 PD4, ICP3 PC7'dir.

Tek bir pede kablolanan iki çevre birimi parçanın kendi eseridir ve datasheet, ikisini birden etkinleştirmemek firmware'in sorumluluğunda bırakır. Burada çıkışını açan çevre birimi pede sahiptir ve yalnızca sahibi onu geri devredebilir.

3.4 Zamanlayıcı/sayıcı 4, on bitlik olan

Bu, ATmega328P'deki bir şeyin daha geniş veya daha dar bir sürümü olmayan çevre birimidir. Paylaşımlı bir yüksek baytın ardında on bit, bir modda değil bir kayıt defterinde TOP ve A, B ve D adında üç karşılaştırma kanalı. C kanalı yoktur, çünkü OCR4C TOP'tur.

yazmaç adres
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

TIFR4 ve TIMSK4 bitleri: TOV4/TOIE4 bit 2, OCF4B/OCIE4B bit 5, OCF4A/OCIE4A bit 6, OCF4D/OCIE4D bit 7. TCCR4B içindeki CS43:0 sayacı 0'da durdurur ve aksi halde 2^(n-1) ile böler, 16384'e kadar. OCR4C 0xFF'a sıfırlanır; sekiz bitlik bir görev döngüsünün TOP yazmadan çalışmasının nedeni budur. Her on bitlik yazmaç TC4H üzerinden geçer; bu, 16 bitlik zamanlayıcıların TEMP'inden ayrı bir mandaldır.

Modellenmiş: hızlı PWM (WGM41:0 = 0) ve faz-ve-frekans-doğru PWM (WGM41:0 = 1), OC4A (PC7, pin 13), OC4B (PB6, pin 10) ve OC4D (PD7, pin 6) üzerindeki üç karşılaştırma çıkışı ve etkinleştirmeleriyle birlikte dört bayrak. Bir kanal, COM4x bitlerinin yanı sıra PWM4x bitine de ihtiyaç duyar; tek başına COM4x hiçbir şey yapmaz.

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

Tek USART ve o da Serial1'dir. 0xC8'den itibaren yedi yazmaç: UCSR1A, +1 UCSR1B, +2 UCSR1C, +3 UCSR1D, +4 UBRR1L, +5 UBRR1H, +6 UDR1. Bit konumları Uno'nunkilerdir (docs/uno.md bölüm 3.4). UCSR1D saklanır ve 0 olarak geri okunur; donanım akış kontrolü modellenmemiştir.

Kendi pinlerine ve başka hiçbir şeye kabloludur: RXD1 PD2'dir (pin 0) ve TXD1 PD3'tür (pin 1). Bir çerçeve ped üzerinden bir seferde bir bit sürülür (düşük bir başlangıç biti, önce en düşük anlamlı olmak üzere sekiz veri biti, yüksek bir durdurma biti, her biri 16 (UBRR + 1) CPU çevrimi, U2X1 ile yarısı), dolayısıyla pin 1'den pin 0'a bir jumper gerçekten bir karakter taşır. Alma, her bitin ortasını örnekler; eşleşmeyen bir baud hızının metni burada masadaki gibi bozmasının nedeni budur.

TXEN1, DDRD ne derse desin TXD1'i alır ve RXEN1, RXD1'i girişte tutar: bu datasheet'in kuralıdır ve Serial1.begin()'in neden pinMode gerektirmediğinin açıklamasıdır.

3.6 USB aygıtı: bayt taşıyan bir taslak

Modelin bilinçli olarak çipten farklı olduğu yer burasıdır ve açıkça söylemeye değer.

Gerçek adreslerde modellenmiş: 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. Yedi uç nokta, 0 ile 6.

Ne davranış sergiliyor:

  • USBCON.USBE denetleyiciyi açar; UDCON.DETACH temizlenince takılır. İkisi de olana kadar her UEx yazmacı 0 okur ve yazılanlar hiçbir yere gitmez.
  • UENUM selects an endpoint. UECONX.EPEN enables it and UECFG0X.EPDIR gives it a direction: set is IN (device to host), clear is OUT.
  • UEINTX saklanmak yerine hesaplanır. Etkin bir IN uç noktasında TXINI | FIFOCON okur, ayrıca 64 baytlık bankada yer varken RWAL. Etkin bir OUT uç noktasında, izleyicinin kimsenin okumadığı bir şey gönderdiği sürece tam olarak RXOUTI | FIFOCON | RWAL okur, aksi halde 0.
  • Writing UEINTX follows the AVR USB convention: a bit is cleared by writing a zero to it. Clearing FIFOCON or TXINI on an IN endpoint hands the staged bank to the serial monitor. A bank that reaches 64 bytes goes out on its own.
  • UEDATX baytları taşır: bir yazma, seçili IN endpoint'ine bir bayt koyar; bir okuma, seçili OUT endpoint'inden bir bayt alır. UEBCLX bekleyen veya hazır olan baytları sayar ve 255'te doyar. UEINT'te her endpoint için yapılacak bir şey varsa bir bit bulunur.
  • USBSTA reads VBUS set and UESTA0X reads CFGOK set: the board is plugged in and an endpoint this model has is always allocated, because there is no FIFO memory to run out of.

Burada olmayan şeyler: host, veri yolu, veri yolu sıfırlaması, SETUP paketleri, tanımlayıcılar, numaralandırma, adresleme, kare sayacı, 1 ms'lik kare başlangıcı, endpoint bankacılığı, NAK, STALL, çift tamponlama ve her iki USB kesmesi. USB_GENERAL ve USB_ENDPOINT hiç tetiklenmez, dolayısıyla bu modeldeki bir CDC çalışma zamanı yoklama yapar.

Bir kodun görebileceği iki sonuç vardır. while (!Serial) {} burada hemen döner ama masada bekler, çünkü aygıtı numaralandıracak bir host yoktur. Ayrıca bir kontrol aktarımını inceleyen bir kodun eline bir şey geçmez.

Keyboard.h, Mouse.h ve Joystick.h (firmware/lib içinde, mokxi_hid.h üzerine kurulu) burada aynen derlenir ve çalışır. Bunlardan birini içeren bir kod, firmware/leonardo/src/usb_hid.c dosyasını da bağlar; bu, yalnızca böyle bir kodun içine çektiği bir kütüphane üyesidir ve aygıtı bileşik bir aygıt yapar: eskisi gibi CDC arayüzleri, artı biri kesmeli IN endpoint 4 olan bir HID arayüzü ve her kütüphanenin rapor tanımlayıcısı birleşik halde, her biri kendi rapor kimliğiyle (Mouse 1, Keyboard 2, Joystick 3). Gerçek bir kartta host numaralandırdığı şey budur. Burada host olmadığından her kütüphane, göndereceği şeyi onun yerine Serial üzerinden yazdırır, her değişimde köşeli parantezli bir satır ([Keyboard] press Ctrl, [Joystick] buttons 0 3 | hat 90 | x 512 y 0). Bunlardan hiçbirini içermeyen bir kod düz CDC aygıttır ve buradaki çıktısı her zamanki gibidir.

AVR çekirdeğinin PluggableUSB'sine göre yazılmış kütüphaneler, öncelikle MIDIUSB, arduino.h dosyasının yanında PluggableUSB.h, USBAPI.h, USBCore.h ve USBDesc.h bulur (USB 2.0 belirtiminden, çekirdeğin adlarıyla yazılmıştır), bu yüzden değişmeden derlenir ve çalışır. MIDIUSB'un kendisi hazırdır (firmware/lib/MIDIUSB.h, yanında MIDIUSB_Defs.h ve pitchToNote.h ile), Leonardo, Micro ve Pro Micro'da kullanılabilir. PluggableUSB().plug(), bir modüle çekirdeğin vereceği arayüz ve endpoint numaralarını CDC portundan sonra verir (ilk modül için arayüz 2, endpoint 4), ama hiçbir şey modülü bir host'a göstermez, burada da kartta da: endpoint'leri hiç yapılandırılmaz, dolayısıyla USB_Send(), çekirdeğin numaralandırma öncesinde yaptığı gibi -1 döner, USB_Recv() -1 döner ve USB_Available() 0'dır. Bir MIDI denetleyici kodu çalışır ve notaları hiçbir yere gitmez: MIDIUSB'un ilk sendMIDI() çağrısı bunu seri monitörde bir kez söyler ([Mokxi] MIDIUSB: no USB host is simulated, so these MIDI messages go nowhere. ...) ve kodun kendi Serial çıktısı çevresinde akmaya devam eder. Hiçbir düzenleyici paneli bu mesajları göstermez, çünkü takılan bir modülün endpoint'leri hiçbir zaman motora ulaşmaz.

Çalışma zamanının kendisi taslakla sınırlı değildir. firmware/leonardo/src/usb.c gerçek bir CDC ACM aygıtıdır (kontrol endpoint 0, bildirim endpoint 1, toplu OUT 2 ve toplu IN 3, Arduino çekirdeğinin tanımlayıcıları ile VID ve PID'si, kesmeli, Caterina'ya 1200 baud dokunuşuyla) ve her kalıpta bulunur. Sıfırlamada endpoint 3 üzerinde boş bir IN bankasını bırakır ve FIFOCON değerini geri okur: gerçek silikon bankayı bir host okuyana kadar tutar ve henüz hiçbir host veri yolunu sıfırlamamıştır; bu model ise bırakılan bankayı hemen serbest bırakır. Bu tek okuma modu kalıcı olarak belirler. Burada çalışma zamanı kanalı yukarıda anlatıldığı gibi sürer ve USB yığını hareketsiz kalır; kartta ise yığını çalıştırır. Bırakılan bir bankayı meşgul tutan bir model değişikliği, her Leonardo kodunu donanım yoluna taşır ve orada Serial, bir host aygıtı yapılandırana kadar hiçbir şey söylemez; bu yüzden crates/atmega32u4/src/usb.rs içinde bu davranışı sabitleyen bir test vardır.

3.7 ADC

On bit, on dört kanal, ADCL 0x78, ADCH 0x79, ADCSRA 0x7A, ADCSRB 0x7B, ADMUX 0x7C, DIDR2 0x7D, DIDR0 0x7E, DIDR1 0x7F. Prescaler, serbest çalışma modundaki ADSC, ADIF, ADIE, ADATE ve ADLAR tam olarak docs/uno.md bölüm 3.3'te anlatıldığı gibi davranır; bir dönüşüm 13 ADC saati sürer, ADEN sonrası ilk dönüşüm ise 25 saat sürer.

Bir ATmega328P'den iki, bir ATmega2560'dan bir fark vardır:

  • Kanal seçici altı bittir ve en üst biti, MUX5, şu konumdadır: ADCSRB bit 5, not bit 3, which is where an ATmega2560 puts it.
  • Yediden yukarıdaki kanallar ikinci bir port değildir. ADC8 ile ADC13 arasında PD4, PD6, PD7, PB4, PB5 ve PB6 vardır; bu yüzden bir Arduino Leonardo üzerinde A6 ile A11 arası aynı zamanda 4, 12, 6, 8, 9 ve 10 numaralı dijital pinlerdir. Bu kart A0 ile A5 arasını analog başlıkta verir; geri kalanlara dijital pin numaralarıyla ulaşılır.
  • 1.1 V referans yoktur. REFS1:0, AREF için 0, AVCC için 1, dahili 2.56 V için 3'tür ve 2 ayrılmıştır. 1.1 V bandgap, MUX5:0 = 0x1E'de bir kanal olarak hâlâ kullanılabilir.

Kanaldan bacağa: 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 ve ADC3 mux içinde vardır ama bu pakette bacağa bağlanmamıştır; birini seçmek 0 okur. Diferansiyel ve kazanç kanalları ile sıcaklık sensörü modellenmemiştir ve 0 okur.

3.8 Harici ve pin değişimi kesmeleri

EICRA 0x69, EICRB 0x6A, EIMSK 0x3D, EIFR 0x3C, PCICR 0x68, PCIFR 0x3B, PCMSK0 0x6B.

Beş harici kesme ve üç boşluk: INT0 PD0 (pin 3), INT1 PD1 (pin 2), INT2 PD2 (pin 0), INT3 PD3 (pin 1), INT6 PE6 (pin 7). INT4, INT5 ve INT7 arkasında pin olmayan ayrılmış yerlerdir; birini etkinleştirmek hiçbir zaman tetiklemez. Algılama bitleri 0 ile 3 için EICRA ve 4 ile 7 için EICRB'dir, ikiser bit: 0 düşük seviye, 1 her iki kenar, 2 düşen kenar, 3 yükselen kenar. Düşük seviye kesmesi, pin düşükken tetiklenir ve bayrak belirlemez.

Tek bir pin değişimi grubu, PCINT0, ve tümü B portudur.

3.9 Uyku ve EEPROM

SMCR 0x53, SE biti 0 ile; ve her uyku modu idle gibi davranır: CPU saati durur, çevre birimleri çalışmaya devam eder ve etkinleştirilmiş herhangi bir kesinte onu geri getirir. MCUSR 0x54, güç açma sıfırlamasından sonra PORF, reset pini basılı tutulduktan sonra ise EXTRF bildirir. WDTCSR, Uno'daki gibi watchdog'dur (docs/uno.md bölüm 3.8, vektör 12); tek fark, Caterina bootloader'ının yaptığı gibi, çip modelinin bir watchdog sıfırlamasından sonra, setup()'tan önce WDRF'yi temizlemesi ve watchdog'u durdurmasıdır. CLKPR, PRR0, PRR1, OSCCAL, RCCTRL, SPMCSR ve GPIOR0..2 saklanır ve geri okunur.

EEPROM 1 KB'dir, EECR 0x3F, EEDR 0x40, EEARL 0x41, EEARH 0x42 adreslerinde, EEARH iki bit genişliğindedir. Okuma anında tamamlanır; yazma 3.3 ms sürer (8 MHz RC osilatörünün 26.368 çevrimi; yalnızca silme veya yalnızca yazma modunda 1.8 ms), bu süre boyunca EEPE 1 okunur ve EERIE, bittiğinde EE_READY'yi seviye olarak yükseltir.

3.10 Vektörler

Kırk üç vektör, 0 numaralı kelime adresinden iki kelime aralıklı, öncelik sırasına göre numaralandırılmış. Tabloyu crates/atmega32u4/src/vectors.rs ve firmware/leonardo/include/leonardo.h taşır; burada önemli olan biçim, bu parçada 5, 6, 8, 13, 14 ve 15 numaralı yuvaların rezerve olması ve iki USB vektörünün pin değişimi grubu ile watchdog arasında yer almasıdır, buradaki başka hiçbir AVR'de olmayan bir sıralama.

Çalışma zamanının kullandıkları: INT0..INT3 1 ile 4 arası, INT6 7, PCINT0 9, TIMER0_OVF 23, USART1_RX 25, ADC 29 ve timer 4'ün dört vektörü 38 ile 41 arası.

4. Ana makine kanalı

host_write baytları firmware'in okuduğu USB OUT endpoint'ine koyar; host_read firmware'in IN endpoint'ine gönderdiği baytları alır. Bu, koddaki Serial ve arayüzdeki seri monitördür. Baytlar arayüz açısından UTF-8'dir ve model için opaktır.

Serial1 bu kanalda değildir ve hiçbir zaman olmayacak: iki header pinidir.

5. Zaman modeli ve parça

docs/uno.md bölüm 5'teki gibi. 16 MHz'de bir çevrim tam 62,5 ns, bir dilim 10 us ve tam 160 çevrimdir ve çevrim sayacı her dilimin başında çekirdek zamanına sabitlenir. Bir dilimin içinde çekirdek, her talimatın başladığı çevrimi veri yoluna bildirerek talimat talimat adım adım çalıştırılır, böylece bir pin değişimi onu neden olan çevrimi taşır.

probe bir bit maskesidir: 1 çalışıyor, 2 uyuyor, 4 pin 13'teki kart üstü L LED'i, 8 son 20 ms içinde USB iletim, 16 USB alım. Program yokken 0.

poke: 2 RESET'i tutar, 3 bırakır.

6. Firmware (firmware/leonardo/)

Bu belgeden yazılmış Arduino biçiminde bir çalışma zamanı: setup() ve loop(), pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, delayMicroseconds, attachInterrupt, Serial ve Serial1. Arduino core yok, avr-libc yok, libc yok.

clang --target=avr -mmcu=atmega32u4 ile derlendi, ld.lld ile firmware/leonardo/link.ld dosyasına karşı bağlandı. Çalışma zamanının beş dosyası Uno'nunkiler olup bu parça için kopyalanmak yerine yeniden derlendi: sayı biçimlendirme, matematik yardımcıları, bağımsız floor fonksiyonu ve onun assembly yarısı ile Print. Katalogdaki program dizisi elf32 avr atmega32u4 şeklindedir.

PWM pinleri ve zamanlayıcıları:

pin çıkış zamanlayıcı frekans
3 OC0B 0, hızlı PWM 976.5625 Hz
11 OC0A 0, hızlı PWM 976.5625 Hz
13 OC4A 4, faz ve frekans doğru, TOP = OCR4C 490.196 Hz
6 OC4D 4, faz ve frekans doğru, TOP = OCR4C 490.196 Hz
9 OC1A 1, 8-bit faz doğru 490.196 Hz
10 OC1B 1, 8-bit faz doğru 490.196 Hz
5 OC3A 3, 8-bit faz doğru 490.196 Hz

Serial, src/usb.c içindeki USB aygıtıdır ve Serial1 USART1'dir. mokxi_init(), Arduino çekirdeğindeki USBDevice.attach() gibi, her şeyden önce USB aygıtını başlatır; böylece kart kod Serial.begin() çağırsın ya da çağırmasın seri port olarak görünür ve 1200 baud dokunuşunu alır. PLL bekleme süresi sınırlıdır (10 ms; hiç kilitlenmeyen bir PLL USB'yi kapalı bırakır) ve orada geçirdiği milisaniye, zamanlayıcı 0 başlamadan önce gelir, yani her şeyi birlikte geciktirir. Kartta, ana bilgisayar aygıtı yapılandırana ve bir program portu açana kadar Serial yazmaları atlanır, bir bayt okumayan bir ana bilgisayar için en fazla 250 ms bekler ve while (!Serial) DTR için bekler, tıpkı Arduino çekirdeğindeki gibi. İmaj, Leonardo'nun VID ve PID değerlerini (0x2341:0x8036) ve dizilerini taşır; yükleyici, kartı yazarken bunları bir Micro (0x2341:0x8037) veya bir Pro Micro (0x1B4F:0x9206) için yeniden yazar. Yığın yaklaşık 2 KB flash ve birkaç düzine bayt SRAM harcar.

digitalPinToInterrupt: pin 3 için 0, pin 2 için 1, pin 0 için 2, pin 1 için 3, pin 7 için 4. Bunların dışındakiler -1'dir.

Dört örnek: blink, button (pin 7'de bir anahtar, yani INT6), serial (iki porta da yazdırır, böylece aralarındaki fark ekranda görünür) ve fade (pin 13'ü zamanlayıcı 4'ten, pin 9'u zamanlayıcı 1'den sürer, böylece iki tür PWM donanımı aynı anda çalışır). Bir örnek için 32 KB flash'ın 8 KB'lık bölümü ayrılmıştır.

7. Modellenmeyen şeyler

SPI, TWI, analog karşılaştırıcı, sıcaklık sensörü, bootloader bölümü ve fuse'ları, saat önölçekleyicisi, PLL ve timer 4'ü beslediği hızlı saat, timer 4'ün tamamlayıcı çıkışları ve ölü süre üreteci, ayrıca 3.6 numaralı bölümde listelenen USB bayt borusunun üzerindeki her şey. Bu yazmaçlar sıfırlama değerlerini okur ve başıboş (stray) sayılır.

8. Bu modelin emin olduğu ve emin olmadığı şeyler

Veri sayfasından alınmıştır ve gerçek firmware ile baştan sona denenmiştir. Bölüm 3'teki her adres, bit konumu ve sıfırlama değeri ATmega16U4/ATmega32U4 Data Sheet'ten, veri alanı numaralandırmasıyladır; IN/OUT'un hangi yazmaçlara ulaşabildiğini ve hangilerinin sts gerektirdiğini belirleyen 0x60 ile 0xFF arasındaki genişletilmiş I/O penceresi dahil. Beş port, 0, 1 ve 3 zamanlayıcıları ile TOP için OCR4C içeren on bitlik 4. zamanlayıcı, USART1, on dört ADC kanalı, INT0'dan INT3'e ve INT6, ve tek pin değişimi grubu veri sayfasındakidir. crates/atmega32u4/tests/runtime.rs, paketlenen blink, serial ve fade ELF'lerini portlardan, her iki zamanlayıcı genişliğinden ve USB bayt hattından geçirir.

Modellenmiş ama veri sayfasının sayılarına bağlı tutulmamış. Adreslerden çok davranışlar:

  • USB aygıt denetleyicisi baytları taşıyan bir taslaktır, 3.6 numaralı bölümün açıkça söylediği gibi. Numaralandırma yok, tanımlayıcı alışverişi yok, uç nokta yapılandırması yok, SOF zamanlaması yok, askıya alma veya devam ettirme yok ve 1200 baud dokunuşuyla sıfırlama yok. Serial, bağlı bir CDC portunun yapacağı şekilde Serial ve Serial.dtr() çağrılarına cevap veren, ana makine kanalına giden bir bayt borusudur. Yani bir Leonardo'yu Leonardo yapan tek şey (bir kodun while (!Serial) için sonsuza dek bekleyebilmesi) bu modelin çalıştırdığı bir protokol değil, verdiği bir karardır.
  • Geri kalan her şey Uno'nun listesi. docs/uno.md bölüm 7'nin orta grubu değişmeden geçerlidir: içinde hata olmayan bir ADC, tam 16 MHz bir saat, üç pad durumu ve 35 kΩ pull-up'lı eşik, brown-out yaşamayan ideal bir güç kaynağı, bir mikrosaniyelik başlangıç ve 10 us'lik bir dilim.

Bilinçli olarak yok, 7. bölüm şunları listeliyor: SPI, TWI, analog karşılaştırıcı, sıcaklık sensörü, bootloader bölümü ve sigortaları, saat prescaler'ı, timer 4'ü besleyen PLL ve hızlı saat, timer 4'ün tamamlayıcı çıkışları ve ölü süre üreteci, ve USB bayt hattının üzerindeki her şey. Bu kayıtlar sıfırlama değerini okur ve başıboş (stray) sayılır.