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 Raspberry Pi Pico ve kart sayfası.
Üçüncü mikrodenetleyici ve Cortex-M motorundaki ilk. Bir çekirdek bileşeni (pico, crates/parts içinde), Cortex-M çekirdeği üzerine kurulu bir RP2040 SoC modelini sarar (crates/rp2040; çekirdek: crates/cortexm-core, Profile::V6M, proofs/cortexm/REPORT.md içinde kanıtlanmıştır). Firmware, aşağıdaki çevre birimlerine gerçek RP2040 adreslerinde konuşan bir Thumb ELF'tir; bu yüzden Mokxi için derlenmiş bir program gerçek bir Pico üzerinde de çalışır.
Katalog tipi pico'dır (Raspberry Pi Pico, RP2040). Bu dosyayı kullanan üç aracı derleme yapar: SoC ve parça (Rust), firmware çalışma zamanı ve örnekler (C++, clang ile thumbv6m-none-eabi için), kart görseli (TypeScript). Değişikliği yalnızca önce bu dosyayı düzenleyerek yap. Bir kart parçasının nasıl davrandığına dair docs/esp32c3.md içindeki her şey (dilimler, sunucu kanalı, sıfırlama, çökme satırı), bu dosya aksini söylemedikçe burada da geçerlidir.
Raspberry Pi Pico SDK ile derlenmiş ikili dosyaları çalıştırmak Faz 4 için bir hedef değildi: SDK'nın crt0'ı ikinci aşama önyükleyiciyi, saat ağacını, XOSC'yi ve PLL'leri bekler. Ekim 2026'dan beri çipi yüklemenin ikinci bir yolu var: MicroPython için tam önyükleme (docs/micropython.md): 2 MB silinmiş bir flash'ta bir UF2, önyükleme ROM'u (crates/rp2040/src/rom.rs, veri sayfası bölüm 2.8'den yazılmıştır), SRAM5'ten çalıştırılan ikinci aşama ve eşlenen saat ağacı, SSI ve flash çipi, USB denetleyicisi, RTC ve geri kalanlar (sysregs.rs, ssi.rs, usb.rs); Python'ın 3. fazından beri de MicroPython'ın machine.I2C ve machine.SPI ile kullandığı I2C, SPI ve DMA blokları (i2c.rs, spi.rs, dma.rs). Bu dosyadaki her şey, değişmeden kalan ELF yolunu anlatır: bu blokların hiçbiri bir ELF için eşlenmez ve bir Arduino kodunun Wire ve SPI'ı, firmware/lib/ içindeki yazılım veri yolları olarak normal pinlerde kalır. Modellenen şey, pinMode, digitalWrite, digitalRead, analogWrite, millis, micros, delay, Serial ve attachInterrupt için gereken çevre birimi kümesidir; gerçek adreslerinde, öyle ki firmware/pico/'ye karşı derlenen aynı kaynak, donanımda da çalışan bir görüntü üretir.
1. Kart pinleri (katalog sırası)
40 pinli başlık, USB konektörü üstte olacak şekilde üstten görünüm. Sol sütun aşağı doğru okunan fiziksel pin 1..20'dir; sağ sütun aşağı doğru okunan fiziksel pin 40..21'dir; kart o şekilde tutulduğunda pinler böyle hizalanır.
Sol sütun (pin 1..20): GP0, GP1, GND, GP2, GP3, GP4, GP5, GNDb, GP6, GP7, GP8, GP9, GNDc, GP10, GP11, GP12, GP13, GNDd, GP14, GP15.
Sağ sütun (pinler 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. Yinelenen adlar bir harf eki taşır, çünkü katalog pin adları benzersizdir; kart, yedisinde de GND, 33 numaralı pinde AGND yazılıdır. Üç test noktası (TP1..TP6) ve SWD konektörü pin değildir.
Elektriksel:
3V3,R_SUPPLYdirenciyle 3,3 V verir; herGND*veAGND,R_SUPPLYdirenciyle 0 V verir.VBUSR_SUPPLYdirenciyle 5 V,VSYSise 4,7 V verir (kartın aralarında bulundurduğu Schottky diyotundan geçen 5 V), çünkü kart her zaman USB ile beslenir.ADC_VREF, 200 R üzerinden 3,3 V verir; bu, kartın dışarı sunduğu filtrelenmiş referanstır. Kart, devrenin geri kalanı için bir kaynaktır.3V3_EN,VSYS'e 100 k pull-up'a sahip bir giriştir; onu 1,2 V altına çekmek regülatörü kapatır, bu da çipi durdurur ve tüm pad'leri serbest bırakır. Burada yaptığı tek şey budur.RUN, 3,3 V'a 50 k dahili pull-up ile bir giriştir; 1,65 Volt'un altına çekilirse CPU'yu reset durumunda tutar, serbest bırakıldığında vektör tablosundan yeniden başlatır.GP0..GP22veGP26..GP28iki yönlü GPIO'dur. Çıkış etkinse (SIO.GPIO_OEbiti set ve işlev seçimi SIO ya da PWM):R_STRONGüzerinden 3,3 V ya da 0 V push-pull. Çıkış devre dışıysa: yüksek empedans;PADS_BANK0.GPIOn.PUEset olduğunda 3,3 V'a 55 k pull-up,PDEset olduğunda 55 k pull-down eklenir (ikisi de set ise bus-keeper, yüksek empedans olarak modellenir). Giriş, ağ voltajını 1,65 V'a karşı okur; Unknown ise 0 okunur ve boşta süzülen bir giriş, Uno'daki gibi gürültü okur (docs/uno.mdbölüm 1).PADS_BANK0.GPIOn.OD, seçili çevre birimi ne isterse istesin çıkış sürücüsünü devre dışı bırakır;IEbiti temizse giriş 0 okur. Bir RP2040 pad'inde açık-drain modu yoktur; isteyen bir sürücü alçak sürer ve yüksek için girişe geçer.GP23,GP24veGP25modelde vardır ama gerçek karttaki gibi konektörde bulunmaz:GP23SMPS güç tasarrufu denetimidir,GP24VBUS algılamasıdır (1 okur, çünkü model her zaman USB ile beslenir) veGP25kart üzerindeki yeşil LED'dir. LED bir prob bitinden gösterilir (bölüm 5) ve pad, volt değerlerinin gerçekçi olması için toprağa 1 k yük taşır.GP26,GP27veGP28,ADC0..ADC2'dir ve ADC modellenmiştir (bölüm 5a):analogRead(26), ağdaki voltajı okur.ADC_VREFdönüştürücünün 3.3 V referansıdır veAGNDbir topraktır.GP0/GP1, gerçek kartta UART0 TX/RX'tir. Burada UART0 sunucu kanalıyla konuşur (bölüm 4) ve iki pad GPIO olarak kalır; tıpkıdocs/esp32c3.md'nin yaptığı gibi.
2. Bellek haritası (gerçek RP2040 adresleri)
| bölge | adres | boyut | notlar |
|---|---|---|---|
| ROM | 0x0000_0000 |
16 KB | bir ELF için modellenmez: 0 okur, yazmalar yok sayılır ve sayılır (tam önyükleme rom.rs dosyasını eşler) |
| XIP flash | 0x1000_0000 |
2 MB'a kadar | program görüntüsü; çekirdek için salt okunur |
| SRAM (çizgili) | 0x2000_0000 |
256 KB | SRAM0..SRAM3, kelime bazlı harmanlanmış dört banka |
| SRAM4 | 0x2004_0000 |
4 KB | |
| SRAM5 | 0x2004_1000 |
4 KB | |
| RESETS | 0x4000_C000 |
4 KB | bölüm 3.1 |
| IO_BANK0 | 0x4001_4000 |
4 KB | bölüm 3.2 |
| PADS_BANK0 | 0x4001_C000 |
4 KB | bölüm 3.3 |
| UART0 | 0x4003_4000 |
4 KB | bölüm 3.5 |
| UART1 | 0x4003_8000 |
4 KB | bölüm 3.5a |
| PWM | 0x4005_0000 |
4 KB | bölüm 3.6 |
| TIMER | 0x4005_4000 |
4 KB | bölüm 3.4 |
| SIO | 0xD000_0000 |
4 KB (APB değil) | bölüm 3.7 |
| PPB | 0xE000_0000 |
1 MB | SysTick, NVIC ve SCB, çekirdeğin içinde |
SRAM 264 KB'dir ve 0x2000_0000 ile 0x2004_2000 arasında kesintisizdir. SRAM0..SRAM3 şeritlemesi, tek çekirdekte yazılımdan görünür bir etkisi olmayan bir ayrıntıdır, bu yüzden model tek düz bir dizidir; aynı bankaların şeritsiz takma adları olan 0x2100_0000 ve 0x2110_0000 eşlenmemiştir ve 0x4002_0000 XIP önbellek bakım penceresi de eşlenmemiştir. Eşlenmiş bir bölgenin dışındaki her şey bir veri yolu hatasıdır; ARMv6-M'de bu HardFault'a yükselir; parça hataları sayar ve bir çökme bildirir (bölüm 5). Eşlenmiş bir bloğun içindeki uygulanmamış bir kayıt okunduğunda 0 verir ve yazmaları yok sayar; tanılama için bir sayaç tutulur.
Her APB çevre birimi bloğu ayrıca +0x1000 (atomik XOR), +0x2000 (atomik set) ve +0x3000 (atomik temizleme) adreslerinde de takma adlara sahiptir; RP2040 firmware'i bir biti oku-değiştir-yaz yapmadan ayarlamak için bunu kullanır. Model, uyguladığı her çevre birimi için üçünü de uygular. SIO bir APB bloğu değildir ve çipte olduğu gibi takma adı yoktur.
Firmware ELF. loadProgram bir ELF32 little-endian ARM çalıştırılabilir dosyası alır (e_machine 40). Her PT_LOAD segmenti XIP flash veya SRAM içinde olmalıdır; .data, p_paddr adresine (flash içinde) yüklenir ve çalışma zamanındaki crt0 onu, donanımda olduğu gibi, aşağı kopyalar. İkinci aşama önyükleyici yoktur: model bir boot2 bloğu istemez, çalıştırmaz ve sağlamasını yapmaz; imgedeki 256 baytlık .boot2 bölümü yalnızca yüklenir, asla çalıştırılmaz. Sıfırlama, vektör tablosunu yüklenen en düşük flash adresinden alır: VTOR oraya ayarlanır, SP_main 0. kelimeden ve giriş noktası 1. kelimeden gelir, tıpkı işlemcinin sıfırlamadan çıkışta yaptığı gibi. ELF'in e_entry değeri kullanılmaz; bir vektör tablosu gereklidir. Çalışma zamanında bir yükleme kartı sıfırlar.
3. Çevre birimi kayıtları (alt küme, gerçek ofsetler, gerçek bit konumları)
Kayıtlar 32 bit ve kelime hizalıdır. Bir çevre birimi kaydına bayt ve yarım kelime erişimi desteklenmez (okuma, hizalı kelimenin daraltılmış halini verir; yazma, dar değerden tamamını yazar); firmware bunu yapmamalıdır. SRAM ve flash her genişliği kabul eder.
3.1 RESETS (0x4000_C000)
| ofset | ad | bitler |
|---|---|---|
0x00 |
RESET |
1 = blok sıfırlamada tutuluyor |
0x04 |
WDSEL |
saklanır, geri okunur |
0x08 |
RESET_DONE |
1 = blok resetten çıkmış ve hazır |
Bit numaralandırması veri sayfasındakidir: 5 io_bank0, 8 pads_bank0, 14 pwm, 21 timer, 22 uart0, 23 uart1. RESET_DONE, RESET'in tersidir ve gecikme yoktur: bir blok, biti temizlendiği an sıfırlamadan çıkar, bu yüzden alışılmış while (!(resets_hw->reset_done & bits)) döngüsü doğrudan geçer. Sıfırlamadan çıkınca buradaki her blok açılış değerlerini okur; bir bloğu sıfırlamada tutmak onu bu değerlere döndürür ve io_bank0 veya pads_bank0 sıfırlamada tutulurken her pad yüksek empedanstadır. Modelin uygulamadığı bloklar bitlerini kabul eder ve hazır bildirir.
3.2 IO_BANK0 (0x4001_4000)
| ofset | ad | bitler |
|---|---|---|
0x00 + 8n |
GPIOn_STATUS |
bit 8 OUTTOPAD, bit 13 OETOPAD, bit 17 INFROMPAD, salt okunur |
0x04 + 8n |
GPIOn_CTRL |
4..0 bitleri FUNCSEL, 9..8 OUTOVER, 13..12 OEBEYAZ, 17..16 INOVER |
0x0F0 + 4m |
INTRm |
8m..8m+7 GPIO'ları için ham kesme, her biri dört bit |
0x100 + 4m |
PROC0_INTEm |
etkinleştirme, aynı düzen |
0x110 + 4m |
PROC0_INTFm |
zorlama, aynı düzen |
0x120 + 4m |
PROC0_INTSm |
ham VE etkinleştirme, VEYA zorlama |
FUNCSEL: 4 = PWM, 5 = SIO, 31 = NULL (pad serbest bırakılır). Diğer her şey (SPI 1, UART 2, I2C 3, PIO0 6, PIO1 7, saatler 8, USB 9) kabul edilir, saklanır ve geri okunur ama pad'i serbest bırakılmış halde tutar, çünkü bu çevre birimleri modellenmemiştir. Çipte olduğu gibi her pinde açılış değeri 31'dir, bu yüzden firmware'in bir pad bir şey yapmadan önce SIO'yu seçmesi gerekir ve firmware/pico/ bunu yapar.
OUTOVER/OEOVER: 0 = çevre biriminin sinyali, 1 = ters çevrilmiş, 2 = düşük seviyeye çek (OEOVER 2 = devre dışı bırak), 3 = yüksek seviyeye çek (OEOVER 3 = etkinleştir). INOVER, giriş için aynı dört değerdir.
GPIO başına dört kesme biti şunlardır: 0 LEVEL_LOW, 1 LEVEL_HIGH, 2 EDGE_LOW, 3 EDGE_HIGH. Kenar bitleri kilitlenir ve INTRm içinde kendilerine 1 yazılarak temizlenir; seviye bitleri pad'i izler ve temizlenemez. PROC0_INTSm içindeki herhangi bir bit ayarlanırsa IO_IRQ_BANK0 (IRQ 13) tetiklenir.
3.3 PADS_BANK0 (0x4001_C000)
| ofset | ad | bitler |
|---|---|---|
0x00 |
VOLTAGE_SELECT |
saklanır, geri okunur |
0x04 + 4n |
GPIOn |
0 SLEWFAST, 1 SCHMITT, 2 PDE, 3 PUE, 4..5 DRIVE, 6 IE, 7 OD |
Açılışta veri sayfasında belirtildiği gibi her patta IE clear, PUE clear, PDE set, SCHMITT set, DRIVE = 1 (4 mA) olur. IE clear iken ağ ne yaparsa yapsın giriş 0 okunur; OD set iken seçili çevre birimi ne isterse istesin pad serbest bırakılır; DRIVE ve SLEWFAST saklanır ve geri okunur ama kaynak empedansını değiştirmez, o her zaman R_STRONG olur.
3.4 TIMER (0x4005_4000)
64 bitlik bir mikrosaniye sayacı ve dört 32 bitlik alarm. Parçanın saati budur: micros() ve millis() onu okur, delay() bir alarmda uyur.
| ofset | ad | bitler |
|---|---|---|
0x00 0x04 |
TIMEHW TIMELW |
salt yazma, tüm sayıcının kilitlenmiş yazımı |
0x08 |
TIMEHR |
yüksek kelime, son TIMELR okumasıyla sabitlenir |
0x0C |
TIMELR |
düşük kelime; okunduğunda yüksek kelimeyi TIMEHR içine kilitler |
0x10 + 4n |
ALARMn |
n = 0..3; yazmak kurar, yazma ayrıca INTR bitini de temizler |
0x20 |
ARMED |
bit n = alarm n kurulu; devre dışı bırakmak için 1 yaz |
0x24 0x28 |
TIMERAWH TIMERAWL |
mandallama yapmayan sayıcı |
0x2C |
DBGPAUSE |
saklanır, geri okunur |
0x30 |
PAUSE |
bit 0 sayacı durdurur |
0x34 |
INTR |
bit n = alarm n tetiklendi; temizlemek için 1 yaz |
0x38 0x3C 0x40 |
INTE INTF INTS |
etkinleştirme, zorlama ve ham VE etkinleştirme VEYA zorlama |
Sayaç çekirdek zamanından türetilir: microseconds = (now_ps - origin_ps) / 1_000_000; başlangıç noktası ilk dilimde sabitlenir. Devreden asla kaymaz. Bir alarm, sayacın düşük 32 biti kurulu değere ulaştığında tetiklenir, kendini söker ve INTR bitini set eder; INTS biti n, TIMER_IRQ_n (IRQ 0..3) kesmesini tetikler. Bir alarm yazmak ayrıca INTR bitini temizler. Karşılaştırıcı yalnızca düşük 32 bitleri görür, bu yüzden az önce geçilmiş bir değere kurulan alarm 71.6 dakika boyunca tetiklenmez; donanımda da tam olarak böyledir ve firmware/pico/ bu yüzden kurduktan sonra ve beklemeye geçmeden önce saati yeniden okur.
3.5 UART0 (0x4003_4000)
Bir PL011. Bu, ana bilgisayar kanalıdır; padler işin içinde değildir.
| ofset | ad | bitler |
|---|---|---|
0x00 |
UARTDR |
yazma: ilet; okuma: al (düşük 8 bit, hata bitleri 0 olarak okunur) |
0x04 |
UARTRSR |
0 okur |
0x18 |
UARTFR |
3 BUSY, 4 RXFE, 5 TXFF, 6 RXFF, 7 TXFE |
0x24 0x28 |
UARTIBRD UARTFBRD |
baud = 125 MHz / (16 (IBRD + FBRD/64)); saklanır ve TX hız dengelemesi için kullanılır |
0x2C |
UARTLCR_H |
saklanır; 4. bit FEN FIFO'ları etkinleştirir (temizlenirse boşaltılır) |
0x30 |
UARTCR |
0 UARTEN, 8 TXE, 9 RXE |
0x34 |
UARTIFLS |
saklanır, geri okunur |
0x38 |
UARTIMSC |
4 RXIM, 5 TXIM, 6 RTIM |
0x3C 0x40 |
UARTRIS UARTMIS |
ham ve maskeli kesme durumu |
0x44 |
UARTICR |
temizlemek için 1 yaz |
0x48 |
UARTDMACR |
saklanır, geri okunur |
Her iki FIFO da çipte olduğu gibi 32 girişlidir ve FEN temizken tek girişe düşer. TX baytları FIFO'dan, yapılandırılmış baud hızında ana kanala çıkar (programlanmamış bir bölücü 115200'e düşer: her 86.8 us'de bir bayt, on bit) ve herhangi bir bayt hâlâ çıkarken BUSY set edilir; dolu TX FIFO'ya yapılan yazım düşürülür, donanım da aynısını yapar. RX baytları ana kanaldan anında gelir. RXRIS, RX FIFO tetik seviyesinde veya üzerindeyken yükselir (yarı, UARTIFLS sıfırlama değeri, yani 16 giriş) ve RTRIS, RX'te herhangi bir şey varken 32 bit süresi boyunca bayt gelmediğinde yükselir, böylece ikisinden birini bekleyen bir sürücü tek bir yazılan karakter görür. UARTMIS'de set edilen herhangi bir bit UART0_IRQ'ı yükseltir (IRQ 20).
Alma FIFO'sunun arkasında 256 baytlık bir ana bilgisayar birikimi var, bu donanım değildir: program FIFO'yu boşalttıkça birikim FIFO'ya akar, böylece kod Serial.read() çağrıları arasındayken seri monitöre bir satır yapıştırmak karakter kaybetmez. Uno modelinde de aynı nedenle aynı şey vardır. Birikim de doluysa veriyi düşürür, tıpkı gerçek bir taşmada olduğu gibi.
3.5a UART1 (0x4003_8000)
Diğer PL011, UART0'ın kayıtlarıyla UART0'ın ofsetlerinde ve her açılışta eşlenmiş durumda. UART0'dan farklı olarak ana kanala değil pad'lerine bağlıdır, bu yüzden Arduino çalışma zamanında Serial2, MicroPython'da machine.UART(1)'dir ve pinlerine ne bağlıysa onunla konuşur: bir GPS modülü, bir HC-05, başka bir kartın RX ve TX'i. Kareleri, ESP32'nin UART1 ve UART2'sinin kullandığı kare motorundan (crates/esp-common/src/wire_uart.rs) tek tek bit halinde çıkar ve girer:
- Pinler. Bir GPIO'nun
FUNCSEL'i 2 (UART) olduğunda ve 4 ile 11 veya 20 ile 27 arasından olduğunda (veri sayfası 2.19.2) o GPIO UART1'e aittir;n % 40 iseTX, 1 iseRX'tir. Yani GP4/GP5, GP8/GP9, GP20/GP21 ve GP24/GP25 onun çiftleridir.TXher zaman sürülür, boştayken yüksek;RXbir giriştir;CTSveRTSmodellenmez. UART0 pinindeki aynı fonksiyon hiçbir şey sürmez (UART0 ana kanaldır). - İletim.
UARTDR'ye yazılan bir bayt, kaydırıcı boş olduğu anda, bölenin verdiği bit süresinde,16 (IBRD + FBRD/64)döngü ile çerçevesine başlar ve seviyenin her değişimi olduğu döngüde pad'e ulaşır.LCR_Hçerçeveyi verir:WLENbeş ile sekiz bit arası,EPSile birliktePEN,STP2.UARTENveyaTXEtemizken hiçbir şey dışarı çıkmaz. - Alma.
RXpad'inin seviyesi, kart parçasının bildirdiği gibi, anlattığı anda alınır. Boştaki bir hattaki düşüş bir çerçeve başlatır, her bit kendi yuvasının ortasında örneklenir ve bayt dur bitinin ortasına oturur; böylece uyumsuz bir baud hızında burada da masada olduğu gibi anlamsız veri okunur.RTRIS, FIFO boş değilken son bayttan 32 bit süresi sonra yükselir. - FIFO'lar ve bayraklar. Her biri
FENile 32 girdi, biri hariç, UART0'daki gibi;UARTFR,UARTRIS,UARTMISveUARTICR, bölüm 3.5'teki gibi.UARTMIS'teki herhangi bir bitUART1_IRQ'yi (IRQ 21) yükseltir.
Arduino çalışma zamanının Serial2.begin() fonksiyonu GP4 ve GP5'i (ya da setTX() ve setRX() fonksiyonlarının seçtiği pinleri) UART fonksiyonuna bağlar ve RX'in pull-up'ını açar, böylece hiçbir şey bağlanmamış bir port boşta olan hattı okur.
3.6 PWM (0x4005_0000)
Sekiz dilim, her birinde iki kanal. n çift olduğunda GPIO n, (n / 2) % 8 numaralı dilimin A kanalıdır, tek olduğunda B kanalıdır; dolayısıyla kart üzerindeki LED olan GP25, dilim 4 kanal B'dir.
| ofset | ad | bitler |
|---|---|---|
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 tamsayı, 3..0 kesir: sayaç, her DIV/16 sistem saatinde bir adım atar |
0x08 + 0x14 s |
CHs_CTR |
sayaç, 16 bit; yazılabilir |
0x0C + 0x14 s |
CHs_CC |
15..0 A kanalı karşılaştırması, 31..16 B kanalı |
0x10 + 0x14 s |
CHs_TOP |
15..0 sarmalama değeri; sıfırlama 0xFFFF |
0xA0 |
EN |
s biti s dilimini etkinleştirir, kendi CSR.EN bitiyle aynıdır |
0xA4 0xA8 0xAC 0xB0 |
INTR INTE INTF INTS |
dilim başına sarmalama kesmesi |
Bir kanalın çıkışı CTR < CC iken yüksek, CTR == CC'den sarmal noktasına kadar düşüktür; bu yüzden CC = 0 her zaman düşük, CC > TOP her zaman yüksektir. analogWrite(pin, 255) fonksiyonunun CC'yi TOP'a değil TOP + 1'e ayarlamasının nedeni budur. A_INV ve B_INV çıkışı ters çevirir. Çıkış, o GPIO'nun FUNCSEL değeri 4 olduğu sürece pade ulaşır: PWM bloğu pad'in çıkış etkinleştirmesini kendi başına açar, bu yüzden bir programın yapması gereken tek şey fonksiyonu seçmektir ve SIO.GPIO_OE'ye bakılmaz.
DIVMODE 0 (serbest çalışan) modellenmiştir. 1..3 modları B pini ile kapılı ya da B pininden tetiklenmiş şekilde sayar; bu, modelin yönlendirmediği bir girdi gerektirir, bu yüzden kabul edilip saklanırlar ama serbest çalışan gibi sayarlar. PH_CORRECT modellenmemiştir: bunu ayarlanmış bir dilim yine de arka kenardan sayar, bu da periyodunu yarıya indirir. INTS'te herhangi bir bit ayarlıysa PWM_IRQ_WRAP yükselir (IRQ 4).
3.7 SIO (0xD000_0000)
Tek çevrimli G/Ç: çekirdeğin gerçekten yazdığı GPIO, artı donanım bölücüsü.
| ofset | ad | bitler |
|---|---|---|
0x000 |
CPUID |
0 okur: çekirdek 0 tek çekirdektir (bölüm 5) |
0x004 |
GPIO_IN |
n biti = GPIO n girişinin seviyesi (PADS.IE gerektirir) |
0x008 |
GPIO_HI_IN |
altı QSPI pad'i; 0 okur |
0x010 0x014 0x018 0x01C |
GPIO_OUT _SET _CLR _XOR |
çıkış seviyesi, bit 0..29 |
0x020 0x024 0x028 0x02C |
GPIO_OE _SET _CLR _XOR |
çıkış etkinleştirme, 0..29 arası bitler |
0x030..0x04C |
GPIO_HI_OUT/_OE ve takma adları |
saklanır; pad yok |
0x050 |
FIFO_ST |
2 okur (RDY ayarlı, VLD temiz): çekirdek 1 hiçbir zaman yanıt vermez |
0x054 0x058 |
FIFO_WR FIFO_RD |
yazım atılır, okuma 0 verir |
0x05C |
SPINLOCK_ST |
n biti = n spinlock tutulmuş |
0x060..0x078 |
DIV_UDIVIDEND DIV_UDIVISOR DIV_SDIVIDEND DIV_SDIVISOR DIV_QUOTIENT DIV_REMAINDER DIV_CSR |
donanım bölücüsü |
0x100 + 4n |
SPINLOCKn |
talep etmek için oku (zaten tutuluyorsa 0), bırakmak için yaz |
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 Kesmeler
NVIC, SysTick ve SCB, mimari PPB adreslerinde cortexm-core içindedir; veri yolu onları asla görmez. ARMv6-M iki öncelik biti ve 32 harici kesme hattı verir. Bu modelin sürdüğü hatlar:
| IRQ | ad | şunun tarafından yükseltilir |
|---|---|---|
| 0..3 | TIMER_IRQ_0..3 |
TIMER.INTS bit n |
| 4 | PWM_IRQ_WRAP |
PWM.INTS sıfırdan farklı |
| 13 | IO_IRQ_BANK0 |
herhangi bir IO_BANK0.PROC0_INTS* sıfırdan farklı |
| 20 | UART0_IRQ |
UART0.UARTMIS sıfırdan farklı |
Her biri bir seviyedir, çevre biriminin durumu sürdüğü sürece yüksek tutulur, yani kaynağı temizlemeyen bir işleyiciye yeniden girilir, tam olarak donanımdaki gibi. Diğer tüm IRQ numaraları NVIC'te mevcuttur ve asla tetiklenmez.
WFI, bekleyen etkin bir kesme olana kadar çekirdeği beklemeye alır (bölüm 5). WFE aynı şekilde davranır, ayrıca mimarinin tanımladığı olay kaydıyla birlikte; SEV kabul edilir ve onu ayarlar.
3.9 WATCHDOG (0x4005_8000) ve PSM.WDSEL (0x4001_0000)
CTRL (ENABLE, TRIGGER, saklanan duraklatma bitleri, TIME sayacı), LOAD, REASON, SCRATCH0..7 ve TICK (saklıdır; tick, hangi değeri tutarsa tutsun bir mikrosaniyedir). Sayaç bir mikrosaniyede iki azalır; bu RP2040-E1 erratum'ıdır ve SDK'nın ms * 2000 yüklemesinin nedeni budur. Sıfıra ulaştığında ya da TRIGGER geldiğinde REASON, TIMER veya FORCE der ve PSM.WDSEL çekirdek 0'ı seçiyorsa (SDK, osilatörler hariç her şeyi seçer), çip yeniden başlar: devrenin saati çalışır durumdadır, REASON ve scratch yazmaçları korunur ve watchdog kapalıdır. Çalışma zamanı, SDK'nın hardware/watchdog.h dosyasını ve arduino-pico'nun rp2040.wdt_begin(), wdt_reset(), reboot() ve restart() işlevlerini bu yazmaçlar üzerinde sunar. Boot ROM'un bir watchdog_reboot() pc'sine atlaması modellenmemiştir: yeniden başlatma, programı en baştan başlatır.
4. Ana makine kanalı
host = "UART0 üzerindeki utf-8 baytları". readHost, UART0 TX baytlarını FIFO'dan çıkarken, ayarlanmış baud hızında döndürür; writeHost baytları UART0 RX FIFO'suna iter (taşma olursa, çipteki gibi bırakılır). Seri monitör baytları metin olarak gösterir, UTF-8'i çözümler ve \n karakterini satır sonu sayar (\r yok sayılır). ESP32-C3 kanalıyla aynı semantiğe sahiptir.
5. Zaman modeli ve parça
Tek çekirdek, 125 MHz. SoC, 10 us = 1250 çevrimlik dilimlerle çalışır ve çekirdeğin çevrim sayacı saat olarak kullanılır: cortexm-core her komutun veri sayfasındaki çevrim sayısını hesaplar, dolayısıyla simüle edilen zaman çevrim sayısının 125 MHz'e bölümüdür. Çevrim sayacı her dilimin başında kernel zamanına sabitlenir, tıpkı ATmega328P modelinin kendi sayacını sabitlemesi gibi, böylece dilimler nereye düşerse düşsün bir zamanlayıcı devreden asla uzaklaşamaz.
İkinci çekirdek modellenmedi. SIO.CPUID 0 okur, çekirdekler arası FIFO kalıcı olarak boş ve okumaya asla hazır değildir ve çekirdek 1'i başlatmanın bir yolu yoktur: FIFO_WR adresine başlatma dizisini yazıp yanıt bekleyen bir program sonsuza kadar bekler. proofs/cortexm/REPORT.md, elimizdeki tek çekirdeği bir tarayıcıda gerçek bir 125 MHz RP2040'ın 0.85x hızında ölçüyor; yani ikinci bir yorumlanmış çekirdek bu hızı yarıya düşürürdü. Bu bir 5. Aşama kararıdır, üstü kapatılacak bir 4. Aşama eksikliği değildir. firmware/pico/ içindeki her şey tek çekirdeklidir.
İki vites. Uno modelinin aksine çekirdek, her zaman bir komutla ilerletilmez: bunun için yer yoktur. Bir dilim 128 çevrimlik (1.024 us) parçalar hâlinde çalıştırılır; bu da bir pin değişikliğine damga vurulan zamandaki hatayı sınırlar. Tek bir parçanın içindeki birkaç değişiklik sırasını korur ve parçaya yayılır, yani asla çakışmazlar. Bir parça, bir sonraki zamanlanmış çevre birimi olayının (bir zamanlayıcı alarmı, bir PWM kenarı, bir UART baytının çıkışı) tam çevriminde kesilir; böylece bunlar olması gereken çevrime denk gelir ve micros() tamdır.
SIO.GPIO_OUT veya SIO.GPIO_OE'yi (takma adlarının herhangi biri üzerinden) değiştiren bir yazma, sonraki rp2040::FINE_CYCLES süresince (12.500 çevrim, 100 us) ince vitese geçer: parça başına bir talimat, böylece her pin değişikliği onu yapan yazma talimatının çevrimini taşır. Bit-banged bir protokolün ihtiyacı olan budur; bir WS2812 bitinin kısa yüksekliği 0.4 us'dir ve mokxi_ws2812.h şeridi bu şekilde sürer (Uno R4 modeli de aynı iki vitese sahiptir). Vitesi açan yazma talimatı hâlâ kaba parçasına damgalanır, yani buna önem veren bir sürücü önce bir tane yapar.
Uyku bekletir. WFI dilimlemeyi durdurur: parça, bir sonraki uyanışını kurulu zamanlayıcı alarmlarının en erkenine, sürülen bir pad'deki bir sonraki PWM kenarına ve bir sonraki UART olayına zamanlar; bir pin değişikliği veya bir ana makine baytı onu hemen uyandırır. Boşta çalışan bir kod, çekirdeğe saniyede 125 milyon çevrim yerine bir avuç olaya mal olur, çalışma zamanındaki delay() işlevinin uyumasının tüm nedeni budur.
SIO.GPIO_IN okumaları, pin seviyelerini parçanın başındaki haliyle, ayrıca kodun kendisinin parça içinde yaptığı değişikliklerle birlikte görür.
Prob: bir bit maskesi, program yokken 0.
| bit | anlam |
|---|---|
| 1 | çalışıyor (talimat yürütüyor, reset durumunda değil, çökmemiş) |
| 2 | WFI ile beklemeye alınmış |
| 4 | GP25 pinindeki kart üstü LED yanıyor |
| 8 | son 20 ms içinde seri gönderim |
| 16 | son 20 ms içinde seri alma |
Poke: 1 = BOOTSEL'e bas, 0 = bırak (modelde bootsel buton işlevi yoktur: basmak sadece görseli yakar, çünkü BOOTSEL, modellenmemiş olan QSPI çip seçme pedi üzerinden okunur); 2 = RUN'ı düşük tut, 3 = bırak.
Çökme işleme, docs/esp32c3.md bölüm 5'teki gibidir. ARMv6-M'de her hata bir HardFault'tur ve HardFault önceliğinde alınan bir hata Lockup'tır, bunu cortexm-core Trap::Lockup olarak bildirir. Parça bir Trap üzerinde durur (bir Lockup veya hata ayıklayıcısız bir BKPT) ve ana makine kanalına bir satır yazdırır:
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.
Çalışma zamanı (firmware/pico/src/gpio.c) arduino-pico'nun yaptığını yapar: analogRead() yalnızca GP26 ile GP29 arasını (A0 ile A3) okur, padi dönüştürücüye devreder (pull-up yok, dijital giriş yok) ve analogReadResolution() başka bir genişlik istemediği sürece on bit döndürür; analogReadTemp() 4 numaralı girişi veri sayfasındaki formülle okur.
Modellenmeyenler: FIFO ve DMA, round robin, ADC kesmesi, DIV'in tempo ayarı, dönüştürme gürültüsü ve girişin kaynağa olan yükü.
6. Modellenmeyenler
PIO, DMA, SPI, I2C, USB denetleyicisi, RTC, saat ağacı (CLOCKS, XOSC, PLL_SYS, PLL_USB: sistem saati sıfırlamadan itibaren 125 MHz), imajın okunmasının ötesindeki QSPI pad'leri ve flash arayüzü, ikinci çekirdek, çip üzerindeki ROM ve işlev tablosu, ve interpolatörler. Adres blokları eşlenmediği için bunlara dokunmak sessiz bir sıfır yerine veri yolu hatası verir (tam şekilde önyüklenmiş bir MicroPython kartı I2C, SPI ve DMA'yı eşler: docs/micropython.md bölüm 3). İstisna, bölüm 3'te listelenen bloklardır; orada uygulanmış bir bloğun içindeki uygulanmamış bir register 0 okunur ve sayılır.
7. Firmware çalışma zamanı (firmware/pico/)
clang 18 ile derlenmiş (--target=thumbv6m-none-eabi -mcpu=cortex-m0plus -mthumb -Os) ve ld.lld ile bağlanmış, RP2040 için bağımsız bir C ve C++ çalışma zamanı: Pico SDK yok, newlib yok, libgcc veya compiler-rt yok, GPL olan hiçbir şey yok:
crt0.S: vektör tablosu (16 sistem girişi artı 32 IRQ),Reset_Handler(.data'yı flash'tan kopyala,.bss'ü temizle, C++ yapıcılarını çalıştır,main'i çağır) ve Cortex-M0+'nın bölme komutu ve uzun çarpma komutu olmadığı için ihtiyaç duyduğu AEABI yardımcıları:__aeabi_uidiv,__aeabi_uidivmod,__aeabi_idiv,__aeabi_idivmod,__aeabi_lmul,__aeabi_llsr,__aeabi_llslve bellek yardımcıları.link.ld:.textve.rodataXIP flash'ta0x1000_0000adresinde,.datave.bssSRAM'de0x2000_0000adresinde, yığın SRAM'in tepesinden (0x2004_2000) aşağı doğru.boot2yok.include/rp2040.h: bölüm 3'teki register'lar gerçek adlarıyla makro olarak tanımlıdır.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.- arduino-pico'nun
rp2040nesnesi:loop()ileloop1()arasındaki FIFO,f_cpu(),getCycleCount(), bölüm 3.9'daki watchdog çağrıları ve programın verisi ile yığını arasındaki çalışma zamanının öbek belleğini okuyangetFreeHeap(),getUsedHeap()vegetTotalHeap(). WiFi.hyok. Pico'da kablosuz çip olmadığı için ağ başlıkları onun için derlenmez ve derlemenin önerisi, kartı aynı pinlere sahip bir Pico W ile değiştirmektir. Pico W ise bu çalışma zamanının şu eklerle sahip halidir:-DMOKXI_BOARD_PICO_W, bu simüle edilmiş ağ posta kutusunu eşleştirir ve şunları getirir:WiFi.h,HTTPClient.h,WebServer.hve arduino-pico'nun bunlar için kendi adları (docs/picow.mdbölüm 6 ve 7).analogWrite(pin, 0..255)her GPIO'da çalışır, çünkü her birinin bir PWM kanalı vardır:FUNCSEL4 olur ve dilim, 65.536 sayımının bir periyoda ulaşmasını sağlayan en küçük bölücüyü alır; böylece varsayılan 1 kHz'de bölücü 1,9375 veTOP64.515'tir.analogWriteFreq()(100 Hz ile 1 MHz arası),analogWriteRange()veanalogWriteResolution()arduino-pico'ya aittir: yeni bir frekans, üzerindeki bir pin bir dahaki yazılışta dilimi yeniden şekillendirir ve aralık, tamamen açık anlamına gelen değerdir (varsayılan 255). 0 ve tam ölçek PWM bağlantısını keser ve pini düşük ya da yüksek seviyede sürer, yanianalogWrite(pin, 0)gerçekten kapalıdır.millis()/micros()TIMER'ı okur, bu yüzden tamdır ve asla kaymaz.delay()ve 50 us ya da üzeri birdelayMicroseconds()zamanlayıcı alarmı 0'ı kurup tetiklenene kadarWFIyapar; daha kısa beklemelerTIMERAWLüzerinde döner.attachInterrupt(pin, handler, mode),IO_IRQ_BANK0ile çalışır;RISING,FALLING,CHANGE,ONLOWveONHIGHdörtINTRbitine eşlenir.digitalPinToInterrupt(pin)pinin kendisidir: her GPIO'nun bir tane vardır.
firmware/pico/examples/<name>/sketch.ino altındaki örnekler, web/public/firmware/pico/<name>.elf olarak derlenir ve Uno diziniyle aynı biçimde web/public/firmware/pico/index.json dosyasında yer alır; her girdi "program": "elf32 arm rp2040" taşır: blink (GP25), button (iç pull-up ile GP15, GP25'i yakar), serial (saniyede bir millis() yazdırır ve aldığını geri yollar), fade (GP25 üzerinde PWM).
Arayüz, firmware listesini parçanın katalogdaki program dizgisine göre seçer: "elf32 riscv32imc" ise /firmware/index.json, "elf32 avr atmega328p" ise /firmware/uno/index.json, "elf32 arm rp2040" ise /firmware/pico/index.json okunur.
8. Bu modelin emin olduğu ve emin olmadığı şeyler
Üç grup, docs/esp32c6.md bölüm 7'nin kullandığıyla aynı sıralama. Bunun nedeni, sessizce bir adresi tahmin eden bir kart modelinin, bilmediğini söyleyen modelden daha kötü olmasıdır.
Veri sayfasından alınmıştır ve gerçek firmware ile çalıştırılmıştır. Bölüm 2 ve 3'teki her taban adresi, yazmaç ofseti ve bit konumu RP2040 Datasheet'ten (Raspberry Pi Ltd) gelir; hw_set_bits'i çalıştıran +0x1000, +0x2000 ve +0x3000'deki üç atomik takma ad dahil. Bölüm 1'deki kırk pinli başlık sırası Pico'nun kendi sırasıdır. crates/rp2040/tests/firmware.rs gerçek ELF'leri yükler ve RESETS, IO_BANK0, PADS_BANK0, SIO, TIMER, UART0 ile PWM dilimlerini bunlarla sürer.
Modellenmiş ama veri sayfasının sayılarına bağlı tutulmamış. Adreslerden çok davranışlar:
- Çekirdek, talimat talimat yerine 128 çevrimlik parçalar halinde çalışır; yalnızca program bir pini değiştirdikten sonraki 100 us boyunca tek tek ilerler (bölüm 5, "İki vites"). Bir parça 1.024 us sürer ve bir sonraki zamanlanmış çevre birimi olayının tam çevriminde kesilir; böylece timer alarmları, PWM kenarları ve UART baytları doğru yerlerine düşer. Ancak uzun bir sessiz dönemden sonra yazılımın yaptığı ilk pin değişikliği parçanın yuvarlama hatasını taşır ve en fazla 1.024 us kayabilir; onu izleyenler tam isabetlidir. Uno modeli her pad değişikliğini tam çevrimine damgalar; bu modelde buna her seferinde gücü yetmez, çünkü 125 MHz'de hiç performans payı yoktur (
proofs/cortexm/REPORT.md: tarayıcıda gerçek zamanın 0.85x'i). - Sistem saati sıfırlamadan itibaren 125 MHz'dir ve asla değişmez. Saat ağacı modellenmediği için
clocks_init, kristal, her iki PLL ve kodun ayarladığı herhangi bir frekans yok sayılır ve yanıt hep 125 MHz'dir. Flash bekleme durumları ve XIP önbelleği de yoktur, bu yüzden yerinde çalıştırma SRAM hızında çalışır. - Padler üç durum ve bir eşikten oluşur. 3.3 V'da push-pull, yüksek empedans veya 55 kΩ dahili çekme (veri sayfası yaklaşık 50 kΩ ile 80 kΩ arasında veriyor), yarı besleme gerilimine karşı okunur; histeresis yok, sürücü gücü ayarı yok, yükselme hızı kontrolü yok, yükselme süresi yok ve akım sınırı yok.
- Güç pinleri bir güç ağacı değil, sayılardır.
VSYS4.7 V'dur, yaniVBUSeksi Schottky düşüşü;3V3_EN100 kΩ'luk bir çekme direncidir ve 1.2 V altına çekmek kartı durdurur;RUN50 kΩ'luk bir çekme direncidir;ADC_VREF200 Ω arkasından 3.3 V verir. Regülatörün hiçbir davranışı modellenmez, hiçbir şey sarkmaz ve hiçbir şey kesilmez, ayrıca GP24'tekiVBUSalgılaması basitçe yüksek seviyeye bağlıdır. - Başlangıç bir mikrosaniyedir; boot ROM yok ve ikinci aşama önyükleyici yok: görüntü yerleştirilir ve çalıştırılır.
BOOTSELtuşunu basılı tutmak, modelin bildirdiği bir poke'dur; arkasında bir depolama aygıtı yoktur.
Bilinçli olarak yok, bölüm 6'da listelendiği gibi: ikinci çekirdek, PIO, DMA, SPI, I2C, USB, RTC, saat ağacı, QSPI padleri, görüntüyü okumanın ötesinde flash arayüzü, çip üstü ROM ve işlev tablosu, ve interpolatörler. Adres blokları eşlenmemiştir, yani birine dokunmak sessiz bir sıfır yerine veri yolu hatası verir. ADC istisnadır: bölüm 5a.