Tổng quan, kèm các ví dụ đang chạy, nằm ở trang bo mạch và Mô hình ESP8266 NodeMCU (mọi thanh ghi).
Đây là gì
NodeMCU V1.0 "Amica", một module ESP-12E trên bo mạch ba mươi chân, chạy bằng core Xtensa của chính chúng tôi ở cấu hình LX106. Firmware là một ELF Xtensa giao tiếp với các địa chỉ ESP8266 thật, với một ngoại lệ, được nêu dưới đây, mà mô hình tuyên bố rõ ràng.
Bo mạch có kích thước 48.3 nhân 25.6 mm và hai hàng mười lăm chân cách nhau 0.9 inch, nên nó bắt qua rãnh giữa của breadboard và còn lại một hàng lỗ trống ở mỗi bên. Bo mạch mà người ta thường chụp ảnh nối liền hai breadboard là bản V3 "LoLin" rộng hơn, có hai hàng cách nhau đúng một inch. Linh kiện này là bản V1.0.
D0 to D8 are not GPIO numbers
Đây là điều khiến ai cũng bị vấp trên bo mạch này, nên nó được đặt lên đầu:
| 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) là D4, không phải D2. Runtime của Mokxi định nghĩa D0 thành
D8, nên bạn có thể viết digitalWrite(D2, HIGH) và chỉ đúng chân mà bạn đang nhìn thấy.
Các chân
Mười lăm chân mỗi cạnh dài, ổ cắm micro-USB ở cạnh dưới.
Cột trái, từ trên xuống dưới: A0, RSV, RSV, SD3, SD2, SD1, CMD, SD0, CLK, GND, 3V3, EN, RST, GND, VIN.
Cột phải, từ trên xuống dưới: D0, D1, D2, D3, D4, 3V3, GND, D5, D6, D7, D8, RX, TX, GND, 3V3.
Đây là bo mạch 3.3 volt và các chân của nó không chịu được 5 V. VIN là nguồn 5 V từ USB.
SD0 đến SD3, CMD và CLK là sáu dây của chip flash. Trên NodeMCU thật chúng có trên header và trên linh kiện này cũng vậy, nhưng ở đây chúng không nối với gì cả: không kéo cũng không đọc. Kéo một chân đó trên bo mạch thật sẽ làm dừng flash mà chương trình của bạn đang chạy, nên một trình mô phỏng cho phép bạn dùng chúng sẽ dạy bạn làm hỏng bo mạch. Hai chân RSV cũng như vậy.
Hai LED, và cả hai đều ngược chiều
D4 (GPIO 2) có LED xanh của module ESP-12 và D0 (GPIO 16) có LED trên bo mạch gắn. Cả hai đều active low: digitalWrite(LED_BUILTIN, LOW) làm sáng LED trên module. LED_BUILTIN là 2.
Ví dụ blink ghi LED trên bo và một LED nối dây trên D1 theo hai chiều ngược nhau một cách cố ý, nên hai LED luôn ngược pha nhau, đúng như những gì bạn thấy trên bàn.
Nút FLASH là GPIO 0, tức D3, active low. Nhấn nó trên bo mạch sẽ nối chân xuống đất.
D0 không phải chân thông thường
GPIO 16 (D0) là chân của RTC, không phải của khối GPIO. Ba điều sau đây phát sinh:
- Nó có điện trở kéo xuống, trong khi mọi pad khác trên linh kiện này đều kéo lên.
- Nó không thể tạo ngắt.
attachInterrupt(D0, ...)không làm gì cả. - Trên bo mạch thật, đó là chân bạn nối đến
RSTđể đánh thức khỏi deep sleep, điều không được mô phỏng ở đây vì deep sleep cũng không.
analogRead: một chân, mười bit, và một mạch chia điện áp
A0 là chân analog duy nhất mà ESP8266 có. Nó không phải GPIO và không thể ghi.
Chân trên chip quy đổi từ 0 đến 1.0 V. NodeMCU đặt một mạch chia 220k/100k trước nó, nên A0 trên header nhận từ 0 đến khoảng 3.2 V và một biến trở nối qua nguồn 3.3 V gần như phủ kín cả dải. Mạch chia là một phần của bo mạch, và Mokxi mô phỏng nó: chân sẽ tải đường nối của bạn với 320 k, đúng như bo mạch thật.
Mười bit, từ 0 đến 1023, cũng chính là dải PWM của bo mạch này, nên ví dụ knob đưa thẳng giá trị đọc vào duty.
Đây là thứ duy nhất trên bo mạch này không nằm ở một địa chỉ thật. Espressif chưa bao giờ công bố các thanh ghi ADC của ESP8266 (SDK gọi system_adc_read() từ một blob nhị phân), nên thay vì bịa ra một địa chỉ và để bạn tưởng đó là của chip, Mokxi đặt ba thanh ghi của riêng mình ở đó và nói rõ điều đó. Trên thực tế điều đó có nghĩa là: nếu bạn đem bản dựng từ đây sang một NodeMCU thật, analogRead là lời gọi duy nhất bạn phải sửa. Không có gì khác.
analogWrite là phần mềm, dải là 1023, và nó tốn chút tài nguyên của core
ESP8266 hoàn toàn không có phần cứng PWM. Không phải LEDC thu nhỏ: là không có gì cả. Core Arduino ESP8266 tạo sóng từ một trình xử lý timer và runtime này cũng vậy: tám chân cùng lúc, 1 kHz mặc định, analogWriteFreq(40..60000).
Hai điều sau đây phát sinh, và cả hai đều có thật:
analogWritenhận giá trị từ 0 đến 1023, không phải 0 đến 255.analogWrite(pin, 255)là độ sáng một phần tư, không phải sáng đầy. Đó là cách core thật hoạt động, và việc sao chép như vậy là lựa chọn giữa làm bạn ngạc nhiên ở đây và làm bạn ngạc nhiên trên bàn làm việc.analogWriteRange(255)giúp một sketch Uno chạy đúng.- Core thức dậy hai lần mỗi chu kỳ để đổi mức chân. Trên ESP32 một LED fade là miễn phí; ở đây thì không. Cả hai bo mạch đều có ở đây, và sự khác biệt giữa chúng là một trong những điều hữu ích nhất mà cặp bo này dạy.
Serial
Serial là UART0 trên TX và RX, là cổng mà cầu USB nằm trên, và nó được nối vào serial monitor. Các byte đi ra ở tốc độ baud bạn đặt.
Serial1 không được mô phỏng. Trên ESP8266 thật, chân TX của UART1 là GPIO 2, cũng chính là LED của module, vì vậy bạn không thể có cả hai.
Để có cổng thứ hai, SoftwareSerial.h chạy được trên bất kỳ hai chân nào trừ D0 (GPIO 16 không có ngắt), với các lệnh gọi của EspSoftwareSerial, thư viện mà core ESP8266 kèm theo: SoftwareSerial gps(D5, D6); gps.begin(9600);. Mỗi sườn tín hiệu trên chân nhận được tính thời gian bằng ngắt dựa trên bộ đếm chu kỳ, nên nhiều cổng nhận cùng lúc và listen() không làm dừng các cổng khác. Chỉ hỗ trợ 8N1.
What is modeled
Xtensa LX106 với ABI call0: mười sáu thanh ghi và không có cửa sổ thanh ghi, đó là những gì trình biên dịch của nó phát ra và là lý do một ảnh ESP32 bị lỗi trên core này thay vì chạy sai âm thầm. Xung quanh nó: khối GPIO và IO_MUX, các thanh ghi RTC là GPIO 16, UART0, bộ chuyển đổi TOUT, và CCOUNT cùng CCOMPARE0 đứng sau millis(), micros(), delay() và PWM phần mềm.
Đó là tập thanh ghi mà pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, attachInterrupt và Serial cần, ở đúng địa chỉ thật của chúng, với ADC là ngoại lệ như đã nêu.
WiFi, simulated
Không có radio. Và sẽ không bao giờ có: một MAC 802.11 không phải thứ mà mô hình này có thể tái hiện một cách trung thực.
Thay vào đó là một mạng được mô phỏng. Một khối do chính Mokxi tạo chứ không phải của chip (một hộp thư tại 0x6FFF_E000, nơi ESP8266 thật không ánh xạ gì cả) hỗ trợ WiFi.h, HTTPClient.h và WebServer.h, nên code Arduino mà một bài hướng dẫn đưa cho bạn vẫn chạy ở đây: bo mạch tham gia một điểm truy cập có tên và mật khẩu là thuộc tính của bo mạch, WiFi.status() đi qua các trạng thái giống hệt trong cùng khoảng một đến ba giây, DHCP cấp cho nó địa chỉ 192.168.4.2, và một sketch có thể tải một trang web hoặc phục vụ một trang.
Đằng sau nó là phần mềm, và không có gì che giấu điều đó. Không có 802.11, không có kênh, không quét mạng, không WPA2, không TCP, không TLS và không có internet thật: chỉ bốn cái tên bịa đặt dưới .mokxi là phân giải được và không có gì khác, và chẳng có gì mà sketch làm có thể chạm tới mạng mà trình duyệt của bạn đang dùng. WiFiClientSecure biên dịch được nhưng sẽ thất bại, báo rằng TLS không được mô phỏng. Các bảng Web và Cloud dọc theo đáy trình soạn thảo mở ra với câu đó và không cuộn nó đi.
Ngoại lệ duy nhất là Internet thật, một công tắc trong bảng Cloud dành cho ai đã đăng nhập (nhiều hơn với Pro), tắt mỗi lần trang được tải. Khi bật nó, một yêu cầu cho tên ngoài .mokxi,
https:// bao gồm cả, sẽ đi ra qua cổng của Mokxi và câu trả lời quay về sketch. Xem Internet thật.
Đây là phần có sóng vô tuyến mà chẳng có tài liệu nào cả: WiFi của ESP8266 là một blob nhị phân trong SDK và Espressif chưa bao giờ công bố thanh ghi của nó. Mô hình này không đoán bừa. Thay vào đó nó cung cấp một hộp thư đúng nghĩa là của Mokxi, ở một địa chỉ đúng nghĩa là không thuộc về linh kiện.
Có ba ví dụ cho bo mạch này: WiFi: join the network, WiFi: fetch the weather và WiFi: a lamp on a web page.
WiFi, simulated hướng dẫn cách dùng; Simulated WiFi là bản hợp đồng, giới hạn từng điều khoản một.
Những gì không có
Mọi loại sóng vô tuyến. Không có 802.11, không có PHY, không có kênh, không có WPA2, và không có thanh ghi nào của đài phát trên linh kiện, vì Espressif chưa bao giờ công bố. Trên một linh kiện mà lý do tồn tại của nó chính là WiFi, đó là thứ thiếu sót lớn nhất ở đây, và nó được nói đầu tiên chứ không phải cuối cùng, đó là lý do phần phía trên nó là mạng mô phỏng chứ không phải phần này.
Cũng vắng mặt: flash và vùng đệm ánh xạ nó, nên không có PROGMEM đọc từ flash, không có SPIFFS, không có LittleFS và không có OTA. FRC1 và FRC2, hai bộ định thời phần cứng. Đồng hồ ở đây là bộ đếm chu kỳ của chính core, là một thanh ghi mà không mô hình nào phải đoán. Ngủ sâu và RTC, bộ đếm và bộ nhớ của nó. SPI, I2S và UART1 phần cứng. Chip này vốn không có ngoại vi I2C; core Arduino bit-bang nó, và phần đó cũng không có ở đây. Các eFuse. Watchdog thì được mô phỏng: một sketch không nhường CPU trong 3 đến 5 giây sẽ nhận "Soft WDT reset" của core, và một sketch đã tắt nó bằng ESP.wdtDisable() reset của watchdog phần cứng vào khoảng 8,4 giây.
Các file nhị phân SDK của hãng và core Arduino sẽ không chạy ở đây: runtime là của chúng tôi.
Biên dịch sketch của bạn
Sửa sketch rồi bấm Chạy: nó biên dịch ngay trong tab, như mọi bo mạch khác ở đây. Với chip này trình biên dịch là clang của chính Espressif, có back end Xtensa, nên lần build đầu tiên tải về một bộ công cụ riêng (clang-v3, khoảng 80 MB, một lần) và các lần build sau dùng lại. Không có gì được nạp lên. Một ví dụ chưa đụng đến vẫn chạy chương trình dựng sẵn; đổi một dòng rồi bấm Chạy sẽ build chương trình của bạn.
Phép tính dấu phẩy động hoạt động: LX106 không có FPU, nên các phép cộng float và double được thực hiện bằng phần mềm, như trên ESP8266 thật. Biên dịch trong trình duyệt có bản tường thuật đầy đủ.
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 mô hình ESP8266 NodeMCU. Mục 6 là phần cần đọc trước khi đưa một bản build từ đây lên chip thật.
Các thư viện Arduino chuẩn mà các bo mạch khác biên dịch (Servo.h, Wire.h, EEPROM.h, Adafruit_SSD1306.h và phần còn lại) cũng nằm trên đường dẫn include ở đây, nhưng chưa được kiểm tra trên bo mạch này.
Các ví dụ
Blink, Button, Serial, Fade, Knob và ba ví dụ WiFi: WiFi: kết nối vào mạng, WiFi: lấy dữ liệu thời tiết và WiFi: đèn điều khiển qua trang web. Mỗi chương trình chạy bản dựng sẵn cho đến khi bạn thay đổi nó, sau đó Chạy sẽ biên dịch phiên bản của bạn.
Ở nơi khác
- Trang bo mạch: /boards/nodemcu
- Tài liệu đặc tả: mô hình ESP8266 NodeMCU
- Bo mạch Xtensa còn lại: ESP32 DevKit
- Chip thay thế nó: ESP32-C3
- Cùng chip trên các bo mạch nhỏ hơn: Wemos D1 mini và ESP-01S