El editor

Ejecutar un firmware ya compilado

Ejecuta una compilación del Pico SDK o de ESP-IDF en la Pico, la ESP32 o la ESP32-S3, de la manera en que Wokwi ejecuta el archivo que wokwi.toml indica.

Mokxi compila los sketches de Arduino por sí mismo cuando presionas Ejecutar. Un programa escrito para el SDK de Raspberry Pi Pico (C o C++ con pico/stdlib.h) o para ESP-IDF (app_main), o en Rust con esp-hal o esp-idf-hal, no se compila aquí: lo compilas en tu propia computadora y le das a Mokxi el archivo que produjo la compilación. La placa entonces lo arranca exactamente como lo haría la real después de que se le escribe el archivo.

Subir un firmware

  1. Coloca una Raspberry Pi Pico (también sirve una Pico W o una Arduino Nano RP2040 Connect), o una placa ESP32 o ESP32-S3, en el lienzo y haz clic en ella.
  2. En sus propiedades, abre programa y elige Subir firmware (menciona los archivos que acepta la placa, como .uf2, .elf).
  3. Elige el archivo que generó tu compilación y presiona Ejecutar.

Qué archivos acepta cada placa:

Placa Archivos Cómo arranca
Pico, Pico W, Nano RP2040 Connect .uf2, .elf a través de la ROM de arranque y de la segunda etapa de la propia imagen, igual que después de copiar el archivo a la unidad de la placa
ESP32 DevKit V1, DevKitC, LOLIN32 Lite .bin, .elf como después de idf.py flash: la aplicación en 0x10000, o una imagen combinada donde la compilación la colocó
ESP32-S3 DevKitC-1, XIAO ESP32-S3, Nano ESP32 .bin, .elf igual

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: arrástralo a la página de importación y el proyecto se abre con la placa ejecutándolo.

En una Pico, el monitor serie muestra ambas salidas serie del SDK de la Pico: UART0 en GP0 y GP1 a 115200 baudios (pico_enable_stdio_uart) y el puerto serie USB (pico_enable_stdio_usb). En una ESP32 o ESP32-S3 es UART0, el puerto al que el chip envía sus registros. Lo que escribas llega a la placa en cualquier caso.

Un .elf se guarda como la imagen que arranca la placa, sin su información de depuración, así que un .elf grande normalmente cabe. El archivo guardado puede medir 2 MB como máximo. Un archivo compilado para otro chip se rechaza con una frase que indica para qué chip se compiló.

Compila uno en tu computadora

Instala el Pico SDK como indica la guía Getting started with the Raspberry Pi Pico de Raspberry Pi, o usa la extensión Raspberry Pi Pico para VS Code, que configura el SDK y el compilador por ti. Luego, en la carpeta de tu proyecto:

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

La compilación deja <tu programa>.uf2 y <tu programa>.elf en build/. Sube cualquiera de los dos. Después de cambiar el código, compila de nuevo y sube el archivo nuevo: Mokxi ejecuta el archivo que le diste, no el código del editor.

Para una ESP32 o ESP32-S3, instala ESP-IDF como indica la guía Get Started de Espressif, luego en la carpeta de tu proyecto:

idf.py set-target esp32
idf.py build

Eso deja build/<tu proyecto>.bin y build/<tu proyecto>.elf. Sube cualquiera de los dos. Una imagen combinada (esptool merge-bin) también funciona, y lo mismo una compilación de Rust: cargo build --release con esp-hal (bare metal) o esp-idf-hal, luego el ELF de target/, o el .bin que escribe espflash save-image.

Desde Wokwi

Un proyecto de Wokwi para VS Code nombra su compilación en wokwi.toml (firmware = 'build/blink.uf2' para una Pico, firmware = 'build/flasher_args.json' para ESP-IDF). Importa el proyecto con ese archivo en la subida (un zip de toda la carpeta, build/ incluida, es lo más fácil) y la placa lo ejecuta: el informe de importación dice qué archivo tomó. Sin el archivo, el informe dice cuál agregar.

Qué funciona y qué todavía no

En la Pico, la ROM de arranque, la flash, los relojes, el temporizador, la UART, el GPIO, el PWM, el ADC, el I2C, el SPI, el DMA, el PIO, el USB y el watchdog están simulados, así que la mayoría de los ejemplos del Pico SDK funcionan tal cual, incluidos los LEDs WS2812 mediante ws2812.pio. En una Pico W la CYW43439 se modela como la manejan las compilaciones oficiales de MicroPython y CircuitPython a través de cyw43-driver, el driver que enlaza pico_cyw43_arch, y se une a la red simulada de Mokxi; el Bluetooth, los clientes del modo de punto de acceso, el ahorro de energía y el TLS no se simulan. Lo que no funciona:

  • El segundo núcleo. multicore_launch_core1 detiene la placa.
  • El reloj del sistema siempre es de 125 MHz, sin importar lo que pida set_sys_clock_khz.

En la ESP32 y la ESP32-S3, el firmware arranca en un modelo del chip completo, con ambos núcleos: la ROM de máscara, la flash detrás de la caché, los temporizadores, la matriz de interrupciones, GPIO, LEDC, RMT, I2C, los maestros SPI, las UART y ADC1. Los ejemplos hello_world, blink, GPIO, LEDC y FreeRTOS del propio ESP-IDF funcionan, y también las compilaciones de Rust. Lo que no:

  • El Wi-Fi y el Bluetooth. Sus drivers son bibliotecas cerradas de Espressif que manejan una radio sin registros públicos, así que un firmware que inicia cualquiera de los dos se detiene en la radio con una línea en el monitor serie que lo indica. (El Wi-Fi de un sketch de Arduino sí funciona: Mokxi lo compila contra su propio runtime).
  • Un periférico que el modelo no tiene (I2S, el contador de pulsos, el PWM de control de motores, TWAI, SD/MMC, los aceleradores criptográficos) detiene la placa con una línea que lo nombra, en vez de ejecutarse sobre registros que solo recuerdan lo que se escribió.
  • La suspensión ligera y profunda, y la PSRAM no se simulan.

Las placas ESP32-C3 y ESP32-C6 todavía no ejecutan una compilación de ESP-IDF: ejecutan sketches de Arduino, compilados aquí.