Referensi

Kontrak board ESP8266 NodeMCU (Boards Wave C)

LX106 dengan ABI call0, GPIO16 yang bukan GPIO, PWM software, dan satu blok yang register-nya direkayasa.

Ini adalah referensi teknis untuk modelnya: apa yang diimplementasikan, register demi register, untuk orang yang menulis firmware menggunakannya. Untuk memakai board ini di editor, mulai dari ESP8266 NodeMCU dan halaman board.

NodeMCU V1.0 adalah board tiga puluh pin di sekitar modul ESP-12E: Xtensa LX106 pada 80 MHz, komponen terkecil dan tertua di sini dan tetap board WiFi pertama kebanyakan orang. Satu komponen kernel (esp8266 di crates/parts) membungkus model SoC ESP8266 (crates/esp8266) pada interpreter Xtensa yang sama dengan ESP32 (crates/xtensa-core), dalam konfigurasi berbeda. Dokumen ini adalah kontraknya, dan ia menang atas komentar apa pun di kode.

Tipe katalognya esp8266. String program pada katalog adalah elf32 xtensa lx106 esp8266.

Baca bagian 6 dulu jika kamu membawa build dari sini ke silikon sungguhan. Sebagian besar board ini ada di alamat aslinya; ADC-nya tidak, dan hal itu dinyatakan di bagian 3.5, di halaman board dan di artikel bantuan serta di sini, karena Espressif tidak pernah mempublikasikan antarmuka register konverter TOUT sama sekali.

A sketch for this board compiles in the browser with clang-v3, the wasm build of Espressif's LLVM fork (-mcpu=esp8266), published 2026-09-28 and checked on this simulator (docs/compile.md). An untouched example still runs its prebuilt ELF from web/public/firmware/esp8266/, which Espressif's GCC builds. Section 7 has the details.

1. Pin board (urutan katalog)

Tampak atas, soket micro-USB di bawah, modul ESP-12E dan antena PCB-nya di atas. Boardnya 48.3 x 25.6 mm dan dua header 15 pin-nya berjarak 22.86 mm (0.9 inch), jadi ia mengangkangi breadboard dengan satu baris lubang tersisa kosong di tiap sisi. Visual menggambarnya dalam ukuran itu.

Itu adalah V1.0 Amica, yaitu board yang dimodelkan komponen ini. V3 "LoLin" yang juga sering disebut NodeMCU lebih lebar, dengan jarak satu inci penuh antara barisan header-nya: di breadboard ia tidak menyisakan satu baris pun yang bebas, dari situlah reputasi board ini butuh dua breadboard berasal.

Header kiri, dari atas ke bawah (15 lubang): A0, RSV, RSVb, SD3, SD2, SD1, CMD, SD0, CLK, GND, 3V3, EN, RST, GNDb, VIN.

Header kanan, dari atas ke bawah (15 lubang): D0, D1, D2, D3, D4, 3V3b, GNDc, D5, D6, D7, D8, RX, TX, GNDd, 3V3c.

30 pin. Nama yang duplikat diberi huruf karena nama pin di katalog harus unik.

Nama di silkscreen bukan nomor GPIO

Ini satu-satunya hal yang paling sering menjebak orang di board ini, jadi ditulis di sini, di artikel bantuan dan di halaman board:

silkscreen D0 D1 D2 D3 D4 D5 D6 D7 D8 RX TX
GPIO 16 5 4 0 2 14 12 13 15 3 1

digitalWrite(2, HIGH) adalah D4, bukan D2. Runtime mendefinisikan D0 ke D8 sehingga sketch bisa memakai keduanya, dan crates/parts/src/parts/esp8266.rs punya test yang mencakup seluruh tabelnya.

Delapan pin header yang tidak tersambung ke apa pun

SD0, SD1, SD2, SD3, CMD dan CLK adalah GPIO 7, 8, 9, 10, 11 dan 6: enam kabel chip flash, dan program berjalan lewat kabel-kabel itu. Pin-pin itu ada di header NodeMCU asli, jadi ada juga di komponen ini; di sini pin-pin itu tidak menggerakkan apa pun dan tidak dibaca. Dua pin RSV juga sama. Sketch yang tadinya jalan di simulator karena memakai SD1 akan menghentikan flash di meja kerja, dan itulah satu hal yang dicegah oleh komponen ini.

A0 berada di belakang pembagi tegangan board

Pin TOUT chip mengonversi 0 sampai 1.0 V. NodeMCU memasang pembagi 220k/100k di depannya, jadi A0 pada header adalah 0 sampai sekitar 3.2 V dan sebuah pot yang dipasang melintasi rel 3.3 V hampir mencakup seluruh rentangnya. Pembaginya milik board, bukan chip, jadi ia ada di komponen board: pin membebani net-nya dengan 320 k dan SoC menerima sepertiga tegangan yang sampai ke pin chip. A0 bukan GPIO dan tidak bisa ditulis.

Dua LED, dan keduanya aktif rendah

  • GPIO 2, yaitu D4, memiliki LED biru modul ESP-12. Di komponen asli ia juga adalah TX dari UART1, karena itulah sketch yang memakai Serial1 akan kehilangan LED itu.
  • GPIO 16, yaitu D0, memiliki LED board pembawa NodeMCU.

Keduanya disambung dari 3V3 ke pin, jadi LOW menyalakannya. Kebalikannya adalah kesalahan yang paling mudah terjadi di board ini, jadi probe melaporkan tiap lampu sebagai menyala saat pad-nya rendah (bagian 5).

GPIO 16 bukan pin biasa

D0 adalah pin RTC. Ia tidak ada di register mana pun blok GPIO (ia punya register output, enable dan input sendiri di blok RTC, bagian 3.2); ia punya pull-down di mana setiap pad lain di komponen ini punya pull-up, dan ia tidak bisa memunculkan interrupt. Di NodeMCU ia adalah pin yang kamu sambungkan ke RST untuk wake dari deep-sleep, dan ia adalah D0, jadi bukan keanehan yang bisa diabaikan sketch.

Electrical: every GPIO drives push-pull at 3.3 V through R_STRONG, sits high-Z, or pulls through 45 k. An input reads high at 1.65 V; a contended (Unknown) net reads 0, and a floating one reads noise, as on the Uno (docs/uno.md section 1); the board's boot straps hold GPIO0 and GPIO2 high and GPIO15 low when nothing else does. 3V3 drives 3.3 V at R_SUPPLY, VIN drives 5 V, the four grounds drive 0 V. RST and EN are tied to the same node here, as a NodeMCU ties them, with a 10 k pull-up to 3.3 V; pulling either below 1.65 V holds the core in reset. The capacitor beside that resistor is the board's power-on reset and is not modeled.

Urutan silkscreen yang persis dari kedua header adalah pembacaan model ini atas pinout NodeMCU V1.0 (Amica). Nomor GPIO adalah milik chip dan itulah pegangan firmware; posisinya di header adalah pegangan diagram. V3 LoLin memindahkan dua di antaranya selain lebih lebar, dan rangkaian yang digambar di sini perlu disambung ulang untuk salah satunya.

2. Peta memori

IRAM (instruksi) 32 KB di 0x4010_0000 sampai 0x4010_7FFF
IROM (flash code and constants) 0x4020_0000, read-only, up to 1,044,464 bytes
DRAM (data) 80 KB di 0x3FFE_8000 sampai 0x3FFF_BFFF
puncak stack 0x3FFF_C000
UART0 0x6000_0000, bagian 3.4
GPIO 0x6000_0300, bagian 3.1
RTC (GPIO16) 0x6000_0700, bagian 3.2
IO_MUX 0x6000_0800, bagian 3.3
SAR (TOUT) 0x6000_0D00, bagian 3.5, milik model ini sendiri

Setiap blok peripheral berukuran 0x100 di sini, karena di komponen ini mereka memang benar-benar seberdekatan itu.

Three windows, as on the real part: the vectors, the exception entry and the startup code in iram1_0_seg (the 32 KB of instruction RAM), the rest of the code and every constant in irom0_0_seg, which a real ESP8266 reads from flash through the cache at 0x4020_0000, and the data in dram0_0_seg. Every ESP8266 linker script uses these names and these addresses.

The Arduino IDE gives a NodeMCU sketch 1,044,464 bytes of flash by default ("4MB (FS:2MB OTA:~1019KB)"), and that is the room here: code, literals, constants, startup code and the initial values of the variables, which is what the IDE adds up and the editor prints after a build. The flash window is a read-only view of the loaded image, not a cache: there are no misses and no timing, so a fetch from flash costs what a fetch from IRAM costs here. A store to it faults. Global variables are limited by the 80 KB of data RAM and a program over it is refused with "no room for the stack". Literal pools sit in front of their own functions (L32R reaches 256 KB backwards) and calls out of the startup code go through a register (CALL0 reaches 128 KB).

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

The core resets with pc at the ELF entry point and every address register zero. There is no boot ROM: the real part's ROM loader, the flash reads, the cache set-up and the SDK's own initialization are absent, and firmware/esp8266/crt0.S makes the state it wants explicit.

3. Register peripheral

Hanya subset di bawah ini yang diimplementasikan. Apa pun selain itu di dalam blok yang dipetakan terbaca 0 dan dihitung sebagai akses liar; apa pun di luar semua blok adalah access fault.

3.1 GPIO (0x6000_0300)

Tujuh belas pin, tetapi hanya enam belas yang ada di sini: GPIO 0 sampai 15 adalah biasa dan GPIO 16 ada di blok RTC (bagian 3.2).

offset register
0x00 GPIO_OUT
0x04 GPIO_OUT_W1TS
0x08 GPIO_OUT_W1TC
0x0C GPIO_ENABLE
0x10 GPIO_ENABLE_W1TS
0x14 GPIO_ENABLE_W1TC
0x18 GPIO_IN
0x1C GPIO_STATUS
0x20 GPIO_STATUS_W1TS
0x24 GPIO_STATUS_W1TC
0x28 + 4n GPIO_PINn, untuk n dalam 0..16

Terverifikasi sejauh yang komponen ini izinkan: base dan setiap offset di sini adalah yang dipakai setiap header ESP8266, linker script dan deskripsi register terbuka selama satu dekade, dan itu yang diberikan ESP8266 Technical Reference Manual dari Espressif untuk blok GPIO. Itu bukan angka pilihan model ini.

GPIO_PINn bit 2 PAD_DRIVER membuat pad open drain; bit 7..9 INT_TYPE memilih apa yang memunculkan interrupt pin: 0 mati, 1 rising, 2 falling, 3 semua edge, 4 level rendah, 5 level tinggi. Tidak ada GPIO matrix di komponen ini: sebuah pad jadi GPIO atau milik peripheral, dan pilihannya dilakukan di IO_MUX.

Tidak ada bit enable interrupt per pin selain INT_TYPE, dan tidak ada paruh kedua dari register mana pun, karena enam belas bit sudah cukup untuk blok ini.

3.2 Register RTC di belakang GPIO16 (0x6000_0700)

offset register bit
0x68 RTC_GPIO_OUT bit 0 adalah level output GPIO16
0x74 RTC_GPIO_ENABLE bit 0 adalah driver output GPIO16
0x8C RTC_GPIO_IN_DATA bit 0 adalah apa yang dilihat pad GPIO16
0x90 RTC_GPIO_CONF bit 0 clear puts the pad under RTC_GPIO_ENABLE
0xA0 PAD_XPD_DCDC_CONF bit 0..1 memilih GPIO16 alih-alih pin DCDC

Diyakini, bukan diverifikasi. Lima ini adalah register yang dipakai setiap sequence GPIO16 ESP8266 sejak 2015 dan yang ditulis oleh pinMode(16, ...) core Arduino, tapi ini bukan kutipan dari halaman manual. Pull pada pad ini adalah pull-down, tidak seperti setiap pad lain pada komponen ini.

Tidak ada bagian lain dari blok RTC yang dimodelkan: tanpa counter RTC, tanpa memori RTC, tanpa deep sleep, tanpa wake source.

3.3 IO_MUX (0x6000_0800)

PERIPHS_IO_MUX_CONF_U di 0x00, lalu satu register per pad. Bit 7 adalah pull-up internal.

Tidak ada bit input-enable di mana pun, dan tidak ada pull-down internal pada GPIO 0 sampai 15. Input buffer ESP8266 selalu aktif, dan INPUT_PULLDOWN tidak ada pada komponen ini; hanya GPIO16 yang punya pull-down, dan itu ada di blok RTC. Sketch yang butuh pull-down harus pakai resistor.

Seperti pada ESP32, register-nya disusun dalam urutan pad, bukan urutan GPIO:

GPIO offset GPIO offset
0 0x34 8 0x24
1 0x18 9 0x28
2 0x38 10 0x2C
3 0x14 11 0x30
4 0x3C 12 0x04
5 0x40 13 0x08
6 0x1C 14 0x0C
7 0x20 15 0x10

Lebih diperkirakan daripada diverifikasi. GPIO16 tidak punya register IO_MUX sama sekali.

3.4 UART0 (0x6000_0000)

offset register
0x00 UART_FIFO
0x04 UART_INT_RAW
0x08 UART_INT_ST
0x0C UART_INT_ENA
0x10 UART_INT_CLR
0x14 UART_CLKDIV
0x1C UART_STATUS
0x20 UART_CONF0
0x24 UART_CONF1

Verified: the base and every offset, and the bits below, against the ESP8266 Technical Reference v1.7, appendix 3 "UART Registers". The offsets are the ESP32's and the ESP32-C3's, but this part's fields are narrower, so crates/esp8266/src/uart.rs is no longer crates/esp32/src/uart.rs twice.

Dua FIFO masing-masing 128 byte. UART_STATUS bit 0..7 RXFIFO_CNT dan bit 16..23 TXFIFO_CNT, dan model serta runtime membaca field delapan bit di sana, seperti yang diberikan lampiran 3. Runtime dulu membaca sepuluh bit, yang memberi angka sama karena bit di atas setiap field reserved dan terbaca 0; header sekarang cocok dengan manual, seperti pada ESP32, yang bit di atasnya tidak reserved. UART_CONF0 bit 17 RXFIFO_RST dan bit 18 TXFIFO_RST. UART_CONF1 bit 0..6 RXFIFO_FULL_THRHD dan bit 8..14 TXFIFO_EMPTY_THRHD, keduanya 96 saat reset. UART_CLKDIV bit 0..19 adalah pembagi, yang membagi clock APB 80 MHz dan reset ke 694 (0x2B6 dari lampiran), yaitu 115 274 baud.

Tiga dari itu sebelumnya salah di sini sebelum pemeriksaan itu, dan tidak ada yang mengubah image hasil build: dua bit reset FIFO tertukar (Serial.begin runtime menyetel dan membersihkan keduanya bersamaan, jadi nilai yang ditulis sama); CONF1 memakai field sembilan bit milik ESP32-C3 di 0 dan 9 (runtime tidak pernah menulis CONF1); dan pacing kirim hanya membaca dua belas bit pembagi, jadi Serial.begin(9600), yang pembaginya 8333, mengirim byte sekitar 59 kali terlalu cepat. Pacing sekarang memakai semua dua puluh bit.

Byte keluar dari FIFO kirim pada baud rate, bukan seketika, dengan alasan yang diberikan bagian 3.3 docs/esp32.md. crates/esp8266/tests/runtime.rs mengukur jeda antara dua byte contoh serial terhadap 86.8 us yang diperlukan satu byte pada 115200.

UART1 tidak dimodelkan. Pada ESP8266 sungguhan, TX UART1 adalah GPIO 2, yang juga merupakan LED modul, dan itu seluruh alasan Serial1 dan LED biru tidak bisa dimiliki bersamaan.

3.5 The TOUT converter (0x6000_0D00): the one block that is not the chip's

Baca ini sebelum memercayai sebuah alamat. Setiap peripheral lain dalam model ini berada di alamat aslinya dengan offset aslinya, jadi firmware yang di-build di sini bisa berjalan di NodeMCU sungguhan. ADC-nya adalah pengecualiannya, dan bukan pengecualian kecil. Espressif tidak pernah mempublikasikan register SAR ESP8266: system_adc_read() ada di dalam blob biner SDK, core Arduino memanggilnya, dan tidak ada halaman manual untuk dikutip. Daripada mengarang alamat dan biarkan pembaca menganggapnya milik chip, model ini menaruh tiga register miliknya sendiri di SAR_BASE:

offset register bit
0x00 SAR_CFG bit 0 START memulai konversi; bit 1 tersimpan dan tidak melakukan apa pun
0x04 SAR_STATUS bit 31 DONE; bit 0..9 hasil sepuluh bit

Tidak diverifikasi, dan bukan sekadar tidak diverifikasi: dikarang. analogRead adalah satu-satunya panggilan di board ini yang perlu diubah untuk hardware sungguhan. Di sana itu system_adc_read() dari SDK. Tidak ada lainnya.

Yang dimodelkan adalah bagian yang bisa dilihat sebuah rangkaian: satu channel, sepuluh bit, round(1023 x Vin / 1.0 V), di-clamp, dari tegangan di pin chip. Pembagi 220k/100k NodeMCU adalah milik bagian board (bagian 1), jadi skala penuh header sekitar 3.2 V. A0 yang tidak tersambung mengembara, seperti perilaku input mengambang (docs/uno.md bagian 1).

Satu konversi memakan waktu 80 us waktu simulasi yang tetap. Angka sungguhan tergantung loop sampling SDK dan lebih dekat ke seratus mikrodetik; ini satu-satunya angka pada blok ini yang merupakan pilihan model, bukan pengukuran, dan bagian 6 mencatatnya.

3.6 The clock: CCOUNT, and no timer peripheral

FRC1 dan FRC2 tidak dimodelkan. ESP8266 punya dua timer hardware dan tidak ada satu pun di sini. Clock yang dibaca runtime board ini adalah milik core sendiri CCOUNT, dan tick milidetiknya serta software PWM-nya keduanya berasal dari CCOMPARE0. Keduanya adalah register core di setiap Xtensa, jadi tidak ada alamat peripheral yang sekadar diyakini yang menopang millis().

The cost is written down rather than hidden. CCOUNT is thirty-two bits at 80 MHz, so it wraps every 53.7 seconds. The sixty-four-bit count the runtime hands out is kept by sampling CCOUNT and adding the difference, which is exact as long as no more than one wrap happens between two samples. Every millis(), micros() and delay() samples it, and the scheduler never lets the next interrupt be more than 2^30 cycles (13.4 seconds) away. So only a sketch that turns interrupts off for a minute and asks the time for nothing in that minute can lose a wrap. Section 6 says so again.

crates/esp8266/tests/runtime.rs mengukur millis() terhadap clock milik kernel sendiri selama lima detik.

3.7 PWM, yang berupa software pada komponen ini

ESP8266 tidak punya hardware PWM apa pun: tanpa LEDC, tanpa apa pun. Core Arduino ESP8266 menghasilkan gelombangnya dari handler timer dan runtime ini juga begitu: delapan slot, masing-masing dengan pin, waktu high dan waktu low dalam siklus CPU, dan deadline CCOMPARE0 bersama yang dipersenjatai untuk tepi mana pun yang datang berikutnya.

Itulah perbedaan jujur antara dua board Xtensa di sini. Pada ESP32, LED yang memudar tidak membebani core sama sekali, karena LEDC adalah hardware dan simulator membangunkan board hanya untuk tepinya. Pada ESP8266 core terbangun dua kali per periode untuk menggerakkan pinnya sendiri, yang persis seperti biaya komponen sungguhan, dan itu terlihat pada jumlah instruksi. Halaman board mengatakannya juga.

Delapan pin sekaligus. Frekuensi bawaan 1 kHz dan analogWriteFreq menerima 40 Hz sampai 60 kHz. crates/esp8266/tests/runtime.rs menjaga periode contoh fade pada 1 kHz dalam jitter sebesar satu handler, bukan lima mikrodetik milik ESP32, karena jitter sebesar satu handler adalah yang dimiliki software PWM.

Rentangnya 1023, bukan 255; lihat bagian 7.

3.8 Apa yang sama sekali tidak punya register di sini

SPI dan HSPI, I2C (periferal I2C memang tidak ada di komponen ini; Arduino core menanganinya lewat bit-bang), I2S, UART1 hardware, counter dan memori RTC, deep sleep, eFuse, serta keseluruhan MAC dan PHY WiFi.

3.9 Kotak surat jaringan Mokxi (0x6FFF_E000)

Blok ini bukan milik ESP8266. Segala hal lain dalam dokumen ini milik komponen tersebut atau ditandai sebagai temuan model ini sendiri beserta alasannya (bagian 3.5, konverter TOUT). Yang ini bukan keduanya: ini adalah jaringan simulasi Mokxi dari crates/net, di puncak jendela periferal yang blok aslinya semua berada di beberapa kilobyte pertamanya, sehingga image yang memakainya fault di silicon alih-alih membaca register periferal lain. Fault itu adalah jawaban yang jujur, karena hal di balik blok ini memang tidak ada di chip. Tidak ada di sini yang diambil dari Espressif SDK atau Arduino ESP8266 core.

Inilah komponen dengan radio yang sama sekali tidak punya dokumentasinya. WiFi ESP8266 adalah blob biner di SDK; Espressif tidak pernah mempublikasikan registernya, dan model ini tidak menebak-nebaknya. Sebagai gantinya model ini menawarkan kotak surat yang jujur milik Mokxi, di alamat yang jujur bukan milik komponen tersebut.

Blok ini tidak menimbulkan interupsi. Nomor interupsi yang dipakai model ini adalah yang disepakati semua header ESP8266, dan tidak ada nomor seperti itu untuk periferal yang tidak dimiliki chip, jadi kotak surat ini tidak diberi nomor. Firmware melakukan polling, dan core yang parkir di waiti tetap dibangunkan saat jaringan punya sesuatu untuk disampaikan.

Di sini tidak ada radio, tidak ada 802.11 dan tidak ada internet sungguhan. Tidak ada apa pun dalam model ini yang mengirim, memindai, berasosiasi, mengenkripsi atau membuka socket: password dibandingkan sebagai string, nama yang tidak berada di bawah .mokxi tidak di-resolve, dan tiga origin yang dilayani jaringan adalah fungsi-fungsi di crates/net/src/http.rs. Kotak surat ini adalah bentuk sejatinya sambungan itu, bukan fiksi tentang MAC: pada ESP32 sungguhan perangkat keras WiFi adalah blob biner tertutup dengan antarmuka perintah, dan WiFi.h milik Arduino berakhir di sisi lain dari salah satunya. docs/wifi.md adalah kontrak untuk apa yang ada di baliknya; bagian ini hanya registernya.

Sebuah register perintah, register status, ring 4096-byte untuk tiap arah dan satu bit interrupt. Menulis ke NET_CMD_REG menjalankan perintah; perintah yang memakan waktu simulasi menaikkan BUSY dan menghapusnya, dengan DONE di NET_INT_RAW_REG, saat selesai.

offset nama bit
0x00 NET_ID_REG membaca 0x494B4F4D, dan tidak ada hal lain yang melakukannya. Sketch yang ingin tahu apakah ia berjalan di Mokxi membaca ini; di silicon akses ini gagal
0x04 NET_CMD_REG tulis kode perintah (tabel di bawah); penulisan menjalankannya
0x08 NET_ARG_REG satu word argumen, bisa dibaca kembali: port untuk LISTEN, status untuk REPLY
0x0C NET_STATUS_REG bit 0 BUSY, bit 1 ERR, bit 2 RX_READY, bit 3 LINK, bit 4 SERVE, bit 8..11 STATE
0x10 NET_RESULT_REG apa yang dijawab perintah terakhir
0x14 NET_INT_RAW_REG bit 0 DONE, bit 1 EVENT
0x18 NET_INT_ENA_REG dua bit yang sama
0x1C NET_INT_CLR_REG tulis 1 untuk menghapus, dua bit yang sama
0x20 NET_TX_LEN_REG byte yang siap di ring keluar
0x24 NET_TX_DATA_REG tulis: dorong satu byte (bit 0..7) ke ring keluar
0x28 NET_RX_LEN_REG byte yang menunggu di ring masuk
0x2C NET_RX_DATA_REG baca: ambil satu byte dari ring masuk, 0 saat kosong
0x30 NET_RING_LEN_REG kapasitas tiap ring dalam byte, agar firmware tidak perlu hard-code 4096
0x40 NET_BT_CMD_REG Bluetooth: tulis kode perintah Bluetooth (docs/bluetooth.md); penulisan menjalankannya
0x44 NET_BT_ARG_REG Bluetooth: satu word argumen, bisa dibaca kembali; sebuah event meninggalkan nomornya di sini
0x48 NET_BT_RESULT_REG Bluetooth: apa yang dijawab perintah Bluetooth terakhir
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: byte yang siap di ring keluarnya sendiri
0x54 NET_BT_TX_DATA_REG Bluetooth: tulis: dorong satu byte ke ring tersebut
0x58 NET_BT_RX_LEN_REG Bluetooth: byte yang menunggu di ring masuknya sendiri
0x5C NET_BT_RX_DATA_REG Bluetooth: baca: ambil satu byte, 0 saat kosong

Delapan register NET_BT_ membaca 0 dan mengabaikan penulisan di board ini: ESP8266 tidak punya Bluetooth (docs/bluetooth.md).

STATE adalah posisi station: 0 idle, 1 mulai, 2 menghubungkan, 3 terhubung, 4 gagal, 5 jaringan tidak ada. NET_CMD_STATUS mengubah hal yang sama menjadi kode wl_status_t Arduino yang dibaca sketch dari WiFi.status().

NET_CMD_REG nama fungsinya
0 NOP tidak melakukan apa pun
1 RESET putuskan koneksi, buang kedua ring, buang semua request
2 CONNECT ring keluar berisi ssid\0password; menaikkan BUSY selama satu sampai tiga detik
3 DISCONNECT hapus asosiasi dan alamatnya
4 STATUS NET_RESULT_REG = kode wl_status_t
5 IP NET_RESULT_REG = alamat yang didapat, oktet pertama di byte rendah
6 RSSI NET_RESULT_REG = sinyal dalam dBm, dengan tanda diperluas
7 SSID ring masuk menerima nama access point
8 MAC ring masuk menerima enam byte MAC board
9 REQUEST ring keluar berisi method\0url\0headers\0body; menaikkan BUSY
10 POLL NET_RESULT_REG = 0 saat berjalan, lalu status HTTP, atau error negatif dengan ERR naik; body mendarat di ring masuk
11 LISTEN mendengarkan di port yang ada di NET_ARG_REG
12 ACCEPT NET_RESULT_REG = 1 dan ring masuk berisi method\0path\0query\0body, atau 0 saat tidak ada yang menunggu
13 REPLY jawab request yang diterima dengan status di NET_ARG_REG; ring keluar berisi content-type\0body
14 STOP berhenti mendengarkan
15 WL_GPIO_SET drive GPIO milik komponen nirkabel sendiri dari NET_ARG_REG. Bukan board ini: radio komponen ini tidak punya pin seperti itu, jadi ia menyetel ERR dan tidak menggerakkan apa pun. Inilah jalur yang diambil LED bawaan Pico W (docs/picow.md bagian 3.8)
16 WL_GPIO_GET baca kembali nilainya, dan ERR yang sama di sini
17 BLYNK satu operasi pada server Blynk yang disimulasikan, operasinya di NET_ARG_REG dan field-nya di ring keluar; dijawab seketika di NET_RESULT_REG, dengan ERR dimatikan dari jaringan (docs/wifi.md, "Blynk")
20 SOFTAP soft AP (crates/net/src/softap.rs, docs/wifi.md), operasinya di NET_ARG_REG: 1 mengaktifkannya (ring keluar ssid\0password\0 dan byte channel; NET_RESULT_REG 1, atau 0 dengan ERR untuk nama kosong atau kata sandi satu sampai tujuh karakter), 2 mematikannya, 3 mengonfigurasinya (alamat, gateway dan netmask, masing-masing empat byte), 4 alamatnya (0 saat mati), 5 station yang bergabung, 6 join, leave dan bit aktif yang diubah runtime menjadi event, 7 dan 8 DNS server captive portal yang menyala (namanya, satu byte nol, alamatnya) dan berhenti, 9 namanya ke ring masuk, 10 alamat HP, 11 Host dari permintaan yang sedang dilayani ke ring masuk. Station satu-satunya adalah HP panel Web

Kode POLL negatif: -1 nama tidak ter-resolve, -2 station tidak terasosiasi, -3 https:// dan TLS tidak disimulasikan, -4 body lebih panjang dari ring, -5 URL yang tidak bisa di-parse jaringan ini, -6 sudah ada permintaan yang berjalan. firmware/include/HTTPClient.h mengubahnya menjadi kode bergaya Arduino yang dibandingkan oleh sketch, dan docs/wifi.md memuat daftar pemetaannya.

Timing, semuanya milik model ini sendiri dan semuanya dinyatakan di docs/wifi.md: asosiasi memakan waktu satu sampai tiga detik, ditentukan dari SSID supaya sebuah pelajaran memakan waktu yang sama dua kali; kata sandi yang salah menjadi WL_CONNECT_FAILED setelah lima detik; permintaan ke origin tersimulasi kembali 60 ms kemudian; permintaan ke server milik sketch sendiri yang tidak pernah dijawab sketch ditutup oleh jaringan dengan 504 setelah sepuluh detik.

3.10 Reset dan watchdog (0x6000_0700, 0x6000_0900)

Espressif tidak mendokumentasikan register ini: SDK dan ROM menjalankannya lewat kode tertutup. Nama dan offset di sini adalah yang dipakai esp8266_peri.h serta rtc_get_reset_reason() dan software_reset() milik ROM, sejauh yang diketahui, dan model menganggapnya sebagai kepercayaan alih-alih hal yang terverifikasi. Watchdog hardware: bit 0 WDTCTL menjalankannya, menulis 0x73 ke WDTFEED (0x14) memberinya feed, dan 2^23 µs (sekitar 8,4 s) tanpa feed me-reset chip. RTC: bit 31 dari 0x00 adalah reset sistem software, 0x14 bit 3:0 penyebab reset menurut ROM (1 power on, 2 reset software, 4 watchdog), dan 0x30..0x3C empat register penyimpanan yang selamat dari setiap reset kecuali power-on.

The runtime (firmware/esp8266/src/time.c) is the SDK's: the software watchdog counts the hardware one's 1.6 s first stage, feeding it when the sketch has yielded (loop() returned, delay(), yield(), ESP.wdtFeed()) and, on the second tick in a row that finds it has not (3.2 to 4.8 s after it last yielded), prints the Arduino core's "Soft WDT reset" postmortem (exception 4, the epc, the stack dump between the cut lines) and resets. ESP.wdtDisable() stops only the software watchdog, as on the board, which leaves the hardware one; ESP.getResetReason() and getResetInfo() say which it was.

4. Core-nya: ABI mana, dan bagaimana sebuah interrupt datang

crates/xtensa-core adalah interpreter yang sama dengan yang dijalankan ESP32, dalam konfigurasi LX106. Tidak ada bagian darinya yang diturunkan dari QEMU, dari Espressif SDK, dari Arduino ESP8266 core, atau dari emulator lain; xtensa-lx106-elf-as dipakai sebagai alat ukur di meja kerja dan crates/xtensa-core/tests/encoding.rs menyimpan encoding yang dihasilkannya.

ABI call0, dan tidak ada pilihan lain. LX106 memiliki enam belas register alamat dan sama sekali tidak punya register window, jadi xtensa-lx106-elf-gcc menghasilkan call0, ret, dan addi sp, sp, -16 eksplisit. Tidak ada ENTRY, tidak ada RETW, tidak ada ROTW, tidak ada spilling, dan tidak ada handler window overflow atau underflow yang perlu ditulis. crt0.S di sini jauh lebih pendek daripada milik ESP32 karena alasan itu saja, dan tabel vectornya enam slot lebih pendek. Vector window di VECBASE + 0x000 sampai +0x140 tidak mungkin tercapai di komponen tanpa opsi windowed, jadi di sana diletakkan lompatan ke pelapor fault alih-alih apa pun yang kebetulan ada di memori.

Akibat lainnya, handler interupsi board ini boleh menyimpan register di stack yang diinterupsi, yang tidak boleh dilakukan milik ESP32: tanpa window tidak ada frame yang lebih lama yang bergantung pada stack pointer window ini.

Yang tidak dimiliki konfigurasi LX106, dan setiap perbedaannya diuji langsung ke assembler daripada dikira-kira: pembagian hardware, perkalian tinggi 32-bit, MIN/MAX, SEXT, CLAMPS, zero-overhead loop, dan atomic load. MUL16 dan MULL tersedia. Program yang dibuild untuk ESP32 karena itu fault di core ini daripada salah perilaku secara diam-diam, itulah sebabnya string program kedua board berbeda.

Vector. VECBASE adalah register khusus; dua yang penting di sini adalah KernelException di +0x300 dan UserException di +0x340. Every level-1 interrupt takes the user exception vector with EXCCAUSE 4, sehingga crt0.S mengirim semuanya ke satu tempat dan runtime yang mencari tahu sumbernya.

Interrupts. INTENABLE masks and PS.INTLEVEL gates, and only level 1 is modeled. Every interrupt the ESP8266 brings out is level 1 except the NMI, which is not modeled, so the level-1 mask here is all ones. That is believed rather than verified.

Di komponen ini tidak ada interrupt matrix: setiap sumber punya nomor interupsi CPU tetap, itulah mengapa attachInterrupt di sini cukup dua penulisan alih-alih tiga seperti di ESP32.

sumber interrupt CPU
GPIO 4
UART0 5
CCOMPARE0 6

Diyakini, bukan diverifikasi. 4 adalah yang disebut ETS_GPIO_INUM oleh setiap header ESP8266 dan 5 adalah ETS_UART_INUM; itu bukan nomor yang dikutip dari manual. Angka 6 milik CCOMPARE0 berasal dari Xtensa ISA.

Floating point. LX106 tidak punya FPU, jadi tidak ada yang bisa ditinggalkan di sini: setiap encoding floating-point memunculkan EXCCAUSE 32, coprocessor disabled, dan runtime memakai soft float, sama seperti yang didapat sketch ESP8266 sungguhan.

Aturan CCOMPARE dari bagian 4 docs/esp32.md (perbandingannya "tercapai atau terlampaui", dan deadline yang sudah lewat tidak dipasang) berlaku di sini, dan board inilah yang menemukan aturan keduanya.

5. Model waktu, probe, poke dan channel host

CPU berjalan di 80 MHz, satu instruksi per siklus, jadi satu instruksi tepat 12.5 ns dan slice 800 instruksi tepat 10 us. Berbeda dengan milik ESP32, bus ini mengalikan alih-alih membagi: instruksi k selesai pada slice_start + 12.5 ns * k.

ESP8266 bisa dijalankan di 160 MHz. Model ini selalu di 80, yaitu kondisi awal komponen ini dan tempat Arduino core membiarkannya; di sini tidak ada clock tree untuk mengubahnya.

Di dalam sebuah slice, jumlah instruksi adalah jamnya: pembacaan CCOUNT, satu byte UART, dan perubahan pin semuanya jatuh tepat pada instruksi yang menyebabkannya. Core yang parkir di WAITI tidak memakan biaya dan dibangunkan pada deadline CCOMPARE0 berikutnya (tick milidetik, sebuah delay yang bangun, atau tepi software PWM berikutnya) atau oleh perubahan pin atau byte host.

probe adalah bitmask:

bit arti
1 berjalan
2 parkir di waiti
4 LED modul di GPIO 2 menyala
8 LED carrier board di GPIO 16 menyala

0 means no program, held in reset, or crashed. Both LEDs are active low, so each bit is set when its pad is low.

poke: 1 menahan FLASH (GPIO 0 rendah), 0 melepaskannya; 2 menahan RST, 3 melepaskannya.

Kanal host. host_write memasukkan byte ke FIFO receive UART0; host_read mengambil byte yang sudah keluar dari FIFO transmit-nya. Itu adalah Serial dalam sebuah sketch dan serial monitor di UI. Byte berupa UTF-8 sejauh UI yang bersangkutan dan tidak transparan bagi model. Soket micro-USB NodeMCU terhubung ke bridge CP2102 atau CH340 di port ini; bridge tidak dimodelkan, begitu pula urutan auto-reset DTR/RTS.

Crash. 1000 trap berturut-turut tanpa kemajuan dan core dinyatakan crash lalu dihentikan, dengan lokasi kematiannya dicatat.

6. Apa yang diyakini dan tidak diyakini oleh model ini

Se-nyata komponen ini bisa digali

ESP8266 tidak punya manual referensi teknis semacam milik ESP32 (milik Espressif singkat dan melewatkan seluruh blok), jadi "terverifikasi" di sini berarti angkanya adalah angka yang telah dipakai selama satu dekade oleh setiap header ESP8266, linker script, dan deskripsi register terbuka, dan merupakan apa yang diberikan daftar register resmi. Dengan standar itu:

UART0_BASE 0x6000_0000, GPIO_BASE 0x6000_0300, IOMUX_BASE 0x6000_0800 and RTC_BASE 0x6000_0700. Every register offset inside the GPIO block and inside UART0, and UART0's CONF0 FIFO resets, CONF1 thresholds, CLKDIV width and STATUS counts, each checked against appendix 3 of the ESP8266 Technical Reference v1.7 (section 3.4). The iram1_0_seg at 0x4010_0000 with 32 KB and the dram0_0_seg at 0x3FFE_8000 with 80 KB. The seventeen GPIOs, that 6 to 11 are the flash, and that 16 is the RTC's pin and is in no GPIO register. The D0 to D8 silkscreen table. The module's LED on GPIO 2 and the carrier board's on GPIO 16, both active low. The 220k/100k divider on A0. That there is no PWM hardware, no input-enable bit and no pull-down on GPIO 0 to 15. The Xtensa vector offsets and EXCCAUSE numbers, which are the ISA's.

Diyakini, tidak diverifikasi

  • Tabel urutan pad IO_MUX (bagian 3.3).
  • Lima register RTC di balik GPIO16 (bagian 3.2).
  • Nomor interrupt CPU: GPIO 4, UART0 5 (bagian 4). Itu adalah ETS_GPIO_INUM dan ETS_UART_INUM, bukan angka yang dikutip langsung.
  • The level-1 interrupt mask, taken to be every interrupt the part brings out (section 4).

Semuanya berada di satu tempat yang dibaca firmware, firmware/esp8266/include/esp8266.h, jadi image yang akan dibawa ke silikon sungguhan punya daftar pendek #define untuk diperiksa. crates/esp8266/tests/contract.rs menguji header itu dan crates/esp8266/src/map.rs terhadap angka yang sama; itu tidak membuat keduanya benar.

Diciptakan, dan dinyatakan sebagai ciptaan

  • Tiga register SAR di 0x6000_0D00 (bagian 3.5). SAR_CFG, SAR_STATUS dan bit-bitnya adalah milik model ini, karena milik chip tidak dipublikasikan. analogRead adalah satu-satunya pemanggilan di board ini yang perlu diubah untuk NodeMCU sungguhan.

Dimodelkan, tapi tidak dengan angka milik komponennya

  • Satu konversi memakan tepat 80 us. Angka sebenarnya bergantung pada loop sampling SDK dan mendekati seratus.
  • ADC berupa garis lurus pada 0 sampai 1,0 V di pin chip, dan pembaginya tepat 100/320.
  • Clock selalu 80 MHz. Tidak ada 160 MHz, dan tidak ada yang bisa dipakai untuk berpindah.
  • RST dan EN hanyalah pull-up 10 k; kapasitor power-on reset tidak dimodelkan.
  • Tidak ada boot ROM. POWER_ON di sini 1 us; ESP8266 sungguhan menghabiskan waktu jauh lebih lama di ROM loader-nya dan mencetak pesan boot 74880-baud yang tidak pernah dicetak board ini.
  • micros64() bisa kehilangan satu wrap jika interrupt ditahan lebih lama dari 53,7 detik dan tidak ada yang menanyakan waktu dalam jendela itu (bagian 3.6).
  • PWM software bergoyang sebesar satu handler, karena ia software (bagian 3.7). Komponen sungguhan juga melakukan hal yang sama.
  • Setiap pad menyala dengan kondisi yang sama: GPIO biasa, tanpa pull.

Sengaja tidak disertakan

  • WiFi, dalam segala bentuk. Tidak ada radio, tidak ada PHY, tidak ada MAC, tidak ada stack, tidak ada ESP8266WiFi.h, bahkan tidak ada stub yang gagal dengan sopan. Pada komponen yang seluruh alasan keberadaannya adalah WiFi, ini adalah hal terbesar yang hilang, dan halaman board menyebutnya lebih dulu, bukan terakhir.
  • Flash and the cache that maps it. Code and constants are read from a fixed, read-only window (section 2): no cache to miss, no SPI flash device, no 32-bit-only access rule for it, and no SPIFFS, LittleFS or OTA.
  • FRC1 dan FRC2, dua timer hardware itu (bagian 3.6). Watchdog ada di bagian 3.10.
  • Deep sleep dan RTC, counter dan memorinya, dan wake dari GPIO16 ke RST.
  • SPI, HSPI, I2S dan UART1 hardware (bagian 3.8).
  • eFuses dan chip ID.
  • Setiap level interrupt di atas satu, dan NMI.

Itulah sebabnya biner vendor SDK dan Arduino-core tidak berjalan di sini, sedangkan firmware yang dibangun untuk dokumen ini berjalan.

Image ESP32 juga tidak akan berjalan di sini. String program pada katalog adalah elf32 xtensa lx106 esp8266 berbanding elf32 xtensa lx6 esp32 milik DevKit, dan itu perbedaan nyata: LX106 tidak punya register window, jadi entry pertama pada image ber-window adalah instruksi ilegal, bukan jawaban yang salah secara halus.

7. Runtime firmware (firmware/esp8266/)

Runtime berbentuk Arduino: setup() dan loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead, analogWrite beserta kontrol rentang dan frekuensinya, millis, micros, micros64, delay, delayMicroseconds, attachInterrupt, Serial, map, random. Tanpa Arduino core, tanpa SDK Espressif, tanpa libc.

Konstruktor statis keluar dari .ctors di sini, bukan dari .init_array. GCC 8.4 milik Espressif dikonfigurasi tanpa --enable-initfini-array dan tidak punya -fuse-init-array, jadi konstruktor objek global berada di .ctors sedangkan setiap toolchain lain di repositori ini menghasilkan .init_array. link.ld mengumpulkan keduanya ke dalam satu rentang yang crt0.S menjelajahi. Tanpa itu, sketch dengan objek global (WebServer server(80) di dalam wifilamp) akan tersambung, dijalankan, dan menemukan anggotanya nol. Keduanya dilalui dalam satu pass dan .ctors tidak dibalik, karena urutan constructor yang berjalan antar translation unit tidak ditentukan dalam C++ dan sebuah sketch tidak boleh bergantung padanya.

LED_BUILTIN adalah 2: LED modul, aktif rendah. FLASH_BUTTON adalah 0. D0 sampai D8, RX dan TX didefinisikan sesuai tabel di bagian 1, dan A0 adalah 17, sebuah pin semu: ia bukan GPIO, dan analogRead pada yang lain mengembalikan 0, bukan angka yang mustahil dihasilkan board ini.

analogWrite menerima 0 sampai 1023, bukan 0 sampai 255. Itulah yang dilakukan Arduino ESP8266 core dengan PWMRANGE , dan menyalinnya adalah pilihan antara membuatmu terkejut di browser atau terkejut di meja kerja. analogWriteRange(255) membuat sketch Uno berperilaku semestinya, dan analogWriteResolution(8) adalah hal yang sama yang dikatakan dengan cara ESP32. Ini adalah PWM software (bagian 3.7): delapan pin sekaligus, 1 kHz secara bawaan, 40 Hz sampai 60 kHz.

analogRead sepuluh bit dan analogReadResolution menggeser nilai yang dikembalikannya alih-alih mengubah konverter, seperti yang dilakukan Arduino ESP32 core.

millis() and micros() come from CCOUNT extended to sixty-four bits by the tick handler (section 3.6). micros() wraps every 71.6 minutes and millis() every 49.7 days, like Arduino; micros64() does not wrap. delay() parks the core on CCOMPARE0 rather than spinning. One comparator has two customers (the next delay deadline and the next PWM edge), so the scheduler works out which comes first, arms that, and the handler services whatever was due and schedules again.

attachInterrupt dua penulisan, bukan tiga, karena tidak ada interrupt matrix (bagian 4). GPIO16 tidak bisa memunculkannya.

Contoh yang dikirim dibangun oleh GCC milik Espressif, dan sketch milik pengguna oleh clang-v3 di browser, dengan alasan yang diberikan bagian 7 docs/esp32.md. deploy/fetch-xtensa.sh menempatkan xtensa-lx106-elf-gcc 8.4.0 di tools/xtensa/, yang di-gitignore: GCC berlisensi GPL dan tidak ada yang dibangun di sini yang di-link dengan libgcc, jadi tidak ada kode GPL yang sampai ke ELF yang dikirim.

Tiga file dari runtime ini adalah milik ESP32, dikompilasi ulang untuk board ini alih-alih disalin: format angka, helper matematika dan floor freestanding, plus Print dan main. Milik board ini sendiri adalah crt0.S, header register, linker script, serta driver GPIO, ADC, PWM, time, UART dan interrupt. support32.c ada di sini karena LX106 tidak punya pembagian hardware: helper pembagian dan modulo 32-bit yang dipanggil compiler adalah milik kita, supaya tidak ada yang di-link dengan libgcc.

Linked against firmware/esp8266/link.ld: the vectors and startup code in the 32 KB of IRAM, code and constants in the flash window, .data, .bss and the stack in the 80 KB of DRAM. A NodeMCU has 4 MB of flash and an example should be a small part of it, so the build refuses an image over its budget; the real ceiling the linker script enforces is the 1,044,464 bytes of the IDE's default sketch partition. The upload build (firmware/esp8266/link-hw.ld) is loaded into RAM by the ROM and keeps the 32 KB.

Lima contoh, masing-masing dengan sketch yang ditampilkan UI-nya: blink (LED modul di D4 dan satu lagi yang disambungkan di D1, selalu berkebalikan karena salah satunya active low), button (saklar ke ground di D2 dengan pull-up bawaan pad), serial (satu tick per detik, dan sebuah echo), fade (LED di D1 pada PWM software, 0 sampai 1023) dan knob (potensiometer di A0, sepuluh bit, langsung ke duty PWM karena kedua rentangnya angka yang sama).

crates/esp8266/tests/runtime.rs menjalankan lima ELF itu dan mengukur: setengah periode blink, 1 kHz PWM software dalam batas jitter satu handler, millis() terhadap jam kernel, dan pacing byte UART0 pada 115200 baud. Setiap test dilewati ketika image-nya belum dibangun.