Bo mạch

ESP32 DevKit V1

ESP32 kinh điển: Xtensa LX6 240 MHz trên bo mạch DOIT ba mươi chân, với bộ điều khiển PWM LEDC, ADC mười hai bit và sáu chân chỉ dùng để vào liệu.

Tổng quan, kèm các ví dụ đang chạy, nằm ở trang bo mạch và Mô hình ESP32 DevKit (đầy đủ từng thanh ghi).

Đây là gì

DOIT ESP32 DevKit V1, một module ESP32-WROOM-32 trên bo mạch ba mươi chân, chạy trên lõi Xtensa của riêng chúng tôi, bo mạch đầu tiên ở đây có tập lệnh không phải RISC-V, AVR hay Arm. Firmware là một ELF Xtensa giao tiếp với các địa chỉ ESP32 thật.

Bo mạch có kích thước 51.5 x 28.3 mm, 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, chừa trống một hàng lỗ ở mỗi bên.

This is the thirty-pin DOIT board, not the 38-pin Espressif DevKitC. The DevKitC is a full inch between rows, leaves no row free at all, and brings out more pins. If your board has 38 pins, use ESP32-DevKitC V4, là một bo mạch riêng trong hộp linh kiện.

Các chân

Mười lăm chân dọc theo mỗi cạnh dài, ổ cắm micro-USB ở dưới, module và ăng-ten PCB của nó ở trên.

Cột bên trái, từ trên xuống dưới: EN, VP, VN, D34, D35, D32, D33, D25, D26, D27, D14, D12, GND, D13, VIN.

Cột phải, từ trên xuống dưới: D23, D22, TX0, RX0, D21, D19, D18, D5, TX2, RX2, D4, D0, D2, D15, 3V3.

Dn là GPIO n. VP là GPIO 36 và VN là GPIO 39, được đặt tên trên silkscreen theo chức năng thay vì theo số. EN là chân cho phép chip, và đây chính là chân reset của bo mạch này. VIN là nguồn 5 V từ USB.

Đây là bo mạch 3.3 volt và các chân của nó không chịu được 5 V.

Ba điều sơ đồ chân tác động đến bạn

Đây là phần cứng, không phải mô hình, và mỗi cái đều khiến ai đó vấp phải:

  • GPIO 34 đến 39 không thể làm đầu ra. Không bao giờ. Sáu chân đó chỉ có bộ đệm đầu vào và không có gì khác: không có mạch khuếch đại đầu ra, không có điện trở kéo lên hay kéo xuống bên trong. pinMode(34, OUTPUT) vẫn ghi vào thanh ghi, nhưng bit không được giữ, và chân vẫn ở trạng thái trở kháng cao. Bốn trong số chúng có trên đầu nối này: D34, D35, VP và VN. Mokxi từ chối lần ghi đó giống như chip thật, đếm nó lại, và đặt một vết màu hổ phách nhỏ trên bo mạch thay vì để bạn tưởng một chân nào đó đang xuất tín hiệu. Nếu bạn cần kéo lên một trong các chân này, phải dùng điện trở ngoài.
  • GPIO 6 đến 11 không hề có trên đầu nối, vì chúng là SPI flash mà chương trình đang chạy từ đó. Trên các bo mạch có đưa các chân này ra, xuất tín hiệu lên một chân sẽ làm chip ngừng hoạt động.
  • GPIO 0, 2, 5, 12 và 15 là các chân strapping. Chúng quyết định cách chip khởi động, nên những gì được nối vào chúng lúc cấp điện là quan trọng. GPIO 2 cũng là LED xanh dương, nên trạng thái của nó trước khi pinMode chạy khác nhau giữa các bo mạch.

LED và nút nhấn

LED_BUILTIN là GPIO 2, một LED xanh dương bình thường được nối theo chiều thông thường: HIGH làm nó sáng. BOOT là GPIO 0, hoạt động ở mức thấp, và cũng có trên đầu nối dưới tên D0 nên bạn có thể nối dây vào đó; nhấp nó trên bo mạch sẽ nối chân xuống GND.

analogRead: tám kênh, và 4095 không phải là giá trị mà nguồn 3.3 V cho ra

Tám kênh của ADC1 không phải là GPIO 0 đến 7. Theo thứ tự, chúng là GPIO 36, 37, 38, 39, 32, 33, 34 và 35, và chân 37, 38 không được đưa ra trên WROOM-32, nên thực tế bạn dùng được là VP, VN, D32, D33, D34 và D35.

Mười hai bit, và với suy giảm mặc định 11 dB, số đọc đi theo đường cong của ESP32 thật thay vì một đường thẳng: 0 trong khoảng 80 mV đầu tiên, gần tuyến tính ở giữa, và đạt 4095 từ khoảng 3.1 V. Vì vậy một biến trở đặt qua chính nguồn 3.3 V của bo mạch này đạt 4095 hơi trước khi vặn hết, và đọc được khoảng 1890 chứ không phải 2048 ở giữa. Đó là linh kiện thật, và ví dụ knob in ra số thô để bạn không thắc mắc. analogReadMilliVolts() khử đường cong và đọc ra theo volt.

ADC2 không được mô phỏng. Trên ESP32 thật, ADC2 dùng chung với radio WiFi và ngừng hoạt động khi WiFi bật, đó là lý do không ai dùng nó; ở đây nó vắng mặt hẳn, nên tám kênh nêu trên là tất cả.

Độ chuyển đổi theo đường thẳng ở đây là xấp xỉ của bộ chuyển đổi thật, vốn cong ở cả hai đầu và được hiệu chỉnh bằng đường cong hiệu chuẩn ghi sẵn trong chip. Mô hình có khả năng sẽ dễ dãi hơn silicon một chút gần 0 V và gần đầu trên của dải đo.

analogWrite là LEDC, và nó không hề tốn tài nguyên của lõi

analogWrite(pin, 0..255) gắn một trong tám kênh tốc độ cao của LEDC vào chân ở lần gọi đầu tiên: tám bit ở 1 kHz, trên bất kỳ chân nào có mạch xuất tín hiệu, vì kênh đi đến pad qua ma trận GPIO chứ không qua một chân cố định. Khi tần số là điều quan trọng, có sẵn ledcAttach(pin, frequency, bits) và ledcWrite(pin, duty), và các kênh dùng cùng tần số và độ phân giải sẽ chia sẻ một trong bốn timer.

Vì LEDC là phần cứng thật, một LED mờ dần ở đây không hề tốn tài nguyên của lõi: sketch có thể ngồi trong delay() mà các cạnh xung vẫn đến đúng lúc. ESP8266 NodeMCU là đối chứng thú vị: nó không có phần cứng PWM, nên lõi của nó phải tự làm việc đó. Cả hai bo mạch đều trung thực về điều này.

Serial

Serial là UART0, cổng mà cầu USB của DevKit nối tới, và nó được nối vào serial monitor. Byte rời đi ở tốc độ baud bạn đặt, nên một sketch in nhanh hơn mức 115200 baud có thể truyền được sẽ phải chờ ở đây y như trên bàn thật.

Serial1 và Serial2 là UART1 và UART2, các cổng thật trên bất kỳ chân nào bạn chỉ định, gửi và nhận từng khung bit bằng bit trên dây, nên một module GPS, một HC-05, một PZEM-004T, một bộ thu phát RS-485 hay một bo mạch thứ hai trên các chân đó sẽ nghe thấy chúng:

Serial2.begin(9600, SERIAL_8N1, 16, 17); // RX, TX: the pins marked RX2 and TX2

Những gì chúng làm cũng chính là những gì lõi arduino-esp32 3.x làm:

  • Khi không chỉ định chân, Serial1.begin(9600) dùng GPIO 26 (RX) và 27 (TX), còn Serial2.begin(9600) dùng GPIO 4 và 25. Core 2.x dùng 16 và 17 cho Serial2, vì vậy các hướng dẫn cũ bỏ qua phần chỉ định chân; Mokxi nhắc điều này một lần trong Serial Monitor khi một sketch làm vậy. setPins(rx, tx) đổi chân, trước hoặc sau begin().
  • Khung có thể là bất kỳ dạng nào từ SERIAL_5N1 đến SERIAL_8O2, và tham số invert của begin() đảo ngược cả hai đường.
  • Các byte nhận được đến với sketch theo từng khối, giống như driver của ESP-IDF: UART chuyển FIFO của nó vào một bộ đệm vòng 256 byte (setRxBufferSize() gọi trước begin()) một khi đã nhận đủ 120 byte (setRxFIFOFull()) hoặc khi đường truyền im lặng trong thời gian của một ký tự (setRxTimeout()). available() đếm số byte trong bộ đệm vòng, nên một byte còn nằm trong FIFO thì chưa được tính là có sẵn. Một sketch đọc quá chậm sẽ mất byte giống như trên bàn thật.
  • onReceive() được gọi sau mỗi khối, giữa loop()và trong khi sketch chờ trong delay(), thay vì từ một tác vụ FreeRTOS.
  • write() chờ khi FIFO 128 byte đã đầy, và flush() cho đến khi bit stop cuối cùng được gửi xong. setTxBufferSize() được dùng, nhưng không có bộ đệm vòng TX, nên write() vẫn phải chờ ở FIFO.

Điều khiển luồng phần cứng, chế độ RS-485, IrDA và autobaud không được mô phỏng. Chân TX cần một driver đầu ra, nên GPIO 34 đến 39 chỉ làm được RX. SoftwareSerial.h vẫn hoạt động trên bất kỳ cặp chân nào.

Một nhân, không phải hai

Một ESP32 thật có hai nhân Xtensa LX6, còn một sketch Arduino ở đây chỉ chạy trên một nhân: không có APP CPU, không có ngắt xuyên nhân và không có FreeRTOS để lên lịch giữa hai nhân. Một sketch viết theo kiểu setup() và loop() sẽ không hề nhận ra điều này. Bất cứ thứ gì khởi chạy tác vụ trên nhân 1 đều sẽ không chạy.

Một firmware bạn tự biên dịch thì khác: MicroPython và bản biên dịch ESP-IDF chạy trên một mô hình của cả con chip, nơi cả hai nhân đều chạy (xem dưới đây).

What is modeled

Xtensa LX6 ở chế độ ABI có cửa sổ (ABI duy nhất mà trình biên dịch của nó phát ra), cùng với cửa sổ thanh ghi, các bộ xử lý tràn và tràn ngược cửa sổ, và các ngắt mức 1. Bao quanh nó: ma trận GPIO và IO_MUX, UART0, timer 0 của nhóm timer 0 đứng sau millis() và micros(), ADC1 one-shot qua khối SENS, nhóm tốc độ cao của LEDC, và phần ma trận ngắt của DPORT vừa đủ cho hai nguồn.

Đó là bộ hàm mà pinMode, digitalWrite, digitalRead, analogRead, analogWrite, ledcAttach, ledcWrite, millis, micros, delay, attachInterrupt và Serial cần, tại địa chỉ thật của chúng.

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 mô phỏng. Một khối do chính Mokxi tạo ra chứ không phải của chip (một hộp thư tại 0x3FEF_E000, nơi mà ESP32 thật không ánh xạ gì cả) sẽ lo 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 được ở đây: bo mạch kết nối vào 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 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 về 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.

Địa chỉ này nằm trong khoảng trống mà bus dữ liệu của chip để lại giữa các cửa sổ bộ nhớ ngoài và cửa sổ ngoại vi, nên một ảnh nhị phân dùng nó sẽ lỗi trên chip thật thay vì đọc nhầm thanh ghi của ngoại vi khác. Bluetooth được mô phỏng qua cùng khối đó, cả Classic lẫn LE, với một chiếc điện thoại trong khung Bluetooth của trình soạn thảo và không có radio (Bluetooth, được mô phỏng).

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ó

Bất kỳ loại radio nào. Không có radio 802.11 hay Bluetooth nào trong mô hình và cũng không giả vờ là có; WiFi và Bluetooth nói trên đều được mô phỏng và nói rõ như vậy. Nhân thứ hai. FPU: mọi lệnh dấu phẩy động đều gây lỗi ở đây thay vì trả về số sai, và runtime là soft float, nên float hoạt động còn các nhị phân hard-float của nhà cung cấp thì không. Bộ nhớ đệm, flash và PSRAM: code chạy từ RAM nội bộ. RTC, bộ đồng xử lý ULP và deep sleep. ADC2, cảm biến chạm và cảm biến hall. Các bộ điều khiển I2C và SPI, I2S và RMT. Wire và SPI trong runtime là phần mềm trên các chân thường, như trên mọi bo mạch ở đây: Wire.begin() đặt SDA trên 21 và SCL trên 22, còn SPI dùng 18 (SCK), 19 (MISO), 23 (MOSI) và 5 (SS). Adafruit_NeoPixel.h điều khiển dải WS2812 bằng cách tính thời gian từng bit trên bộ đếm chu kỳ của nhân, vì RMT mà ESP32 thật sẽ dùng không có ở đây. Các nhóm timer ngoài timer đầu tiên của nhóm timer 0 và watchdog của nó (vốn chạy task watchdog, như ESP-IDF).

Các nhị phân ESP-IDF và Arduino-core của nhà cung cấp 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 nhấn Chạy: nó biên dịch trong tab, như mọi bo mạch khác ở đây, bằng một clang thật được biên dịch sang WebAssembly. Với chip này đó là clang của chính Espressif, có back end Xtensa, nên lần biên dịch đầu trên ESP32 sẽ 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 biên dịch sau dùng lại nó. Không có gì bị tải 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 nhấn Chạy sẽ biên dịch bản của bạn.

Phép toán dấu phẩy động hoạt động: mô hình này không có FPU, nên bản build thực hiện phép cộng float và double bằng phần mềm, như trên các bo mạch hoàn toàn không có FPU. Compiling in the browser giải thích đầy đủ.

The full list of what the model implements, and a plain account of which register addresses came out of the technical reference manual and which are this model's belief, is in mô hình ESP32 DevKit. 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 tiêu chuẩn mà những bo mạch khác biên dịch được (Servo.h, Wire.h, EEPROM.h, Adafruit_SSD1306.h và các thư viện khác) cũng nằm trên đường dẫn include ở đây. Wire.h, Adafruit_NeoPixel.h và Keypad.h đã được kiểm tra trên bo mạch này, với một lần quét I2C ở chân 21 và 22, một dải LED sáng và một bàn phím 4x4; các thư viện khác chưa được kiểm tra ở đây.

MicroPython

Bo mạch có thể chạy Python thay cho sketch. Chọn MicroPython (main.py) trong bảng Firmware của nó và Chạy sẽ khởi động firmware MicroPython v1.29.0 chính thức cho ESP32 và chạy main.py. Cái đó chạy trên mô hình của cả con chip, khởi động từ mask ROM của Espressif, nên các giới hạn trên là của runtime Arduino, chứ không phải của MicroPython: machine.I2C, machine.SPI, RMT đứng sau neopixel và network.WLAN đều có cho nó. Xem MicroPython trên ESP32.

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.

Một firmware do chính bạn xây dựng

Một sketch Arduino được biên dịch ở đây và chạy trên một nhân. Một chương trình biên dịch ở nơi khác, bằng ESP-IDF hoặc Rust (esp-hal, esp-idf-hal), cũng chạy được, trên một mô hình của cả con chip với cả hai nhân: nạp .bin hoặc .elf của nó vào bảng Firmware, và bo mạch khởi động nó giống như sau khi idf.py flash. Wi-Fi và Bluetooth là khoảng trống, vì driver của chúng là thư viện đóng của Espressif: một firmware khởi động một trong hai sẽ dừng lại kèm một dòng thông báo. Các bước và danh sách đầy đủ nằm trong Chạy một firmware có sẵn.

Ở nơi khác