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 Raspberry Pi Pico dan halaman board.
Mikrokontroler ketiga, dan yang pertama di engine Cortex-M. Satu komponen kernel (pico di crates/parts) membungkus model SoC RP2040 (crates/rp2040) yang dibangun di atas core Cortex-M (crates/cortexm-core, Profile::V6M, terbukti di proofs/cortexm/REPORT.md). Firmwarenya adalah ELF Thumb yang berkomunikasi dengan periferal di bawah pada alamat RP2040 aslinya, jadi program yang dibangun untuk Mokxi berjalan di Pico sungguhan.
Tipe katalognya adalah pico (Raspberry Pi Pico, RP2040). Tiga agen membangun berdasarkan file ini: SoC dan part (Rust), runtime firmware dan contoh (C++, clang untuk thumbv6m-none-eabi), visual board (TypeScript). Ubah hanya dengan mengedit file ini lebih dulu. Semua yang ada di docs/esp32c3.md tentang cara kerja sebuah part board (slices, host channel, reset, crash line) berlaku di sini kecuali file ini menyatakan lain.
Menjalankan biner yang dikompilasi dengan Raspberry Pi Pico SDK bukan menjadi tujuan Fase 4: crt0 milik SDK mengharapkan bootloader tahap kedua, clock tree, XOSC dan PLL. Sejak Oktober 2026 ada cara kedua untuk memuat chip, yaitu full boot, untuk MicroPython (docs/micropython.md): UF2 di flash 2 MB yang terhapus, boot ROM (crates/rp2040/src/rom.rs, ditulis dari bagian 2.8 datasheet), tahap kedua dijalankan dari SRAM5, serta clock tree, SSI dan chip flash, kontroler USB, RTC dan sisanya dipetakan (sysregs.rs, ssi.rs, usb.rs), dan sejak fase 3 Python blok I2C, SPI dan DMA (i2c.rs, spi.rs, dma.rs) yang digerakkan oleh machine.I2C dan machine.SPI milik MicroPython. Semua di file ini menjelaskan jalur ELF, yang tidak berubah: tidak satu pun blok itu dipetakan untuk ELF, dan Wire serta SPI pada sketch Arduino tetap menjadi bus software dari firmware/lib/ di pin biasa. Yang dimodelkan adalah kumpulan periferal yang dibutuhkan pinMode, digitalWrite, digitalRead, analogWrite, millis, micros, delay, Serial dan attachInterrupt, pada alamat aslinya, sehingga source yang sama yang dikompilasi terhadap firmware/pico/ menghasilkan image yang juga berjalan di perangkat keras.
1. Pin board (urutan katalog)
Header 40 pin, tampak atas dengan konektor USB di atas. Kolom kiri adalah pin fisik 1..20 dibaca ke bawah; kolom kanan adalah pin fisik 40..21 dibaca ke bawah, begitulah pinnya berjajar saat board dipegang dengan cara itu.
Kolom kiri (pin 1..20): GP0, GP1, GND, GP2, GP3, GP4, GP5, GNDb, GP6, GP7, GP8, GP9, GNDc, GP10, GP11, GP12, GP13, GNDd, GP14, GP15.
Kolom kanan (pin 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 pin. Nama duplikat diberi akhiran huruf karena nama pin katalog harus unik; silkcreen board mencantumkan GND pada ketujuh pin tersebut dan AGND pada pin 33. Tiga titik uji (TP1..TP6) dan header SWD bukan pin.
Kelistrikan:
3V3mengeluarkan 3,3 V padaR_SUPPLYdan setiapGND*sertaAGNDmengeluarkan 0 V padaR_SUPPLY.VBUSmengeluarkan 5 V padaR_SUPPLYdanVSYSmengeluarkan 4,7 V (5 V melalui dioda Schottky yang board miliki di antara keduanya), karena board selalu ditenagai USB.ADC_VREFmengeluarkan 3,3 V melalui 200 R, yaitu referensi terfilter yang board keluarkan. Board adalah catu daya untuk sisa rangkaian.3V3_ENadalah input dengan pull-up 100 k keVSYS; menariknya di bawah 1,2 V mematikan regulator, yang menghentikan chip dan melepaskan semua pad. Itu satu-satunya fungsinya di sini.RUNadalah input dengan pull-up internal 50 k ke 3,3 V; jika didorong di bawah 1,65 V ia menahan CPU dalam reset, dan melepaskannya memulai ulang dari vector table.GP0..GP22,GP26..GP28adalah GPIO inout. Output aktif (SIO.GPIO_OEbit diset dan pemilih fungsi adalah SIO atau PWM): push-pull pada 3,3 V atau 0 V melaluiR_STRONG. Output nonaktif: high-Z, plus pull-up 55 k ke 3,3 V saatPADS_BANK0.GPIOn.PUEdiset, pull-down 55 k saatPDEdiset (keduanya diset adalah bus-keeper, dimodelkan sebagai high-Z). Input membaca tegangan net terhadap 1,65 V; Unknown terbaca 0, dan input mengambang terbaca noise, seperti pada Uno (docs/uno.mdbagian 1).PADS_BANK0.GPIOn.ODmematikan driver output apa pun yang diminta periferal terpilih, danIEyang kosong membuat input terbaca 0. Pad RP2040 tidak punya mode open-drain; driver yang menginginkannya menggerakkan low lalu beralih ke input untuk high.GP23,GP24danGP25ada di model tetapi tidak di header, seperti di board sungguhan:GP23adalah kontrol power-save SMPS,GP24adalah pendeteksi VBUS (terbaca 1, karena model selalu ditenagai USB) danGP25adalah LED hijau di board. LED ditampilkan dari bit probe (bagian 5), dan padnya memikul beban 1 k ke ground supaya voltasenya jujur.GP26,GP27danGP28adalahADC0..ADC2, dan ADC dimodelkan (bagian 5a):analogRead(26)membaca voltase di net.ADC_VREFadalah referensi 3,3 V konverter danAGNDadalah ground.GP0/GP1adalah UART0 TX/RX di board sungguhan. Di sini UART0 berbicara dengan host channel (bagian 4) dan kedua pad tetap GPIO, persis seperti yang dilakukandocs/esp32c3.md.
2. Peta memori (alamat RP2040 asli)
| region | alamat | ukuran | catatan |
|---|---|---|---|
| ROM | 0x0000_0000 |
16 KB | tidak dimodelkan untuk ELF: pembacaan menghasilkan 0, penulisan diabaikan dan dihitung (full boot memetakan rom.rs) |
| XIP flash | 0x1000_0000 |
hingga 2 MB | image program; hanya bisa dibaca oleh core |
| SRAM (striped) | 0x2000_0000 |
256 KB | SRAM0..SRAM3, empat bank yang diinterleave per word |
| SRAM4 | 0x2004_0000 |
4 KB | |
| SRAM5 | 0x2004_1000 |
4 KB | |
| RESETS | 0x4000_C000 |
4 KB | bagian 3.1 |
| IO_BANK0 | 0x4001_4000 |
4 KB | bagian 3.2 |
| PADS_BANK0 | 0x4001_C000 |
4 KB | bagian 3.3 |
| UART0 | 0x4003_4000 |
4 KB | bagian 3.5 |
| UART1 | 0x4003_8000 |
4 KB | bagian 3.5a |
| PWM | 0x4005_0000 |
4 KB | bagian 3.6 |
| TIMER | 0x4005_4000 |
4 KB | bagian 3.4 |
| SIO | 0xD000_0000 |
4 KB (bukan APB) | bagian 3.7 |
| PPB | 0xE000_0000 |
1 MB | SysTick, NVIC dan SCB, di dalam core |
SRAM berukuran 264 KB dan berdampingan mulai dari 0x2000_0000 sampai 0x2004_2000. Striping SRAM0..SRAM3 hanyalah detail arbitrase yang tidak berpengaruh pada software dengan satu core, jadi modelnya berupa satu array datar; 0x2100_0000 dan 0x2110_0000, alias non-striped dari bank yang sama, tidak dipetakan, begitu juga jendela cache-maintenance XIP 0x4002_0000. Apa pun di luar region yang dipetakan menyebabkan bus fault, yang pada ARMv6-M naik menjadi HardFault; komponen ini menghitung fault dan melaporkan crash (bagian 5). Register yang tidak diimplementasikan di dalam blok yang dipetakan terbaca 0 dan mengabaikan penulisan, dengan sebuah counter untuk diagnostik.
Setiap blok peripheral APB juga dialiaskan di +0x1000 (XOR atomik), +0x2000 (set atomik) dan +0x3000 (clear atomik), dan beginilah cara firmware RP2040 menyetel satu bit tanpa read-modify-write. Model ini mengimplementasikan ketiganya untuk setiap peripheral yang diimplementasikannya. SIO bukan blok APB dan tidak punya alias, sama seperti pada chip.
Firmware ELF. loadProgram menerima executable ARM ELF32 little-endian (e_machine 40). Setiap segmen PT_LOAD harus berada di dalam flash XIP atau SRAM; .data dimuat di p_paddr-nya (di flash) dan crt0 runtime yang menyalinnya turun, sama seperti pada hardware. Tidak ada second-stage bootloader: model ini tidak mewajibkan, mengeksekusi, atau melakukan checksum terhadap blok boot2, dan section .boot2 sebesar 256 byte dalam image hanya dimuat dan tidak pernah dijalankan. Reset mengambil vector table di alamat flash terendah yang dimuat: VTOR disetel ke sana, SP_main berasal dari word 0 dan entry point dari word 1, persis seperti yang dilakukan prosesor saat keluar dari reset. e_entry dari ELF tidak digunakan; vector table wajib ada. Pemuatan saat berjalan mereset board.
3. Register peripheral (subset, offset asli, posisi bit asli)
Register berukuran 32 bit dan word aligned. Akses byte dan halfword ke register peripheral tidak didukung (pembacaan mengembalikan word yang aligned lalu dipersempit, penulisan menulis seluruh word dari nilai sempitnya); firmware tidak boleh melakukannya. SRAM dan flash menerima semua lebar akses.
3.1 RESETS (0x4000_C000)
| offset | nama | bit |
|---|---|---|
0x00 |
RESET |
1 = blok ditahan dalam reset |
0x04 |
WDSEL |
tersimpan, terbaca kembali |
0x08 |
RESET_DONE |
1 = blok keluar dari reset dan siap |
Penomoran bit mengikuti datasheet: 5 io_bank0, 8 pads_bank0, 14 pwm, 21 timer, 22 uart0, 23 uart1. RESET_DONE adalah kebalikan dari RESET, tanpa jeda: sebuah blok keluar dari reset begitu bitnya dikosongkan, jadi loop while (!(resets_hw->reset_done & bits)) yang biasa langsung lolos. Saat keluar dari reset setiap blok di sini terbaca dengan nilai power-on-nya; menahan blok dalam reset mengembalikannya ke nilai tersebut, dan selama io_bank0 atau pads_bank0 ditahan, setiap pad berada dalam kondisi high-Z. Blok yang tidak diimplementasikan oleh model menerima bitnya dan melaporkan done.
3.2 IO_BANK0 (0x4001_4000)
| offset | nama | bit |
|---|---|---|
0x00 + 8n |
GPIOn_STATUS |
bit 8 OUTTOPAD, bit 13 OETOPAD, bit 17 INFROMPAD, hanya baca |
0x04 + 8n |
GPIOn_CTRL |
bit 4..0 FUNCSEL, 9..8 OUTOVER, 13..12 OEOVER, 17..16 INOVER |
0x0F0 + 4m |
INTRm |
interrupt mentah untuk GPIO 8m..8m+7, empat bit per pin |
0x100 + 4m |
PROC0_INTEm |
enable, tata letak sama |
0x110 + 4m |
PROC0_INTFm |
force, tata letak sama |
0x120 + 4m |
PROC0_INTSm |
mentah AND enable, OR force |
FUNCSEL: 4 = PWM, 5 = SIO, 31 = NULL (pad dilepas). Nilai lain (SPI 1, UART 2, I2C 3, PIO0 6, PIO1 7, clocks 8, USB 9) diterima, disimpan dan terbaca kembali, tetapi membiarkan pad tetap terlepas, karena peripheral tersebut tidak dimodelkan. Nilai power-on adalah 31 di setiap pin, sama seperti pada chip, jadi firmware harus memilih SIO sebelum sebuah pad berfungsi, dan firmware/pico/ melakukannya.
OUTOVER/OEOVER: 0 = sinyal peripheral, 1 = diinvert, 2 = drive rendah (OEOVER 2 = nonaktif), 3 = drive tinggi (OEOVER 3 = aktif). INOVER sama, empat nilai tersebut untuk input.
Empat bit interrupt per GPIO adalah 0 LEVEL_LOW, 1 LEVEL_HIGH, 2 EDGE_LOW, 3 EDGE_HIGH. Bit edge terkunci dan dihapus dengan menulis 1 padanya di INTRm; bit level mengikuti pad dan tidak bisa dihapus. Bit apa pun yang disetel di PROC0_INTSm menaikkan IO_IRQ_BANK0 (IRQ 13).
3.3 PADS_BANK0 (0x4001_C000)
| offset | nama | bit |
|---|---|---|
0x00 |
VOLTAGE_SELECT |
tersimpan, terbaca kembali |
0x04 + 4n |
GPIOn |
0 SLEWFAST, 1 SCHMITT, 2 PDE, 3 PUE, 4..5 DRIVE, 6 IE, 7 OD |
Saat power-on, IE clear, PUE clear, PDE set, SCHMITT set, DRIVE = 1 (4 mA) di setiap pad, sesuai yang tertulis di datasheet. IE clear membuat input terbaca 0 apa pun kondisi net; OD set melepas pad tanpa memedulikan apa yang diminta oleh peripheral yang dipilih; DRIVE dan SLEWFAST disimpan dan bisa dibaca kembali tapi tidak mengubah impedansi sumber, yang selalu R_STRONG.
3.4 TIMER (0x4005_4000)
Sebuah counter mikrodetik 64-bit dan empat alarm 32-bit. Ini adalah clock komponen ini: micros() dan millis() membacanya dan delay() tidur menunggu alarm.
| offset | nama | bit |
|---|---|---|
0x00 0x04 |
TIMEHW TIMELW |
hanya tulis, penulisan seluruh counter secara terkunci |
0x08 |
TIMEHR |
word tinggi, dikunci oleh pembacaan TIMELR terakhir |
0x0C |
TIMELR |
word rendah; membacanya mengunci word tinggi ke TIMEHR |
0x10 + 4n |
ALARMn |
n = 0..3; menulis mempersenjatainya, menulis juga menghapus bit INTR-nya |
0x20 |
ARMED |
bit n = alarm n dipersenjatai; tulis 1 untuk menetralkan |
0x24 0x28 |
TIMERAWH TIMERAWL |
counter tanpa penguncian |
0x2C |
DBGPAUSE |
tersimpan, terbaca kembali |
0x30 |
PAUSE |
bit 0 menghentikan counter |
0x34 |
INTR |
bit n = alarm n terpicu; tulis 1 untuk menghapus |
0x38 0x3C 0x40 |
INTE INTF INTS |
enable, force, dan raw AND enable OR force |
Counter diturunkan dari waktu kernel: microseconds = (now_ps - origin_ps) / 1_000_000, dengan origin tetap di slice pertama. Counter ini tidak pernah bergeser dari rangkaian. Sebuah alarm terpicu saat 32 bit rendah counter mencapai nilai yang dipersenjatai, menetralkan dirinya sendiri dan menyetel bit INTR-nya; bit n pada INTS menaikkan TIMER_IRQ_n (IRQ 0..3). Menulis ke alarm juga menghapus bit INTR-nya. Komparator hanya melihat 32 bit rendah, jadi alarm yang dipersenjatai pada nilai yang baru saja terlewat tidak akan terpicu selama 71,6 menit, persis seperti pada hardware, dan itulah sebabnya firmware/pico/ membaca ulang clock setelah mempersenjatai dan sebelum berhenti.
3.5 UART0 (0x4003_4000)
Sebuah PL011. Ini adalah kanal host; pad tidak terlibat.
| offset | nama | bit |
|---|---|---|
0x00 |
UARTDR |
tulis: kirim; baca: terima (8 bit rendah, bit error terbaca 0) |
0x04 |
UARTRSR |
terbaca 0 |
0x18 |
UARTFR |
3 BUSY, 4 RXFE, 5 TXFF, 6 RXFF, 7 TXFE |
0x24 0x28 |
UARTIBRD UARTFBRD |
baud = 125 MHz / (16 (IBRD + FBRD/64)); disimpan dan dipakai untuk pengaturan laju TX |
0x2C |
UARTLCR_H |
disimpan; bit 4 FEN mengaktifkan FIFO (menghapusnya akan mengosongkan FIFO) |
0x30 |
UARTCR |
0 UARTEN, 8 TXE, 9 RXE |
0x34 |
UARTIFLS |
tersimpan, terbaca kembali |
0x38 |
UARTIMSC |
4 RXIM, 5 TXIM, 6 RTIM |
0x3C 0x40 |
UARTRIS UARTMIS |
status interupsi raw dan masked |
0x44 |
UARTICR |
tulis 1 untuk menghapus |
0x48 |
UARTDMACR |
tersimpan, terbaca kembali |
Kedua FIFO berisi 32 entri, seperti pada chip sungguhan, dan satu entri saat FEN dihapus. Byte TX keluar dari FIFO ke kanal host pada baud yang dikonfigurasi (divisor yang belum diprogram memakai 115200: satu byte, sepuluh bit, setiap 86.8 us) dan BUSY aktif selama masih ada byte yang keluar; penulisan ke TX FIFO yang penuh diabaikan, sama seperti perangkat keras aslinya. Byte RX tiba dari kanal host secara instan. RXRIS naik saat RX FIFO berada di atau melewati level pemicunya (setengah, nilai reset UARTIFLS, jadi 16 entri) dan RTRIS setiap kali RX berisi apa pun dan tidak ada byte yang tiba selama 32 waktu bit, jadi driver yang menunggu salah satunya akan melihat satu karakter yang diketik. Bit apa pun yang aktif di UARTMIS menaikkan UART0_IRQ (IRQ 20).
Di belakang FIFO terima ada backlog host 256 byte, yang bukan bagian dari perangkat keras: ia mengalir ke FIFO saat program mengosongkannya, jadi menempelkan satu baris ke serial monitor saat sketch sedang di antara panggilan Serial.read() tidak kehilangan karakter. Model Uno punya hal yang sama dengan alasan yang sama. Backlog yang juga penuh akan membuang data, seperti overrun sungguhan.
3.5a UART1 (0x4003_8000)
PL011 satunya lagi, dengan register milik UART0 pada offset UART0, dan dipetakan di setiap boot. Tidak seperti UART0, ini tersambung ke pad-nya, bukan ke kanal host, jadi ini menjadi Serial2 di runtime Arduino dan machine.UART(1) di MicroPython, berkomunikasi dengan apa pun yang tersambung ke pin-nya: modul GPS, HC-05, RX dan TX board lain. Frame-nya keluar dan masuk satu bit demi satu bit melalui mesin frame yang dipakai UART1 dan UART2 ESP32 (crates/esp-common/src/wire_uart.rs):
- Pin. Sebuah GPIO menjadi milik UART1 saat
FUNCSEL-nya bernilai 2 (UART) dan ia salah satu dari 4 sampai 11 atau 20 sampai 27 (datasheet 2.19.2);n % 40 adalahTX, 1 adalahRX. Jadi GP4/GP5, GP8/GP9, GP20/GP21 dan GP24/GP25 adalah pasangannya.TXselalu didorong, idle tinggi;RXadalah input;CTSdanRTStidak dimodelkan. Fungsi yang sama pada pin UART0 tidak mendorong apa pun (UART0 adalah kanal host). - Kirim. Byte yang ditulis ke
UARTDRmemulai frame-nya begitu shifter kosong, pada waktu bit yang diberikan divisor,16 (IBRD + FBRD/64)siklus, dan setiap perubahan level mencapai pad pada siklus saat itu terjadi.LCR_Hmenentukan frame:WLENlima sampai delapan bit,PENdenganEPS,STP2. Tidak ada yang keluar saatUARTENatauTXEdihapus. - Terima. Level pad
RXdiambil seperti yang dilaporkan komponen board, pada saat yang dijelaskannya. Penurunan pada garis idle memulai frame, setiap bit disampel di tengah slot-nya dan byte mendarat di tengah stop bit-nya, jadi baud rate yang tidak cocok membaca sampah di sini seperti di meja kerja sungguhan.RTRISnaik 32 waktu bit setelah byte terakhir selama FIFO tidak kosong. - FIFO dan flag. 32 entri masing-masing dengan
FEN, satu tanpa itu, seperti pada UART0;UARTFR,UARTRIS,UARTMISdanUARTICRsesuai bagian 3.5. Bit apa pun yang aktif diUARTMISmemicuUART1_IRQ(IRQ 21).
Serial2.begin() milik runtime Arduino memindahkan GP4 dan GP5 (atau pin yang dipilih setTX() dan setRX()) ke fungsi UART dan menyalakan pull-up RX, jadi port tanpa apa pun yang tersambung membaca garis idle.
3.6 PWM (0x4005_0000)
Delapan slice, dua kanal masing-masing. GPIO n adalah kanal A dari slice (n / 2) % 8 saat n genap dan kanal B saat ganjil, jadi GP25, LED on-board, adalah slice 4 kanal B.
| offset | nama | 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 integer, 3..0 pecahan: pencacah melangkah sekali per DIV/16 clock sistem |
0x08 + 0x14 s |
CHs_CTR |
pencacahnya, 16 bit; bisa ditulis |
0x0C + 0x14 s |
CHs_CC |
15..0 pembanding kanal A, 31..16 kanal B |
0x10 + 0x14 s |
CHs_TOP |
15..0 nilai wrap; reset 0xFFFF |
0xA0 |
EN |
bit s mengaktifkan slice s, bit yang sama dengan CSR.EN-nya |
0xA4 0xA8 0xAC 0xB0 |
INTR INTE INTF INTS |
interupsi wrap per slice |
Output sebuah kanal tinggi selama CTR < CC dan rendah dari CTR == CC sampai wrap, jadi CC = 0 selalu rendah dan CC > TOP selalu tinggi. Itulah sebabnya analogWrite(pin, 255) menyetel CC ke TOP + 1 alih-alih ke TOP. A_INV dan B_INV membalik output. Output mencapai pad setiap kali FUNCSEL GPIO itu bernilai 4: blok PWM menegaskan output enable pad itu sendiri, jadi memilih fungsinya saja cukup untuk sebuah program, dan SIO.GPIO_OE tidak diperiksa.
DIVMODE 0 (free-running) dimodelkan. Mode 1..3 menghitung dengan gerbang dari atau dipicu oleh pin B, yang memerlukan input yang tidak dirutekan model, jadi mode itu diterima dan disimpan tetapi dihitung sebagai free-running. PH_CORRECT tidak dimodelkan: slice dengan bit itu aktif tetap menghitung trailing-edge, yang membagi dua periode-nya. Bit apa pun yang aktif di INTS menaikkan PWM_IRQ_WRAP (IRQ 4).
3.7 SIO (0xD000_0000)
I/O satu siklus: GPIO yang benar-benar ditulis oleh core, plus pembagi perangkat keras.
| offset | nama | bit |
|---|---|---|
0x000 |
CPUID |
membaca 0: core 0 adalah satu-satunya core (bagian 5) |
0x004 |
GPIO_IN |
bit n = level input GPIO n (butuh PADS.IE) |
0x008 |
GPIO_HI_IN |
enam pad QSPI; membaca 0 |
0x010 0x014 0x018 0x01C |
GPIO_OUT _SET _CLR _XOR |
level output, bit 0..29 |
0x020 0x024 0x028 0x02C |
GPIO_OE _SET _CLR _XOR |
output enable, bit 0..29 |
0x030..0x04C |
GPIO_HI_OUT/_OE dan alias-aliasnya |
disimpan; tanpa pad |
0x050 |
FIFO_ST |
membaca 2 (RDY aktif, VLD tidak): core 1 tidak pernah menjawab |
0x054 0x058 |
FIFO_WR FIFO_RD |
penulisan dibuang, pembacaan memberi 0 |
0x05C |
SPINLOCK_ST |
bit n = spinlock n dipegang |
0x060..0x078 |
DIV_UDIVIDEND DIV_UDIVISOR DIV_SDIVIDEND DIV_SDIVISOR DIV_QUOTIENT DIV_REMAINDER DIV_CSR |
pembagi perangkat keras |
0x100 + 4n |
SPINLOCKn |
baca untuk mengklaim (0 saat sudah dipegang), tulis untuk melepaskan |
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 Interupsi
NVIC, SysTick dan SCB berada di dalam cortexm-core pada alamat PPB arsitekturalnya; bus tidak pernah melihatnya. ARMv6-M memberi dua bit prioritas dan 32 garis interupsi eksternal. Garis yang diberikan model ini:
| IRQ | nama | dinaikkan oleh |
|---|---|---|
| 0..3 | TIMER_IRQ_0..3 |
TIMER.INTS bit n |
| 4 | PWM_IRQ_WRAP |
PWM.INTS tidak nol |
| 13 | IO_IRQ_BANK0 |
nilai IO_BANK0.PROC0_INTS* yang tidak nol |
| 20 | UART0_IRQ |
UART0.UARTMIS tidak nol |
Masing-masing adalah level, tetap tinggi selama status periferal mengatakannya, jadi handler yang tidak membersihkan sumbernya akan dipanggil lagi, persis seperti pada perangkat keras. Setiap nomor IRQ lain ada di NVIC dan tidak pernah dinaikkan.
WFI menghentikan core sampai ada interupsi yang aktif tertunda (bagian 5). WFE berperilaku sama, plus register event yang didefinisikan arsitektur; SEV diterima dan menetapkannya.
3.9 WATCHDOG (0x4005_8000) dan PSM.WDSEL (0x4001_0000)
CTRL (ENABLE, TRIGGER, bit pause disimpan, TIME hitungannya), LOAD, REASON, SCRATCH0..7 dan TICK (disimpan; tick-nya satu mikrosekon apa pun isinya). Hitungannya turun dua setiap mikrosekon, yang merupakan erratum RP2040-E1 dan alasan SDK memuat ms * 2000. Saat mencapai nol, atau karena TRIGGER, REASON berisi TIMER atau FORCE dan, jika PSM.WDSEL memilih core 0 (SDK memilih semuanya kecuali osilator), chip melakukan reboot dengan clock rangkaian tetap berjalan: REASON dan register scratch bertahan dan watchdog mati. Runtime menyediakan hardware/watchdog.h milik SDK dan rp2040.wdt_begin(), wdt_reset(), reboot() dan restart() milik arduino-pico di register ini. Lompatan boot ROM ke pc watchdog_reboot() tidak dimodelkan: reboot memulai program dari awal.
4. Kanal host
host = "byte UTF-8 di UART0". readHost mengembalikan byte TX UART0 saat keluar dari FIFO pada baud yang dikonfigurasi; writeHost mendorong byte ke FIFO RX UART0 (kelebihan dibuang, seperti pada chip). Serial Monitor menampilkan byte sebagai teks, mendekode UTF-8 dan memperlakukan \n sebagai akhir baris (\r diabaikan). Semantiknya sama dengan kanal ESP32-C3.
5. Model waktu dan komponen
Satu core pada 125 MHz. SoC berjalan dalam potongan 10 us = 1250 siklus, dengan penghitung siklus core sebagai clock: cortexm-core mengenakan jumlah siklus datasheet untuk setiap instruksi, jadi waktu simulasi adalah jumlah siklus dibagi 125 MHz. Penghitung siklus ditambatkan ke waktu kernel di awal setiap potongan, seperti model ATmega328P menambatkan miliknya, jadi timer tidak akan pernah bergeser dari rangkaian bagaimana pun potongan itu jatuh.
Core kedua tidak dimodelkan. SIO.CPUID terbaca 0, FIFO antar-core selalu kosong dan tidak pernah siap dibaca, dan tidak ada cara untuk meluncurkan core 1: program yang menulis urutan peluncuran ke FIFO_WR dan menunggu respons akan menunggu selamanya. proofs/cortexm/REPORT.md mengukur satu core yang kita punya di 0.85x RP2040 asli 125 MHz di browser, jadi core kedua yang diinterpretasi akan memotong itu jadi setengah; itu keputusan Phase 5, bukan kelalaian Phase 4 yang ditutupi. Semuanya di firmware/pico/ satu core.
Dua gigi. Tidak seperti model Uno, core tidak dijalankan satu instruksi pada satu waktu sepanjang waktu: tidak ada ruang untuk itu. Satu potongan dijalankan dalam gumpalan 128 siklus (1.024 us), yang membatasi galat pada waktu yang dicap pada perubahan pin; beberapa perubahan dalam satu gumpalan menjaga urutannya dan disebar di dalamnya sehingga tidak pernah bertepatan. Sebuah gumpalan dipotong tepat pada siklus peristiwa periferal berwaktu berikutnya (alarm timer, tepi PWM, byte UART yang keluar), jadi semuanya jatuh pada siklus yang benar dan micros() tepat.
Penulisan yang mengubah SIO.GPIO_OUT atau SIO.GPIO_OE (lewat alias mana pun) bergeser ke gigi halus untuk rp2040::FINE_CYCLES berikutnya (12.500 siklus, 100 us): satu instruksi satu gumpalan, jadi setiap perubahan pin membawa siklus dari store yang membuatnya. Itulah yang dibutuhkan protokol bit-banged; tinggi singkat satu bit WS2812 adalah 0.4 us, dan mokxi_ws2812.h menggerakkan strip dengan cara itu (model Uno R4 punya dua gigi yang sama). Store yang mengaktifkan gigi tetap dicap di gumpalan kasarnya, jadi driver yang peduli membuat satu dulu.
Sleep menghentikan sementara. WFI menghentikan pemotongan: komponen menjadwalkan bangun berikutnya pada yang paling awal dari alarm timer yang dipasang, tepi PWM berikutnya pada pad yang digerakkan dan peristiwa UART berikutnya, dan perubahan pin atau byte host membangunkannya seketika. Sketch yang idle hanya menghabiskan segelintir peristiwa per detik di kernel alih-alih 125 juta siklus, dan itulah alasan delay() di runtime tidur.
Pembacaan SIO.GPIO_IN melihat level pin pada awal gumpalan, plus perubahan apa pun yang dibuat sketch itu sendiri di dalamnya.
Probe: bitmask, 0 tanpa program.
| bit | arti |
|---|---|
| 1 | berjalan (mengeksekusi, tidak dalam reset, tidak crash) |
| 2 | berhenti di WFI |
| 4 | LED on-board di GP25 menyala |
| 8 | transmisi serial dalam 20 ms terakhir |
| 16 | penerimaan serial dalam 20 ms terakhir |
Poke: 1 = tekan BOOTSEL, 0 = lepas (model ini tidak punya fungsi tombol bootsel: menekannya hanya menyalakan visualnya, karena BOOTSEL dibaca lewat pad chip-select QSPI, yang tidak dimodelkan); 2 = tahan RUN rendah, 3 = lepas.
Penanganan crash seperti di docs/esp32c3.md bagian 5. Pada ARMv6-M setiap fault adalah HardFault, dan fault yang diambil pada prioritas HardFault adalah Lockup, yang dilaporkan cortexm-core sebagai Trap::Lockup. Komponen berhenti pada Trap (Lockup atau BKPT tanpa debugger) dan mencetak satu baris di kanal host:
firmware crashed at pc=0x100002a4, lockup in exception 3
5a. 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.
Runtime (firmware/pico/src/gpio.c) melakukan seperti arduino-pico: analogRead() mengambil GP26 sampai GP29 (A0 sampai A3) dan tidak yang lain, menyerahkan pad ke konverter (tanpa pull, tanpa input digital), dan mengembalikan sepuluh bit kecuali analogReadResolution() meminta lebar lain; analogReadTemp() membaca input 4 lewat rumus datasheet.
Tidak dimodelkan: FIFO dan DMA, round robin, interupsi ADC, pacing DIV, derau konversi dan beban input pada sumbernya.
6. Yang tidak dimodelkan
PIO, DMA, SPI, I2C, pengontrol USB, RTC, clock tree (CLOCKS, XOSC, PLL_SYS, PLL_USB: clock sistem 125 MHz sejak reset), pad QSPI dan antarmuka flash selain membaca image, core kedua, ROM di dalam chip beserta tabel fungsinya, dan interpolator. Blok alamatnya tidak dipetakan, jadi menyentuh salah satunya menyebabkan bus fault, bukan nol diam-diam (board MicroPython, yang di-boot sampai penuh, memetakan I2C, SPI dan DMA: bagian 3 di docs/micropython.md). Pengecualiannya adalah blok yang tercantum di bagian 3, di mana register yang belum diimplementasikan di dalam blok yang sudah diimplementasikan terbaca 0 dan dihitung.
7. Runtime firmware (firmware/pico/)
Runtime C dan C++ freestanding untuk RP2040 yang dibangun dengan clang 18 (--target=thumbv6m-none-eabi -mcpu=cortex-m0plus -mthumb -Os) dan ld.lld, tanpa Pico SDK, tanpa newlib, tanpa libgcc atau compiler-rt, tanpa apa pun yang berlisensi GPL:
crt0.S: tabel vektor (16 entri sistem plus 32 IRQ),Reset_Handler(menyalin.datadari flash, mengosongkan.bss, menjalankan konstruktor C++, memanggilmain), dan helper AEABI yang dibutuhkan Cortex-M0+ karena tidak punya instruksi pembagian dan perkalian panjang:__aeabi_uidiv,__aeabi_uidivmod,__aeabi_idiv,__aeabi_idivmod,__aeabi_lmul,__aeabi_llsr,__aeabi_llsldan helper memori.link.ld:.textdan.rodatadi flash XIP di0x1000_0000,.datadan.bssdi SRAM di0x2000_0000, stack dari puncak SRAM (0x2004_2000) turun. Tanpaboot2.include/rp2040.h: register bagian 3 sebagai macro dengan nama aslinya.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.- Objek
rp2040milik arduino-pico: FIFO antaraloop()danloop1(),f_cpu(),getCycleCount(), panggilan watchdog di bagian 3.9, sertagetFreeHeap(),getUsedHeap()dangetTotalHeap(), yang membaca heap runtime di antara data program dan stack. - Tidak ada
WiFi.h. Pico tidak punya chip nirkabel, jadi header jaringan tidak bisa dikompilasi untuknya, dan saran dari build menyuruh mengganti board ke Pico W, yang pinnya sama. Pico W adalah runtime ini dengan-DMOKXI_BOARD_PICO_W, yang memetakan mailbox jaringan simulasi dan membawa sertaWiFi.h,HTTPClient.h,WebServer.hdan nama-nama arduino-pico sendiri untuk semuanya (docs/picow.mdbagian 6 dan 7). analogWrite(pin, 0..255)berfungsi di setiap GPIO, karena masing-masing punya kanal PWM:FUNCSELdiatur ke 4 dan slice mendapat pembagi terkecil yang 65.536 hitungannya mencapai satu periode, jadi pada default 1 kHz pembaginya 1.9375 danTOPadalah 64.515.analogWriteFreq()(100 Hz sampai 1 MHz),analogWriteRange()dananalogWriteResolution()milik arduino-pico: frekuensi baru membentuk ulang sebuah slice saat pin di dalamnya ditulis berikutnya, dan range adalah nilai yang berarti sepenuhnya menyala (default 255). Nilai 0 dan skala penuh memutus PWM dan menarik pin ke rendah atau tinggi, jadianalogWrite(pin, 0)benar-benar mati.millis()/micros()membaca TIMER, jadi hasilnya eksak dan tidak pernah bergeser.delay()dandelayMicroseconds()sebesar 50 us atau lebih memasang alarm timer 0 danWFIsampai terpicu; tunggu yang lebih pendek memutar diTIMERAWL.attachInterrupt(pin, handler, mode)menggunakanIO_IRQ_BANK0denganRISING,FALLING,CHANGE,ONLOWdanONHIGHyang dipetakan ke empat bitINTR.digitalPinToInterrupt(pin)adalah pin itu sendiri: setiap GPIO memilikinya.
Contoh di firmware/pico/examples/<name>/sketch.ino, dibangun ke web/public/firmware/pico/<name>.elf dengan web/public/firmware/pico/index.json berbentuk sama seperti indeks Uno, setiap entri memuat "program": "elf32 arm rp2040": blink (GP25), button (GP15 dengan pull-up internal menyalakan GP25), serial (mencetak millis() sekali per detik dan menggema apa yang diterima), fade (PWM di GP25).
UI memilih daftar firmware berdasarkan string program di katalog komponen: "elf32 riscv32imc" membaca /firmware/index.json, "elf32 avr atmega328p" membaca /firmware/uno/index.json, "elf32 arm rp2040" membaca /firmware/pico/index.json.
8. Hal yang pasti dari model ini, dan yang belum
Tiga kelompok, dengan pengurutan yang sama seperti docs/esp32c6.md bagian 7. Ini ada karena model board yang menebak alamat diam-diam lebih buruk daripada yang mengaku tidak tahu.
Diambil dari lembar data, dan dijalankan oleh firmware sungguhan. Setiap alamat dasar, offset register dan posisi bit di bagian 2 dan 3 berasal dari RP2040 Datasheet (Raspberry Pi Ltd), termasuk tiga alias atomik di +0x1000, +0x2000 dan +0x3000 yang membuat hw_set_bits bekerja. Urutan header empat puluh pin di bagian 1 adalah milik Pico sendiri. crates/rp2040/tests/firmware.rs memuat ELF sungguhan dan menggerakkan RESETS, IO_BANK0, PADS_BANK0, SIO, TIMER, UART0 dan slice PWM melaluinya.
Dimodelkan, tetapi tidak diikat ke angka data sheet. Perilaku, bukan alamat:
- Inti berjalan dalam potongan 128 siklus, bukan satu instruksi demi satu, kecuali selama 100 us setelah program memindahkan pin (bagian 5, "Dua gigi"). Satu potongan adalah 1.024 us dan dipotong tepat pada siklus kejadian periferal terjadwal berikutnya, jadi alarm timer, tepi PWM dan satu byte UART semua mendarat di tempat yang semestinya, tetapi perubahan pin pertama yang dibuat perangkat lunak setelah masa tenang membawa pembulatan potongan dan bisa meleset sampai 1.024 us; perubahan setelahnya eksak. Model Uno menstempel setiap perubahan pad pada siklusnya yang tepat; model ini tidak sanggup melakukannya sepanjang waktu, karena tidak ada ruang sisa pada 125 MHz (
proofs/cortexm/REPORT.md: 0.85x waktu nyata di browser). - Jam sistem 125 MHz sejak reset dan tidak pernah berubah. Pohon jam tidak dimodelkan, jadi
clocks_init, kristal, kedua PLL dan frekuensi apa pun yang diatur sketch semuanya diabaikan dan jawabannya selalu 125 MHz. Wait state flash dan cache XIP juga tidak ada, jadi execute-in-place berjalan secepat SRAM. - Pad-nya punya tiga state dan satu ambang. Push-pull pada 3,3 V, high-Z, atau pull internal 55 kΩ (data sheet menyebut sekitar 50 kΩ sampai 80 kΩ), dibaca kembali terhadap setengah dari suplai, tanpa histeresis, tanpa pengaturan drive-strength, tanpa kontrol slew-rate, tanpa rise time dan tanpa batas arus.
- Pin power berupa angka-angka, bukan pohon power.
VSYSadalah 4,7 V, yaituVBUSdikurangi drop Schottky;3V3_ENadalah pull-up 100 kΩ dan menariknya di bawah 1,2 V menghentikan board;RUNadalah pull-up 50 kΩ;ADC_VREFadalah 3,3 V di belakang 200 Ω. Perilaku regulator tidak dimodelkan sama sekali, tidak ada yang turun dan tidak ada yang brown out, dan pendeteksiVBUSdi GP24 cukup diikat tinggi. - Startup memakan satu mikrodetik, tanpa boot ROM dan tanpa bootloader tahap kedua: citranya diletakkan lalu dijalankan. Menahan
BOOTSELadalah poke yang dilaporkan model; tidak ada perangkat penyimpanan massal di baliknya.
Sengaja tidak ada, sebagaimana didaftar di bagian 6: core kedua, PIO, DMA, SPI, I2C, USB, RTC, clock tree, pad QSPI dan antarmuka flash selain membaca citra, ROM di dalam chip beserta tabel fungsinya, dan interpolator. Blok alamat mereka tidak dipetakan, jadi menyentuhnya menjadi bus fault, bukan nol senyap. ADC adalah pengecualiannya: bagian 5a.