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
- 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.
- Nas propriedades dela, abra program e escolha Upload firmware (ele mostra os arquivos que a placa aceita, como
.uf2, .elf). - 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_core1para a placa. - O clock do sistema é sempre 125 MHz, seja lá o que
set_sys_clock_khzpedir.
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.
Related
- Código e compilação: Sketches Arduino que o próprio Mokxi compila.
- VS Code e GitHub com o Mokxi: rodar uma compilação Wokwi ou PlatformIO do VS Code.
- Enviar um programa para uma placa real