Tinjauannya, dengan contoh yang berjalan, ada di halaman board dan Model ESP8266 NodeMCU (setiap register).
Apa ini
NodeMCU V1.0 "Amica", modul ESP-12E pada dudukan tiga puluh pin, berjalan pada core Xtensa milik kami dalam konfigurasi LX106-nya. Firmware-nya adalah ELF Xtensa yang berbicara ke alamat ESP8266 yang sebenarnya, dengan satu pengecualian, disebutkan di bawah, yang modelnya katakan secara terbuka.
Board-nya berukuran 48,3 kali 25,6 mm dan dua baris lima belas pin-nya berjarak 0,9 inci, jadi ia menumpangi saluran tengah breadboard dengan satu baris lubang tersisa di setiap sisi. Board yang sering difoto menjembatani dua breadboard adalah V3 "LoLin" yang lebih lebar, yang barisnya berjarak satu inci penuh. Komponen ini adalah V1.0.
D0 to D8 are not GPIO numbers
Ini adalah hal yang membuat semua orang terkejut di board ini, jadi ini dulu:
| 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 Mokxi mendefinisikan D0 ke
D8, jadi kamu bisa menulis digitalWrite(D2, HIGH) dan maksudnya pin yang sedang kamu lihat.
Pin-pin-nya
Lima belas di setiap sisi panjang, soket micro-USB di bagian bawah.
Kolom kiri, atas ke bawah: A0, RSV, RSV, SD3, SD2, SD1, CMD, SD0, CLK, GND, 3V3, EN, RST, GND, VIN.
Kolom kanan, atas ke bawah: D0, D1, D2, D3, D4, 3V3, GND, D5, D6, D7, D8, RX, TX, GND, 3V3.
Ini adalah board 3.3 volt dan pin-pinnya tidak tahan 5 V. VIN adalah rel 5 V dari USB.
SD0 sampai SD3, CMD dan CLK adalah enam kabel chip flash. Itu ada di header NodeMCU asli dan ada di komponen ini, dan di sini tidak tersambung ke apa pun: tidak menggerakkan maupun membaca. Menggerakkan salah satunya di board asli menghentikan flash tempat programmu berjalan, jadi simulator yang membiarkanmu memakainya justru mengajarkanmu merusak board. Dua pin RSV sama saja.
Dua LED, dan keduanya terbalik
D4 (GPIO 2) memiliki LED biru modul ESP-12 dan D0 (GPIO 16) milik board dudukannya. Keduanya active low: digitalWrite(LED_BUILTIN, LOW) menyalakan LED modul. LED_BUILTIN adalah 2.
Contoh blink menulis LED on-board dan LED yang disambungkan di D1 dengan arah berlawanan dengan sengaja, jadi keduanya selalu terbalik satu sama lain, seperti yang kamu lihat di meja kerja.
Tombol FLASH adalah GPIO 0, yaitu D3, active low. Mengekliknya di board men-ground pin itu.
D0 bukan pin biasa
GPIO 16 (D0) adalah pin milik RTC, bukan milik blok GPIO. Tiga hal mengikuti dari sini:
- Ia memiliki pull-down, sedangkan setiap pad lain di komponen ini memiliki pull-up.
- Ia tidak bisa memunculkan interrupt.
attachInterrupt(D0, ...)tidak melakukan apa-apa. - Di board asli, ini pin yang kamu sambungkan ke
RSTuntuk wake dari deep sleep, yang tidak dimodelkan di sini karena deep sleep juga tidak.
analogRead: satu pin, sepuluh bit, dan pembagi tegangan
A0 adalah satu-satunya pin analog yang dimiliki ESP8266. Ia bukan GPIO dan tidak bisa ditulis.
Pin milik chip-nya mengonversi 0 sampai 1.0 V. NodeMCU memasang pembagi 220k/100k di depannya, jadi A0 di header adalah 0 sampai sekitar 3.2 V dan potensiometer melintasi rel 3.3 V hampir mencakup seluruh rentangnya. Pembagi itu bagian dari board, dan Mokxi memodelkannya: pin membebani net-mu dengan 320 k, seperti yang dilakukan board asli.
Sepuluh bit, 0 sampai 1023, yang juga rentang PWM board ini, jadi contoh knob memasukkan hasil pembacaan langsung ke duty.
Ini satu-satunya hal di board ini yang tidak berada di alamat asli. Espressif tidak pernah mempublikasikan register ADC ESP8266 (SDK memanggil system_adc_read() dari binary blob), jadi alih-alih mengarang alamat dan membiarkanmu menganggapnya milik chip, Mokxi menaruh tiga register miliknya sendiri di sana dan mengatakannya. Artinya dalam praktik: jika kamu membawa build dari sini ke NodeMCU asli, analogRead adalah satu-satunya pemanggilan yang harus kamu ubah. Tidak ada yang lain.
analogWrite adalah software, rentangnya 1023, dan itu membebani core
ESP8266 tidak punya hardware PWM sama sekali. Bukan LEDC versi ringkas: tidak ada. Core Arduino ESP8266 menghasilkan gelombangnya dari handler timer dan runtime ini juga: delapan pin sekaligus, 1 kHz secara default, analogWriteFreq(40..60000).
Dua hal mengikuti, dan keduanya nyata:
analogWritemenerima 0 sampai 1023, bukan 0 sampai 255.analogWrite(pin, 255)adalah seperempat kecerahan, bukan penuh. Itulah yang dilakukan core aslinya, dan menyalinnya adalah pilihan antara mengejutkanmu di sini atau mengejutkanmu di meja kerja.analogWriteRange(255)membuat sketch Uno berperilaku wajar.- Core terbangun dua kali per periode untuk menggerakkan pin. Di ESP32 LED memudar itu gratis; di sini tidak. Kedua board ada di sini, dan perbedaan di antara keduanya adalah salah satu hal paling berguna yang diajarkan pasangan ini.
Serial
Serial adalah UART0 di TX dan RX, yaitu port tempat bridge USB berada, dan tersambung ke serial monitor. Byte keluar pada baud rate yang kamu atur.
Serial1 tidak dimodelkan. Di ESP8266 asli, pin TX UART1 adalah GPIO 2, yang juga merupakan LED modul, itulah sebabnya kamu tidak bisa punya keduanya.
Untuk port kedua, SoftwareSerial.h bekerja di dua pin mana pun kecuali D0 (GPIO 16 tidak punya interrupt), dengan pemanggilan EspSoftwareSerial, library yang dibawa core ESP8266: SoftwareSerial gps(D5, D6); gps.begin(9600);. Setiap edge pada pin penerima dihitung waktunya lewat interrupt terhadap cycle counter, jadi beberapa port menerima sekaligus dan listen() tidak menghentikan yang lain. Hanya 8N1.
What is modeled
Xtensa LX106 dengan ABI call0: enam belas register dan tanpa register window, itulah yang dikeluarkan compilernya dan alasan image ESP32 mengalami fault di core ini alih-alih salah tingkah diam-diam. Di sekitarnya: blok GPIO dan IO_MUX, register RTC yang menjadi GPIO 16, UART0, konverter TOUT, serta CCOUNT dan CCOMPARE0 di balik millis(), micros(), delay() dan PWM software.
Itulah set yang dibutuhkan pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, attachInterrupt dan Serial, di alamat aslinya, dengan ADC sebagai pengecualian yang disebutkan.
WiFi, simulated
Tidak ada radio. Dan tidak akan pernah ada: MAC 802.11 bukan sesuatu yang bisa model ini tiru dengan jujur.
Yang ada sebagai gantinya adalah jaringan simulasi. Blok yang merupakan milik Mokxi sendiri, bukan milik chip (mailbox di 0x6FFF_E000, tempat ESP8266 asli tidak memetakan apa pun) membawa WiFi.h, HTTPClient.h dan WebServer.h, jadi kode Arduino dari tutorial bisa berjalan di sini: board bergabung ke access point yang nama dan kata sandinya adalah properti board, WiFi.status() melewati state yang sama dalam satu sampai tiga detik yang sama, DHCP memberinya lease 192.168.4.2, dan sketch bisa mengambil sebuah halaman atau menyajikannya.
Yang ada di baliknya adalah perangkat lunak, dan tidak ada yang disembunyikan soal itu. Tidak ada 802.11, tidak ada channel, tidak ada scan, tidak ada WPA2, tidak ada TCP, tidak ada TLS dan tidak ada internet sungguhan: hanya empat nama buatan di bawah .mokxi yang bisa di-resolve dan tidak ada lainnya, dan tidak ada yang dilakukan sebuah sketch bisa menjangkau jaringan tempat browsermu berada. WiFiClientSecure dikompilasi lalu gagal, mengatakan TLS tidak disimulasi. Panel Web dan Cloud di sepanjang bagian bawah editor terbuka dengan kalimat itu dan tidak menggulirnya menjauh.
Satu-satunya pengecualian adalah Internet sungguhan, sebuah saklar di panel Cloud untuk siapa pun yang masuk (lebih banyak dengan Pro) yang mati setiap kali halaman dimuat. Dengan itu menyala, permintaan untuk nama di luar .mokxi,
https:// termasuk, keluar melalui gateway Mokxi dan jawabannya kembali ke sketch. Lihat Internet sungguhan.
Ini komponen dengan radio dan tanpa dokumentasi sama sekali: WiFi ESP8266 adalah blob biner dalam SDK dan Espressif tidak pernah mempublikasikan registernya. Model ini tidak menebak-nebaknya. Yang ditawarkannya sebagai gantinya adalah mailbox yang jujur milik Mokxi, di alamat yang jujur bukan milik komponen itu.
Tiga contoh disertakan untuk board ini: WiFi: join the network, WiFi: fetch the weather dan WiFi: a lamp on a web page.
WiFi, simulated adalah cara memakainya; Simulated WiFi adalah kontraknya, batas demi batas.
Yang tidak
Radio jenis apa pun. Tidak ada 802.11, tidak ada PHY, tidak ada channel, tidak ada WPA2, dan tidak ada register radio milik komponen itu sendiri, karena Espressif tidak pernah mempublikasikannya. Pada komponen yang alasan utama keberadaannya adalah WiFi, itu hal terbesar yang hilang di sini, dan itu dikatakan lebih dulu bukan terakhir, itulah sebabnya bagian di atasnya adalah jaringan simulasi dan bukan yang ini.
Juga tidak ada: flash dan cache yang memetakannya, jadi tidak ada PROGMEM pembacaan dari flash, tidak ada SPIFFS, tidak ada LittleFS dan tidak ada OTA. FRC1 dan FRC2, dua timer hardware. Jam di sini adalah cycle counter milik core itu sendiri, yaitu register yang tidak perlu ditebak model mana pun. Deep sleep dan RTC, counter dan memorinya. SPI, I2S dan UART1 hardware. Tidak ada peripheral I2C di chip ini sejak awal; core Arduino melakukan bit-bang, dan itu juga tidak ada di sini. eFuses. Watchdog dimodelkan: sketch yang tidak yield selama 3 sampai 5 detik mendapat "Soft WDT reset" dari core, dan yang mematikannya dengan ESP.wdtDisable() reset watchdog hardware pada sekitar 8,4 detik.
Binari SDK vendor dan core Arduino tidak akan berjalan di sini: runtime-nya milik kami.
Mengompilasi sketch-mu
Edit sketch dan tekan Jalankan: sketch dikompilasi di tab, seperti board lainnya di sini. Untuk chip ini compilernya adalah clang milik Espressif sendiri, yang punya back end Xtensa, jadi build pertama mengunduh toolchain terpisah (clang-v3, sekitar 80 MB, sekali saja) dan build berikutnya memakainya lagi. Tidak ada yang di-upload. Contoh yang belum disentuh tetap menjalankan program prebuilt-nya; ubah satu baris dan Jalankan akan mengompilasi versimu.
Aritmetika floating point bekerja: LX106 tidak punya FPU, jadi penjumlahan float dan double dilakukan di software, seperti di ESP8266 asli. Mengompilasi di browser memuat penjelasan lengkapnya.
The full list of what the model implements, and a plain account of which addresses are as real as this part allows, which are believed and which three are invented, is in model ESP8266 NodeMCU. Bagian 6 adalah yang perlu dibaca sebelum membawa build dari sini ke silikon sungguhan.
Library Arduino bawaan yang dikompilasi board lain (Servo.h, Wire.h, EEPROM.h, Adafruit_SSD1306.h dan lainnya) juga ada di include path di sini, tapi belum diperiksa di board ini.
Contoh-contoh
Blink, Button, Serial, Fade, Knob, dan tiga sketch WiFi: WiFi: gabung ke jaringan, WiFi: ambil cuaca dan WiFi: lampu di halaman web. Masing-masing menjalankan program bawaannya sampai kamu mengubahnya, lalu Jalankan akan mem-build versimu.
Di tempat lain
- Halaman board: /boards/nodemcu
- Dokumen kontrak: model ESP8266 NodeMCU
- Board Xtensa lainnya: ESP32 DevKit
- Chip yang menggantikannya: ESP32-C3
- Chip yang sama di board lebih kecil: Wemos D1 mini dan ESP-01S