Editor

Jalankan firmware prebuilt

Jalankan build Pico SDK atau ESP-IDF di Pico, ESP32 atau ESP32-S3, seperti Wokwi menjalankan file yang disebut wokwi.toml.

Mokxi mengompilasi sketch Arduino sendiri saat kamu menekan Jalankan. Program yang ditulis untuk Raspberry Pi Pico SDK (C atau C++ dengan pico/stdlib.h) atau untuk ESP-IDF (app_main), atau dengan Rust memakai esp-hal atau esp-idf-hal, tidak dikompilasi di sini: kamu mengompilasinya di komputermu sendiri dan memberikan file hasil build-nya ke Mokxi. Board lalu mem-boot-nya persis seperti board sungguhan setelah file ditulis ke sana.

Unggah firmware

  1. Letakkan Raspberry Pi Pico (Pico W atau Arduino Nano RP2040 Connect juga bisa), atau board ESP32 atau ESP32-S3, di kanvas dan klik.
  2. Di propertinya, buka program dan pilih Upload firmware (ini menyebutkan file yang diterima board, seperti .uf2, .elf).
  3. Pilih file hasil build-mu, lalu tekan Run.

File yang diterima tiap board:

Board File Cara boot-nya
Pico, Pico W, Nano RP2040 Connect .uf2, .elf melalui boot ROM dan second stage milik image-nya, seperti setelah menyalin file ke drive board
ESP32 DevKit V1, DevKitC, LOLIN32 Lite .bin, .elf seperti setelah idf.py flash: aplikasi di 0x10000, atau image gabungan sesuai letak build-nya
ESP32-S3 DevKitC-1, XIAO ESP32-S3, Nano ESP32 .bin, .elf sama saja

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 Impor: jatuhkan di halaman import dan proyek terbuka dengan board menjalankannya.

Di Pico, Serial Monitor menampilkan kedua output serial Pico SDK: UART0 di GP0 dan GP1 dengan 115200 baud (pico_enable_stdio_uart) dan port serial USB (pico_enable_stdio_usb). Di ESP32 atau ESP32-S3, itu adalah UART0, port tempat chip mencatat log. Apa pun yang kamu ketik tetap terkirim ke board.

File .elf disimpan sebagai image yang di-boot board, tanpa informasi debug-nya, jadi .elf berukuran besar biasanya tetap muat. File yang disimpan maksimal 2 MB. File yang dibuild untuk chip lain akan ditolak dengan kalimat menyebutkan chip asal build-nya.

Build salah satu di komputermu

Pasang Pico SDK sesuai panduan Getting started with the Raspberry Pi Pico dari Raspberry Pi, atau pakai ekstensi Raspberry Pi Pico untuk VS Code, yang menyiapkan SDK dan compiler untukmu. Lalu, di folder proyekmu:

mkdir build
cd build
cmake .. -DPICO_BOARD=pico
make

Build meninggalkan <your program>.uf2 dan <your program>.elf di build/. Unggah salah satunya. Setelah kamu mengubah kode, build lagi dan unggah file barunya: Mokxi menjalankan file yang kamu berikan, bukan kode di editor.

Untuk ESP32 atau ESP32-S3, pasang ESP-IDF sesuai panduan Get Started dari Espressif, lalu di folder proyekmu:

idf.py set-target esp32
idf.py build

Itu meninggalkan build/<your project>.bin dan build/<your project>.elf. Unggah salah satunya. Image gabungan (esptool merge-bin) juga bisa, begitu juga build Rust: cargo build --release dengan esp-hal (bare metal) atau esp-idf-hal, lalu ELF dari target/, atau file .bin yang ditulis espflash save-image.

Dari Wokwi

Project Wokwi untuk VS Code menamai build-nya di wokwi.toml (firmware = 'build/blink.uf2' untuk Pico, firmware = 'build/flasher_args.json' untuk ESP-IDF). Impor project dengan file itu di dalam unggahan (zip dari seluruh folder, termasuk build/, adalah cara termudah) dan board akan menjalankannya: laporan impor menyebutkan file mana yang dipakai. Tanpa file itu, laporan akan menyebutkan file apa yang perlu ditambahkan.

Apa yang berjalan, dan apa yang belum

Di Pico, boot ROM, flash, clock, timer, UART, GPIO, PWM, ADC, I2C, SPI, DMA, PIO, USB dan watchdog semuanya disimulasikan, jadi sebagian besar contoh Pico SDK berjalan apa adanya, termasuk LED WS2812 lewat ws2812.pio. Di Pico W, CYW43439 dimodelkan seperti build resmi MicroPython dan CircuitPython yang menggerakkannya lewat cyw43-driver, driver yang ditautkan pico_cyw43_arch, dan ia bergabung ke jaringan simulasi Mokxi; Bluetooth, klien mode access point, power save dan TLS tidak disimulasikan. Yang tidak berjalan:

  • Core kedua. multicore_launch_core1 menghentikan board.
  • Clock sistem selalu 125 MHz, apa pun yang diminta set_sys_clock_khz.

Di ESP32 dan ESP32-S3, firmware di-boot pada model seluruh chip, termasuk kedua core: mask ROM, flash di balik cache, timer, interrupt matrix, GPIO, LEDC, RMT, I2C, master SPI, UART, dan ADC1. Contoh bawaan ESP-IDF seperti hello_world, blink, GPIO, LEDC, dan FreeRTOS bisa berjalan, begitu juga build Rust. Yang tidak bisa:

  • Wi-Fi dan Bluetooth. Driver-nya adalah library tertutup milik Espressif yang menggerakkan radio tanpa register publik, jadi firmware yang memulai salah satunya akan berhenti di radio dengan sebuah baris di Serial Monitor yang menjelaskannya. (Wi-Fi pada sketch Arduino bisa berfungsi: Mokxi mengompilasinya dengan runtime-nya sendiri.)
  • Periferal yang belum dimodelkan (I2S, pulse counter, PWM untuk kontrol motor, TWAI, SD/MMC, akselerator kripto) menghentikan board dengan sebuah baris yang menyebutkan namanya, alih-alih berjalan pada register yang hanya mengingat apa yang ditulis.
  • Sleep ringan dan sleep dalam, serta PSRAM tidak disimulasikan.

Board ESP32-C3 dan ESP32-C6 belum bisa menjalankan build ESP-IDF: keduanya menjalankan sketch Arduino, yang dibangun di sini.