Đâ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 Raspberry Pi Pico và trang bo mạch.
Vi điều khiển thứ ba, và là vi điều khiển đầu tiên trên engine Cortex-M. Một thành phần kernel (pico trong crates/parts) bọc một mô hình SoC RP2040 (crates/rp2040) dựng trên nhân Cortex-M (crates/cortexm-core, Profile::V6M, được kiểm chứng trong proofs/cortexm/REPORT.md). Firmware là một ELF Thumb giao tiếp với các ngoại vi bên dưới tại đúng địa chỉ RP2040 thật, nên chương trình dựng cho Mokxi cũng chạy được trên Pico thật.
Kiểu trong danh mục là pico (Raspberry Pi Pico, RP2040). Ba tác tử dựng dựa trên tệp này: SoC và linh kiện (Rust), runtime firmware và các ví dụ (C++, clang cho thumbv6m-none-eabi), hình ảnh bo mạch (TypeScript). Chỉ thay đổi bằng cách sửa tệp này trước tiên. Mọi thứ trong docs/esp32c3.md về cách một linh kiện bo mạch hoạt động (slice, host channel, reset, dòng crash) đều áp dụng ở đây trừ khi tệp này nói khác.
Chạy các tệp nhị phân dựng bằng Raspberry Pi Pico SDK không phải mục tiêu của Giai đoạn 4: crt0 của SDK cần bootloader tầng hai, cây clock, XOSC và các PLL. Từ tháng 10 năm 2026 có một cách thứ hai để nạp chip, full boot, dành cho MicroPython (docs/micropython.md): một UF2 trong flash 2 MB đã xóa, boot ROM (crates/rp2040/src/rom.rs, viết theo mục 2.8 của datasheet), tầng hai chạy từ SRAM5, và cây clock, SSI cùng chip flash, bộ điều khiển USB, RTC cùng phần còn lại được ánh xạ (sysregs.rs, ssi.rs, usb.rs), và từ giai đoạn 3 của Python là các khối I2C, SPI và DMA (i2c.rs, spi.rs, dma.rs) mà machine.I2C và machine.SPI của MicroPython điều khiển. Mọi thứ trong tệp này mô tả đường ELF, vốn không thay đổi: không khối nào trong số đó được ánh xạ cho ELF, và Wire cùng SPI của một sketch Arduino vẫn là các bus phần mềm của firmware/lib/ trên các chân thường. Những gì được mô hình hóa là tập ngoại vi mà pinMode, digitalWrite, digitalRead, analogWrite, millis, micros, delay, Serial và attachInterrupt cần, tại địa chỉ thật của chúng, nên cùng mã nguồn dựng với firmware/pico/ tạo ra ảnh cũng chạy được trên phần cứng.
1. Chân bo mạch (thứ tự trong danh mục)
Header 40 chân, nhìn từ trên với cổng USB ở phía trên. Cột bên trái là các chân vật lý 1..20 đọc từ trên xuống; cột bên phải là các chân vật lý 40..21 đọc từ trên xuống, đúng cách các chân thẳng hàng khi cầm bo mạch theo hướng đó.
Cột trái (chân 1..20): GP0, GP1, GND, GP2, GP3, GP4, GP5, GNDb, GP6, GP7, GP8, GP9, GNDc, GP10, GP11, GP12, GP13, GNDd, GP14, GP15.
Cột phải (chân 40..21): VBUS, VSYS, GNDe, 3V3_EN, 3V3, ADC_VREF, GP28, AGND, GP27, GP26, RUN, GP22, GNDf, GP21, GP20, GP19, GP18, GNDg, GP17, GP16.
40 chân. Các tên trùng nhau mang hậu tố chữ vì tên chân trong danh mục là duy nhất; bo mạch in lụa GND trên cả bảy chân và AGND trên chân 33. Ba điểm đo (TP1..TP6) và header SWD không phải là chân.
Điện:
3V3cấp 3.3 V với trở khángR_SUPPLYvà mọiGND*cùngAGNDcấp 0 V vớiR_SUPPLY.VBUScấp 5 V vớiR_SUPPLYvàVSYScấp 4.7 V (5 V qua diode Schottky mà bo mạch có giữa chúng), vì bo mạch luôn được cấp nguồn qua USB.ADC_VREFcấp 3.3 V qua điện trở 200 R, đó là điện áp tham chiếu đã lọc mà bo mạch đưa ra. Bo mạch là nguồn cấp cho phần còn lại của mạch.3V3_ENlà ngõ vào với điện trở kéo lên 100 k vềVSYS; kéo xuống dưới 1.2 V sẽ tắt bộ ổn áp, làm chip dừng lại và nhả mọi pad. Đó là điều duy nhất nó làm ở đây.RUNlà ngõ vào với điện trở kéo lên bên trong 50 k về 3.3 V; khi bị kéo xuống dưới 1.65 V nó giữ CPU trong trạng thái reset, và nhả ra thì khởi động lại từ bảng vector.GP0..GP22,GP26..GP28là GPIO hai chiều. Khi bật ngõ ra (bitSIO.GPIO_OEđược đặt và chức năng được chọn là SIO hoặc PWM): push-pull ở 3.3 V hoặc 0 V quaR_STRONG. Khi tắt ngõ ra: trở kháng cao, cộng với điện trở kéo lên 55 k về 3.3 V khiPADS_BANK0.GPIOn.PUEđược đặt, kéo xuống 55 k khiPDEđược đặt (đặt cả hai là bus-keeper, mô hình hóa là trở kháng cao). Ngõ vào đọc điện áp trên đường nối so với 1.65 V; Unknown đọc là 0, và ngõ vào bị treo đọc nhiễu, như trên Uno (docs/uno.mdmục 1).PADS_BANK0.GPIOn.ODtắt trình điều khiển ngõ ra bất kể ngoại vi được chọn yêu cầu gì, vàIEbị xóa khiến ngõ vào đọc 0. Một pad RP2040 không có chế độ open-drain; trình điều khiển nào muốn chế độ này thì kéo mức thấp và chuyển sang ngõ vào cho mức cao.GP23,GP24vàGP25tồn tại trong mô hình nhưng không có trên header, như trên bo mạch thật:GP23là điều khiển power-save của SMPS,GP24là chân cảm biến VBUS (đọc là 1, vì mô hình luôn được cấp nguồn qua USB) vàGP25là LED xanh lá trên bo mạch. LED được hiển thị từ một bit probe (mục 5), và pad mang tải 1 k xuống mass để điện áp được chính xác.GP26,GP27vàGP28làADC0..ADC2, và ADC được mô hình hóa (mục 5a):analogRead(26)đọc điện áp trên đường nối.ADC_VREFlà điện áp tham chiếu 3.3 V của bộ chuyển đổi vàAGNDlà một chân đất.GP0/GP1là UART0 TX/RX trên bo mạch thật. Ở đây UART0 nói chuyện với host channel (mục 4) và hai pad vẫn là GPIO, giống hệt cáchdocs/esp32c3.mdlàm.
2. Bản đồ bộ nhớ (địa chỉ thật của RP2040)
| vùng | địa chỉ | kích thước | ghi chú |
|---|---|---|---|
| ROM | 0x0000_0000 |
16 KB | không mô hình hóa cho ELF: đọc 0, ghi bị bỏ qua nhưng được đếm (toàn bộ quá trình khởi động ánh xạ rom.rs) |
| XIP flash | 0x1000_0000 |
tối đa 2 MB | ảnh chương trình; chỉ đọc với nhân |
| SRAM (sọc) | 0x2000_0000 |
256 KB | SRAM0..SRAM3, bốn bank xen kẽ theo word |
| SRAM4 | 0x2004_0000 |
4 KB | |
| SRAM5 | 0x2004_1000 |
4 KB | |
| RESETS | 0x4000_C000 |
4 KB | mục 3.1 |
| IO_BANK0 | 0x4001_4000 |
4 KB | mục 3.2 |
| PADS_BANK0 | 0x4001_C000 |
4 KB | mục 3.3 |
| UART0 | 0x4003_4000 |
4 KB | mục 3.5 |
| UART1 | 0x4003_8000 |
4 KB | mục 3.5a |
| PWM | 0x4005_0000 |
4 KB | mục 3.6 |
| TIMER | 0x4005_4000 |
4 KB | mục 3.4 |
| SIO | 0xD000_0000 |
4 KB (không phải APB) | mục 3.7 |
| PPB | 0xE000_0000 |
1 MB | SysTick, NVIC và SCB, nằm trong nhân |
SRAM có dung lượng 264 KB và liền tục từ 0x2000_0000 đến 0x2004_2000. Việc chia dải SRAM0..SRAM3 chỉ là chi tiết phân xử bus, không ảnh hưởng gì tới phần mềm khi chỉ có một nhân, nên mô hình là một mảng phẳng; 0x2100_0000 và 0x2110_0000, các bí danh không chia dải của cùng các bank đó, không được ánh xạ, và cửa sổ bảo trì cache XIP 0x4002_0000 cũng không. Bất kỳ địa chỉ nào ngoài vùng được ánh xạ đều gây bus fault, mà trên ARMv6-M sẽ leo cấp thành HardFault; linh kiện đếm số lỗi và báo cáo sự cố (mục 5). Một thanh ghi chưa được triển khai bên trong một khối đã ánh xạ thì đọc ra 0 và bỏ qua ghi, kèm bộ đếm để chẩn đoán.
Mỗi khối ngoại vi APB còn có địa chỉ bí danh tại +0x1000 (XOR nguyên tử), +0x2000 (set nguyên tử) và +0x3000 (clear nguyên tử), đây là cách firmware RP2040 set một bit mà không cần đọc-sửa-ghi. Mô hình triển khai cả ba cho mọi ngoại vi mà nó hỗ trợ. SIO không phải khối APB và không có bí danh, giống như trên chip.
ELF firmware. loadProgram nhận một tệp thực thi ARM ELF32 little-endian (e_machine 40). Mỗi phân đoạn PT_LOAD phải nằm trọn trong flash XIP hoặc SRAM; .data được nạp tại p_paddr của nó (trong flash) và crt0 của runtime sao chép xuống, giống như trên phần cứng. Không có bootloader cấp hai: mô hình không yêu cầu, không chạy và không kiểm tra checksum khối boot2, và một section .boot2 256 byte trong ảnh chỉ đơn giản được nạp và không bao giờ chạy. Reset lấy bảng vector tại địa chỉ flash thấp nhất đã nạp: VTOR được đặt tại đó, SP_main lấy từ word 0 và điểm vào từ word 1, đúng như bộ xử lý làm ngay sau reset. Giá trị e_entry của ELF không được dùng; bắt buộc phải có bảng vector. Nạp lúc đang chạy sẽ reset bo mạch.
3. Thanh ghi ngoại vi (tập con, offset thật, vị trí bit thật)
Thanh ghi dài 32 bit và căn theo word. Truy cập byte hoặc halfword vào thanh ghi ngoại vi không được hỗ trợ (đọc trả về word đã căn bị thu hẹp, ghi ghi nguyên cả word từ giá trị hẹp); firmware không được làm vậy. SRAM và flash chấp nhận mọi độ rộng.
3.1 RESETS (0x4000_C000)
| offset | tên | bit |
|---|---|---|
0x00 |
RESET |
1 = khối bị giữ ở trạng thái reset |
0x04 |
WDSEL |
được lưu, đọc lại được |
0x08 |
RESET_DONE |
1 = khối đã thoát khỏi reset và sẵn sàng |
Đánh số bit theo datasheet: 5 io_bank0, 8 pads_bank0, 14 pwm, 21 timer, 22 uart0, 23 uart1. RESET_DONE là giá trị đảo của RESET, không có độ trễ: một khối ra khỏi trạng thái reset ngay khi bit của nó được xóa, nên vòng lặp quen thuộc while (!(resets_hw->reset_done & bits)) sẽ chạy xuyên qua luôn. Khi ra khỏi reset, mọi khối ở đây đều đọc về giá trị khởi tạo lúc cấp nguồn; giữ một khối trong trạng thái reset sẽ đưa nó về các giá trị đó, và khi io_bank0 hoặc pads_bank0 bị giữ thì mọi pad đều ở trạng thái trở kháng cao. Các khối mà mô hình chưa triển khai vẫn nhận bit của chúng và báo đã hoàn tất.
3.2 IO_BANK0 (0x4001_4000)
| offset | tên | bit |
|---|---|---|
0x00 + 8n |
GPIOn_STATUS |
bit 8 OUTTOPAD, bit 13 OETOPAD, bit 17 INFROMPAD, chỉ đọc |
0x04 + 8n |
GPIOn_CTRL |
các bit 4..0 FUNCSEL, 9..8 OUTOVER, 13..12 OECOVER, 17..16 INOVER |
0x0F0 + 4m |
INTRm |
ngắt thô cho các GPIO 8m..8m+7, mỗi ngắt bốn bit |
0x100 + 4m |
PROC0_INTEm |
cho phép, cùng bố cục |
0x110 + 4m |
PROC0_INTFm |
ép buộc, cùng bố cục |
0x120 + 4m |
PROC0_INTSm |
thô AND cho phép, OR ép |
FUNCSEL: 4 = PWM, 5 = SIO, 31 = NULL (pad được nhả ra). Các giá trị khác (SPI 1, UART 2, I2C 3, PIO0 6, PIO1 7, clocks 8, USB 9) được chấp nhận, lưu và đọc lại được, nhưng để pad ở trạng thái nhả, vì những ngoại vi đó không được mô phỏng. Giá trị khởi động là 31 trên mọi chân, như trên chip, nên firmware phải chọn SIO trước khi pad hoạt động, và firmware/pico/ làm vậy.
OUTOVER/OEOVER: 0 = tín hiệu của ngoại vi, 1 = đảo, 2 = kéo thấp (OEOVER 2 = tắt), 3 = kéo cao (OEOVER 3 = bật). INOVER cũng có bốn giá trị như vậy cho đầu vào.
Bốn bit ngắt cho mỗi GPIO là 0 LEVEL_LOW, 1 LEVEL_HIGH, 2 EDGE_LOW, 3 EDGE_HIGH. Bit cạnh được chốt và xóa bằng cách ghi 1 vào chúng trong INTRm; bit mức theo pad và không thể xóa. Bất kỳ bit nào được set trong PROC0_INTSm sẽ kích hoạt IO_IRQ_BANK0 (IRQ 13).
3.3 PADS_BANK0 (0x4001_C000)
| offset | tên | bit |
|---|---|---|
0x00 |
VOLTAGE_SELECT |
được lưu, đọc lại được |
0x04 + 4n |
GPIOn |
0 SLEWFAST, 1 SCHMITT, 2 PDE, 3 PUE, 4..5 DRIVE, 6 IE, 7 OD |
Khởi động là IE bằng 0, PUE bằng 0, PDE bằng 1, SCHMITT bằng 1, DRIVE = 1 (4 mA) trên mọi pad, đúng như datasheet ghi. IE bằng 0 khiến đầu vào đọc 0 bất kể đường nối đang thế nào; OD bằng 1 nhả pad bất kể ngoại vi đang chọn yêu cầu gì; DRIVE và SLEWFAST được lưu và đọc lại nhưng không thay đổi trở kháng nguồn, luôn luôn là R_STRONG.
3.4 TIMER (0x4005_4000)
Một bộ đếm 64 bit theo microsecond và bốn bộ báo thức 32 bit. Đây là đồng hồ của linh kiện: micros() và millis() đọc nó còn delay() ngủ chờ một bộ báo thức.
| offset | tên | bit |
|---|---|---|
0x00 0x04 |
TIMEHW TIMELW |
chỉ ghi, ghi có chốt toàn bộ bộ đếm |
0x08 |
TIMEHR |
word cao, được chốt bởi lần đọc TIMELR gần nhất |
0x0C |
TIMELR |
word thấp; đọc nó sẽ chốt word cao vào TIMEHR |
0x10 + 4n |
ALARMn |
n = 0..3; ghi sẽ kích hoạt nó, ghi cũng xóa bit INTR của nó |
0x20 |
ARMED |
bit n = báo động n đã được kích hoạt; ghi 1 để hủy kích hoạt |
0x24 0x28 |
TIMERAWH TIMERAWL |
bộ đếm không chốt |
0x2C |
DBGPAUSE |
được lưu, đọc lại được |
0x30 |
PAUSE |
bit 0 dừng bộ đếm |
0x34 |
INTR |
bit n = báo thức n đã kích hoạt; ghi 1 để xóa |
0x38 0x3C 0x40 |
INTE INTF INTS |
cho phép, ép buộc và raw AND cho phép OR ép buộc |
Bộ đếm được suy ra từ thời gian của nhân: microseconds = (now_ps - origin_ps) / 1_000_000, với mốc gốc cố định tại slice đầu tiên. Nó không bao giờ lệch khỏi mạch. Một bộ báo thức kích hoạt khi 32 bit thấp của bộ đếm đạt giá trị đã đặt, tự gỡ và set bit INTR của nó; bit n của INTS kích hoạt TIMER_IRQ_n (IRQ 0..3). Ghi vào bộ báo thức cũng xóa bit INTR của nó. Bộ so sánh chỉ nhìn thấy 32 bit thấp, nên bộ báo thức được đặt tại một giá trị vừa mới trôi qua sẽ không kích trong 71,6 phút, đúng như trên phần cứng, và vì vậy firmware/pico/ đọc lại đồng hồ sau khi đặt và trước khi dừng.
3.5 UART0 (0x4003_4000)
Một PL011. Đây là kênh host; các pad không liên quan.
| offset | tên | bit |
|---|---|---|
0x00 |
UARTDR |
ghi: phát; đọc: nhận (8 bit thấp, các bit lỗi đọc 0) |
0x04 |
UARTRSR |
đọc 0 |
0x18 |
UARTFR |
3 BUSY, 4 RXFE, 5 TXFF, 6 RXFF, 7 TXFE |
0x24 0x28 |
UARTIBRD UARTFBRD |
baud = 125 MHz / (16 (IBRD + FBRD/64)); được lưu và dùng để điều nhịp TX |
0x2C |
UARTLCR_H |
được lưu; bit 4 FEN bật các FIFO (xóa nó sẽ xả sạch các FIFO) |
0x30 |
UARTCR |
0 UARTEN, 8 TXE, 9 RXE |
0x34 |
UARTIFLS |
được lưu, đọc lại được |
0x38 |
UARTIMSC |
4 RXIM, 5 TXIM, 6 RTIM |
0x3C 0x40 |
UARTRIS UARTMIS |
trạng thái ngắt thô và đã che |
0x44 |
UARTICR |
ghi 1 để xóa |
0x48 |
UARTDMACR |
được lưu, đọc lại được |
Cả hai FIFO đều 32 ô, như trên chip thật, và chỉ sâu 1 ô khi FEN bị xóa. Các byte TX rời FIFO vào kênh máy chủ ở tốc độ baud đã cấu hình (một divisor chưa được lập trình sẽ dùng 115200: một byte, mười bit, mỗi 86.8 us) và BUSY được set khi còn byte nào đang ra; ghi vào TX FIFO đã đầy sẽ bị bỏ, đúng như phần cứng thật làm. Các byte RX đến từ kênh máy chủ tức thì. RXRIS được bật khi RX FIFO bằng hoặc vượt mức kích hoạt (một nửa, giá trị reset của UARTIFLS, tức 16 ô) và RTRIS khi RX có bất kỳ dữ liệu nào mà không còn byte nào đến trong 32 bit time, nên một driver chờ ở bất kỳ tín hiệu nào cũng thấy được một ký tự gõ đơn lẻ. Bất kỳ bit nào được set trong UARTMIS đều nâng UART0_IRQ (IRQ 20).
Phía sau FIFO nhận là một bộ đệm 256 byte của máy chủ, thứ không phải phần cứng: nó chảy vào FIFO khi chương trình làm rỗng FIFO, nên dán một dòng vào serial monitor khi sketch đang ở giữa hai lần gọi Serial.read() sẽ không mất ký tự. Mô hình Uno cũng có thứ tương tự vì lý do tương tự. Bộ đệm này nếu cũng đầy thì sẽ bỏ dữ liệu, giống như một lần tràn bộ đệm thật.
3.5a UART1 (0x4003_8000)
PL011 kia, với các thanh ghi của UART0 tại các offset của UART0, và được ánh xạ ở mỗi lần khởi động. Khác với UART0, nó được nối tới các pad của nó chứ không phải kênh máy chủ, nên nó là Serial2 trong runtime Arduino và machine.UART(1) trong MicroPython, nói chuyện với bất cứ thứ gì được nối vào các chân của nó: một module GPS, một HC-05, RX và TX của một bo mạch khác. Các khung của nó ra và vào từng bit một qua frame engine mà UART1 và UART2 của ESP32 dùng (crates/esp-common/src/wire_uart.rs):
- Chân. Một GPIO thuộc về UART1 khi
FUNCSELcủa nó là 2 (UART) và nó là một trong các chân 4 đến 11 hoặc 20 đến 27 (datasheet 2.19.2); vớin % 4bằng 0 làTX, 1 làRX. Vậy GP4/GP5, GP8/GP9, GP20/GP21 và GP24/GP25 là các cặp của nó.TXluôn được điều khiển, ở mức cao khi nhàn rỗi;RXlà ngõ vào;CTSvàRTSkhông được mô phỏng. Cùng chức năng đó trên một chân UART0 không điều khiển gì cả (UART0 là kênh máy chủ). - Truyền. Một byte ghi vào
UARTDRbắt đầu khung của nó ngay khi bộ dịch chuyển bit rảnh, với chu kỳ bit mà divisor cho ra,16 (IBRD + FBRD/64)chu kỳ, và mỗi lần đổi mức đến pad ngay tại chu kỳ nó xảy ra.LCR_Hcho biết khung:WLENnăm đến tám bit,PENcùngEPS,STP2. Không có gì được truyền ra khiUARTENhoặcTXEbị xóa. - Nhận. Mức của pad
RXđược lấy đúng như linh kiện bo mạch báo, tại thời điểm nó mô tả. Sườn xuống trên đường nhàn bắt đầu một khung, mỗi bit được lấy mẫu ở giữa khe của nó và byte được chốt tại giữa bit dừng, nên tốc độ baud lệch sẽ đọc ra rác ở đây như trên bàn thật.RTRISđược nâng lên sau 32 chu kỳ bit kể từ byte cuối khi FIFO chưa rỗng. - FIFO và các cờ. Mỗi FIFO 32 mục với
FEN, một FIFO không có, giống như trên UART0;UARTFR,UARTRIS,UARTMISvàUARTICRnhư mục 3.5. Bất kỳ bit nào được đặt trongUARTMISsẽ kích hoạtUART1_IRQ(IRQ 21).
Serial2.begin() của runtime Arduino đặt GP4 và GP5 (hoặc các chân mà setTX() và setRX() chọn) sang chức năng UART và bật pull-up của RX, nên một cổng không nối dây gì sẽ đọc được đường truyền đang ở trạng thái nhàn.
3.6 PWM (0x4005_0000)
Tám slice, mỗi slice hai kênh. GPIO n là kênh A của slice (n / 2) % 8 khi n chẵn và kênh B khi lẻ, vậy GP25, LED trên bo mạch, là slice 4 kênh B.
| offset | tên | bit |
|---|---|---|
0x00 + 0x14 s |
CHs_CSR |
0 EN, 1 PH_CORRECT, 2 A_INV, 3 B_INV, 5..4 DIVMODE, 6 PH_RET, 7 PH_ADV |
0x04 + 0x14 s |
CHs_DIV |
11..4 phần nguyên, 3..0 phần thập phân: bộ đếm bước một lần mỗi DIV/16 xung hệ thống |
0x08 + 0x14 s |
CHs_CTR |
bộ đếm, 16 bit; ghi được |
0x0C + 0x14 s |
CHs_CC |
15..0 so sánh kênh A, 31..16 kênh B |
0x10 + 0x14 s |
CHs_TOP |
15..0 giá trị wrap; reset 0xFFFF |
0xA0 |
EN |
bit s bật slice s, cùng bit với CSR.EN của nó |
0xA4 0xA8 0xAC 0xB0 |
INTR INTE INTF INTS |
ngắt wrap cho mỗi slice |
Ngõ ra của một kênh ở mức cao khi CTR < CC và thấp từ CTR == CC đến điểm wrap, nên CC = 0 luôn thấp và CC > TOP luôn cao. Đó là lý do analogWrite(pin, 255) đặt CC thành TOP + 1 thay vì TOP. A_INV và B_INV đảo ngõ ra. Ngõ ra đến pad bất cứ khi nào FUNCSEL của GPIO đó là 4: khối PWM tự điều khiển output enable của pad, nên chương trình chỉ cần chọn chức năng là đủ, SIO.GPIO_OE không được tham chiếu.
DIVMODE 0 (free-running) được mô phỏng. Các chế độ 1..3 đếm được khóa cổng hay kích hoạt từ chân B, cần một tín hiệu vào mà mô hình không định tuyến tới, nên chúng được chấp nhận và lưu nhưng đếm như free-running. PH_CORRECT không được mô phỏng: một slice có bit này được đặt vẫn đếm trailing-edge, làm chu kỳ của nó giảm một nửa. Bất kỳ bit nào được đặt trong INTS đều kích hoạt PWM_IRQ_WRAP (IRQ 4).
3.7 SIO (0xD000_0000)
I/O một chu kỳ: GPIO mà lõi thực sự ghi, cộng với bộ chia phần cứng.
| offset | tên | bit |
|---|---|---|
0x000 |
CPUID |
đọc ra 0: lõi 0 là lõi duy nhất (mục 5) |
0x004 |
GPIO_IN |
bit n = mức ngõ vào của GPIO n (cần PADS.IE) |
0x008 |
GPIO_HI_IN |
sáu pad QSPI; đọc ra 0 |
0x010 0x014 0x018 0x01C |
GPIO_OUT _SET _CLR _XOR |
mức ngõ ra, bit 0..29 |
0x020 0x024 0x028 0x02C |
GPIO_OE _SET _CLR _XOR |
cho phép ngõ ra, bit 0..29 |
0x030..0x04C |
GPIO_HI_OUT/_OE và các bí danh của chúng |
được lưu; không đệm |
0x050 |
FIFO_ST |
đọc ra 2 (RDY set, VLD xóa): lõi 1 không bao giờ đáp |
0x054 0x058 |
FIFO_WR FIFO_RD |
lệnh ghi bị hủy, lệnh đọc trả về 0 |
0x05C |
SPINLOCK_ST |
bit n = spinlock n đang được giữ |
0x060..0x078 |
DIV_UDIVIDEND DIV_UDIVISOR DIV_SDIVIDEND DIV_SDIVISOR DIV_QUOTIENT DIV_REMAINDER DIV_CSR |
bộ chia phần cứng |
0x100 + 4n |
SPINLOCKn |
đọc để nhận (0 khi đã bị giữ), ghi để nhả |
The divider completes immediately: a read of DIV_CSR always shows READY
(bit 0) set, and DIRTY (bit 1) is set by writing an operand and cleared by
reading DIV_REMAINDER. Division by zero gives the hardware's answer (quotient
all ones for unsigned, +/-1 for signed by the dividend's sign, remainder the
dividend). Reading DIV_QUOTIENT before DIV_REMAINDER is the SDK's order and
both are readable in any order here. The interpolators (INTERP0/INTERP1 at
0x080 and 0x0C0) are not modeled: they read 0.
3.8 Ngắt
NVIC, SysTick và SCB nằm trong cortexm-core tại các địa chỉ PPB kiến trúc của chúng; bus không bao giờ thấy chúng. ARMv6-M cho hai bit ưu tiên và 32 đường ngắt ngoài. Các đường mà mô hình này điều khiển:
| IRQ | tên | được nâng bởi |
|---|---|---|
| 0..3 | TIMER_IRQ_0..3 |
bit n của TIMER.INTS |
| 4 | PWM_IRQ_WRAP |
PWM.INTS khác 0 |
| 13 | IO_IRQ_BANK0 |
bất kỳ IO_BANK0.PROC0_INTS* nào khác 0 |
| 20 | UART0_IRQ |
UART0.UARTMIS khác không |
Mỗi tín hiệu là một mức, giữ cao chừng nào trạng thái của ngoại vi còn như vậy, nên một trình xử lý không xóa nguồn sẽ bị gọi lại, đúng như trên phần cứng. Mọi số IRQ khác đều tồn tại trong NVIC nhưng không bao giờ được kích hoạt.
WFI cho core dừng lại cho đến khi có ngắt nào được bật đang chờ xử lý (mục 5). WFE hoạt động tương tự, cộng thêm thanh ghi sự kiện mà kiến trúc định nghĩa; SEV được chấp nhận và đặt thanh ghi đó.
3.9 WATCHDOG (0x4005_8000) và PSM.WDSEL (0x4001_0000)
CTRL (ENABLE, TRIGGER, các bit pause được lưu, TIME là bộ đếm), LOAD, REASON, SCRATCH0..7 và TICK (được lưu; tick là một microgiây bất kể nó giữ giá trị nào). Bộ đếm giảm hai đơn vị mỗi microgiây, đây là lỗi silic RP2040-E1 và là lý do SDK nạp ms * 2000. Khi về 0, hoặc khi có TRIGGER, REASON cho biết TIMER hoặc FORCE và, nếu PSM.WDSEL chọn core 0 (SDK chọn tất cả trừ các bộ dao động), chip khởi động lại với đồng hồ của mạch vẫn chạy: REASON và các thanh ghi scratch vẫn còn và watchdog tắt. Runtime cung cấp hardware/watchdog.h của SDK và rp2040.wdt_begin(), wdt_reset(), reboot(), restart() của arduino-pico trên các thanh ghi này. Việc boot ROM nhảy đến pc của watchdog_reboot() không được mô phỏng: khởi động lại sẽ chạy chương trình từ đầu.
4. Kênh host
host = "các byte UTF-8 trên UART0". readHost trả về các byte TX của UART0 khi chúng rời FIFO ở tốc độ baud đã cấu hình; writeHost đẩy byte vào FIFO RX của UART0 (tràn thì bỏ, như trên chip). Serial Monitor hiển thị byte dạng văn bản, giải mã UTF-8 và coi \n là kết thúc dòng (\r bị bỏ qua). Cùng ngữ nghĩa với kênh ESP32-C3.
5. Mô hình thời gian và linh kiện
Một core ở 125 MHz. SoC chạy theo lát 10 us = 1250 chu kỳ, với bộ đếm chu kỳ của core làm đồng hồ: cortexm-core tính đúng số chu kỳ theo datasheet cho mỗi lệnh, nên thời gian mô phỏng là số chu kỳ chia cho 125 MHz. Bộ đếm chu kỳ được neo vào thời gian kernel ở đầu mỗi lát, giống cách mô hình ATmega328P neo bộ đếm của nó, nên timer không bao giờ lệch khỏi mạch dù các lát rơi vào đâu.
Core thứ hai không được mô phỏng. SIO.CPUID đọc được 0, FIFO giữa hai core vĩnh viễn rỗng và không bao giờ sẵn sàng đọc, và không có cách nào khởi động core 1: chương trình ghi chuỗi khởi động vào FIFO_WR rồi chờ phản hồi sẽ chờ mãi mãi. proofs/cortexm/REPORT.md đo được core duy nhất ta có ở mức 0,85x một RP2040 125 MHz thật trong trình duyệt, nên thêm một core thông dịch nữa sẽ giảm một nửa; đây là quyết định của Phase 5, không phải thiếu sót của Phase 4 cần bị che giấu. Mọi thứ trong firmware/pico/ đều đơn core.
Hai bánh răng. Khác với mô hình Uno, core không được chạy từng lệnh một mọi lúc: không đủ dư địa cho việc đó. Một lát được chạy theo cụm 128 chu kỳ (1,024 us), giới hạn sai số của mốc thời gian gắn trên một thay đổi chân; vài thay đổi trong cùng một cụm giữ đúng thứ tự và được trải đều trên cụm nên không bao giờ trùng nhau. Một cụm bị cắt đúng tại chu kỳ của sự kiện ngoại vi định thời kế tiếp (báo thức timer, sườn PWM, một byte UART rời đi), nên chúng rơi đúng chu kỳ của mình và micros() chính xác.
Một lệnh ghi thay đổi SIO.GPIO_OUT hoặc SIO.GPIO_OE (qua bất kỳ alias nào của chúng) sẽ chuyển sang tốc độ mịn trong rp2040::FINE_CYCLES kế tiếp (12.500 chu kỳ, 100 us): mỗi cụm một lệnh, nên mỗi thay đổi chân mang theo chu kỳ của lệnh store gây ra nó. Đó là điều một giao thức bit-banged cần; mức cao ngắn của một bit WS2812 là 0,4 us, và mokxi_ws2812.h điều khiển dải LED theo cách đó (mô hình Uno R4 cũng có cùng hai tốc độ). Lệnh store bật chế độ này vẫn được đóng mốc trong cụm thô của nó, nên driver cần quan tâm sẽ thực hiện một lệnh trước.
Sleep cho nghỉ hẳn. WFI dừng việc chạy theo lát: linh kiện lên lịch thức dậy kế tiếp vào thời điểm sớm nhất trong các báo thức timer đã kích hoạt, sườn PWM kế tiếp trên một pad đang điều khiển và sự kiện UART kế tiếp, và một thay đổi chân hay một byte từ host đánh thức nó ngay. Một sketch rảnh chỉ tốn của kernel vài sự kiện mỗi giây thay vì 125 triệu chu kỳ, đó là toàn bộ lý do delay() trong runtime ngủ.
Các lệnh đọc SIO.GPIO_IN thấy mức chân như tại thời điểm bắt đầu của đoạn, cộng với mọi thay đổi mà chính sketch gây ra trong đoạn đó.
Que đo: một bitmask, bằng 0 khi không có chương trình.
| bit | ý nghĩa |
|---|---|
| 1 | đang chạy (đang thực thi, không ở trạng thái reset, không bị treo) |
| 2 | đang dừng trong WFI |
| 4 | LED trên bo mạch ở chân GP25 sáng |
| 8 | truyền serial trong 20 ms gần nhất |
| 16 | nhận serial trong 20 ms gần nhất |
Poke: 1 = nhấn BOOTSEL, 0 = nhả (mô hình không có chức năng nút bootsel: nhấn chỉ làm sáng hình hiển thị, vì BOOTSEL được đọc qua pad chip-select của QSPI, phần này không được mô phỏng); 2 = giữ RUN ở mức thấp, 3 = nhả.
Xử lý treo (crash) như trong mục 5 của docs/esp32c3.md. Trên ARMv6-M mọi lỗi đều là HardFault, và lỗi xảy ra ở mức ưu tiên HardFault là Lockup, được cortexm-core báo về dưới dạng Trap::Lockup. Linh kiện dừng lại khi gặp Trap (một Lockup hoặc BKPT khi không có trình gỡ lỗi) và in một dòng trên kênh của máy chủ:
firmware crashed at pc=0x100002a4, lockup in exception 3
5a. Bộ ADC
crates/rp2040/src/adc.rs, at 0x4004_C000 (datasheet section 4.9): one
12-bit converter behind a five-way mux, inputs 0 to 3 on GP26 to GP29 and
input 4 on the temperature sensor. CS.EN, CS.TS_EN, CS.AINSEL,
CS.START_ONCE (CS.READY 2 us later, 96 clocks of the 48 MHz ADC clock),
CS.START_MANY and RESULT are modeled. The reference is 3.3 V, so a count is
volts / 3.3 * 4096, rounded and held to 0..4095; a pin with nothing on it
reads 0. The temperature sensor gives the datasheet's 0.706 V, which is 27 C,
while TS_EN is set. The board part hands the ADC the net voltage on the four
pins every time it samples its inputs.
Phần runtime (firmware/pico/src/gpio.c) làm giống arduino-pico: analogRead() chỉ nhận GP26 đến GP29 (A0 đến A3) và không nhận chân khác, chuyển pad sang bộ chuyển đổi (không có điện trở kéo, không có ngõ vào số), và trả về mười bit trừ khi analogReadResolution() yêu cầu độ rộng khác; analogReadTemp() đọc ngõ vào 4 theo công thức trong datasheet.
Chưa mô phỏng: FIFO và DMA, cơ chế round robin, ngắt của ADC, nhịp pacing của DIV, nhiễu khi chuyển đổi và tải của ngõ vào lên nguồn tín hiệu.
6. Những gì chưa được mô phỏng
PIO, DMA, SPI, I2C, bộ điều khiển USB, RTC, cây đồng hồ (CLOCKS, XOSC, PLL_SYS, PLL_USB: đồng hồ hệ thống là 125 MHz ngay từ lúc reset), các pad QSPI và giao diện flash ngoài việc đọc image, lõi thứ hai, ROM trên chip cùng bảng hàm của nó, và các bộ nội suy. Các khối địa chỉ của chúng không được ánh xạ, nên chạm vào một khối sẽ gây lỗi bus thay vì lặng lẽ trả về số 0 (một bo mạch MicroPython, khởi động đầy đủ, sẽ ánh xạ I2C, SPI và DMA: mục 3 trong docs/micropython.md). Ngoại lệ là các khối được liệt kê ở mục 3, nơi một thanh ghi chưa được triển khai bên trong một khối đã triển khai sẽ đọc được giá trị 0 và được đếm.
7. Môi trường chạy firmware (firmware/pico/)
Một thời gian chạy C và C++ độc lập cho RP2040, được dựng bằng clang 18 (--target=thumbv6m-none-eabi -mcpu=cortex-m0plus -mthumb -Os) và ld.lld, không dùng Pico SDK, không newlib, không libgcc hay compiler-rt, không có gì thuộc GPL:
crt0.S: bảng vector (16 mục hệ thống cộng 32 IRQ),Reset_Handler(sao chép.datatừ flash, xóa.bss, chạy các constructor C++, gọimain), và các hàm hỗ trợ AEABI mà Cortex-M0+ cần vì nó không có lệnh chia và không có phép nhân dài:__aeabi_uidiv,__aeabi_uidivmod,__aeabi_idiv,__aeabi_idivmod,__aeabi_lmul,__aeabi_llsr,__aeabi_llslcùng các hàm hỗ trợ bộ nhớ.link.ld:.textvà.rodatanằm trong flash XIP tại0x1000_0000,.datavà.bssnằm trong SRAM tại0x2000_0000, stack đi từ đỉnh SRAM (0x2004_2000) xuống. Không cóboot2.include/rp2040.h: các thanh ghi của mục 3 dưới dạng macro với tên thật của chúng.include/arduino.h: the same sketch surface as the other two runtimes:pinMode,digitalWrite,digitalRead,analogWrite,delay,delayMicroseconds,millis,micros,shiftOut,attachInterrupt,Serialwithbegin/print/println/write/available/read/peek, withLED_BUILTIN= 25.Serial1isSerial(both UART0, the serial monitor);Serial2is UART1 on GP4 and GP5, or the UART1 pinssetTX()andsetRX()pick (section 3.5a).src/serial.cdrives both by base address. The Nano RP2040 Connect has noSerial2.- Đối tượng
rp2040của arduino-pico: FIFO nối giữaloop()vàloop1(),f_cpu(),getCycleCount(), các lời gọi watchdog ở mục 3.9, cùnggetFreeHeap(),getUsedHeap()vàgetTotalHeap(), vốn đọc vùng heap của runtime nằm giữa dữ liệu chương trình và stack. - Không có
WiFi.h. Pico không có chip không dây, nên các header mạng không biên dịch được cho nó, và phần tư vấn của bản biên dịch bảo đổi bo mạch sang Pico W, vốn có cùng các chân. Pico W là thời gian chạy này với-DMOKXI_BOARD_PICO_W, thứ ánh xạ hộp thư mạng được mô phỏng và đưa vàoWiFi.h,HTTPClient.h,WebServer.hvà tên gọi riêng của arduino-pico cho chúng (docs/picow.mdmục 6 và 7). analogWrite(pin, 0..255)hoạt động trên mọi GPIO, vì mỗi chân đều có một kênh PWM:FUNCSELchuyển thành 4 và slice nhận bộ chia nhỏ nhất mà 65.536 đếm vừa một chu kỳ, nên ở tần số mặc định 1 kHz bộ chia là 1.9375 vàTOPlà 64.515.analogWriteFreq()(100 Hz đến 1 MHz),analogWriteRange()vàanalogWriteResolution()là của arduino-pico: một tần số mới sẽ định hình lại slice vào lần kế tiếp một chân trên đó được ghi, còn range là giá trị nghĩa là bật hoàn toàn (mặc định 255). Giá trị 0 và thang đầy đủ ngắt kết nối PWM và kéo chân xuống mức thấp hoặc cao, nênanalogWrite(pin, 0)thực sự là tắt.millis()/micros()đọc TIMER, nên chúng chính xác và không bao giờ trôi.delay()vàdelayMicroseconds()từ 50 us trở lên sẽ thiết lập alarm 0 của TIMER vàWFIđến khi nó kích hoạt; khoảng chờ ngắn hơn thì vòng chờ trênTIMERAWL.attachInterrupt(pin, handler, mode)dùngIO_IRQ_BANK0vớiRISING,FALLING,CHANGE,ONLOWvàONHIGHđược ánh xạ vào bốn bitINTR.digitalPinToInterrupt(pin)chính là chân đó: mọi GPIO đều có một ngắt.
Các ví dụ nằm ở firmware/pico/examples/<name>/sketch.ino, được biên dịch thành web/public/firmware/pico/<name>.elf với web/public/firmware/pico/index.json theo cùng cấu trúc như index của Uno, mỗi mục mang "program": "elf32 arm rp2040": blink (GP25), button (GP15 với điện trở kéo lên nội bộ để sáng LED ở GP25), serial (in millis() mỗi giây một lần và phản hồi lại những gì nhận được), fade (PWM trên GP25).
Giao diện chọn danh sách firmware theo chuỗi program trong danh mục của linh kiện: "elf32 riscv32imc" đọc /firmware/index.json, "elf32 avr atmega328p" đọc /firmware/uno/index.json, "elf32 arm rp2040" đọc /firmware/pico/index.json.
8. Những gì mô hình này chắc chắn, và những gì thì không chắc
Ba nhóm, cùng cách phân loại mà mục 7 của docs/esp32c6.md dùng. Nó tồn tại vì một mô hình bo mạch âm thầm đoán một địa chỉ còn tệ hơn một mô hình nói rằng nó không biết.
Lấy từ tài liệu kỹ thuật, và được chạy thử bằng firmware thật. Mọi địa chỉ cơ sở, offset thanh ghi và vị trí bit trong mục 2 và 3 đều lấy từ RP2040 Datasheet (Raspberry Pi Ltd), gồm cả ba bí danh nguyên tử tại +0x1000, +0x2000 và +0x3000 giúp hw_set_bits hoạt động. Thứ tự header bốn mươi chân ở mục 1 là của chính Pico. crates/rp2040/tests/firmware.rs nạp các ELF thật và điều khiển RESETS, IO_BANK0, PADS_BANK0, SIO, TIMER, UART0 cùng các slice PWM qua chúng.
Đượ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ỉ:
- Lõi chạy theo từng khối 128 chu kỳ, không phải từng lệnh một, trừ 100 us sau khi chương trình đổi trạng thái một chân (mục 5, "Hai tốc độ"). Một khối dài 1.024 us và bị cắt đúng tại chu kỳ của sự kiện ngoại vi có định thời kế tiếp, nên một báo thức của bộ đếm giờ, một cạnh PWM và một byte UART đều rơi đúng chỗ, nhưng thay đổi chân đầu tiên mà phần mềm tạo ra sau một khoảng im lặng sẽ mang phần làm tròn của khối và có thể lệch tới 1.024 us; các thay đổi sau đó thì chính xác. Mô hình Uno đóng dấu mọi thay đổi pad đúng chu kỳ của nó; mô hình này không đủ sức làm vậy mọi lúc, vì không còn dư địa nào ở 125 MHz (
proofs/cortexm/REPORT.md: 0.85x thời gian thực trong trình duyệt). - Xung clock hệ thống là 125 MHz từ lúc reset và không bao giờ thay đổi. Cây clock không được mô hình hóa, nên
clocks_init, thạch anh, cả hai PLL và bất kỳ tần số nào sketch đặt đều bị bỏ qua và câu trả lời luôn là 125 MHz. Các chu kỳ chờ flash và bộ nhớ đệm XIP cũng không có, nên execute-in-place chạy với tốc độ SRAM. - Các pad là ba trạng thái và một ngưỡng. Push-pull ở 3.3 V, trở kháng cao, hoặc điện trở kéo trong 55 kΩ (datasheet cho khoảng 50 kΩ đến 80 kΩ), đọc lại so với một nửa nguồn cấp, không có hysteresis, không có cài đặt cường độ truyền, không điều khiển tốc độ sườn, không có thời gian tăng và không giới hạn dòng.
- Các chân nguồn là những con số chứ không phải một cây nguồn.
VSYSlà 4.7 V, tứcVBUStrừ đi sụt áp Schottky;3V3_ENlà điện trở kéo lên 100 kΩ và kéo nó xuống dưới 1.2 V sẽ dừng bo mạch;RUNlà điện trở kéo lên 50 kΩ;ADC_VREFlà 3.3 V sau điện trở 200 Ω. Hoàn toàn không mô phỏng hành vi của bộ ổn áp, không có gì sụt áp và không có gì brownout, và tín hiệuVBUStrên GP24 đơn giản được nối mức cao. - Khởi động chỉ mất một microgiây, không có boot ROM và không có bootloader tầng hai: ảnh được nạp vào và chạy luôn. Giữ
BOOTSELlà một thao tác poke mà mô hình báo lại; phía sau nó không có thiết bị lưu trữ nào.
Cố ý không có, như mục 6 liệt kê: lõi thứ hai, PIO, DMA, SPI, I2C, USB, RTC, cây clock, các pad QSPI và giao tiếp flash ngoài việc đọc ảnh, ROM trên chip cùng bảng hàm của nó, và các bộ nội suy. Khối địa chỉ của chúng không được ánh xạ, nên chạm vào một cái là lỗi bus chứ không phải lặng lẽ trả về số 0. ADC là ngoại lệ: mục 5a.