O editor

Rodar um firmware pronto

Rode uma compilação do Pico SDK ou do ESP-IDF no Pico, no ESP32 ou no ESP32-S3, do jeito que o Wokwi roda o arquivo que o wokwi.toml indica.

O Mokxi compila os sketches do Arduino por conta própria quando você aperta Rodar. Um programa escrito para o SDK do Raspberry Pi Pico (C ou C++ com pico/stdlib.h) ou para o ESP-IDF (app_main), ou em Rust com esp-hal ou esp-idf-hal, não é compilado aqui: você compila no seu próprio computador e entrega ao Mokxi o arquivo que a compilação gerou. A placa então inicializa exatamente como a real faz depois que o arquivo é gravado nela.

Enviar um firmware

  1. Coloque uma Raspberry Pi Pico (uma Pico W ou uma Arduino Nano RP2040 Connect também serve), ou uma placa ESP32 ou ESP32-S3, no canvas e clique nela.
  2. Nas propriedades dela, abra program e escolha Upload firmware (ele mostra os arquivos que a placa aceita, como .uf2, .elf).
  3. Escolha o arquivo que sua compilação gerou e aperte Rodar.

Quais arquivos cada placa aceita:

Placa Arquivos Como inicializa
Pico, Pico W, Nano RP2040 Connect .uf2, .elf pela ROM de boot e pelo segundo estágio da própria imagem, como ao copiar o arquivo para a unidade da placa
ESP32 DevKit V1, DevKitC, LOLIN32 Lite .bin, .elf como após idf.py flash: a aplicação em 0x10000, ou uma imagem mesclada onde a compilação a colocou
ESP32-S3 DevKitC-1, XIAO ESP32-S3, Nano ESP32 .bin, .elf o mesmo

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 Importar: solte-o na página de importação e o projeto abre com a placa rodando-o.

Numa Pico o monitor serial mostra as duas saídas seriais do SDK do Pico: a UART0 nos pinos GP0 e GP1 a 115200 baud (pico_enable_stdio_uart) e a porta serial USB (pico_enable_stdio_usb). Num ESP32 ou ESP32-S3 é a UART0, a porta onde o chip faz os logs. O que você digita vai para a placa em ambos os casos.

Um .elf é guardado como a imagem que a placa inicializa, sem suas informações de depuração, então um .elf grande normalmente cabe. O arquivo guardado pode ter no máximo 2 MB. Um arquivo compilado para outro chip é recusado com uma frase dizendo para qual chip ele foi compilado.

Compile um no seu computador

Instale o Pico SDK como o guia Getting started with the Raspberry Pi Pico da Raspberry Pi indica, ou use a extensão Raspberry Pi Pico para VS Code, que configura o SDK e o compilador para você. Depois, na pasta do seu projeto:

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

A compilação deixa <your program>.uf2 e <your program>.elf em build/. Faça upload de qualquer um dos dois. Depois de mudar o código, compile de novo e faça upload do novo arquivo: o Mokxi roda o arquivo que você deu a ele, não o código no editor.

Para um ESP32 ou ESP32-S3, instale o ESP-IDF como o guia Get Started da Espressif indica, e depois na pasta do seu projeto:

idf.py set-target esp32
idf.py build

Isso deixa build/<your project>.bin e build/<your project>.elf. Faça upload de qualquer um dos dois. Uma imagem mesclada (esptool merge-bin) também funciona, e uma compilação em Rust também: cargo build --release com esp-hal (bare metal) ou esp-idf-hal, depois o ELF de target/, ou o .bin que espflash save-image grava.

Do Wokwi

Um projeto Wokwi for VS Code nomeia sua compilação em wokwi.toml (firmware = 'build/blink.uf2' para um Pico, firmware = 'build/flasher_args.json' para ESP-IDF). Importe o projeto com esse arquivo no upload (um zip da pasta inteira, build/ incluída, é o mais fácil) e a placa o executa: o relatório de importação diz qual arquivo foi usado. Sem o arquivo, o relatório diz qual adicionar.

O que roda, e o que ainda não roda

No Pico, a boot ROM, a flash, os clocks, o timer, UART, GPIO, PWM, ADC, I2C, SPI, DMA, PIO, USB e o watchdog estão todos simulados, então a maioria dos exemplos do Pico SDK roda como está, incluindo LEDs WS2812 através do ws2812.pio. No Pico W o CYW43439 é modelado como as versões oficiais de MicroPython e CircuitPython o usam através do cyw43-driver, o driver que pico_cyw43_arch liga, e ele entra na rede simulada do Mokxi; Bluetooth, os clientes do modo access point, power save e TLS não são simulados. O que não roda:

  • O segundo núcleo. multicore_launch_core1 para a placa.
  • O clock do sistema é sempre 125 MHz, seja lá o que set_sys_clock_khz pedir.

No ESP32 e no ESP32-S3, o firmware inicializa em um modelo do chip inteiro, incluindo os dois núcleos: a mask ROM, a flash atrás do cache, os timers, a matriz de interrupções, GPIO, LEDC, RMT, I2C, os mestres SPI, as UARTs e o ADC1. Os próprios exemplos hello_world, blink, GPIO, LEDC e FreeRTOS do ESP-IDF rodam, e compilações em Rust também. O que não roda:

  • Wi-Fi e Bluetooth. Seus drivers são bibliotecas fechadas da Espressif que controlam um rádio sem registradores públicos, então um firmware que inicia qualquer um dos dois para no rádio com uma linha no Monitor Serial avisando disso. (O Wi-Fi de um sketch Arduino funciona: o Mokxi o compila com o próprio runtime.)
  • Um periférico que o modelo não tem (I2S, o contador de pulsos, o PWM de controle de motores, TWAI, SD/MMC, os aceleradores criptográficos) para a placa com uma linha nomeando-o, em vez de rodar sobre registradores que só lembram o que foi escrito.
  • Sleep leve e profundo, e PSRAM não são simulados.

As placas ESP32-C3 e ESP32-C6 ainda não rodam uma compilação do ESP-IDF: elas rodam sketches Arduino, compilados aqui.