Başvuru

Raspberry Pi Pico kart sözleşmesi (Faz 4)

Cortex-M0+ çekirdeğimiz üzerindeki RP2040; SIO GPIO, TIMER, UART0 ve PWM ile birlikte.

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_SUPPLY direnciyle 3,3 V verir; her GND* ve AGND, R_SUPPLY direnciyle 0 V verir. VBUS R_SUPPLY direnciyle 5 V, VSYS ise 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..GP22 ve GP26..GP28 iki yönlü GPIO'dur. Çıkış etkinse (SIO.GPIO_OE biti 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.PUE set olduğunda 3,3 V'a 55 k pull-up, PDE set 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.md bö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; IE biti 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, GP24 ve GP25 modelde vardır ama gerçek karttaki gibi konektörde bulunmaz: GP23 SMPS güç tasarrufu denetimidir, GP24 VBUS algılamasıdır (1 okur, çünkü model her zaman USB ile beslenir) ve GP25 kart ü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, GP27 ve GP28, ADC0..ADC2'dir ve ADC modellenmiştir (bölüm 5a): analogRead(26), ağdaki voltajı okur. ADC_VREF dönüştürücünün 3.3 V referansıdır ve AGND bir 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 % 4 0 ise TX, 1 ise RX'tir. Yani GP4/GP5, GP8/GP9, GP20/GP21 ve GP24/GP25 onun çiftleridir. TX her zaman sürülür, boştayken yüksek; RX bir giriştir; CTS ve RTS modellenmez. 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: WLEN beş ile sekiz bit arası, EPS ile birlikte PEN, STP2. UARTEN veya TXE temizken hiçbir şey dışarı çıkmaz.
  • Alma. RX pad'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 FEN ile 32 girdi, biri hariç, UART0'daki gibi; UARTFR, UARTRIS, UARTMIS ve UARTICR, bölüm 3.5'teki gibi. UARTMIS'teki herhangi bir bit UART1_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_llsl ve bellek yardımcıları.
  • link.ld: .text ve .rodata XIP flash'ta 0x1000_0000 adresinde, .data ve .bss SRAM'de 0x2000_0000 adresinde, yığın SRAM'in tepesinden (0x2004_2000) aşağı doğru. boot2 yok.
  • 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, Serial with begin/print/println/write/available/read/peek, with LED_BUILTIN = 25. Serial1 is Serial (both UART0, the serial monitor); Serial2 is UART1 on GP4 and GP5, or the UART1 pins setTX() and setRX() pick (section 3.5a). src/serial.c drives both by base address. The Nano RP2040 Connect has no Serial2.
  • arduino-pico'nun rp2040 nesnesi: loop() ile loop1() 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 okuyan getFreeHeap(), getUsedHeap() ve getTotalHeap().
  • WiFi.h yok. 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.h ve arduino-pico'nun bunlar için kendi adları (docs/picow.md bölüm 6 ve 7).
  • analogWrite(pin, 0..255) her GPIO'da çalışır, çünkü her birinin bir PWM kanalı vardır: FUNCSEL 4 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 ve TOP 64.515'tir. analogWriteFreq() (100 Hz ile 1 MHz arası), analogWriteRange() ve analogWriteResolution() 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, yani analogWrite(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 bir delayMicroseconds() zamanlayıcı alarmı 0'ı kurup tetiklenene kadar WFI yapar; daha kısa beklemeler TIMERAWL üzerinde döner.
  • attachInterrupt(pin, handler, mode), IO_IRQ_BANK0 ile çalışır; RISING, FALLING, CHANGE, ONLOW ve ONHIGH dört INTR bitine 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. VSYS 4.7 V'dur, yani VBUS eksi Schottky düşüşü; 3V3_EN 100 kΩ'luk bir çekme direncidir ve 1.2 V altına çekmek kartı durdurur; RUN 50 kΩ'luk bir çekme direncidir; ADC_VREF 200 Ω 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'teki VBUS algı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. BOOTSEL tuş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.