Đây là tài liệu tham khảo kỹ thuật cho mô hình: nó mô tả những gì được triển khai, thanh ghi này đến thanh ghi khác, dành cho những người viết firmware chạy trên đó. Để dùng bo mạch trong trình soạn thảo, hãy bắt đầu với Arduino Leonardo và trang bo mạch.
Leonardo là bo mạch Arduino có cổng USB nối thẳng vào vi điều khiển. Một thành phần nhân (leonardo trong crates/parts) bọc một mô hình SoC ATmega32U4 (crates/atmega32u4) trên cùng nhân AVR với Uno và Mega (crates/avr-core). Nhân được dùng chung; con chip bao quanh nó thì không. Tài liệu này là hợp đồng, và nó được ưu tiên hơn mọi ghi chú trong mã.
Kiểu trong catalog là leonardo. Nếu một mục ghi "như docs/uno.md", thì tài liệu đó là hợp đồng cho phần đó.
Chi tiết duy nhất khiến bo này khác mọi bo AVR khác ở đây: Serial không phải UART. ATmega32U4 có một thiết bị USB full-speed ngay trên die, socket duy nhất của bo nối vào nó, và Serial Monitor là một CDC endpoint do chính firmware của sketch mở. Serial1 (USART thật) nằm trên chân header 0 và 1 và không chạm tới đâu trừ khi có thứ gì đó được nối vào nó. Mục 3.6 nói rõ bao nhiêu phần của USB được mô phỏng, và câu trả lời là: đường ống byte, và không có gì phía trên nó.
1. Chân bo mạch (thứ tự trong danh mục)
Nhìn từ trên, socket micro-USB và giắc tròn ở cạnh trái. Bo mạch có kích thước 68.6 x 53.3 mm và header shield giống hệt của Uno, từng lỗ một, kể cả khoảng hở 0.16 inch của Uno giữa hai khối của header digital.
Hàng trên, từ trái sang phải (18 lỗ): SCL, SDA, AREF, GND, 13, 12, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0.
Hàng dưới, từ trái sang phải (13 lỗ): IOREF, RESET, 3V3, 5V, GNDb, GNDc, VIN, A0 đến A5.
Header ICSP, khối 2x3 ở cạnh phải, theo thứ tự chân riêng của nó từ 1 đến 6 (6 lỗ): MISO, 5Vb, SCK, MOSI, RESETb, GNDd. Trên bo mạch, chân 1, 3 và 5 nằm ở một cột và 2, 4, 6 ở cột kia.
37 chân. Đầu ICSP là nơi duy nhất trên Leonardo đưa SPI ra ngoài: MISO, SCK và MOSI là PB3, PB1 và PB2, tức chân 14, 15 và 16 của nhân, và không lỗ nào khác chạm tới các pad này. SPI.h (thư viện bit-bang bus này) đặt SCK, MISO và MOSI trên các pad ICSP, chân 15, 14 và 16, giống như biến thể leonardo của Arduino core; SS là 17, tức PB0, chân của đèn RX, và không có lỗ nào, nên sketch dùng bất kỳ chân nào còn trống làm chip select. Chân 11, 12 và 13 không phải SPI trên bo mạch này. 5Vb và GNDd là đường nguồn 5 V và mass, còn RESETb là cùng vết với RESET: kéo một trong hai lỗ xuống mức thấp sẽ giữ chip ở trạng thái reset, và lỗ còn lại theo qua R_STRAP.
Ánh xạ port, thứ mà bảng chân của bo này tồn tại để cho biết:
| pins | cổng |
|---|---|
0, 1 |
PD2, PD3 |
2, 3 |
PD1, PD0 |
4 |
PD4 |
5 |
PC6 |
6 |
PD7 |
7 |
PE6 |
8 đến 11 |
PB4 đến PB7 |
12 |
PD6 |
13 |
PC7 |
A0 đến A3 |
PF7 xuống đến PF4 |
A4, A5 |
PF1, PF0 |
MISO, SCK, MOSI (14, 15, 16, ICSP) |
PB3, PB1, PB2 |
Năm port, từ B đến F. Bộ phận này không có port A và không có port G. Trong package 44 chân mà Leonardo dùng, port B và port D đủ chân, port C chỉ đưa ra PC6 và PC7, port E đưa ra PE2 và PE6, còn port F thiếu PF2 và PF3. Một pad mà package không có thì không bao giờ điều khiển gì và đọc về 0.
Điện:
- Mỗi chân GPIO đều đẩy kéo (push-pull) ở 5 V qua
R_STRONG, ở trạng thái trở kháng cao, hoặc kéo lên qua 35 k, đúng như mô tả trong mục 1 củadocs/uno.md. Một đầu vào đọc mức cao ở 2,5 V; một đường nối xung đột (Unknown) đọc 0, và một đường nối lơ lửng đọc nhiễu, giống như trên Uno (docs/uno.mdmục 1). SCL/SDAbesideAREFare the same two pieces of metal as pins3and2, không phảiA5vàA4như trên Uno, vì trên chip này I2C nằm ở port D. Đó là chỗ duy nhất mà footprint shield dùng chung lại không phải chip dùng chung, và là điều cần kiểm tra khi chuyển sketch sang bo khác. Cả hai lỗ của mỗi cặp mang tín hiệu chân đang điều khiển cộng với mọi gì mà đường nối bên kia đang làm, quaR_STRAP.5VvàIOREFcấp 5 V quaR_SUPPLY;3V3cấp 3.3 V;GND,GNDbvàGNDccấp 0 V.VINlà đầu vào mà bo mạch bỏ qua: bo luôn được cấp nguồn qua USB.RESET(vàRESETb, cùng một vệt đồng) có điện trở kéo 10 k lên 5 V. Kéo xuống dưới 2.5 V sẽ giữ CPU trong trạng thái reset; thả ra là một lần reset ngoài, và đó là điềuMCUSRbáo.AREFchỉ được đọc, không bao giờ bị điều khiển. Khi chọn tham chiếu nội, chân này được để yên.- Chân
13có LEDLtrên bo mạch nối qua điện trở 1 k xuống đất. A0đếnA5là chân digital thường cũng như là đầu vào analog.
2. Bản đồ bộ nhớ
| flash | 32 KB, 16 K word lệnh, PC 14 bit |
| SRAM | 2560 byte tại 0x0100 đến 0x0AFF, RAMEND = 0x0AFF |
| EEPROM | 1 KB |
| I/O | 0x20 đến 0x5F, truy cập bằng IN/OUT/SBI/CBI |
| I/O mở rộng | 0x60 đến 0xFF, chỉ truy cập bằng LDS/STS và các lệnh load qua con trỏ |
Không có RAMPZ và không có EIND: 32 KB flash nằm gọn trong Z, nên LPM với tới được toàn bộ và một địa chỉ trả về dài hai byte. Một ảnh gốc lớn hơn dung lượng flash sẽ bị từ chối theo tên.
Trên bo mạch thật, 4 KB đầu của flash chứa USB bootloader, đó là cách nó tự nạp lại chương trình qua chính cổng mà sketch dùng để giao tiếp. Ở đây không có gì nạp qua bootloader (ảnh được đặt trực tiếp vào flash), nên toàn bộ 32 KB đều khả dụng và firmware/leonardo/link.ld nói rõ điều đó.
3. Linh kiện ngoại vi
Mọi địa chỉ dưới đây là địa chỉ không gian dữ liệu, theo cách LDS/STS và một con trỏ volatile nhìn thấy. Mọi thanh ghi không được nêu ở đây sẽ đọc ra giá trị reset và bị coi là truy cập lạc.
3.1 Port
Năm cổng, mỗi cổng ba thanh ghi, PINx rồi DDRx rồi PORTx, tất cả nằm trong cửa sổ I/O thấp:
| cổng | PINx |
|---|---|
| B | 0x23 |
| C | 0x26 |
| D | 0x29 |
| E | 0x2C |
| F | 0x2F |
0x20 đến 0x22 là nơi cổng A sẽ nằm trên một linh kiện có cổng A, còn linh kiện này không có: ba địa chỉ đó là truy cập lạc. Bit 4 PUD của MCUCR (0x55) tắt cùng lúc mọi điện trở kéo lên. Ghi một vào một bit PINx sẽ đảo bit PORTx tương ứng.
3.2 Bộ định thời/bộ đếm 0
Tám bit, hai kênh so sánh, bảng chia tần số thông thường. TCCR0A 0x44, TCCR0B 0x45, TCNT0 0x46, OCR0A 0x47, OCR0B 0x48, TIMSK0 0x6E, TIFR0 0x35, GTCCR 0x43. Đầy đủ mọi chế độ sóng như mục 3.2 của docs/uno.md. OC0A là PB7 (chân 11) và OC0B là PD0 (chân 3).
3.3 Bộ định thời/bộ đếm 1 và 3
Mười sáu bit, mười sáu chế độ sóng, cùng một khối mười bốn thanh ghi lặp lại hai lần: TCCRnA ở địa chỉ gốc, rồi +1 TCCRnB, +2 TCCRnC, +4 TCNTnL, +5 TCNTnH, +6 ICRnL, +7 ICRnH, +8..+13 từ OCRnAL đến OCRnCH. Timer 1 ở 0x80 và timer 3 ở 0x90. TIMSK1 0x6F, TIMSK3 0x71, TIFR1 0x36, TIFR3 0x38.
Timer 3 có một kênh so sánh. TCCR3A chỉ chứa COM3A1:0 và các bit WGM3 mà thôi, OCR3B và OCR3C không phải là thanh ghi, còn 0x9A đến 0x9D là các truy cập lạc. TIMSK3 chỉ chấp nhận TOIE3, OCIE3A và ICIE3.
OC1A là PB5 (chân 9), OC1B là PB6 (chân 10), OC1C là PB7 (chân 11, dùng chung với OC0A), và OC3A là PC6 (chân 5). Bắt tín hiệu vào: ICP1 là PD4, ICP3 là PC7.
Hai ngoại vi nối vào cùng một chân là do chính linh kiện thiết kế vậy, và datasheet giao cho firmware trách nhiệm không bật cả hai. Ở đây, ngoại vi nào bật ngõ ra của mình thì chiếm chân đó, và chỉ kẻ chiếm mới trả lại được.
3.4 Bộ định thời/bộ đếm 4, bộ mười bit
Đây là ngoại vi không phải bản rộng hơn hay hẹp hơn của thứ gì đó trên ATmega328P. Mười bit sau một byte cao dùng chung, TOP nằm trong thanh ghi thay vì trong chế độ, và ba kênh so sánh tên A, B và D. Không có kênh C, vì OCR4C chính là TOP.
| thanh ghi | địa chỉ |
|---|---|
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 |
Các bit TIFR4 và TIMSK4: TOV4/TOIE4 bit 2, OCF4B/OCIE4B bit 5, OCF4A/OCIE4A bit 6, OCF4D/OCIE4D bit 7. CS43:0 trong TCCR4B dừng bộ đếm ở 0 và nếu không thì chia tần cho 2^(n-1), tối đa 16384. OCR4C reset về 0xFF, đó là lý do một chu kỳ nhiệm vụ tám bit chạy được mà không cần ghi TOP. Mọi thanh ghi mười bit đều đi qua TC4H, là một chốt riêng biệt với TEMP của các timer 16 bit.
Được mô phỏng: fast PWM (WGM41:0 = 0) và phase-and-frequency-correct PWM (WGM41:0 = 1), ba ngõ so sánh trên OC4A (PC7, chân 13), OC4B (PB6, chân 10) và OC4D (PD7, chân 6), cùng bốn cờ với các bit cho phép tương ứng. Một kênh cần bit PWM4x của nó cũng như các bit COM4x; riêng COM4x thì không làm gì.
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
Có một USART, và đó là Serial1. Bảy thanh ghi bắt đầu từ 0xC8: UCSR1A, +1 UCSR1B, +2 UCSR1C, +3 UCSR1D, +4 UBRR1L, +5 UBRR1H, +6 UDR1. Vị trí các bit giống như của Uno (mục 3.4 trong docs/uno.md). UCSR1D được lưu và đọc lại là 0; điều khiển dòng phần cứng không được mô phỏng.
Nó được nối vào các chân của nó và không vào đâu khác: RXD1 là PD2 (chân 0) và TXD1 là PD3 (chân 1). Một khung dữ liệu được đẩy qua chân từng bit một (bit start mức thấp, tám bit dữ liệu với bit ít trọng số nhất đi trước, bit stop mức cao, mỗi bit 16 (UBRR + 1) chu kỳ CPU, một nửa nếu có U2X1), nên một dây cắm từ chân 1 sang chân 0 thực sự truyền được một ký tự. Phần nhận lấy mẫu ở giữa mỗi bit, vì vậy lệch baud rate làm hỏng chữ ở đây y như ngoài đời thực.
TXEN1 chiếm quyền điều khiển TXD1 bất kể DDRD nói gì, và RXEN1 giữ RXD1 ở chế độ đầu vào: đó là quy tắc trong datasheet, và đó là lý do Serial1.begin() không cần pinMode.
3.6 Thiết bị USB: một stub truyền byte
Đây là chỗ mô hình cố ý khác với chip thật, và điều đó đủ quan trọng để nói thẳng.
Được mô phỏng, tại các địa chỉ thật: 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. Bảy endpoint, từ 0 đến 6.
Những gì hoạt động đúng:
USBCON.USBEbật bộ điều khiển; xóaUDCON.DETACHđể gắn kết nó. Cho đến khi cả hai xảy ra, mọi thanh ghiUExđọc là 0 và ghi đi vào hư không.UENUMselects an endpoint.UECONX.EPENenables it andUECFG0X.EPDIRgives it a direction: set is IN (device to host), clear is OUT.UEINTXđược tính toán chứ không được lưu. Trên một endpoint IN đã bật, nó đọcTXINI | FIFOCON, cộng thêmRWALkhi bank 64 byte còn chỗ. Trên một endpoint OUT đã bật, nó đọcRXOUTI | FIFOCON | RWALđúng khi trình mô phỏng đã gửi thứ gì đó mà chưa ai đọc, và bằng 0 trong trường hợp còn lại.- 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. UEDATXdi chuyển các byte: ghi vào sẽ đặt một byte lên endpoint IN đang chọn, đọc sẽ lấy một byte từ endpoint OUT đang chọn.UEBCLXđếm số byte đã chuẩn bị hoặc đang chờ, bão hòa ở 255.UEINTcó một bit cho mỗi endpoint có việc cần làm.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.
Những gì không có ở đây: host, bus, bus reset, gói SETUP, descriptor, enumeration, đánh địa chỉ, bộ đếm frame, start-of-frame 1 ms, endpoint banking, NAK, STALL, đệm kép, và cả hai ngắt USB. USB_GENERAL và USB_ENDPOINT không bao giờ được bật, nên một runtime CDC trên mô hình này phải poll.
Hai hệ quả mà một sketch có thể thấy. while (!Serial) {} ở đây trả về ngay lập tức, còn trên bàn thật thì phải chờ, vì không có host nào để enumerate thiết bị. Và một sketch xét đến control transfer thì chẳng có gì để làm.
Keyboard.h, Mouse.h và Joystick.h (trong firmware/lib, dựng trên mokxi_hid.h) vẫn biên dịch và chạy ở đây như thường. Một sketch include một trong số chúng sẽ link thêm firmware/leonardo/src/usb_hid.c, một thành viên thư viện chỉ được kéo vào bởi một sketch như vậy, và điều đó biến thiết bị thành thiết bị composite: các interface CDC như trước, cộng thêm một interface HID với endpoint IN ngắt số 4 và report descriptor của mọi thư viện nối lại với nhau, mỗi cái có report ID riêng (Mouse 1, Keyboard 2, Joystick 3). Trên bo mạch thật, đó là điều host enumerate. Ở đây không có host, nên mỗi thư viện in ra Serial những gì nó lẽ ra gửi đi, mỗi thay đổi một dòng trong ngoặc vuông ([Keyboard] press Ctrl, [Joystick] buttons 0 3 | hat 90 | x 512 y 0). Một sketch không dùng thư viện nào trong số đó vẫn là thiết bị CDC thường, và output ở đây vẫn như trước giờ.
Các thư viện viết dựa trên PluggableUSB của core AVR, MIDIUSB là thư viện đầu tiên, tìm PluggableUSB.h, USBAPI.h, USBCore.h và USBDesc.h nằm cạnh arduino.h (được viết từ đặc tả USB 2.0 với tên gọi của core), nên chúng biên dịch và chạy mà không cần thay đổi. Bản thân MIDIUSB được dựng sẵn (firmware/lib/MIDIUSB.h, kèm MIDIUSB_Defs.h và pitchToNote.h), trên Leonardo, Micro và Pro Micro. PluggableUSB().plug() trao cho module các số hiệu interface và endpoint sau cái của cổng CDC giống như core vẫn làm (interface 2, endpoint 4 cho cái đầu tiên), nhưng không có gì hiển thị module đó lên máy chủ, ở đây cũng như trên bo mạch thật: các endpoint của nó không bao giờ được cấu hình, nên USB_Send() trả về -1 giống như của core trước khi được đánh số, USB_Recv() trả về -1 và USB_Available() là 0. Một sketch điều khiển MIDI vẫn chạy, nhưng các nốt nhạc của nó không đi đến đâu: lần sendMIDI() đầu tiên của MIDIUSB báo điều này một lần trên serial monitor ([Mokxi] MIDIUSB: no USB host is simulated, so these MIDI messages go nowhere. ...), còn output Serial của sketch vẫn tiếp tục in quanh đó. Không bảng trình soạn code nào hiển thị các thông điệp này, vì endpoint của module được cắm không bao giờ tới được engine.
Bản thân runtime không bị giới hạn ở stub. firmware/leonardo/src/usb.c là một thiết bị CDC ACM thật (endpoint điều khiển 0, endpoint thông báo 1, bulk OUT 2 và bulk IN 3, descriptor cùng VID và PID của Arduino core, điều khiển bằng ngắt, với thao tác 1200 baud chạm vào Caterina), và nó có trong mọi image. Khi reset nó nhả một bank IN rỗng trên endpoint 3 và đọc lại FIFOCON: silicon giữ bank đó cho tới khi một host đọc, và chưa có host nào reset bus cả, còn mô hình này nhả bank đã release ngay lập tức. Chính một lần đọc đó chốt hẳn chế độ. Ở đây runtime điều khiển đường ống đúng như mô tả ở trên và stack USB đứng im; trên bo mạch nó chạy stack. Một thay đổi mô hình khiến bank đã release bị giữ bận sẽ đẩy mọi sketch Leonardo sang đường phần cứng, nơi Serial không nói gì cho tới khi một host cấu hình thiết bị, nên crates/atmega32u4/src/usb.rs có một test ghim chặt hành vi này.
3.7 ADC
Mười bit, mười bốn kênh, ADCL 0x78, ADCH 0x79, ADCSRA 0x7A, ADCSRB 0x7B, ADMUX 0x7C, DIDR2 0x7D, DIDR0 0x7E, DIDR1 0x7F. Prescaler, ADSC, ADIF, ADIE, ADATE ở chế độ free-running và ADLAR đều hoạt động đúng như mục 3.3 của docs/uno.md mô tả; một lần chuyển đổi là 13 xung ADC, là 25 xung cho lần đầu tiên sau ADEN.
Hai điểm khác với ATmega328P và một điểm khác với ATmega2560:
- Bộ chọn kênh có sáu bit và bit cao nhất của nó,
MUX5, làADCSRBbit 5, not bit 3, which is where an ATmega2560 puts it. - Các kênh trên số bảy không phải là một port thứ hai.
ADC8đếnADC13là PD4, PD6, PD7, PB4, PB5 và PB6, đó là lý do A6 đến A11 trên Arduino Leonardo cũng là chân số 4, 12, 6, 8, 9 và 10. Bo mạch này đưa raA0đếnA5trên header analog; các kênh còn lại được truy cập qua số chân digital. - Ở đây không có tham chiếu 1.1 V.
REFS1:0là 0 choAREF, 1 cho AVCC, 3 cho 2.56 V nội bộ, còn 2 là dành riêng. Bandgap 1.1 V vẫn có sẵn như một kênh tạiMUX5:0= 0x1E.
Kênh tới 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 và ADC3 có trong mux nhưng không được bonding ra trên package này; chọn một trong hai sẽ đọc được 0. Các kênh differential, kênh có khuếch đại và cảm biến nhiệt độ không được mô hình hóa và luôn đọc được 0.
3.8 Ngắt ngoài và ngắt thay đổi chân
EICRA 0x69, EICRB 0x6A, EIMSK 0x3D, EIFR 0x3C, PCICR 0x68, PCIFR 0x3B, PCMSK0 0x6B.
Năm ngắt ngoài và ba chỗ trống: INT0 PD0 (chân 3), INT1 PD1 (chân 2), INT2 PD2 (chân 0), INT3 PD3 (chân 1), INT6 PE6 (chân 7). INT4, INT5 và INT7 là các chỗ dành riêng không có chân nào phía sau; bật chúng lên cũng không bao giờ tạo ngắt. Các bit sense là EICRA cho 0 đến 3 và EICRB cho 4 đến 7, mỗi cái hai bit: 0 mức thấp, 1 mọi cạnh, 2 cạnh xuống, 3 cạnh lên. Ngắt mức thấp giữ trạng thái kích hoạt khi chân đang mức thấp và không đặt cờ.
Một nhóm ngắt thay đổi chân, PCINT0, và nó là toàn bộ port B.
3.9 Ngủ và EEPROM
SMCR 0x53 với bit SE bằng 0, và mọi chế độ ngủ đều hoạt động như idle: xung nhịp CPU dừng, các ngoại vi vẫn chạy, và bất kỳ ngắt nào được bật cũng đưa chip trở lại hoạt động. MCUSR 0x54 báo PORF sau khi reset do cấp nguồn và EXTRF sau khi chân reset bị giữ. WDTCSR là watchdog, giống của Uno (docs/uno.md mục 3.8, vector 12), chỉ khác là, như bootloader Caterina làm, mô hình chip xóa WDRF và dừng watchdog sau một lần reset bởi watchdog, trước setup(). CLKPR, PRR0, PRR1, OSCCAL, RCCTRL, SPMCSR và GPIOR0..2 được lưu và đọc lại.
EEPROM có dung lượng 1 KB tại EECR 0x3F, EEDR 0x40, EEARL 0x41, EEARH 0x42, với EEARH rộng hai bit. Một lệnh đọc hoàn tất ngay lập tức; một lệnh ghi mất 3.3 ms (26,368 chu kỳ của bộ tạo dao động RC 8 MHz; 1.8 ms ở chế độ chỉ xóa hoặc chỉ ghi), trong thời gian đó EEPE đọc được 1, và EERIE phát EE_READY ở mức một khi kết thúc.
3.10 Các vector
Bốn mươi ba vector, cách nhau hai word kể từ địa chỉ word 0, đánh số theo thứ tự ưu tiên. crates/atmega32u4/src/vectors.rs và firmware/leonardo/include/leonardo.h chứa bảng này; điều quan trọng ở đây là các slot 5, 6, 8, 13, 14 và 15 được dành riêng trên phần cứng này, và hai vector USB nằm giữa nhóm pin-change và watchdog, một thứ tự không AVR nào khác ở đây có.
Các vector mà runtime dùng: INT0..INT3 là 1 đến 4, INT6 là 7, PCINT0 là 9, TIMER0_OVF là 23, USART1_RX là 25, ADC là 29, và bốn vector của timer 4 là 38 đến 41.
4. Kênh host
host_write đưa các byte vào endpoint OUT để firmware đọc; host_read lấy các byte firmware đã gửi trên endpoint IN. Đó chính là Serial trong sketch và Serial Monitor trong giao diện. Các byte là UTF-8 theo góc nhìn của giao diện, và mô hình coi chúng là dữ liệu mờ đục.
Serial1 không nằm trên kênh này và sẽ không bao giờ có: nó là hai chân header.
5. Mô hình thời gian và linh kiện
Như mục 5 của docs/uno.md. 16 MHz, một chu kỳ dài đúng 62.5 ns, một slice là 10 us và đúng 160 chu kỳ, và bộ đếm chu kỳ được neo vào thời gian kernel ở đầu mỗi slice. Bên trong một slice, lõi được chạy từng lệnh một với bus được báo chu kỳ mà mỗi lệnh bắt đầu, nên một thay đổi trên chân sẽ kèm theo chu kỳ đã gây ra nó.
probe là một bitmask: 1 đang chạy, 2 đang ngủ, 4 LED L trên bo mạch ở chân 13, 8 USB truyền trong 20 ms cuối, 16 USB nhận. Bằng 0 khi không có chương trình.
poke: 2 giữ RESET, 3 nhả ra.
6. Firmware (firmware/leonardo/)
Một runtime có dạng Arduino được viết từ tài liệu này: setup() và loop(), pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, delayMicroseconds, attachInterrupt, Serial và Serial1. Không có Arduino core, không có avr-libc, không có libc.
Được biên dịch bằng clang --target=avr -mmcu=atmega32u4, link bằng ld.lld với firmware/leonardo/link.ld. Năm tệp của runtime là của Uno, được biên dịch lại cho phần cứng này thay vì sao chép: phần định dạng số, các hàm hỗ trợ toán học, floor độc lập và phần assembly của nó, và Print. Chuỗi program trong catalog là elf32 avr atmega32u4.
Các chân PWM và timer của chúng:
| chân | đầu ra | timer | tần số |
|---|---|---|---|
| 3 | OC0B |
0, fast PWM | 976.5625 Hz |
| 11 | OC0A |
0, fast PWM | 976.5625 Hz |
| 13 | OC4A |
4, phase và frequency correct, TOP = OCR4C |
490.196 Hz |
| 6 | OC4D |
4, phase và 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 là thiết bị USB trong src/usb.c và Serial1 là USART1. mokxi_init() khởi động thiết bị USB trước mọi thứ khác, giống như USBDevice.attach() của Arduino core làm, để bo mạch xuất hiện dưới dạng một cổng serial và nhận thao tác 1200 baud dù sketch có gọi Serial.begin() hay không. Thời gian đợi PLL của nó có giới hạn (10 ms; một PLL không bao giờ khóa thì USB bị tắt), và khoảng một mili-giây nó dành ở đó diễn ra trước khi timer 0 bắt đầu, nên mọi thứ chỉ bị dồn lại cùng nhau. Trên bo mạch thật, các lệnh ghi Serial bị bỏ qua cho đến khi host đã cấu hình thiết bị và một chương trình đã mở cổng, một byte chờ tối đa 250 ms cho host không đọc, và while (!Serial) chờ DTR, tất cả như trong Arduino core. Ảnh firmware mang VID và PID của Leonardo (0x2341:0x8036) cùng các chuỗi; trình nạp ghi lại chúng cho Micro (0x2341:0x8037) hoặc Pro Micro (0x1B4F:0x9206) khi ghi vào bo mạch. Ngăn xếp này tốn khoảng 2 KB flash và chục byte SRAM.
digitalPinToInterrupt: chân 3 là 0, chân 2 là 1, chân 0 là 2, chân 1 là 3, chân 7 là 4. Chân khác là -1.
Bốn ví dụ: blink, button (một công tắc ở chân 7, tức INT6), serial (in ra cả hai cổng để thấy sự khác biệt giữa chúng trên màn hình), và fade (điều khiển chân 13 bằng timer 4 và chân 9 bằng timer 1, để cả hai loại phần cứng PWM chạy cùng lúc). Một ví dụ được cấp 8 KB trong 32 KB flash.
7. Những gì không được mô phỏng
SPI, TWI, bộ so sánh analog, cảm biến nhiệt độ, vùng bootloader và các fuse của nó, bộ chia tần số xung nhịp, PLL và xung nhanh mà nó cấp cho timer 4, các đầu ra bổ sung và bộ tạo dead-time của timer 4, và mọi thứ nằm trên đường ống byte USB được liệt kê ở mục 3.6. Các thanh ghi đó đọc về giá trị reset và được tính là stray.
8. Những gì mô hình này chắc chắn, và những gì thì không chắc
Lấy từ data sheet, và được chạy thử bằng firmware thật. Mọi địa chỉ, vị trí bit và giá trị reset trong mục 3 đều từ ATmega16U4/ATmega32U4 Data Sheet, theo đánh số data-space, gồm cả cửa sổ I/O mở rộng từ 0x60 đến 0xFF quyết định thanh ghi nào IN/OUT truy cập được và thanh ghi nào cần sts. Năm port, các timer 0, 1, 3 và timer 4 mười bit với OCR4C làm TOP, USART1, mười bốn kênh ADC, INT0 đến INT3 và INT6, và nhóm pin-change duy nhất đều theo data sheet. crates/atmega32u4/tests/runtime.rs chạy các ELF blink, serial và fade kèm theo qua các port, cả hai độ rộng timer và đường ống byte USB.
Được mô hình hóa, nhưng không ràng buộc theo các con số trong tài liệu kỹ thuật. Mô phỏng theo hành vi thay vì theo địa chỉ:
- Bộ điều khiển thiết bị USB chỉ là một stub truyền tải byte, đúng như mục 3.6 nói rõ. Không có enumeration, không có trao đổi descriptor, không có cấu hình endpoint, không có tính thời gian SOF, không có suspend hay resume và không có reset bằng cách chạm 1200 baud.
Seriallà một đường ống byte nối tới kênh máy chủ, trả lờiSerialvàSerial.dtr()giống như một cổng CDC đã kết nối. Vì vậy, điều làm nên một Leonardo đúng nghĩa (rằng một sketch có thể chờ mãi mãi vớiwhile (!Serial)) là một quyết định của mô hình này chứ không phải một giao thức mà nó chạy. - Phần còn lại là danh sách của Uno. Nhóm giữa trong mục 7 của
docs/uno.mdáp dụng không đổi: một ADC không có lỗi, xung nhịp 16 MHz chính xác, ba trạng thái pad và một ngưỡng với điện trở pull-up 35 kΩ, nguồn lý tưởng không thể sụt, thời gian khởi động một micro-giây, và một slice 10 us.
Cố ý không có mặt, như mục 7 liệt kê: SPI, TWI, bộ so sánh analog, cảm biến nhiệt, vùng bootloader cùng các fuse của nó, bộ chia tỷ lệ xung nhịp, PLL và xung nhanh mà nó cấp cho timer 4, các ngõ ra bổ sung và bộ tạo thời gian chết của timer 4, và mọi thứ phía trên đường truyền byte USB. Các thanh ghi đó đọc về giá trị reset và được tính là thanh ghi rời.