Những bo mạch nào
Một số bo mạch có MicroPython (main.py) trong bảng Firmware. Trang này nói về các bo ESP32 cổ điển: DOIT DevKit V1, DevKitC và LOLIN32 Lite. Các bo khác chạy bản build chính thức của chip tương ứng theo cùng cách:
- ESP32-S3: ESP32-S3-DevKitC-1, XIAO ESP32-S3 và Arduino Nano ESP32.
- ESP32-C3: ESP32-C3-DevKitM-1, XIAO ESP32-C3 và ESP32-C3 SuperMini.
- ESP32-C6: ESP32-C6-DevKitC-1 và XIAO ESP32-C6.
- RP2040: Raspberry Pi Pico và Pico W.
Cheap Yellow Display, T-Display và D1 R32 cũng dùng ESP32 cổ điển, nhưng chỉ chạy sketch Arduino.
Thứ chạy là MicroPython v1.29.0 cho ESP32, bản build chính thức một nhân, nguyên văn từng byte như micropython.org phát hành, trên mô hình toàn bộ con chip của Mokxi, khởi động từ chính mask ROM của Espressif. Không có gì trong trang này diễn dịch code Python của bạn.
Chọn nó trong bảng Firmware
- Đặt một bo ESP32 DevKit V1, DevKitC hoặc LOLIN32 Lite lên khung vẽ.
- Mở bảng Firmware của nó và chọn MicroPython (main.py).
- Các tệp của bo mạch trở thành một
main.py. Viết chương trình của bạn ở đó rồi bấm Chạy.
Bo mạch có tệp main.py và không có .ino sẽ chạy MicroPython. Sketch Arduino trên cùng bo mạch vẫn chạy như trước, và không tải gì của MicroPython cho nó.
Lần Chạy đầu tiên của một dự án MicroPython trên ESP32 sẽ tải về firmware và ROM của chip, 1.4 MB, và trình duyệt giữ lại cho mọi lần Chạy sau. Sketch Arduino không bao giờ tải chúng.
Chạy làm gì với main.py
Chạy sẽ khởi động firmware, và máy tính ở đầu dây USB mô phỏng của bo mạch chép các tệp .py của bạn lên bo như Thonny và mpremote vẫn làm: vào raw REPL qua cổng serial của bo, ghi từng tệp vào flash của bo, rồi soft-reboot. Bo in ra MPY: soft reboot, chạy boot.py rồi đến main.py.
Mọi thẻ .py, .txt, .json và .csv đều được chép, nên một driver như ssd1306.py của micropython-lib đặt trong thẻ riêng cạnh main.py sẽ được import ssd1306 tìm thấy.
Nút EN và machine.reset() giữ nguyên các tệp, nên main.py chạy lại, như trên bàn thực tế. Chạy lại từ đầu thì khởi đầu với chip đã bị xóa.
Serial Monitor và REPL
Từ khi có MPY: soft reboot, Serial Monitor chính là UART0 của bo mạch, cả hai chiều. Mọi thứ print() nói đều hiện ở đó. Khi main.py kết thúc, hoặc khi bạn dừng nó bằng Ctrl-C, REPL trả lời ở đó: gõ một biểu thức rồi bấm Enter.
Khi chương trình dừng vì lỗi, MicroPython in ra một traceback. Mokxi đọc traceback đó, đánh dấu dòng tương ứng trong file của bạn và giải thích lỗi thường có ý nghĩa gì, giống như trên Pico.
Những gì hoạt động
machine.Pin với ngắt, PWM (bộ LEDC), ADC trên tám kênh của ADC1 với bốn mức suy giảm, I2C và SoftI2C, SPI và SoftSPI, UART(1) và UART(2) trên các chân được nối vào chúng, neopixel, dht, onewire và ds18x20, cùng machine.freq() ở 80, 160 hoặc 240 MHz.
Không được mô phỏng: chế độ ngủ nhẹ và sâu, ADC2, PSRAM, chế độ slave của I2C và SPI, điều khiển luồng UART, nhận bằng RMT, và watchdog reset lại bo mạch. Bản build là bản đơn nhân.
WiFi
network.WLAN kết nối vào điểm truy cập được mô phỏng của Mokxi, cũng là điểm mà WiFi.begin trong một sketch Arduino kết nối vào. Tên và mật khẩu của nó là các thuộc tính WiFi của bo mạch, ban đầu là Mokxi-Lab và breadboard; bạn có thể đổi trong thuộc tính bo mạch, rồi dùng đúng hai giá trị đó trong wlan.connect(). Bo mạch nhận địa chỉ 192.168.4.2 qua DHCP.
import network, time, urequests
wlan = network.WLAN(network.STA_IF)
wlan.active(True)
wlan.connect("Mokxi-Lab", "breadboard")
while not wlan.isconnected():
time.sleep_ms(250)
r = urequests.get("http://weather.mokxi/")
print(r.json())
r.close()
socket và urequests truy cập các trang giả lập của mạng mô phỏng: time.mokxi, weather.mokxi, echo.mokxi và api.mokxi. Các tên khác sẽ không tìm thấy, và https:// thì không có nơi nào để kết nối. Bảng Cloud hiển thị những gì bo mạch yêu cầu.
network.WLAN(network.AP_IF) khởi động điểm truy cập riêng của bo mạch: bảng Web tham gia như một điện thoại, ap.status('stations') liệt kê nó, và một socket server trên cổng 80 mở tại http://192.168.4.1/. Để chạy song song với chế độ station, hãy chuyển nó đi bằng ap.ifconfig(), vì mạng mô phỏng cũng là 192.168.4.0/24.
Không được mô phỏng trên mạng: một station thứ hai trên điểm truy cập, ESP-NOW, chế độ tiết kiệm pin, TLS, và mọi mạng khác ngoài mạng mô phỏng.
WiFi, mô phỏng nói về bản thân mạng.
Nhập từ Wokwi
Một dự án Wokwi cho ESP32 DevKit V1, DevKitC hoặc LOLIN32 Lite có
main.py được nhập vào như một dự án MicroPython, với bo mạch đặt ở chế độ MicroPython. Mạng của bo mạch được đặt tên Wokwi-GUEST không có mật khẩu, như trên Wokwi, nên
wlan.connect("Wokwi-GUEST", "") chạy đúng như đã viết. Xem
Chuyển từ Wokwi sang.
Trên ESP32 thật
Một bo mạch MicroPython không cần build. Hãy nạp MicroPython vào ESP32 bằng esptool (esptool.py --chip esp32 erase_flash, rồi esptool.py --chip esp32 write_flash -z 0x1000 ESP32_GENERIC-UNICORE-20260824-v1.29.0.bin, tải từ micropython.org/download/ESP32_GENERIC), sau đó sao chép main.py vào bằng Thonny hoặc mpremote. Đặt tên và mật khẩu mạng của bạn vào wlan.connect(): các trang .mokxi chỉ tồn tại trong Mokxi.
Bài khởi động
Sáu bài khởi động trên DevKit V1, mỗi bài một trang riêng: blink, nút nhấn với Pin.irq(), mờ dần bằng PWM, một DHT22, một màn hình OLED SSD1306 và WiFi và thời tiết. Trình mô phỏng ESP32 MicroPython đi qua cả sáu bài.
Ở nơi khác
- Các bo mạch: ESP32 DevKit V1, DevKitC và LOLIN32 Lite
- MicroPython trên Pico: Pico
- Các trang bo mạch: /boards/esp32-devkit và /boards/esp32-devkitc
- Hợp đồng Arduino của chip: mô hình ESP32 DevKit