Başvuru

ESP32 DevKit kart sözleşmesi (Boards Wave C)

Klasik ESP32, bir Xtensa LX6 üzerinde: GPIO matrisi, LEDC, ADC1 ve çipte iki çekirdek varken yalnızca tek çekirdek.

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 ESP32 DevKit V1 ve kart sayfası.

ESP32 DevKit V1, bir ESP32-WROOM-32 modülü çevresindeki otuz pinli DOIT kartıdır: 240 MHz'de bir Xtensa LX6, buradaki ilk RISC-V olmayan, AVR olmayan, Arm olmayan parça. Tek bir çekirdek bileşeni (crates/parts içinde esp32), bir Xtensa yorumlayıcısı (crates/xtensa-core) üzerinde bir ESP32 SoC modelini (crates/esp32) sarar. Bu belge sözleşmedir ve koddaki herhangi bir yorumdan üstün tutulur.

Katalog türü esp32'dir. Katalog program dizgesi: elf32 xtensa lx6 esp32.

Buradaki bir derlemeyi gerçek silikona götürüyorsan önce bölüm 6'yı oku. Adres adres, hangi sayıların ESP32 Technical Reference Manual'den geldiğini ve hangilerinin bu modelin varsayımı olduğunu söyler ve burada hiç olmayanları listeler: ikinci çekirdek, önbellek, flash, PSRAM ve iki radyo bunların arasındadır. Hiçbir şey sessizce tahmin edilmez.

Bu kart için bir kod tarayıcıda derlenir, Espressif'in LLVM çatalının wasm derlemesi olan clang-v3 ile (-mcpu=esp32), 2026-09-28'de yayımlandı ve bu simülatörde denetlendi (docs/compile.md). Dokunulmamış bir örnek hâlâ önceden derlenmiş ELF'ini web/public/firmware/esp32/ adresinden çalıştırır; onu Espressif'in GCC'si derler. Ayrıntılar bölüm 7'de.

1. Kart pinleri (katalog sırası)

Üstten görünüm, altta micro-USB soketi, üstte WROOM-32 modülü ve PCB anteni. Kart 51.5 x 28.3 mm ve iki 15 pinli konnektörü 22.86 mm (0.9 inç) arayla yerleşmiştir, bir DOIT DevKit V1'in bir breadboard'a her iki tarafta bir sıra delik boş kalacak şekilde oturmasını sağlayan da budur. Görsel onu bu boyutta çizer.

38 pinli Espressif DevKitC, insanların "bir ESP32 DevKit" derken kastettiği diğer karttır ve pin başlıkları tam bir inç arayla: bir breadboard üzerinde hiçbir sıra boş bırakmaz. Bu, otuz pinli DOIT kartıdır.

Sol konnektör, yukarıdan aşağıya (15 delik): EN, VP, VN, D34, D35, D32, D33, D25, D26, D27, D14, D12, GND, D13, VIN.

Sağ konnektör, yukarıdan aşağıya (15 delik): D23, D22, TX0, RX0, D21, D19, D18, D5, TX2, RX2, D4, D0, D2, D15, 3V3.

30 pin. Dn, GPIO ndir. VP, GPIO 36 ve VN, GPIO 39'dur: dönüştürücünün SENSOR_VP ve SENSOR_VN pinleri, ve baskılı yazı bunları işlevine göre adlandırır. TX0/RX0, GPIO 1 ve 3'tür, konsol UART'ı; TX2/RX2 ise GPIO 17 ve 16'dır. EN, çip etkinleştirmesidir ve bu kartın sıfırlama pinidir. VIN, USB 5 V hattıdır. Yinelenen isimler bir harf taşırdı, çünkü katalogdaki pin adları benzersizdir; bu kartta böyle bir pin yoktur.

GPIO 6 ile 11 hiçbir konnektörde yok. Onlar SPI flash'tır (SD_CLK, SD_DATA0..3 ve SD_CMD) ve program onlardan çalışıyor. Bir kodun onları kullanmasına izin veren kart, kendini kullanılamaz hale getiren kart olurdu, bu yüzden burada pin değillerdir. crates/parts/src/parts/esp32.rs içinde bir konnektörde görünmelerini reddeden bir test vardır.

GPIO 34 ile 39'un çıkış sürücüsü yoktur. Bu parçada onlar yalnızca giriştir: push-pull yok, open drain yok, dahili pull-up veya pull-down da yok. pinMode(34, OUTPUT) komutu GPIO_ENABLE1_REG yazısına yazar, bit tutunmaz ve pin yüksek empedansta kalır. Altının dördü konnektördedir (D34, D35, VP, VN). Model her denemeyi sayar ve kart parçası sayımı probe üzerinden bildirir (bölüm 5), çünkü bu, bir ESP32 sahibine bir öğleden sonrasına mal olan hatadır ve bunu sessizce geçen bir simülatör yanlış şeyi öğretirdi.

İki pin kart üzerinde bir şey taşır:

  • GPIO 2 üzerinde mavi bir LED vardır ve sıradan bir pad üzerindeki sıradan bir LED'dir: pad'in seviyesi lambadır, hiçbir şey bir şey çözmez. Aynı zamanda bir strapping pinidir, bu yüzden gerçek bir DevKit'in pinMode çalışmadan önceki LED durumu kartlar arasında değişir.
  • GPIO 0 BOOT butonudur, aktif düşük çalışır. Sağ konnektörde D0 olarak yer alır, yani kablolanabilir de; poke onu kartta toprağa çeker.

Elektriksel: çıkış sürücüsü olan her GPIO, R_STRONG üzerinden 3,3 V'ta push-pull sürer, high-Z durumunda kalır ya da 45 k üzerinden yukarı ya da aşağı çeker. Bir giriş, 1,65 V'ta (I/O beslemesinin yarısı) yüksek okur; çekişmeli (Unknown) bir ağ 0 okur ve boşta kalan bir ağ, Uno'daki gibi gürültü okur (docs/uno.md bölüm 1). GPIO0, BOOT butonunun yanındaki DevKit'in kendi pull-up'ı sayesinde, hiçbir şey onu tutmadığında yüksek okur. 3V3, R_SUPPLY üzerinden 3,3 V sürer; VIN, 5 V sürer; GND, 0 V sürer. EN, 3,3 V'a 10 k pull-up taşır ve onu 1,65 V'un altına çekmek çekirdeği reset halinde tutar. Gerçek bir DevKit'te o direncin yanındaki 100 nF, kartın açılışta sıfırlanma (power-on reset) devresidir ve modellenmez; yani buradaki EN yalnızca dirençtir.

İki konnektörün tam baskı düzeni sırası, bu modelin DOIT DevKit V1 pinout'unun okunuşudur. GPIO numaraları çipe aittir ve firmware'in bağlı olduğu şey onlardır; konnektördeki konumları ise bir diyagramın bağlı olduğu şeydir. Belirli bir DevKit'in sıraları farklıysa (30 pinli ve 36 pinli kartlar arasında gerçekten değişir), burada çizilen bir devre bir tezgah üzerinde yeniden kablolama gerektirirdi ve başka hiçbir şey değişmezdi.

2. Bellek haritası

IRAM (talimat) 0x4008_0000 ile 0x4009_FFFF arasında 128 KB
IROM (flash code) 0x400D_0000, read-only, up to 1,310,720 bytes, section 2.1
DROM (flash constants) 0x3F40_0000, read-only, up to 1,310,720 bytes, section 2.1
DRAM (veri) 0x3FFB_0000 ile 0x3FFD_FFFF arasında 192 KB
yığın tepe 0x3FFE_0000
DPORT 0x3FF0_0000, bölüm 3.7
UART0 0x3FF4_0000, bölüm 3.3
GPIO matrisi 0x3FF4_4000, bölüm 3.1
SENS 0x3FF4_8800, bölüm 3.5
IO_MUX 0x3FF4_9000, bölüm 3.2
LEDC 0x3FF5_9000, bölüm 3.6
Timer group 0 0x3FF5_F000, bölüm 3.4

Burada her çevre birim bloğu 4 KB'dir.

Two windows, not one, and that is the shape of this chip. The ESP32 has three internal SRAMs, two of which are visible through both the instruction bus and the data bus at different addresses, and SRAM1's 32 KB blocks appear in the opposite order through the two. That alias is not modeled. What is modeled is the pair ESP-IDF itself uses and keeps apart: IRAM for code, DRAM for data. The vectors, the exception entry and the startup code go in the 128 KB at 0x4008_0000; the rest of the code and the constants run from flash (section 2.1); .data, .bss and the stack go in the 192 KB at 0x3FFB_0000. A program that tries to read its own .text through the data bus is refused rather than served, because on the real part that read would have come back through the other window with the blocks in a different order.

Every PT_LOAD segment must land inside one of those two ranges or one of the two flash windows; anything else is refused with the offending address in the message, and the chip is left with no program.

2.1 Flash: code and constants

A real ESP32 runs almost all of a sketch from flash through the cache: code is read at IROM (0x400D_0000) and const data at DROM (0x3F40_0000), and the Arduino IDE's default partition table ("Default 4MB with spiffs") gives the sketch 1,310,720 bytes (0x14_0000) of it. That is the room a sketch has here, and the number the editor prints after a build ("Sketch uses N bytes ... Maximum is 1,310,720 bytes"). It counts what the IDE counts: code, literals, constants, the startup code and the initial values of the variables.

What is modeled: two read-only windows over the loaded image. A fetch or a read from either costs what a fetch from IRAM costs, which is the speed of a warm cache; there is no cache to miss and no MMU, and docs/esp32.md section 6 still says so. A store to a flash window faults, as it does on the chip. The code window shares one buffer with the instruction RAM (so a fetch is one range check whichever it is in), which means the unmapped 192 KB between them reads as zeros here, where the chip would fault; a jump into it still stops the core, since an all-zero word is an illegal instruction.

The link script (firmware/esp32/link.ld) puts .text.vectors, .text.exception, .text.start and anything marked .iram in the instruction RAM and every other function in the code window. Its literal pools sit in front of their own functions, because L32R only reaches 256 KB backwards, and every call out of the startup code goes through a register, because CALL4 and CALL8 reach 128 KB. Global variables are still limited by the data RAM (192 KB here); a program over it is refused with "no room for the stack".

Çekirdek, pc ELF giriş noktasında ve tüm adres yazmaçları sıfırlanmış halde sıfırlanır. Burada bir önyükleme ROM'u yoktur: gerçek bir ESP32'nin birinci aşama yükleyicisinde, flash okumalarında, saat ağacında ve önbellek kurulumunda geçirdiği onlarca milisaniyenin tamamı yoktur ve firmware/esp32/crt0.S, istediği durumu bir ROM'un geride bıraktıklarını varsaymak yerine açık hale getirir.

3. Çevre birimi yazmaçları

Yalnızca aşağıdaki alt küme uygulanmıştır. Eşlenmiş bir 4 KB'lık bloğun içindeki başka her şey 0 okur ve başıboş erişim olarak sayılır; hiçbir bloğun dışında kalan her şey erişim hatasıdır.

3.1 GPIO matrisi (0x3FF4_4000)

Kırk pin olduğundan, pin başına bir bit içeren her yazmaç iki parçadan gelir: düz olan GPIO 0 ile 31'i, 1 olan ise düşük sekiz bitinde GPIO 32 ile 39'u kapsar.

ofset yazmaç
0x00 GPIO_BT_SELECT_REG
0x04 GPIO_OUT_REG
0x08 GPIO_OUT_W1TS_REG
0x0C GPIO_OUT_W1TC_REG
0x10 GPIO_OUT1_REG
0x14 GPIO_OUT1_W1TS_REG
0x18 GPIO_OUT1_W1TC_REG
0x20 GPIO_ENABLE_REG
0x24 GPIO_ENABLE_W1TS_REG
0x28 GPIO_ENABLE_W1TC_REG
0x2C GPIO_ENABLE1_REG
0x30 GPIO_ENABLE1_W1TS_REG
0x34 GPIO_ENABLE1_W1TC_REG
0x38 GPIO_STRAP_REG
0x3C GPIO_IN_REG
0x40 GPIO_IN1_REG
0x44 GPIO_STATUS_REG
0x48 GPIO_STATUS_W1TS_REG
0x4C GPIO_STATUS_W1TC_REG
0x50 GPIO_STATUS1_REG
0x54 GPIO_STATUS1_W1TS_REG
0x58 GPIO_STATUS1_W1TC_REG
0x88 + 4n GPIO_PINn_REG
0x530 + 4n GPIO_FUNCn_OUT_SEL_CFG_REG

Teknik referans kılavuzuna göre doğrulandı: bloğun temel adresi ve bu tablodaki her ofset.

GPIO_PINn_REG bit 2 PAD_DRIVER pedi açık dreyn yapar; 7..9 bitleri INT_TYPE pini kesmesi hangi durumda tetikleyeceğini seçer (0 kapalı, 1 yükselen kenar, 2 düşen kenar, 3 herhangi bir kenar, 4 düşük seviye, 5 yüksek seviye); bit 13 PIN_INT_ENA, PRO çekirdeğine ait bit, pinin matrise hiç ulaşabilmesini sağlar.

256 değerindeki GPIO_FUNCn_OUT_SEL_CFG_REG, pedin GPIO_OUT'u izlemesini sağlar. 71 ile 78 arası, onu LEDC yüksek hız kanalları 0 ile 7'ye devreder. Başka herhangi bir değer modellenmemiş bir çevre birimini seçer ve model, bir seviye uydurmak yerine bunu 256 gibi ele alır. LEDC kanalının sürdüğü bir pedin, GPIO_ENABLE içindeki çıkış sürücüsünün yine de açık olması gerekir.

Doğrulanmamış: ledc_hs_sig_out0 ile ledc_hs_sig_out7 için GPIO matrisi sinyal indeksleri 71 ile 78. Matrisin sinyal tablosu bu modelin ezbere aktarabileceği bir tablo değil ve bu sayı tam olarak iki yerde bulunuyor (crates/esp32/src/map.rs içindeki OUT_SEL_LEDC_HS_SIG ve firmware/esp32/include/esp32.h içindeki GPIO_FUNC_OUT_SEL_LEDC_HS); dolayısıyla model ve çalışma zamanı uyumlu çünkü ikisi de aynı sabiti okuyor, ikisinden biri kontrol ettiği için değil. GPIO_FUNC_OUT_SEL_GPIO = 256 değeri kılavuzdaki değerdir.

GPIO_STRAP_REG geri okunduğunda 0b1101: GPIO 0, 2 ve 5 yüksek, geri kalan her şey düşük; bir WROOM-32 fabrikadan böyle çıkar. Burada bu bir sabittir, sıfırlama anında pinlerin ne yaptığının kaydı değil.

Çıkış sürücüsü olmayan altı pin (GPIO 34'ten 39'a), ENABLE1 bitine yapılan yazmaları kabul eder ve biti temiz tutar; model de bu denemeyi sayar (bölüm 1, bölüm 5).

3.2 IO_MUX (0x3FF4_9000)

0x00 adresindeki IO_MUX_PIN_CTRL_REG, sonra her pad için bir yazmaç. Bit 7 FUN_WPD, bit 8 FUN_WPU, bit 9 FUN_IE, bit 12..14 MCU_SEL; bunlardan 2 bu parçada düz GPIO'dur. Bir pad, giriş tamponu etkinleştirilmedikçe GPIO_IN_REG'e ulaşamaz; donanımın yaptığı da budur.

ESP32'nin IO_MUX'u GPIO numarasına göre indekslenmez. Yazmaçlar paketin pad sırasına göredir ve GPIO'dan pad'e eşleme, kılavuzdaki bir tablodur. Bu modelin tablosu şu şekildedir:

GPIO ofset GPIO ofset GPIO ofset GPIO ofset
0 0x44 10 0x58 20 0x78 32 0x1C
1 0x88 11 0x5C 21 0x7C 33 0x20
2 0x40 12 0x38 22 0x80 34 0x14
3 0x84 13 0x3C 23 0x8C 35 0x18
4 0x48 14 0x30 24 0x90 36 0x04
5 0x6C 15 0x34 25 0x24 37 0x08
6 0x60 16 0x4C 26 0x28 38 0x0C
7 0x64 17 0x50 27 0x2C 39 0x10
8 0x68 18 0x70 28..31 yok
9 0x54 19 0x74

Doğrulanmadı, varsayıldı. Tablo bu modelin pad sırası okumasıdır ve kılavuzdan aktarılan bir sayfa değildir. İki yerde bulunur: crates/esp32/src/map.rs içindeki IOMUX_INDEX ve firmware/esp32/src/gpio.c içindeki mokxi_iomux_index[]; dolayısıyla model ve çalışma zamanı, silikonla uyuşup uyuşmadıklarından bağımsız olarak birbirleriyle uyuşur. GPIO 28 ile 31 bu parçada yoktur ve yazmacı yoktur.

Burada her pad FUN_IE | (2 << 12) durumuyla açılır: giriş tamponu açık, düz GPIO. Kılavuzdaki pad başına sıfırlama değerleri farklıdır (strapping ve flash pinleri pull'larla başlar) ve bu model her pine aynı nötr durumu verir; böylece yalnızca GPIO_ENABLE ve GPIO_OUT yazan bir program her pinde aynı şekilde davranır. Bölüm 6 bunu bir adres olarak değil, bir yaklaşımla tekrarlar.

3.3 UART0 (0x3FF4_0000)

ofset yazmaç
0x00 UART_FIFO_REG
0x04 UART_INT_RAW_REG
0x08 UART_INT_ST_REG
0x0C UART_INT_ENA_REG
0x10 UART_INT_CLR_REG
0x14 UART_CLKDIV_REG
0x1C UART_STATUS_REG
0x20 UART_CONF0_REG
0x24 UART_CONF1_REG

Doğrulandı: temel adres ve tüm ofsetler, iki FIFO sıfırlama biti ve aşağıdaki iki FIFO sayacının genişliği. Bu, ESP32-C3'ünki ve ESP8266'nınki ile yazmaçtan yazmaca aynı UART IP'sidir; crates/esp32/src/uart.rs ve crates/esp8266/src/uart.rs aynı dosyanın iki kopyası olduğundan ötürüdür.

İki adet 128 baytlık FIFO. UART_CONF0_REG bit 17 RXFIFO_RST ve bit 18 TXFIFO_RST bunları boşaltır: ESP32 Technical Reference Manual (v5.8), yazmaç 19.9 UART_CONF0_REG, TXFIFO_RST'i bit 18'e ve RXFIFO_RST'yi bit 17'ye yerleştirir. Bu modelin ve firmware/esp32/include/esp32.h'nin daha önceki bir sürümünde ikisi yer değiştirmişti. Çalışma zamanının Serial.begin iki biti birlikte set edip temizler, dolayısıyla yazdığı değer her iki durumda da aynıdır ve imajları etkilenmemiştir.

UART_CONF1_REG bitleri 0..6 RXFIFO_FULL_THRHD ve bitleri 8..14 TXFIFO_EMPTY_THRHD alanlarıdır, ikisi de sıfırlamada 96'dır (yazmaç 19.10); bu modelin daha önceki bir sürümünde dokuz bitlik alanlar 0 ve 9 konumlarındaydı ve çalışma zamanı bu yazmaca hiç yazmaz. UART_CLKDIV_REG bitleri 0..19 bölünenin tam sayı kısmıdır (yazmaç 19.6; bit 20..23'teki kesirli kısım modellenmemiştir). Bölünen, 80 MHz APB saatini böler ve sıfırlamada 694 değerine sahiptir; bu da 115 274 baud yapar: bir monitörün umursamayacağı kadar 115200'a yakın ve sayının tam olarak verdiği değerdir. Aktarım tempolaması bir zamanlar bundan yalnızca on iki bit okuyordu, bu yüzden bölüneni 8333 olan Serial.begin(9600), baytları yaklaşık 59 kat fazla hızlı gönderiyordu; artık yirmi bitin tamamını okuyor.

UART_STATUS_REG 0..7 bitleri RXFIFO_CNT, 16..23 bitleri ise TXFIFO_CNT'dir (yazmaç 19.8). Üstlerindeki 8..11 ve 24..27 bitleri alıcının ve vericinin durum makineleridir (ST_URX_OUT, ST_UTX_OUT). Model bu iki sayıyı ilgili konumlarda, durum makinesi bitlerinde ise 0 olarak döndürür; çünkü her iki durum makinesini de çalıştırmaz. Çalışma zamanı kılavuzun verdiği alanlara göre sekiz bit okur. Önceki bir çalışma zamanı on bit okuyordu ve üstteki bitler 0 okunduğu için burada aynı sayıları verirdi; ama gerçek silisyumda ST_UTX_OUT'tan iki bit alırdı: bir bayt hat üzerindeyken iletim sayısı 256 veya daha fazla okunurdu ve FIFO'da yer açılmasını bekleyen Serial.write sonsuza kadar beklerdi. Görüntüler bu düzeltildiğinde yeniden oluşturuldu ve crates/esp32/tests/contract.rs başlıktaki maskeleri modeldekilerle eşitler.

Baytlar aktarım FIFO'sundan baud hızında ayrılır, anında değil. Bu olmasa döngüde yazdıran bir program FIFO'sunu doldurduğu hızda boşaltır, TXFIFO_CNT hiç yükselmez ve yazmadan önce onu kontrol eden firmware beklemek zorunda kalmaz. Bununla, 115 200 baud'luk bir port burada tıpkı bir masada olduğu gibi saniyede 11 520 bayt taşır ve crates/esp32/tests/runtime.rs, serial örneğinin iki baytı arasındaki boşluğu, bir baytın sürdüğü 86.8 us'ye karşı ölçer.

3.3a UART1 (0x3FF5_0000) ve UART2 (0x3FF6_E000)

UART0'ın yazmaç bloğunun iki kopyası daha, ESP-IDF'nin REG_UART_BASE(1) ve REG_UART_BASE(2) adreslerinde, aynı ofsetlerle. Doğrulandı: ESP-IDF'nin soc/esp32/register/soc/uart_reg.h dosyasına karşı taban adresler, ofsetler ve aşağıdaki alanlar. UART0'dan farklı olarak bunlar hiçbir ana makine kanalına bağlanmaz: devreye yalnızca GPIO matrisi üzerinden (bölüm 3.1), bir seferde bir bit ulaşırlar.

  • Matris yönlendirmesi. GPIO_FUNCn_OUT_SEL_CFG_REG sinyal 17 U1TXD, 198 U2TXD'dir; 0x130 + 4m adresindeki GPIO_FUNCm_IN_SEL_CFG_REG (256 tane) için sinyal 17 U1RXD ve 198 için U2RXD'dir; SIG_IN_SEL (bit 7), GPIO numarasını IN_SEL alanından (bitler 0..5) alır ve IN_INV_SEL (bit 6) onu tersine çevirir. Numaralar ESP-IDF'nin gpio_sig_map.h dosyasındandır. OUT_SEL'in INV_SEL'i (bit 9) çıkışı tersine çevirir. SIG_IN_SEL biti temiz olan bir sinyal çip üzerindeki IO_MUX padinden gelir; o yol modellenmemiştir (hat boşta okunur) ve çalışma zamanı her pini matristen geçirir, bu da gerçek silikonda her pinde çalışır.
  • Çerçeve. UART_CONF0_REG PARITY/PARITY_EN (0 ve 1 bitleri), BIT_NUM (2..3, beş ile sekiz bit) ve STOP_BIT_NUM (4..5: bir, bir buçuk, iki). Çipte iki durdurma biti, ESP-IDF'nin RS485_CONF.DL1_EN geçici çözümünü gerektirir; burada STOP_BIT_NUM 3 basitçe iki demektir. RXD_INV (19) ve TXD_INV (22) hatları ters çevirir, ERR_WR_MASK (26) çerçeve veya eşlik hatası olan baytları FIFO dışında tutar.
  • Saat. TICK_REF_ALWAYS_ON (bit 27, sıfırlamada ayarlanır), 80 MHz APB saatini böler; temizlenirse 1 MHz REF_TICK'tir, ki ESP-IDF onu 250 000 baud'a kadar seçer. UART_CLKDIV_REG'de tam kısım 0..19 bitlerinde, on altıda birler ise CLKDIV_FRAG içinde, 20..23 bitlerindedir; ikisi de modellenmiştir: REF_TICK'ten 9600 baud, 104 ve 2/16'dır; bir bit 104.125 us, yani 9603.8 baud eder, çipteki gibi.
  • FIFO'lar ve eşikler. Her yönde 128 bayt. Bir bayt, kaydırma yazmacı boş olduğu anda başlar ve bir sonraki, son durdurma bitinin ardından boşluksuz gelir (tx_idle_num 0, ESP-IDF'nin ayarladığı gibi). TXFIFO_CNT hâlâ bekleyen baytları sayar, çıkmakta olanı değil; ST_UTX_OUT (24..27) ve ST_URX_OUT (8..11) her durum makinesinin bulunduğu yuvayı bildirir, boştayken 0. STATUS bit 15 alma hattı ve bit 31 gönderme hattıdır.
  • Alma. Boşta olan bir hatta meydana gelen düşüş bir çerçeve başlatır; başlangıç biti ortasında kontrol edilir (bir parazit yok sayılır), diğer her bit kendi yuvasının ortasında örneklenir ve bayt, durdurma bitinin ortasına gelmiş olur. Çekirdek devreden en fazla bir dilim ileride çalışır, bu yüzden alıcı yalnızca devrenin çoktan bildirdiği zamanı örnekler.
  • Kesmeler. CONF1'in eşiklerine karşı RXFIFO_FULL (bit 0) ve TXFIFO_EMPTY (1), PARITY_ERR (2), FRM_ERR (3), RXFIFO_OVF (4), RXFIFO_TOUT (8) ve TX_DONE (14), kesme matrisi kaynakları 35 ve 36 üzerinde. RX_TOUT_EN ve RX_TOUT_THRHD (CONF1 bit 31 ve 24..30) zaman aşımını, ESP-IDF'nin uart_ll_set_rx_tout işlevinin yazdığı birimlerde ayarlar: APB'den birim başına sekiz bit süresi, REF_TICK'tan birimin sekizde biri.
  • Modellenmedi: donanım ve yazılım akış kontrolü, RS-485, IrDA, otomatik baud algılama, break, geri dönüş (loopback) biti, AT-komut algılayıcısı ve DPORT saat etkinleştirme ve sıfırlama bitleri (her iki UART da her zaman saat sinyali alır). Yazmaçları başıboştur.

Programın hiç yazmadığı bir UART simülatöre hiçbir şeye mal olmaz: yazmaçlarından biri yazılana kadar hiçbir yolda incelenmez ve crates/esp32/src/bus.rs bunu söyleyen bir teste sahiptir.

Çalışma zamanının Serial1 ve Serial2'si (firmware/esp32/src/uartn.c) bunları, arduino-esp32 çekirdeği 3.x ve ESP-IDF'nin sürücüsünün yaptığı gibi kullanır; docs/help/boards/esp32-devkit.md bir kodun ne gördüğünü anlatır.

3.4 Zamanlayıcı grubu 0, zamanlayıcı 0 (0x3FF5_F000)

micros() ve millis() arkasındaki 64 bitlik sayaç.

ofset yazmaç
0x00 TIMG_T0CONFIG_REG
0x04 TIMG_T0LO_REG
0x08 TIMG_T0HI_REG
0x0C TIMG_T0UPDATE_REG
0x10 TIMG_T0ALARMLO_REG
0x14 TIMG_T0ALARMHI_REG
0x18 TIMG_T0LOADLO_REG
0x1C TIMG_T0LOADHI_REG
0x20 TIMG_T0LOAD_REG
0x98 TIMG_INT_ENA_TIMERS_REG
0x9C TIMG_INT_RAW_TIMERS_REG
0xA0 TIMG_INT_ST_TIMERS_REG
0xA4 TIMG_INT_CLR_TIMERS_REG

Doğrulandı: bloğun taban adresi. Doğrulanmadı ama kabul ediliyor: bu tablodaki her ofset. Taban adres kılavuzun; içindeki yerleşim ise bu modelin ve crates/esp32/src/map.rs ile firmware/esp32/include/esp32.h'de aynıdır.

T0CONFIG bit 31 EN, bit 30 INCREASE, bit 29 AUTORELOAD, bit 13..28 DIVIDER, bit 10 ALARM_EN. Çalışma zamanı DIVIDER'ı 80'e ayarlar; böylece 80 MHz APB saatinden mikrosaniyede bir tik gelir.

Okuma, donanımın gerektirdiği gibi önce kilitle sonra oku şeklindedir: T0UPDATE yaz, sonra T0HI ve T0LO oku. Sayaç sayılmaz. C3'ün SYSTIMER'ı gibi o da bölücüye bölünmüş simüle edilmiş zamandır; bu yüzden sapacağı bir şey yoktur ve micros() üzerinde meşgul bekleyen firmware, devrenin geri kalanının geçtiğini gördüğü süreyi tam olarak ölçer.

Alarm uygulanmış ve sayaç onu geçtiğinde TIMG_INT_RAW yükselir, ama bu bloktan çıkan bir kesme hattı yoktur. Hiçbir şey onu kesme matrisine yönlendirmez. Modelin milisaniye tik'i çekirdeğin kendi CCOMPARE0 yazmacından gelir (bölüm 4); o, sabit bir CPU kesmesine bağlı bir çekirdek yazmacıdır ve dolayısıyla bu modelin tahmin etmek zorunda kaldığı bir adresin arkasında durmaz. TIMG_INT_ST yine de yoklanabilir ve silinebilir.

Zamanlayıcı grubu 0'ın zamanlayıcı 1'i ve zamanlayıcı grubu 1'in tamamı yoktur; zamanlayıcı grubu 0'ın watchdog'u bölüm 3.9'dakinidir.

3.5 SENS: ADC1, tek atış (0x3FF4_8800)

Tek atış modunda ADC1: bu parçayı adc1_get_raw ve Arduino çekirdeğinin analogRead'i üstlenir, başka hiçbir şey.

ofset yazmaç bitler
0x00 SENS_SAR_READ_CTRL_REG saklanır, geri okunur; dönüşüm zamanlaması burada sabittir
0x34 SENS_SAR_ATTEN1_REG kanal başına iki zayıflatma biti, n kanalı 2n..2n+1 bitlerinde
0x54 SENS_SAR_MEAS_START1_REG bit 0..15 MEAS1_DATA_SAR (sonuç, salt okunur), bit 16 MEAS1_DONE_SAR, bit 17 MEAS1_START_SAR, bit 18 MEAS1_START_FORCE, bit 19..26 SAR1_EN_PAD (kanal başına bir bit), bit 31 SAR1_EN_PAD_FORCE

Doğrulandı: taban adres. Doğrulanmadı ama kabul ediliyor: üç ofset ve içindeki tüm bit konumları. Bunlar, docs/esp32c3.md bölüm 3.5'in C3'ün kendi SAR ofsetlerini işaretlediği anlamda, bu modelin SENS bloğu okumasıdır. Burada derlenen firmware, silikona uyup uymadığına bakılmaksızın modelle uyumludur.

Tek dönüşüm: zayıflatmayı ATTEN1'e koy, START_FORCE ve EN_PAD_FORCE'u ayarla, kanalın bitini SAR1_EN_PAD'e yerleştir, MEAS1_START_SAR'ı yükselt, MEAS1_DONE_SAR'ı bekle, veriyi oku. Bir dönüşüm simüle edilmiş sürede sabit 5 us sürer ve firmware bunu gerçekten bekler.

Sekiz kanal ve ESP32'de bunlar GPIO n değildir:

kanal 0 1 2 3 4 5 6 7
GPIO 36 37 38 39 32 33 34 35

Kanal 0 SENSOR_VP ve kanal 3 SENSOR_VN'dir; 37 ve 38 bir WROOM-32'de dışa bağlanmamıştır, dolayısıyla DevKit'in sıradan numaralar olarak dışa çıkardığı dördü 4'ten 7'ye kadar olan kanallardır. O tablo kılavuzundakidir.

Sonuç, dönüşümün başladığı andaki ağ geriliminin on iki bitidir. 0, 2.5 ve 6 dB'de bu, veri sayfasındaki nominal doğru çizgidir: round(4095 x Vin / Vfull), sınırlandırılmış, tam ölçek 1.1 V, 1.5 V ve 2.2 V. 11 dB'de, Arduino çekirdeğinin varsayılanında, gerçek parçanın ham eğrisidir (crates/esp32/src/adc.rs içindeki CURVE_11DB): yaklaşık 80 mV'a kadar 0, ortada doğrusala yakın, tepeye doğru yukarı kıvrılan ve yaklaşık 3.15 V'tan itibaren 4095'te doygunlaşan. Nominal 3.9 V tam ölçek, ham okumanın verdiği sonuç değildir; veri sayfası 11 dB'de yalnızca 150 ile 2450 mV arasında doğruluk vaat eder ve tipik bir parçanın ham sayısı 3.9 V'tan çok önce tükenir. Bu yüzden 3.3 V hattına bağlanmış bir pot 0 ile 4095 arasında okur, 4095'e dönüşünün sonundan biraz önce ulaşır, hattın yarısı (1.65 V) yaklaşık 1890 okur ve map(analogRead(pin), 0, 4095, 0, 180) bir servoyu tam tur döndürür. Noktalar, ölçülmüş ESP32s için yaygın olarak kullanılan dördüncü mertebe uydurmanın ters çevrilmiş halidir; bir birimin eFuse kalibrasyonu bunları birkaç yüzde kaydırır ve bu modellenmemiştir. Çekirdeğin kalibrasyonunun yaptığı gibi analogReadMilliVolts aynı eğriyi tersine çevirir, dolayısıyla 1.65 V'ta yaklaşık 1650 okur. Pininde hiçbir şey bağlı olmayan bir kanal, yüzen bir girişin yaptığı gibi başıboş gezer (docs/uno.md bölüm 1).

Gerçek dönüştürücünün aktarım fonksiyonu iki uçta da kıvrılır ve eFuse kalibrasyon eğrisinden düzeltilir. Bunların hiçbiri modellenmemiştir: buradaki ise düz bir çizgidir. Bölüm 6 onu bir yaklaşım olarak listeler.

ADC2 (gerçek bir ESP32'de WiFi ile paylaşılır), DMA ve örüntü tablosu yolu, dijital denetleyici, kalibrasyon eFuse'ları, iç referans, dokunmatik sensör ve hall sensörü tümü yoktur.

3.6 LEDC, yüksek hızlı grup (0x3FF5_9000)

LED PWM denetleyicisi. Yüksek hızlı grup, ledcSetup, ledcAttachPin ve ledcWrite fonksiyonlarının 0 ila 7 kanallarıyla ulaştığı grup olup analogWrite fonksiyonunun da burada kullandığı gruptur: dört zamanlayıcı ve sekiz kanal.

ofset yazmaç bitler
0x00 + 0x14n LEDC_HSCHn_CONF0_REG bit 0..1 TIMER_SEL, bit 2 SIG_OUT_EN, bit 3 IDLE_LV, bit 4 PARA_UP (saklanır; buraya yazılan bir görev döngüsü hemen etkili olur)
0x04 + 0x14n LEDC_HSCHn_HPOINT_REG bit 0..19 HPOINT: darbenin başladığı sayı
0x08 + 0x14n LEDC_HSCHn_DUTY_REG bits 0..24 DUTY: darbe genişliği, sayımın on altıda biri cinsinden
0x0C + 0x14n LEDC_HSCHn_CONF1_REG görev döngüsü soldurma donanımı: saklanır, geri okunur ve hiçbir şeyi soldurmaz
0x10 + 0x14n LEDC_HSCHn_DUTY_R_REG halihazırdaki görev döngüsü, salt okunur
0x140 + 8n LEDC_HSTIMERn_CONF_REG bit 0..4 DUTY_RES, 1 ile 20 bit arası (0, kimsenin yapılandırmadığı ve hiçbir şey saymayan bir zamanlayıcıdır), bit 5..22 CLK_DIV, bit 23 PAUSE, bit 24 RST
0x144 + 8n LEDC_HSTIMERn_VALUE_REG sayaç, salt okunur
0x180 LEDC_INT_RAW_REG bit n = zamanlayıcı n taştı
0x184 LEDC_INT_ST_REG ham ve etkin
0x188 LEDC_INT_ENA_REG saklanır; çekirdeğe ulaşan bir hat yoktur
0x18C LEDC_INT_CLR_REG temizlemek için 1 yaz
0x190 LEDC_CONF_REG bit 0..1 APB_CLK_SEL, 1 = 80 MHz APB saati, modellenen tek kaynaktır
0x1FC LEDC_DATE_REG 0x1605_3100 okur

Doğrulandı: bloğun temel adresi. Tahmine dayalı, doğrulanmamış olan: içindeki tüm düzen: kanal adımı, 0x140 adresindeki zamanlayıcı bloğu ve 0x180 adresinden yukarıdaki kesme ve yapılandırma yazmaçları.

Bir zamanlayıcı, CLK_DIV ile bölünen 80 MHz'de 2^DUTY_RES sayım sayar; CLK_DIV, sayım başına APB saati sayısını veren bir Q10.8 sayısıdır:

f = 80e6 / ((CLK_DIV / 256) * 2^DUTY_RES)

yani 5 kHz sekiz bitte, tam olarak CLK_DIV 16000 ile DUTY_RES 8'dir. Bir kanal bir zamanlayıcı, bir başlangıç sayısı HPOINT ve bir görev döngüsü seçer ve çıkışı HPOINT'tan itibaren DUTY >> 4 sayım boyunca yüksektir, periyodun tepesinde dolaşarak. 0 görev döngüsü düz bir alçaktır ve 2^DUTY_RES << 4 görev döngüsü hiçbir kenarı olmayan düz bir yüksektir; Arduino çekirdeğinin sekiz bitte ledcWrite(pin, 255)'i 255 yerine 256 görev döngüsüne çevirmesinin nedeni budur, 255 olsaydı her periyotta tek sayımlık bir çentik kalırdı.

Bir kanal bir pada GPIO matrisi üzerinden ulaşır: pad'in GPIO_ENABLE bitini ayarla ve GPIO_FUNCn_OUT_SEL_CFG_REG kaydını 71 + channel değerine yönlendir (bölüm 3.1 ve o indeks doğrulanmamış olandır).

Sayaç adım adım ilerletilmez: simüle edilmiş zamanın kapalı biçimli bir fonksiyonudur, bir sonraki kenarının zamanı da öyledir. Bu yüzden waiti'de bekleyen bir çekirdek bir PWM çalışırken hiçbir şeye mal olmaz ve kart yalnızca kenarlar için uyanır, başka hiçbir şey için değil. crates/esp32/tests/runtime.rs, fade örneğinin periyodunu 1 kHz'in 1 ms'sine karşı 5 us toleransıyla ölçer.

Modellenmeyenler: düşük hızlı grup (ESP32'de bir tane var, kendi dört zamanlayıcısı, sekiz kanalı ve yavaş saatiyle; çalışma zamanında hiçbir şey onu kullanmaz), görev döngüsü soldurma donanımı, bir kanalın kendi taşma sayacı, APB dışındaki saat kaynakları ve LEDC'nin kesme matrisine giden hattı: LEDC_INT_RAW_REG yoklanabilir ve temizlenebilir ama çekirdeğe asla ulaşmaz.

3.7 DPORT ve kesme matrisi (0x3FF0_0000)

ESP32'de bir çevre biriminin sabit bir CPU kesmesi yoktur. Onun bir kaynak numarası vardır ve matrisin o kaynak için olan eşleme yazmacı, çekirdeğin 32 kesmesinden hangisini yükselteceğini söyler. Buradaki attachInterrupt'ın bir değil üç yazma olmasının nedeni budur: pini yapılandır, kaynağı yönlendir, CPU kesmesinin maskesini kaldır.

ofset yazmaç
0x104 + 4n Kaynak n için DPORT_PRO_..._INTR_MAP_REG

96 kaynak. Bir eşleme yazmacı, CPU kesme numarasını düşük beş bitinde tutar; 0'a eşlenen bir kaynak 0 numaralı kesmeyi yükseltir, bunu hiçbir şey etkinleştirmez, dolayısıyla hiçbir şey olmaz; gerçek donanım da aynısını yapar ve bir kaynak bu şekilde kapatılır.

Doğrulandı: DPORT_BASE = 0x3FF0_0000. Doğrulanmadan inanılan: eşleme dizisinin 0x104 ofseti ve bu modelin yönlendirdiği iki kaynak numarası:

kaynak numara
GPIO 22
UART0 34
UART1 35
UART2 36

UART1'inki ve UART2'ninki, ESP-IDF'nin soc/esp32/include/soc/interrupts.h dosyasındaki sırayla doğrulandı; bu dosya GPIO'yu 22'ye, UART0'ı 34'e koyar. Bu modelde yalnızca bu kaynaklar ve zamanlayıcı grubu 0'ın watchdog'u (bölüm 3.9) bir şeye ulaşır. Diğer her eşleme yazmacı saklanır ve geri okunur ama hiçbir şey yönlendirmez, çünkü bu modelde başka hiçbir şey kesme oluşturmaz. DPORT'un geri kalanı (önbellek ve MMU denetimi, APP-CPU denetim yazmaçları, çevre birimi saat ve sıfırlama kapıları, DMA hakemliği) yoktur.

3.8 Mokxi ağ posta kutusu (0x3FEF_E000)

Bu blok ESP32'nin değildir. Bu belgedeki diğer her adres, teknik referans kılavuzundan alıntılanmış, çipe ait bir adrestir ve buna göre derlenen bir imge, gerçek bir WROOM-32 için bir imgedir. Bu ise Mokxi'nin kendi bloğudur: crates/net içindeki simüle edilmiş ağ, veri yolunun harici bellek pencereleri (0x3FBF_FFFF'de biter) ile çevre birimi penceresi (DPORT'ta, 0x3FF0_0000'de başlar) arasında bıraktığı boşluktadır; çip bu aralığı ayırmıştır ve içinde hiçbir şeye yanıt vermez, böylece onu kullanan bir imge, başka bir çevre biriminin yazmacını okumak yerine silisyumda hata üretir. Bu hata dürüst cevaptır, çünkü bu bloğun arkasındaki şey çipte yoktur.

Blok hiçbir kesme yükseltmez. Buradaki diğer tüm kaynaklar, bölüm 3.7'deki kesme matrisi üzerinden çekirdeğe ulaşır ve bir matris kaynak numarası çipe aittir; çipin sahip olmadığı bir çevre birimine dürüst bir numara verilemez, bu yüzden posta kutusuna hiç verilmez. NET_INT_RAW_REG yine de okunur, firmware yoklar ve waiti içinde bekleyen bir çekirdek, ağın söyleyecek bir şeyi olduğunda, bir PWM kenarı için uyandırıldığı gibi yine uyandırılır.

Burada radyo, 802.11 ve gerçek internet yoktur. Modelde hiçbir şey iletilmez, taranmaz, ilişkilendirilmez, şifrelenmez veya soket açılmaz: bir parola dizgi olarak karşılaştırılır, .mokxi altında olmayan bir ad çözümlenmez ve ağın hizmet verdiği üç kaynak, crates/net/src/http.rs içindeki fonksiyonlardır. Posta kutusu, bir MAC hakkındaki bir kurgu değil, gerçek ara yüzün biçimidir: gerçek bir ESP32'de WiFi donanımı, komut arabirimli kapalı bir ikili bloktur ve Arduino'nun WiFi.h kitaplığı bunlardan birinin öbür tarafında biter. Arkasında ne olduğunu belirleyen sözleşme docs/wifi.md dosyasıdır; bu bölüm yalnızca yazmaçlardır.

Bir komut yazmacı, bir durum yazmacı, her yönde 4096 baytlık bir halka ve bir kesme biti. NET_CMD_REG'e yazmak komutu çalıştırır; simüle edilmiş zaman alan bir komut BUSY'yi yükseltir ve bittiğinde onu temizler; NET_INT_RAW_REG içinde DONE belirir.

ofset ad bitler
0x00 NET_ID_REG 0x494B4F4D okur, başka hiçbir şey okumaz. Mokxi'de olup olmadığını öğrenmek isteyen bir kod bunu okur; silisyumda bu erişim hata üretir
0x04 NET_CMD_REG bir komut kodu yaz (aşağıdaki tablo); yazma işlemi onu çalıştırır
0x08 NET_ARG_REG tek bir argüman kelimesi, geri okunur: LISTEN için port, REPLY için durum
0x0C NET_STATUS_REG bit 0 BUSY, bit 1 ERR, bit 2 RX_READY, bit 3 LINK, bit 4 SERVE, 8..11 bitleri STATE
0x10 NET_RESULT_REG son komutun verdiği yanıt
0x14 NET_INT_RAW_REG bit 0 DONE, bit 1 EVENT
0x18 NET_INT_ENA_REG aynı iki bit
0x1C NET_INT_CLR_REG temizlemek için 1 yaz, aynı iki bit
0x20 NET_TX_LEN_REG giden halkada hazırlanan baytlar
0x24 NET_TX_DATA_REG yaz: giden halkaya tek bir bayt (bit 0..7) ekle
0x28 NET_RX_LEN_REG gelen halka tamponda bekleyen baytlar
0x2C NET_RX_DATA_REG oku: gelen halka tampondan tek bir bayt al, boşken 0
0x30 NET_RING_LEN_REG halkaların her birinin bayt cinsinden kapasitesi, böylece firmware 4096'ı sabit kodlamak zorunda kalmaz
0x40 NET_BT_CMD_REG Bluetooth: bir Bluetooth komut kodu yaz (docs/bluetooth.md); yazma işlemi onu çalıştırır
0x44 NET_BT_ARG_REG Bluetooth: tek bir argüman kelimesi, geri okunur; bir olay numarasını buraya bırakır
0x48 NET_BT_RESULT_REG Bluetooth: son Bluetooth komutunun verdiği yanıt
0x4C NET_BT_STATUS_REG bit 0 CLASSIC_ON, bit 1 CLASSIC_LINK, bit 2 EVENT, bit 3 BLE_ADV, bit 4 BLE_LINK, bit 5 BT_ERR, bit 8 HAS_CLASSIC, bit 9 HAS_BLE
0x50 NET_BT_TX_LEN_REG Bluetooth: baytlar kendi giden halka tamponunda hazırlanıyor
0x54 NET_BT_TX_DATA_REG Bluetooth: yaz: o halka tampona tek bir bayt gönder
0x58 NET_BT_RX_LEN_REG Bluetooth: kendi gelen halka tamponunda bekleyen baytlar
0x5C NET_BT_RX_DATA_REG Bluetooth: okuma: bir bayt çek, boş olduğunda 0

Sekiz NET_BT_ yazmacı, bloğun Bluetooth yarısıdır; kendi halkaları vardır, böylece bir Bluetooth geri çağırması hiçbir zaman bir HTTP gövdesine dokunamaz: klasik ESP32'nin sahip olduğu Bluetooth Classic ve LE. Arkalarında da radyo yoktur; docs/bluetooth.md onların sözleşmesidir.

STATE, istasyonun nerede olduğunu belirtir: 0 boşta, 1 başlıyor, 2 bağlanıyor, 3 bağlı, 4 başarısız, 5 böyle bir ağ yok. NET_CMD_STATUS, aynı şeyi bir kodun WiFi.status() çağrısından okuduğu Arduino wl_status_t koduna dönüştürür.

NET_CMD_REG ad ne yaptığı
0 NOP hiçbir şey
1 RESET bağlantıyı kes, iki halkayı da bırak, herhangi bir isteği bırak
2 CONNECT giden halka ssid\0password bilgisini tutar; bir ila üç saniye boyunca BUSY yükseltir
3 DISCONNECT ilişkilendirmeyi ve adresi bırak
4 STATUS NET_RESULT_REG = wl_status_t kodu
5 IP NET_RESULT_REG = kiralanan adres, ilk sekizli düşük baytta
6 RSSI NET_RESULT_REG = dBm cinsinden sinyal, işaret genişletilmiş
7 SSID gelen halka erişim noktasının adını alır
8 MAC gelen halka kartın altı MAC baytını alır
9 REQUEST giden halka method\0url\0headers\0body tutar; BUSY hatası verir
10 POLL NET_RESULT_REG = 0 istek sürerken, ardından HTTP durumu ya da ERR yukarıdayken negatif bir hata; gövde gelen halkaya düşer
11 LISTEN NET_ARG_REG içindeki portta dinle
12 ACCEPT NET_RESULT_REG = 1 ve gelen halka tamponu method\0path\0query\0body içerir, bekleyen bir şey yokken 0
13 REPLY kabul edilen isteğe NET_ARG_REG içindeki durumla yanıt ver; giden halka content-type\0body tutar
14 STOP dinlemeyi durdur
15 WL_GPIO_SET kablosuz parçanın kendi GPIO'larını NET_ARG_REG kaydından sür. Bu kart değil: bu parçanın radyosunda böyle bir pin yok, bu yüzden ERR'yi ayarlar ve hiçbir şeyi sürmez. Bir Pico W'nin kart üzerindeki LED'inin izlediği yol budur (docs/picow.md bölüm 3.8)
16 WL_GPIO_GET onları geri oku, ve burada da aynı ERR
17 BLYNK simüle edilmiş Blynk sunucusunda tek bir işlem, NET_ARG_REG'deki işlem ve giden halkadaki alanları; hemen NET_RESULT_REG'de yanıtlanır, ağdan kopukken ERR yükselir (docs/wifi.md, "Blynk")
19 ETH kablolu Ethernet (firmware/include/ETH.h), NET_ARG_REG'deki işlem: 1 bağlantıyı simüle edilmiş bir kablo üzerinden açar, SSID ve parola olmadan, 1,5 s sonra aynı kiralama ile katılır; 2, bağlantı (ya da son hali) kabluloyu olduğunda NET_RESULT_REG'ye 1 koyar. Tek bir bağlantı vardır: STATUS, IP ve her istek, hangi yoldan açılmışsa açılsın onu okur
20 SOFTAP soft AP (crates/net/src/softap.rs, docs/wifi.md), NET_ARG_REG'deki işlem: 1 onu açar (giden halkaya ssid\0password\0 ve kanal baytı; NET_RESULT_REG 1, ya da boş bir isim veya bir ile yedi karakterlik bir parola için ERR ile 0), 2 onu kapatır, 3 onu yapılandırır (adres, ağ geçidi ve ağ maskesi, her biri dört bayt), 4 adresi (kapalıyken 0), 5 katılan istasyonlar, 6 çalışma zamanının olaylara dönüştürdüğü katılmalar, ayrılmalar ve açık biti, 7 ve 8 bir captive portal'ın DNS sunucusunu başlatma (isim, bir sıfır baytı, adres) ve durdurma, 9 ismini gelen halkaya, 10 telefonun adresini, 11 hizmet verilen isteğin Host'unu gelen halkaya yazar. Tek istasyon Web panelinin telefonudur

Negatif POLL kodları: -1 isim çözümlenemez, -2 istasyon ilişkilendirilmemiş, -3 https:// ve TLS simüle edilmez, -4 halkadan uzun bir gövde, -5 bu ağın ayrıştıramadığı bir URL, -6 zaten devam eden bir istek var. firmware/include/HTTPClient.h bunları bir kodun karşılaştırdığı Arduino biçimli kodlara dönüştürür ve docs/wifi.md eşlemeyi listeler.

Zamanlama, tamamı bu modelin kendine ait ve tamamı docs/wifi.md'de belirtilmiş: bir ilişkilendirme bir ile üç saniye arasında sürer, SSID'den kararlaştırılır ki bir ders iki kez aynı süreyi alsın; yanlış bir parola beş saniye sonra WL_CONNECT_FAILED olur; simüle edilmiş bir kaynağa giden bir istek 60 ms sonra geri döner; kodun kendi sunucusuna gelen ve kodun hiç yanıtlamadığı bir istek, on saniye sonra ağ tarafından 504 ile kapatılır.

3.9 Zamanlayıcı grubu 0'ın watchdog'u ve RTC_CNTL sıfırlamaları (0x3FF5_F048, 0x3FF4_8000)

Zamanlayıcı grubu 0'ın ana watchdog'u, C3'teki gibi (docs/esp32c3.md bölüm 3.9) ama ESP32'nin düzeniyle: bir yazma hemen etkili olur, kesme biti TIMG_INT_*'in 2. bitidir (0x98..0xA4) ve çekirdeğe kesme matrisi üzerinden kaynak 16 olarak ulaşır (çalışma zamanı onu CPU kesmesi 17'ye eşler). RTC_CNTL (0x3FF4_8000, SENS'in altındaki iki kilobayt): RTC_CNTL_RESET_STATE_REG adresi 0x34, saklama yazmaçları 0x4C..0x58 ve 0xB0..0xBC adreslerinde ve iki yazılım sıfırlaması. Zamanlayıcı grubu 1 modellenmemiştir.

Çalışma zamanı, ESP-IDF'in görev watchdog'unu ESP-IDF'in yaptığı gibi zamanlayıcı grubu 0'ın watchdog'u üzerinde çalıştırır (firmware/src/main.cpp): 500 µs tikler, aşamada 0 zaman aşımında bir kesme ve aşamada 1 iki katında sistem sıfırlaması; setup()'dan önce 5 s zaman aşımıyla ve bir panic ile başlatılır, çekirdek 0'ın boşta görevini izler. Kod çekirdek 1'de çalışır, onun boşta görevi istemedikçe izlenmez (enableCore1WDT()), bu yüzden hiç yield etmeyen bir döngü kartta olduğu gibi çalışmaya devam eder. Kesme, ESP-IDF'in satırlarını yazdırır ("E (…) task_wdt: Task watchdog got triggered. …", görevler, "Aborting.", iptal satırı ve "Rebooting..."), ESP-IDF'in ESP_RST_TASK_WDT ipucunu RTC saklama yazmacında bırakır ve CPU'yu yazılım sıfırlamasıyla sıfırlar, böylece esp_reset_reason() sonrasında 6 der. esp_task_wdt_*, enableLoopWDT() ve enable/disableCore0WDT() ona etki eder. Zamanlayıcı grubu 1'in watchdog'u aynı şekilde modellenmiştir ve çalışma zamanında onu kuran bir şey yoktur: kesme watchdog'u simüle edilmez.

4. Çekirdek: hangi ABI kullanılıyor ve bir kesme nasıl gelir

crates/xtensa-core, Xtensa Instruction Set Architecture referansından ve Espressif araç zincirlerinin ürettiği kodlamalardan yola çıkılarak yazılmış bir Xtensa LX yorumlayıcısıdır. İçindekilerin hiçbiri QEMU'dan, ESP-IDF'den, Arduino çekirdeklerinden ya da başka bir emülatörden türetilmemiştir. xtensa-esp32-elf-as, bir tezgah aleti nasıl kullanılıyorsa öyle kullanıldı (bir komutu birleştir, kodlamayı geri oku, çözücüyü çıkan sonuca göre yaz) ve crates/xtensa-core/tests/encoding.rs bu ölçümleri saklar; böylece çözücü, birinin elle yazdığı bir tabloya göre değil, kanıtlara göre denetlenebilir.

Pencereli ABI, başka seçenek de yoktu. xtensa-esp32-elf-gcc entry, call8 ve retw.n üretir ve hiçbir -mabi=call0 seçeneği yoktur. Dolayısıyla buradaki LX6 yapılandırması altmış dört fiziksel adres yazmacına ve yazmaç penceresine sahiptir; ENTRY, RETW, ROTW, MOVSP, L32E/S32E ve pencere taşması ile alt taşma istisnaları kendi vektörlerinden işler. (ESP8266'nın LX106'sı on altı yazmaça sahiptir ve penceresi yoktur, bu yüzden derleyicisi call0 üretir; docs/esp8266.md bölüm 4 bunun öbür yarısıdır.)

What the LX6 configuration has that the LX106 does not: hardware divide (QUOS, QUOU, REMS, REMU), the 32-bit high multiply, MIN/MAX, SEXT, CLAMPS, the zero-overhead loop (LOOP, LOOPNEZ, LOOPGTZ) and the two atomic loads. Each of those differences was put to the assembler of the toolchain that builds for that chip; the encodings that came back are in tests/encoding.rs.

Modellenenler: her genişlikte hizalama istisnasıyla yüklemeler ve depolamalar, dallanma ve koşullu dallanma takımının tamamı, CALL0/CALL4/CALL8/CALL12 ve dolaylı biçimleri, L32R, MOVI, yoğun (.n) komutları, tamsayı ALU'su, MUL16/MULL/MULUH/MULSH, özel yazmaçlar ve WAITI.

Vektörler. VECBASE özel bir yazmaçtır ve tablo ISA'nın tablosudur:

VECBASE adresinden ofset vektör
0x000 WindowOverflow4
0x040 WindowUnderflow4
0x080 WindowOverflow8
0x0C0 WindowUnderflow8
0x100 WindowOverflow12
0x140 WindowUnderflow12
0x300 KernelException (PS.UM temiz)
0x340 UserException (PS.UM ayarlı), ve 1. seviyenin tüm kesmeleri, EXCCAUSE 4 ile
0x3C0 DoubleException (PS.EXCM zaten ayarlı)

Üç taşma işleyicisinden hangisinin devreye gireceğine taşırılan çerçevenin genişliği karar verir, pencerenin ona ulaşmak için ne kadar döndüğü değil: WindowOverflow4 a5 üzerinden, 8 a9 üzerinden ve 12 a13 üzerinden taşırır, ve bunlar bir, iki ve üç pencere ilerideki yığın işaretçileridir. Bir CALL8, çağrılan tarafın ENTRY komutu çalışmadan önce a8 yazılır, dolayısıyla taşma kuralı kayıt erişimine bağlıdır, yalnızca ENTRY'ye değil. İkisi de bu kartın kendi firmware'i tarafından bulunan hatalardı ve ikisi de çekirdekte düzeltildi.

Kesmeler. INTENABLE maskeler; PS.INTLEVEL kapıları kontrol eder. Yalnızca seviye 1 modellenmiştir: birden yüksek kesme seviyeleri, NMI ve hata ayıklama kesmesi modellenmemiştir. Seviye 1 kesmeler 0'dan 10'ya, 12, 13, 17 ve 18'dir, maske 0x0006_37FF. Doğrulandı: ESP32 Technical Reference Manual (v5.8), tablo 8.3-2 "CPU Interrupts": 19, 20 ve 21 seviye 2'de seviye tetiklemelidir, bu yüzden maskede yer almazlar. Bu modelin daha eski bir sürümünde maskede yer alıyorlardı (0x003E_37FF), bu da seviye 2'deki bir hattı seviye 1'de tetikleyecekti; crates/xtensa-core/tests/interrupts.rs artık maskeyi tabloya göre tutuyor. Çalışma zamanı yalnızca 6 ve 13'ü etkinleştirir (bölüm 7), ikisi de aynı tabloda seviye 1'dir, dolayısıyla hiçbir firmware eski maskeye bağımlı değildi.

CCOUNT ve CCOMPARE. LX6'nın üç karşılaştırıcısı vardır. Her birinin hangi CPU kesmesini tetiklediği şöyle varsayılır:

karşılaştırıcı CPU kesmesi
CCOMPARE0 6
CCOMPARE1 15
CCOMPARE2 16

Doğrulandı: aynı tablo 8.3-2'ye göre, 6, 15 ve 16 numaralı iç kesmeler "Timer.0", "Timer.1" ve "Timer.2"dir. Tablo ayrıca 15'i seviye 3'te ve 16'yı seviye 5'te gösterir, dolayısıyla burada yalnızca CCOMPARE0 devreye girer. Çalışma zamanı kendi tiki için CCOMPARE0 ve CPU kesmesi 6'yı kullanır; her Xtensa portunun kullandığı budur.

Bir CCOMPARE'a yapılan WSR karşılaştırıcıyı kurar ve yazma işlemi ayrıca bekleyen kesmeyi de temizler. Bu donanımın kuralıdır ve buradaki kural da budur. Modelin iki ayrıntısı, ikisi de bilinçli ve ikisi de benzetilmiş zamanın adım adım ilerleyen bir saat olmaması nedeniyle böyledir:

  • Gerçek donanım kesmeyi CCOUNT'un karşılaştırıcıya eşit olduğu tek çevrimde tetikler ve karşılaştırıcı tekrar yazılana kadar tutar. Buradaki karşılaştırma "ulaşmış veya geçmiştir" biçimindedir, çünkü WAITI'de bekleyen bir çekirdek komut işlemeyi bırakırken zaman akmaya devam eder ve aksi hâlde önemli olan tek çevrimin üzerinden doğrudan geçerdi. Bir sonraki son tarihi belirleyen bir işleyici için (bu kaydın her kullanımı böyledir) ikisi aynı şekilde davranır.
  • Süresi geçmiş bir kesme kurulmaz. Bir işleyici birkaç yüz çevrim sürer, dolayısıyla "şimdi"ye ayarlanmış bir karşılaştırıcı işleyici döndüğünde geçmişte olur, hemen tekrar tetiklenir ve kesilen programa bir kerede tek komut düşer. Üç saniyelik blink, bu kuraldan önce 200 milyon komut, bu kuraldan sonra yarım milyon komudun altında maliyetle çalışır.

MOVSP Alloca istisnasını tetiklemez burada istisnanın ve işleyicisinin birlikte yaptığı şeyi yapar. Donanımda MOVSP çağıranın penceresi zaten taşmışsa yakalar (WINDOWSTART için temizle WINDOWBASE - 1 hedefine - 3) ve işleyici çağıranınkini kopyalar a0..a3'ünü, eski yığın işaretçisinin altındaki 16 baytlık temel kayıt alanını, taşımadan önce yeni işaretçinin altına kopyalar. Bu model bu kopyayı yerinde yapar ve sonra taşır (crates/xtensa-core/src/cpu.rs, movsp). Kod buna bağımlıdır: clang-v3, bağımsız değişkenleri yığında geçiren her çağrıyı şunlarla çevreler: movsp a1, a8, ve kopya yapılmadan önce şunu çağıran bir kod WiFi.scanNetworks() (sekiz bağımsız değişken ile this) dönüş yolunda pencere alt taşmasında çöktü. Yeterli print çağrısından sonra çağıranını taşırdıran ve altıdan fazla bağımsız değişkenle setup() çağıran her uzun sprintf de öyleydi: her şey yazdırıldı, sonra exccause=9 WindowUnderflow8'de, şu adla setup() dönüşünde (ESP32 ve S3'te; C3 ve Pico'da pencere yoktur). crates/xtensa-core/tests/alloca.rs çalıştırır: CALL8 ve CALL12 her biri yığın işaretçisini aşağı ve yukarı hareket ettiren çerçeveler, bir çağrının etrafında MOVSP ile, 0'dan 40'a her derinlikte, ve web/src/compile/xtensa-movsp.test.ts kodları her iki kartta da çalıştırır.

The FPU is modeled. The ESP32's single-precision coprocessor runs on this model (crates/xtensa-core/tests/fpu.rs): the loads and stores (LSI, SSI, LSX, SSX and their post-incrementing forms), ADD.S, SUB.S, MUL.S, the fused MADD.S, MSUB.S and MADDN.S, the conversions (FLOAT.S, UFLOAT.S, TRUNC.S, UTRUNC.S, ROUND.S, FLOOR.S, CEIL.S), the compares into the boolean registers with BT, BF, MOVT and MOVF, the conditional moves, WFR, RFR, FCR and FSR, and the division and square-root steps libgcc's __divsf3 and newlib's sqrtf are built from, which return the correctly rounded IEEE answer. Arithmetic rounds to nearest whatever FCR says and sets no FSR flags. On this bare-metal model the coprocessor is on from reset, as there is no OS to turn it on at first use; the system model (docs/micropython-esp32.md) still waits for CPENABLE. So a float in an example built by Espressif's GCC through firmware/esp32/build.sh runs and prints the right number, and the browser's soft-float builds (-Xclang -target-feature -Xclang -fp, calls into mokxi_float.c) are unchanged.

5. Zaman modeli, prob, poke ve ana bilgisayar kanalı

CPU 240 MHz'de, çevrim başına bir komut, çevre birimi veri yolu ise 80 MHz'de çalışır. 240 MHz bir çevrim için tam sayıda pikosaniye değildir, bu yüzden k komutunun zamanı biriktirilmek yerine ps_for(k) = k * 12500 / 3 olarak yeniden hesaplanır (Blue Pill ve XIAO'daki gibi), ve 2400 komutluk bir dilim tam 10 us'dir.

Bir dilimin içinde komut sayısı saatin kendisidir: bir zamanlayıcı okuması, bir UART baytı ve bir pin değişimi, hepsi dilimin sonunda değil, kendilerine neden olan komutta yer alır. Kart parçası bunları aynı ofsetlerde drive_after çağrılarına dönüştürür, dolayısıyla dört komut arayla yapılan iki yazma ağda gerçekten 16.7 ns arayladır. RSR.CCOUNT aynı saati okur.

WAITI'de bekleyen bir çekirdeğin maliyeti yoktur: kart, bir sonraki CCOMPARE son tarihi ile bir sonraki LEDC kenarından en erken olanında uyanmayı ister, ve bir pin değişimi ya da bir ana bilgisayar baytı da onu uyandırır.

Çıkışlara yazıldıktan sonra girişlerin okunması devreyi bekler. Çekirdek devreden bir dilim önde çalışır ve GPIO_IN_REG, dilimin başında örneklenen seviyeleri tutar. Dolayısıyla bir GPIO veya IO_MUX yazımı bir dilimde bir padi hareket ettirdiyse, GPIO_IN_REG veya GPIO_IN1_REG yüklemesi yanıtlanmaz: veri yolu BusError::Retry döner, xtensa-core çekirdeği o komuttan önce, onunla ilgili hiçbir şey yapılmadan durdurur, dilim orada biter, kart hareketi ağa koyar ve sonraki dilim girişleri örnekleyip okumayı çalıştırır. Bir tuş takımı taraması (bir sütunu sür, satırları oku) ve bir pinden diğerine bir kablo, ikisi de devrenin yazımdan çıkardığını okur. AVR kartları da böyle bir okumadan önce aynı şekilde durur.

prob bir bit maskesidir, seviye değil, çünkü bu kartta söylenmeye değer dört şey var:

bit anlam
1 çalışıyor
2 waiti içinde bekliyor
4 GPIO 2'deki mavi LED yanıyor
8 firmware, GPIO 34 ile 39 arasındaki bir pini çıkış yapmaya çalıştı ve reddedildi

0, program yok, resette tutuluyor ya da çöktü demektir. Bit 8, çalışma durumuna bağlı değildir: çıkış isteği reddedilmiş bir program reddedilmiş kalır ve kart bunu söylemeye devam eder.

poke: 1 BOOT'u tutar (GPIO 0 düşük), 0 bırakır; 2 tutar EN, 3 bırakır.

Ana makine kanalı. host_write UART0'ın alma FIFO'suna baytları koyar (128 bayta sığmayanlar tutulur ve kod okudukça gerçek bir karttaki baytların baud hızında Arduino çekirdeğinin halka tamponuna damla damla gelmesi gibi, bayt başına bir süre arayla girer, atılmaz); host_read gönderme FIFO'sundan çıkmış baytları alır. Bu, kod tarafında Serial, arayüz tarafında seri monitördür. Baytlar arayüz açısından UTF-8'dir ve model için opaktır. Bir DevKit'in mikro USB yuvası bu portta bir CP2102 veya CH340 köprüsüne gider; köprünün kendisi modellenmemiştir ve DTR/RTS üzerinden otomatik reset de öyle.

Çökme. İlerleme olmadan art arda 1000 tuzak yakalanınca çekirdek çöktü olarak ilan edilip durdurulur ve öldüğü yer kaydedilir.

6. Bu modelin emin olduğu ve olmadığı şeyler

Üç grup, sonra adreslerle hiç ilgisi olmayan yaklaşımlar için dördüncüsü. Bu bölüm var, çünkü sessizce bir adresi tahmin eden kart modeli, bilmediğini söyleyen modelden daha kötüdür.

Teknik referans kılavuzundan alınmıştır

DPORT_BASE 0x3FF0_0000, UART0_BASE 0x3FF4_0000, GPIO_BASE 0x3FF4_4000, SENS_BASE 0x3FF4_8800, IOMUX_BASE 0x3FF4_9000, LEDC_BASE 0x3FF5_9000 ve TIMG0_BASE 0x3FF5_F000. GPIO matrisinin içindeki ve UART0'ın içindeki her kayıt ofseti ve 19.9 numaralı kayıttan UART_CONF0_REG'in RXFIFO_RST'i (bit 17) ve TXFIFO_RST'ı (bit 18), UART_STATUS_REG'in sekiz bitlik RXFIFO_CNT ve TXFIFO_CNT'si (19.8 numaralı kayıt), UART_CONF1_REG'in eşikleri (19.10 numaralı kayıt) ve UART_CLKDIV_REG'in yirmi bitlik böleni (19.6 numaralı kayıt). Seviye-1 CPU kesme maskesi 0x0006_37FF (0'dan 10'a, 12, 13, 17 ve 18) ve tablo 8.3-2'den (bölüm 4) CCOMPARE kesmeleri 6, 15 ve 16. 0x4008_0000'deki IRAM penceresi ve 0x3FFB_0000'deki DRAM penceresi. GPIO_FUNC_OUT_SEL = 256, "GPIO_OUT'u izle" için. Düz GPIO için MCU_SEL değeri 2. ADC1'in kanal haritası: 0'dan 7'ye kanallar GPIO 36, 37, 38, 39, 32, 33, 34, 35. Kırk GPIO, 6 ile 11'in flash olduğu ve 34 ile 39'un çıkış sürücüsünün olmadığı. GPIO 2'deki mavi LED ve GPIO 0'daki BOOT butonu. Xtensa vektör ofsetleri ve EXCCAUSE numaraları, çipin değil ISA'nın olanları.

İnanılan, doğrulanmayan

  • IO_MUX ped sırası tablosu (bölüm 3.2). Kayıtlar ped sırasına göredir ve her GPIO'nun hangi pedde olduğu bu modelin yorumudur.
  • Zamanlayıcı grubu 0'ın kayıt ofsetleri (bölüm 3.4). Taban adresi kılavuzunkidir; içindeki düzen değil.
  • LEDC bloğunun düzeni (bölüm 3.6): kanal adımı, 0x140 adresindeki zamanlayıcı bloğu ve kesme ile yapılandırma kayıtları. Taban adresi kılavuzunkidir.
  • SENS ofsetleri ve bit konumları (bölüm 3.5).
  • DPORT_INTR_MAP = 0x104ve iki kaynak numarası, GPIO 22 ve UART0 34 (bölüm 3.7).
  • 0'dan 7'ye kadar olan LEDC yüksek hızlı kanalları için GPIO matrisi sinyal indeksleri 71'den 78'e (bölüm 3.1). Bu, belgedeki en zayıf iddiadır.

Bunların her biri firmware'in okuduğu tek bir yerde adlandırılmıştır (firmware/esp32/include/esp32.h), böylece gerçek silikona taşınacak bir görüntünün kontrol edeceği kısa bir #define listesi olur. crates/esp32/tests/contract.rs o başlığı ve crates/esp32/src/map.rs'yi aynı sayılara bağlar, böylece ikisi birbirinden kayamaz; ama bu, ikisinin de doğru olduğu anlamına gelmez.

Modellenmiş, ama kılavuzun sayılarına göre değil

Bunlar adreslerden çok yaklaşımlardır ve bir kod bunların her birini görebilir:

  • UART_STATUS_REG'in durum makinesi alanları 0 olarak okunur (bölüm 3.3). Silikonda ST_URX_OUT ve ST_UTX_OUT bir bayt hat üzerindeyken hareket eder; çalışma zamanı yalnızca sekiz bitlik sayıları okur, bu yüzden farkı görmez.
  • 11 dB'deki ADC tipik bir parçanın eğrisidir, bu ünitenin değil. Ham okuma, ölçülen ESP32s'lere uydurulmuş bir eğriyi izler (bölüm 3.5): alttaki ölü bölge, üstteki bükülme ve yaklaşık 3,15 V'taki doyum mevcuttur; eFuse kalibrasyonunun düzelttiği üniteden üniteye yayılım ise mevcut değildir. Diğer zayıflatma değerleri nominal düz doğrulardır.
  • Her ped aynı şekilde güçlenir (bölüm 3.2): düz GPIO, giriş tamponu açık, pull yok. Kılavuz, strapping ve flash pinlerine farklı reset değerleri verir.
  • GPIO_STRAP_REG sabittir, 0b1101, reset anında pinlerin ne yaptığını tutan bir mandal değil.
  • Bir dönüşüm tam 5 us sürer ve bir LEDC kenarı tam o pikosaniyeye düşer. Gerçek parçada titreme (jitter) vardır ve iki sayı da veri sayfası değeri değildir.
  • EN tek başına 10 k pull-up'tır. Yanındaki 100 nF açılış sıfırlama kondansatörü modellenmedi, bu yüzden bir EN burada anında geri gelir.
  • Önyükleme ROM'u yok ve saat ağacı yok. Gerçek bir ESP32, bir kodun ilk komutundan önce onlarca milisaniyeyi birinci aşama yükleyicide geçirir; burada POWER_ON 1 us'dir, çekirdek ilk komuttan itibaren 240 MHz'de ve APB saati 80 MHz'dedir ve ikisini yapılandıracak bir şey de yoktur.
  • CCOMPARE "ulaşıldı ya da aşıldı" durumunu karşılaştırırve geçmişte kalan bir son tarih devreye alınmaz (bölüm 4).
  • MOVSP hiçbir zaman Alloca yükseltmez; işleyicinin taban kayıt alanı kopyasını kendisi yapar (bölüm 4).
  • İki RAM penceresi örtüşmez. Gerçek parçada aynı SRAM, iki veriyolu üzerinden farklı adreslerde görünür, SRAM1'in blokları ters sırada (bölüm 2).

Bilerek hariç tutulanlar

Bunların her biri uydurulmak yerine dışarıda bırakılmıştır:

  • İkinci çekirdek. ESP32'nin iki Xtensa LX6 çekirdeği vardır, PRO ve APP, ve burada yalnızca PRO çekirdeği çalışır. DPORT_APPCPU_CTRL yok, çekirdekler arası kesme yok ve ikisinin arasında zamanlama yapacak FreeRTOS yok. Arduino çekirdeğinin tek loop()'u için yazılmış bir kod bunu hiç fark etmez; çekirdek 1'de görev başlatan her şey çalışmaz.
  • The cache, the MMU and flash. Code and constants are read from two fixed, read-only windows (section 2.1); there is no flash device, no MMU and no cache to miss, so a fetch from flash is as fast as one from IRAM. PSRAM likewise.
  • WiFi ve Bluetooth, her biçimiyle: radyo yok, protokol yığını yok, WiFi.h yok, kibarca başarısız olan bir yer tutucu bile yok.
  • RTC, yavaş belleği, ULP yardımcı işlemcisi, derin uyku ve güç yönetimi birimi.
  • ADC2, SAR'ın DMA'sı ve dijital denetleyicisi, kalibrasyon eFuse'ları, iç referans, dokunmatik sensör ve hall sensörü.
  • LEDC'nin düşük hızlı grubu ve duty-fade donanımı.
  • Zamanlayıcı grubu 1, zamanlayıcı grubu 0'ın zamanlayıcı 1'i, RTC watchdog'u ve kesme watchdog'u.
  • I2C, SPI, I2S, RMT, darbe sayacı, motor PWM'i, SDIO, Ethernet, CAN denetleyicisi ve AES, SHA, RSA ve RNG hızlandırıcıları.
  • 3.7. bölümdeki kaynakların ötesindeki kesme matrisi ve bir seviyenin üzerindeki her CPU kesme seviyesi.

Bu yüzden satıcı ESP-IDF ve Arduino-core ikili dosyaları burada çalışmaz, ancak bu belge için derlenen firmware çalışır.

İki Xtensa kartının görüntüleri de birbirinin yerine kullanılamaz. Katalog program dizgesi burada elf32 xtensa lx6 esp32, NodeMCU'da ise elf32 xtensa lx106 esp8266 şeklindedir ve fark yalnızca kayıt tutmaktan ibaret değildir: bu çekirdek pencereli ABI'yi çalıştırır, öbürünün onu çalıştıracağı bir penceresi yoktur, dolayısıyla biri için derlenen görüntü diğeri üzerinde sessizce yanlış davranmak yerine hata verir.

7. Firmware çalışma zamanı (firmware/esp32/)

An Arduino-shaped runtime: setup() and loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead (with analogReadResolution, analogSetAttenuation and analogSetPinAttenuation), analogWrite and the ledcAttach/ledcWrite/ledcRead family, millis, micros, micros64, delay, delayMicroseconds, attachInterrupt, Serial, Serial1 and Serial2, map, random. No Arduino core, no ESP-IDF, no libc.

Statik kurucular burada .ctors bölümünden gelir, .init_array bölümünden değil. Espressif'in GCC 8.4'ü şunlar olmadan yapılandırılmış --enable-initfini-array ve şuna sahip değildir: -fuse-init-arraybu yüzden global bir nesnenin kurucusu şuraya düşer: .ctors bu depodaki diğer tüm araç zincirleri şuraya yazar: .init_array. link.ld ikisini de tek aralıkta toplar crt0.S gezer. Olmasaydı global nesnesi olan bir kod (WebServer server(80) şurada: wifilamp) bağlanır, çalışır ve üye değişkenlerini sıfır bulurdu. İkisi tek geçişte gezilir ve .ctors tersine çevrilmez, çünkü çeviri birimleri arasında kurucuların çalışma sırası C++'da belirsizdir ve bir kod buna bağlı olmamalıdır.

LED_BUILTIN is 2. The core has no BOOT_BUTTON: the BOOT button is GPIO 0, so sketches use 0. A0 is 36, and A3 to A7 are 39, 32, 33, 34 and 35, which is what the DevKit's own analog pins are called.

analogRead ADC1 tek atımdır (3.5. bölüm), varsayılan olarak 11 dB'de on iki bit. analogWrite(pin, 0..255) çıkış sürücüsü olan her GPIO'da 1 kHz'de sekiz bittir ve ilk çağrıldığında boş bir LEDC yüksek hızlı kanalına bağlanır; frekans önemliyse bir kodun istediği şey ledcAttach(pin, frequency, bits)'tir ve aynı frekans ve çözünürlüğü isteyen kanallar dört zamanlayıcıdan birini paylaşır. mokxi_pin_is_input_only(pin), bir kod reddedilmeden önce sorabilsin diye oradadır.

millis() ve micros(), zamanlayıcı grubu 0'ın 0 numaralı zamanlayıcısından, mikrosaniye başına bir tik ile gelir (bölüm 3.4). delayMicroseconds(), 50 us altında CCOUNT'u sayar: mikrosaniye başına 240 çevrim, yani istenenden asla kısa sürmez (mikrosaniye zamanlayıcısını saymak, delayMicroseconds(10) işlemini 9.01 us yapabilirdi ve HC-SR04 bunu tetik olarak yok sayardı); 50 us ve üzeri delay() gibi bekletir. delay() çekirdeği kısır döngüde tutmak yerine CCOMPARE0 üzerinde bekletir, böylece bir saniyelik blink çekirdeğe saatin saydığı 240 milyon çevrimden yarım milyondan az komuta mal olur. attachInterrupt tek yazma yerine üç yazmadır, çünkü bir çevre birimi çekirdeğe kesme matrisi üzerinden ulaşır (bölüm 3.7).

Serial1 ve Serial2, UART1 ve UART2 üzerinde src/uartn.c dosyasıdır (bölüm 3.3a) ve GPIO matrisi üzerinden begin(baud, config, rx, tx) veya setPins() adının verdiği pinlere yönlendirilir; hiçbiri verilmediğinde arduino-esp32 3.x varsayılanları kullanılır (Serial1 için GPIO 26 ve 27, Serial2 için 4 ve 25). Çekirdek altında ESP-IDF sürücüsü gibi davranır: 250 000 baut'a kadar REF_TICK, üzerinde APB; RXFIFO_FULL (120 bayt) veya tek sembollük alma zaman aşımında kesme, FIFO'yu setRxBufferSize() baytlık (256) bir halkaya taşır; bir parçanın tamamı ya da hiçbiri, halka doluyken parça kenara tutulur ve alma kesmeleri kapatılır, bu arada taşma kesmesi FIFO'yu boşaltır; available() yalnızca halkayı sayar. write() 128 baytlık FIFO'yu, flush() ise vericinin boşta kalmasını bekler. İki UART da CPU kesmesi 18'i paylaşır. onReceive(), mokxi_uartn_events() içinden çalışır; onu delay(), yield() ve main.cpp içindeki döngü çağırır (loop() aralarında), çünkü FreeRTOS görevi yoktur. Burada olmayanlar: akış kontrolü, RS-485, IrDA, otomatik baut ve bir TX halka tamponu.

Hazır örnekler Espressif'in GCC'siyle derlenir; kullanıcının kodu clang ile derlenir. Upstream LLVM'in ld.lld aracı Xtensa'yı hiç bağlayamaz, bu yüzden tarayıcı buradaki her örneği tarayıcının komut listesiyle derleyen Espressif LLVM çatalının wasm derlemesi olan clang-v3'ü kullanır (docs/compile.md). Önceden derlenmiş ELF'ler GCC ile derlenmiş olarak kalır: daha küçüktürler (docs/compile.md, "Code size") ve değişmelerini gerektiren bir şey yoktur. deploy/fetch-xtensa.sh, xtensa-esp32-elf-gcc 8.4.0'ı git tarafından yok sayılan tools/xtensa/ içine koyar: GCC GPL lisanslıdır ve burada derlediği hiçbir şey libgcc'ye veya araç zincirinin başka bir parçasına bağlanmaz, dolayısıyla hiçbir GPL kodu gönderilen bir ELF'e ulaşmaz. Tam açıklama ve kalan adımlar docs/compile.md içindedir.

crt0.S, VECBASE adresindeki altı pencere taşma ve düşme işleyicisini taşır; bunlar herhangi bir üretici kaynağından alınmak yerine ISA referansından yazılmıştır ve kök çerçeveye kendine ait bir temel kaydetme alanı verir: kök çerçevenin pencere taşması, çağıranın yığın işaretçisini bulmak için l32e a0, a1, -12 komutunu çalıştırır ve sonra onun üzerinden yazar; kök çerçevenin çağıranı yoktur, bu yüzden yığının tepesinden altmış dört bayt aşağıya bir tane kurulur. O olmadan ilk derin çağrı zinciri boş bir işaretçi üzerinden taşar.

Özel durum girişi a1 ile temas etmezve bu bir derli topluluk değil doğruluk meselesidir: işleyici kesilen işlevin kendi penceresinde çalışır ve daha eski bir çerçevenin pencere taşması, nereye taşacağını o penceredeki yığın işaretçisini okuyarak bulur. Taşı a1 ve daha eski her çerçeve yanlış yere taşınır ve bozuk geri döner. Kesilen yazmaçlar sabit bir bloğa gider: .bss onun yerine, ki bu kilit olmadan güvenlidir çünkü işleyici şu seviyede çalışır: INTLEVEL 1.

Linked against firmware/esp32/link.ld: the vectors and startup code in the 128 KB of IRAM, code in the flash code window, constants in the flash constants window, .data, .bss and the stack in the 192 KB of DRAM. A WROOM-32 has 4 MB of flash and an example should be a small part of it, so the build refuses an image with more than 64 KB loadable; the real ceiling the linker script enforces is the 1,310,720 bytes of the default app partition.

Beş örnek, her biri arayüzde bir kodla gösterilir: blink (GPIO 2'deki kartın LED'i ve GPIO 4'e kablolanmış bir LED), button (GPIO 15'te kendi pull-up'ı üzerinden toprağa bağlanan bir anahtar), serial (saniyede bir tik ve yazdıklarınızın yankısı), fade (LEDC üzerinde GPIO 4'te bir LED, 1 kHz'de sekiz bit) ve knob (GPIO 32'de, yani ADC1 kanal 4'te bir pot, ham okumayı yazdırarak GPIO 4'teki bir LED'i karartır). pzemmonitor, PZEM004Tv30 kütüphanesi üzerinden Serial2 (GPIO 16 ve 17) üzerindeki bir PZEM-004T enerji ölçer, GCC yerine tarayıcının derleyicisiyle derlenir (bölüm 4) ve ESP32 PZEM-004T enerji izleyici projesidir.

crates/esp32/tests/runtime.rs bu beş ELF'i başlatır ve izlemek yerine ölçer: blink'in yarım periyodu 500'ün 5 ms içinde, LEDC'nin periyodu 1 kHz'in 1 ms'inin 5 us içinde, millis() beş saniye boyunca çekirdeğin kendi saatinin 60 ms içinde ve UART0'ın hiçbir iki baytı 115200 baud'ın 86.8 us'ünden daha yakın değil. Görüntüler derlenmediğinde her test kendini atlar, böylece crate'in testleri hiçbir zaman çapraz derleyiciye bağımlı olmaz.