Kartlar

ESP8266 NodeMCU

Simüle edilmiş WiFi'li bir ESP8266 kartı, 80 MHz'de çalışan bir Xtensa LX106, GPIO numaralarından farklı D0 ile D8 pinleri ve yazılımsal PWM.

Örneklerin çalıştığı genel bakış şurada: kart sayfası ve ESP8266 NodeMCU modeli (her yazmaç).

Nedir

NodeMCU V1.0 "Amica", otuz pinli bir taşıyıcı üzerinde ESP-12E modülü, kendi Xtensa çekirdeğimiz üzerinde LX106 yapılandırmasıyla çalışıyor. Firmware, gerçek ESP8266 adresleriyle konuşan bir Xtensa ELF'idir; aşağıda adı geçen, modelin açıkça belirttiği tek bir istisna dışında.

Kart 48,3 x 25,6 mm ve iki sıra on beş pini 0,9 inç arayla yerleşmiştir; yani bir breadboard'un orta kanalını, her iki tarafta birer sıra delik boş kalacak şekilde kaplar. İnsanların iki breadboard'u köprülemişken fotoğrafladığı kart, sıraları tam bir inç arayla olan daha geniş V3 "LoLin"'dir. Bu parça V1.0'dır.

D0 to D8 are not GPIO numbers

Bu kartın herkesi şaşırtıp yakaladığı şey budur, bu yüzden ilk sırada:

İpek baskı 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) şudur D4, bir Uno'daki gibi değil. D2. Mokxi'nin çalışma zamanı şunu tanımlar: D0 hedefine D8, böylece şunu yazabilirsin digitalWrite(D2, HIGH) ve baktığın pini kastedebilirsin.

Pinler

Her uzun kenarda on beş pin, altta micro-USB soketi.

Sol sütun, yukarıdan aşağıya: A0, RSV, RSV, SD3, SD2, SD1, CMD, SD0, CLK, GND, 3V3, EN, RST, GND, VIN.

Sağ sütun, yukarıdan aşağıya: D0, D1, D2, D3, D4, 3V3, GND, D5, D6, D7, D8, RX, TX, GND, 3V3.

Bu 3.3 volt'luk bir karttır ve pinleri 5 V'a dayanıklı değildir. VIN, USB'den gelen 5 V hattıdır.

SD0 ile SD3 arası, CMD ve CLK, flash çipinin altı kablosudur. Gerçek bir NodeMCU'nun pin başlığında bulunurlar ve bu parçada da bulunurlar, ama burada hiçbir şeye bağlı değillerdir: ne sürerler ne okurlar. Gerçek bir kartta birini sürmek, programının çalıştığı flash'ı durdurur; yani bunları kullanmana izin veren bir simülatör sana bir kartı kırmayı öğretiyor olurdu. İki RSV pininin durumu aynıdır.

İki LED ve ikisi de ters yönlü

D4 (GPIO 2), ESP-12 modülünün mavi LED'ine ve D0 (GPIO 16), taşıyıcı kartın LED'ine bağlıdır. İkisi de aktif düşüktür: digitalWrite(LED_BUILTIN, LOW) modülünkini yakar. LED_BUILTIN 2'dir.

blink örneği, kart üstü LED'i ve D1'e kablolanmış bir LED'i bilerek ters yönlerde yazdırır; böylece ikisi her zaman birbirinin zıttıdır, tıpkı bir masa üstünde gördüğün gibi.

FLASH butonu GPIO 0'dır, yani D3, aktif düşük. Kart üzerinde tıklamak pini toprağa çeker.

D0 sıradan bir pin değildir

GPIO 16 (D0), GPIO bloğunun değil RTC'nin pinidir. Bundan üç şey çıkar:

  • Pull-down'a sahiptir; bu parçadaki diğer tüm pedlerde pull-up vardır.
  • Kesme yükseltemez. attachInterrupt(D0, ...) hiçbir şey yapmaz.
  • Gerçek bir kartta, derin uykudan uyanma için RST'ye kabloladığın pindir; derin uyku modellenmediği için bu da modellenmemiştir.

analogRead: bir pin, on bit ve bir bölücü

A0, ESP8266'nın sahip olduğu tek analog pindir. Bir GPIO değildir ve yazılamaz.

Çipin kendi pini 0 ile 1.0 V arasını dönüştürür. Bir NodeMCU önüne 220k/100k bölücü koyar; yani başlıktaki A0 0 ile yaklaşık 3.2 V arasıdır ve 3.3 Volt hattına bağlanan bir potansiyometre aralığı neredeyse tamamen kaplar. Bölücü kartın bir parçasıdır ve Mokxi onu modeller: pin, ağını 320 k ile yükler, tıpkı gerçeği gibi.

On bit, 0 ile 1023 arası; bu aynı zamanda kartın PWM aralığıdır, yani knob örneği okunan değeri doğrudan görev döngüsüne verir.

Bu, bu karttaki gerçek bir adreste olmayan tek şeydir. Espressif hiçbir zaman ESP8266'nın ADC kayıt defterlerini yayınlamadı (SDK, system_adc_read() çağrısını ikili bir blob'dan çıkarır); bu yüzden Mokxi bir adres uydurup çipin sanmana izin vermek yerine oraya kendi üç kayıt defterini koyar ve bunu açıkça söyler. Pratikte bunun anlamı: buradan aldığın bir derlemeyi gerçek bir NodeMCU'ya götürürsen, değiştirmen gereken tek çağrı analogRead olur. Başka hiçbir şey.

analogWrite yazılımdır, aralık 1023'tür ve çekirdeğe biraz mal olur

ESP8266'nın hiç PWM donanımı yoktur. Küçültülmüş bir LEDC bile değil: hiç. Arduino ESP8266 çekirdeği dalga formlarını bir zamanlayıcı işleyicisinden üretir ve bu çalışma zamanı da öyle yapar: aynı anda sekiz pin, varsayılan olarak 1 kHz, analogWriteFreq(40..60000).

Bundan iki şey çıkar ve ikisi de gerçektir:

  • analogWrite 0 ile 1023 arasında değer alır, 0 ile 255 arasında değil. analogWrite(pin, 255) tam parlaklığın çeyreğidir, tamamı değil. Gerçek çekirdek böyle yapıyor ve bunu kopyalamak, seni burada mı yoksa tezgahın başında mı şaşırtmak arasında bir seçimdi. analogWriteRange(255) bir Uno kodunu olması gerektiği gibi davrandırır.
  • Çekirdek, pini hareket ettirmek için periyot başına iki kez uyanır. Bir ESP32'de solan bir LED bedava gelir; burada gelmez. İki kart da burada ve aralarındaki fark, bu çiftin öğrettiği en yararlı şeylerden biri.

Seri

Serial, TX ve RX üzerindeki UART0'dır; bu, USB köprüsünün bağlı olduğu porttur ve seri monitöre kabloludur. Baytlar ayarladığın baud hızında çıkar.

Serial1 modellenmedi. Gerçek bir ESP8266'da UART1'in TX pini GPIO 2'dir ve bu pin aynı zamanda modülün LED'idir, bu yüzden ikisine aynı anda sahip olamazsın.

İkinci bir port için SoftwareSerial.h D0 hariç herhangi iki pinde çalışır (GPIO 16'da kesme yok); çağrılar, ESP8266 çekirdeğinin yanında getirdiği EspSoftwareSerial kütüphanesinkilerdir: SoftwareSerial gps(D5, D6); gps.begin(9600);. Alım pinindeki her kenar, bir kesmede döngü sayacına karşı zamanlanır; böylece aynı anda birkaç port alım yapar ve listen() diğerlerini durdurmaz. Yalnızca 8N1.

What is modeled

call0 ABI'sindeki Xtensa LX106: on altı yazmaç ve yazmaç penceresi yok; derleyicisinin ürettiği bu ve bir ESP32 imajının bu çekirdekte sessizce yanlış davranmak yerine hata vermesinin sebebi. Etrafında: GPIO bloğu ve IO_MUX, GPIO 16 olan RTC yazmaçları, UART0, TOUT dönüştürücüsü ve millis(), micros(), delay() ile yazılım PWM'inin arkasındaki CCOUNT ve CCOMPARE0.

Var olan şey, pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, attachInterrupt ve Serial için gereken set, gerçek adreslerinde, belirtilen tek istisna ADC olacak şekilde.

WiFi, simulated

Radyo yok. Hiç olmayacak da: 802.11 MAC'i bu modelin dürüstçe yeniden üretebileceği bir şey değil.

Onun yerine burada bir simüle edilmiş ağ var. Çipin değil Mokxi'nin kendi olan bir blok (0x6FFF_E000 adresinde bir posta kutusu; gerçek bir ESP8266'da oraya hiçbir şey eşlenmemiştir) WiFi.h, HTTPClient.h ve WebServer.h'ü taşıyor; böylece bir öğreticide verilen Arduino kodu burada çalışır: kart, adı ve parolası kartın özellikleri olan bir erişim noktasına katılır, WiFi.status() aynı durumları aynı bir ila üç saniyede dolaşır, DHCP ona 192.168.4.2 kiralır ve bir kod bir sayfayı çekebilir ya da sunabilir.

Arkasındaki şey yazılımdır ve bu hiç gizlenmez. 802.11 yok, kanal yok, tarama yok, WPA2 yok, TCP yok, TLS yok ve gerçek internet yok: .mokxi altındaki dört uydurma ad çözümlenir, başka hiçbiri çözümlenmez ve bir kodun yaptığı hiçbir şey tarayıcının bulunduğu ağa ulaşamaz. WiFiClientSecure derlenir ama sonra başarısız olur, TLS simüle edilmiyor der. Düzenleyicinin altındaki Web ve Bulut panelleri o cümleyle açılır ve kaydırınca da o cümle kaybolmaz.

Tek istisna Gerçek internet, Bulut panelinde giriş yapmış herkes için bir anahtar (Pro ile daha fazlası), sayfa her yüklendiğinde kapalıdır. Açık olduğunda, dışındaki bir ad için istek .mokxi, https:// dahil, Mokxi'nin ağ geçidinden çıkar ve yanıt koda geri döner. Bkz. Gerçek internet.

Bu, bir radyosu olan ama ona dair hiçbir belgesi olmayan parçadır: ESP8266'nın WiFi'i SDK'da ikili bir blob'dur ve Espressif yazmaçlarını hiç yayımlamamıştır. Bu model onları tahmin etmez. Onun yerine sunduğu, dürüstçe Mokxi'ye ait bir posta kutusu ve dürüstçe parçaya ait olmayan bir adrestir.

Bu kart için üç örnek hazır geliyor: WiFi: ağa katıl, WiFi: hava durumunu çek ve WiFi: web sayfasında bir lamba.

WiFi, simüle edilmiş nasıl kullanılacağıdır; Simüle edilmiş WiFi ise sözleşmenin kendisidir, sınır sınır.

Neler dahil değil

Herhangi bir türde radyo. 802.11 yok, PHY yok, kanal yok, WPA2 yok ve parçanın kendi radyosunun yazmacı yok, çünkü Espressif hiçbir tane yayımlamadı. Var olma nedeninin tamamı WiFi olan bir parçada bu, burada eksik olan en büyük şeydir ve en son değil ilk söylenir; bu yüzden onun üstündeki bölüm simüle edilmiş ağdır, bu değil.

Ayrıca şunlar da yok: flash ve onu eşleyen önbellek, yani PROGMEM flash'tan okuma yok, SPIFFS yok, LittleFS yok ve OTA yok. FRC1 ve FRC2, iki donanım zamanlayıcısı. Buradaki saat, çekirdeğin kendi döngü sayacıdır; hiçbir modelin tahmin etmek zorunda kalmadığı bir yazmaç. Derin uyku ve RTC, onun sayacı ve belleği. SPI, I2S ve donanım UART1. Bu çipte zaten I2C çevre birimi yoktur; Arduino çekirdeği onu yazılımla idare eder ve o da burada yok. eFuse'lar. Watchdog'lar modellenmiştir: 3 ila 5 saniye boyunca yield vermeyen bir kod çekirdeğin "Soft WDT reset" hatasını alır ve bunu kapatan bir kod ESP.wdtDisable() yaklaşık 8.4 saniyede donanım watchdog'unun resetini alır.

Satıcı SDK'sı ve Arduino çekirdeği ikilileri burada çalışmaz: çalışma zamanı bizim.

Kodun derleniyor

Kodu düzenle ve Çalıştır'a bas: buradaki her kartta olduğu gibi sekmede derlenir. Bu çip için derleyici, Xtensa arka ucuna sahip olan Espressif'in kendi clang'i; bu yüzden ilk derleme ayrı bir araç zinciri indirir (clang-v3, yaklaşık 80 MB, yalnızca bir kez) ve sonraki derlemeler onu yeniden kullanır. Hiçbir şey yüklenmez. Dokunulmamış bir örnek önceden derlenmiş programını yine çalıştırır; bir satırı değiştirip Çalıştır'a basınca seninki derlenir.

Kayan nokta aritmetiği çalışır: LX106'da FPU yoktur, bu yüzden float ve double toplamları, gerçek bir ESP8266'da olduğu gibi yazılımla yapılır. Tam açıklama Tarayıcıda derleme bölümündedir.

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 ESP8266 NodeMCU modeli. Bölüm 6, buradaki bir derlemeyi gerçek silikona taşımadan önce okuman gereken bölümdür.

Diğer kartlarda derlenen hazır Arduino kütüphaneleri (Servo.h, Wire.h, EEPROM.h, Adafruit_SSD1306.h ve diğerleri) burada da include yolunda, ancak bu kartta henüz test edilmediler.

Örnekler

Blink, Button, Serial, Fade, Knob ve üç WiFi örneği: WiFi: ağa katıl, WiFi: hava durumunu çek ve WiFi: web sayfasında lamba. Her biri, sen değiştirene kadar hazır programını çalıştırır; sonra Çalıştır senin sürümünü derler.

Başka yerlerde