Mokxi tự biên dịch sketch Arduino khi bạn nhấn Chạy. Chương trình viết cho Raspberry Pi Pico SDK (C hoặc C++ với pico/stdlib.h) hoặc cho ESP-IDF (app_main), hoặc viết bằng Rust với esp-hal hay esp-idf-hal, sẽ không được biên dịch ở đây: bạn tự biên dịch trên máy của mình rồi đưa cho Mokxi file mà bản build tạo ra. Bo mạch sau đó sẽ khởi động nó đúng như bo mạch thật sau khi file được ghi vào.
Nạp firmware
- Đặt một bo mạch Raspberry Pi Pico (Pico W hoặc Arduino Nano RP2040 Connect cũng được), hoặc bo mạch ESP32 hay ESP32-S3 lên khung vẽ rồi nhấp vào nó.
- Trong thuộc tính của nó, mở chương trình và chọn Nạp firmware (nó liệt kê các loại tệp mà bo mạch nhận, chẳng hạn
.uf2, .elf). - Chọn tệp mà bản biên dịch của bạn tạo ra, rồi nhấn Chạy.
Mỗi bo mạch nhận những tệp nào:
| Bo mạch | Tệp | Cách nó khởi động |
|---|---|---|
| Pico, Pico W, Nano RP2040 Connect | .uf2, .elf |
qua boot ROM và giai đoạn hai của chính tệp ảnh, như khi bạn chép tệp vào ổ đĩa của bo mạch |
| ESP32 DevKit V1, DevKitC, LOLIN32 Lite | .bin, .elf |
như sau khi chạy idf.py flash: ứng dụng nằm ở 0x10000, hoặc một tệp ảnh gộp ở vị trí mà bản biên dịch đặt nó |
| ESP32-S3 DevKitC-1, XIAO ESP32-S3, Nano ESP32 | .bin, .elf |
tương tự |
Other boards offer Upload ELF… in the same place instead: an .elf built
for that board elsewhere, for example by arduino-cli. The AVR boards (Uno,
Nano, Mega 2560, Leonardo, Pro Mini, ATtiny85) also take a raw .bin flash
image. A .hex from the Arduino IDE's Export Compiled Binary opens
through Nhập: thả tệp vào trang nhập và dự án sẽ mở ra với bo mạch đang chạy chương trình đó.
Trên Pico, Serial Monitor hiển thị cả hai cổng serial của Pico SDK: UART0 trên GP0 và GP1 với tốc độ 115200 baud (pico_enable_stdio_uart) và cổng serial USB (pico_enable_stdio_usb). Trên ESP32 hoặc ESP32-S3, đó là UART0, cổng mà chip ghi log vào. Bất kể thế nào, những gì bạn gõ đều được gửi tới bo mạch.
Một tệp .elf được giữ lại như tệp ảnh mà bo mạch khởi động, nhưng bỏ phần thông tin gỡ lỗi, nên một tệp .elf lớn thường vẫn vừa. Tệp giữ lại tối đa 2 MB. Tệp biên dịch cho chip khác sẽ bị từ chối kèm câu cho biết tệp đó được biên dịch cho chip nào.
Biên dịch trên máy tính của bạn
Cài Pico SDK theo hướng dẫn Getting started with the Raspberry Pi Pico của Raspberry Pi, hoặc dùng tiện ích mở rộng Raspberry Pi Pico cho VS Code, tiện ích này sẽ cài SDK và trình biên dịch giúp bạn. Sau đó, trong thư mục dự án của bạn:
mkdir build
cd build
cmake .. -DPICO_BOARD=pico
make
Bản build để lại <your program>.uf2 và <your program>.elf trong build/. Nạp tệp nào cũng được. Sau khi sửa code, hãy build lại và nạp tệp mới: Mokxi chạy tệp bạn đã đưa cho nó, chứ không chạy code trong trình soạn thảo.
Với ESP32 hoặc ESP32-S3, hãy cài ESP-IDF theo hướng dẫn Get Started của Espressif, rồi trong thư mục dự án của bạn:
idf.py set-target esp32
idf.py build
Kết quả để lại build/<your project>.bin và build/<your project>.elf. Nạp tệp nào cũng được. Ảnh hợp nhất (esptool merge-bin) cũng dùng được, và bản build Rust cũng vậy: cargo build --release với esp-hal (bare metal) hoặc esp-idf-hal, rồi tệp ELF trong target/, hoặc tệp .bin do espflash save-image tạo ra.
Từ Wokwi
Dự án Wokwi for VS Code ghi tên bản build trong wokwi.toml (firmware = 'build/blink.uf2' với Pico, firmware = 'build/flasher_args.json' với ESP-IDF). Nhập dự án kèm tệp đó khi nạp (nén zip cả thư mục, gồm cả build/, là dễ nhất) và bo mạch sẽ chạy nó: báo cáo nhập sẽ cho biết nó đã lấy tệp nào. Nếu thiếu tệp, báo cáo sẽ nói cần thêm tệp nào.
Những gì chạy được, và những gì chưa
Trên Pico, boot ROM, flash, các clock, timer, UART, GPIO, PWM, ADC, I2C, SPI, DMA, PIO, USB và watchdog đều được mô phỏng, nên phần lớn các ví dụ của Pico SDK chạy được nguyên trạng, kể cả LED WS2812 qua ws2812.pio. Trên Pico W, CYW43439 được mô hình hóa theo cách các bản chính thức của MicroPython và CircuitPython điều khiển nó qua cyw43-driver, driver pico_cyw43_arch liên kết được, và bo mạch tham gia vào mạng mô phỏng của Mokxi; Bluetooth, các client của chế độ access point, tiết kiệm pin và TLS thì không được mô phỏng. Những gì không chạy được:
- Nhân thứ hai.
multicore_launch_core1sẽ dừng bo mạch. - Xung nhịp hệ thống luôn là 125 MHz, bất kể
set_sys_clock_khzyêu cầu gì.
Trên ESP32 và ESP32-S3, firmware khởi động trên một mô hình của cả con chip, bao gồm cả hai nhân: mask ROM, flash sau bộ nhớ đệm, các timer, ma trận ngắt, GPIO, LEDC, RMT, I2C, các SPI master, các UART và ADC1. Các ví dụ hello_world, blink, GPIO, LEDC và FreeRTOS của chính ESP-IDF chạy được, và các bản build Rust cũng vậy. Những thứ không chạy:
- Wi-Fi và Bluetooth. Driver của chúng là các thư viện đóng của Espressif điều khiển một module radio không có thanh ghi công khai, nên firmware nào khởi động một trong hai sẽ dừng lại ở module radio với một dòng thông báo trong Serial Monitor. (Wi-Fi trong sketch Arduino vẫn hoạt động: Mokxi biên dịch nó với runtime riêng của mình.)
- Một ngoại vi mà mô hình chưa có (I2S, bộ đếm xung, PWM điều khiển động cơ, TWAI, SD/MMC, các bộ tăng tốc mã hóa) sẽ dừng bo mạch kèm một dòng ghi rõ tên nó, thay vì chạy trên các thanh ghi chỉ ghi nhớ những gì đã được ghi vào.
- Chế độ ngủ nhẹ, ngủ sâu và PSRAM không được mô phỏng.
Các bo mạch ESP32-C3 và ESP32-C6 chưa chạy được bản build ESP-IDF: chúng chạy sketch Arduino, được biên dịch tại đây.
Related
- Code và biên dịch: Các sketch Arduino mà Mokxi tự biên dịch.
- VS Code và GitHub với Mokxi: chạy bản biên dịch Wokwi hoặc PlatformIO từ VS Code.
- Nạp chương trình vào bo mạch thật