Cuentas y planes

Cambiar desde Wokwi CI

Pasa un flujo de trabajo de Wokwi CI a Mokxi cambiando dos líneas. Tu carpeta de proyecto, diagram.json, wokwi.toml y los archivos de escenario se quedan como están.

El cambio de dos líneas

En GitHub Actions, cambia la línea uses: y el secreto que lee la entrada token. Todo lo demás del paso se queda igual.

 - uses: actions/checkout@v4
-- uses: wokwi/wokwi-ci-action@v1
+- uses: mokxiorg/sim-action@v1
   with:
-    token: ${{ secrets.WOKWI_CLI_TOKEN }}
+    token: ${{ secrets.MOKXI_TOKEN }}
     path: .
     timeout: 10000
     scenario: test.scenario.yaml
     expect_text: Ready
     fail_text: panic
     serial_log_file: serial.log

A public repository needs no token: Mokxi CI is free for it, so you can delete the token: line. For a private one, CI comes with Pro (and the student price, Lifetime, Classroom and the trial; an account that still has Ultra keeps it too), so you need a CI token from a Pro account. Make the token under Settings > Developer, and save it as a repository secret named MOKXI_TOKEN. The action passes it to the command line tool, which checks your plan with it. Until December 11, 2026 everybody keeps CI and each run prints a notice.

La acción acepta los nombres de entrada de Wokwi (path, timeout, scenario, expect_text, fail_text, serial_log_file, elf, diagram_file, timeout_exit_code, args) con los significados de Wokwi: un timeout solo está en milisegundos, path: / es la raíz del repositorio, scenario se lee relativo a la carpeta del proyecto y args es una línea de opciones separadas por espacios.

Desde una terminal, wokwi-cli <dir> se convierte en npx @mokxi/cli run <dir>, y las opciones conservan sus nombres (--timeout, --expect-text, --fail-text, --scenario, --serial-log-file, --elf, --diagram-file, --timeout-exit-code, --screenshot-part, --screenshot-time, --screenshot-file, --vcd-file).

Lo que se ejecuta sin cambios

  • Archivos del proyecto. diagram.json, el sketch y sus pestañas, libraries.txt y wokwi.toml. Cuando wokwi.toml nombra un archivo de firmware que existe (una compilación de PlatformIO, ESP-IDF, arduino-cli o Rust), esa compilación se ejecuta, igual que en Wokwi. Cuando no existe, Mokxi compila el sketch por sí mismo, así que un repositorio con solo código fuente también funciona.
  • Pasos de escenario. wait-serial, write-serial (texto o una lista de bytes), delay, set-control, expect-pin (con pin y control, o la clave más reciente name), take-screenshot con save-to y compare-with, y touch, touch-press, touch-move y touch-release en los paneles táctiles ILI9341.
  • Ids de componentes. Un paso nombra un componente por su id en tu diagram.json.

Tres cosas se comportan diferente:

  • El código de salida por defecto para un timeout es 1. El de Wokwi es 42. Usa timeout_exit_code: 42 (o --timeout-exit-code 42) si tu flujo de trabajo lo verifica.
  • Las placas tipo Uno tardan 65 ms en iniciar. La Uno, la Nano y otras placas ATmega modelan el retraso de arranque del chip al encender, así que un pin verificado en los primeros 70 ms más o menos de una ejecución se lee distinto que en Wokwi. Comienza un escenario con delay: 100ms o un wait-serial.
  • Las capturas de todo el circuito son SVG. Una captura de un componente de pantalla (un OLED, un TFT, una LCD de caracteres, tinta electrónica o una pantalla Nokia) es un PNG de los píxeles del propio panel, y compare-with la compara con tu referencia píxel por píxel. Una captura de cualquier otro componente es un dibujo SVG, y compare-with no se verifica para él. Toma tus imágenes de referencia de nuevo con Mokxi: la primera ejecución de un compare-with sin archivo de referencia guarda ahí su imagen para que la revises y la confirmes.

Un componente de Wokwi sin equivalente en Mokxi se deja fuera y se nombra en el registro, igual que al importar el proyecto al editor. Importar desde otras herramientas lista lo que sí pasa.

Cómo se comparan

Mokxi Wokwi CI
Dónde se ejecuta la simulación En tu ejecutor de CI En los servidores de Wokwi
Compila el sketch en CI Sí, con el propio compilador del editor, con caché No, primero lo compilas tú
CI gratis Repositorios públicos, sin límite de ejecuciones (corren en tu runner) Unos 50 minutos de CI al mes (según la documentación de Wokwi, verificado el 26-10-2026)
CI de pago Repositorios privados con Pro; sin conteo de minutos en tu runner Pro, from one seat, 2,000 CI minutes a month
Archivos de escenario de Wokwi Sí, sin cambios Sí
Pasos adicionales press, click, set, wait-pin, expect-toggles (tiempos), expect-led, expect-probe, expect-display
Verificaciones de pantalla expect-display (píxeles encendidos, una región, un píxel, en blanco) y PNG compare-with PNG compare-with
Reporte JUnit Sí No aparece en la documentación de Wokwi
Resumen del trabajo y anotaciones Sí: una tabla de resultados, cada falla en la línea del escenario con las últimas líneas de la salida serie No aparece en la documentación de Wokwi
Analizador lógico a VCD --vcd-file --vcd-file
Tiempo simulado y tiempo real Se reporta en cada ejecución
Se reparte entre trabajos --shard 1/3
Otro CI (GitLab, Jenkins, CircleCI) Sí, cualquier máquina con Node 18 Sí
Revisión de diagramas mokxi lint wokwi-cli lint
Monitoreo del heap de ESP-IDF Not yet Sí
Imágenes de tarjeta SD Not yet Sí
Servidor GDB Not yet Sí
Cobertura de código Not yet Sí
Los chips personalizados Not yet Sí
Escribir por stdin durante una ejecución Not yet --interactive

Precios

Running mokxi run and mokxi test on your own computer is free, with no account. CI is free for public repositories on GitHub and gitlab.com, with no limit on runs: they run on your runner, not ours. A private repository comes with Pro, with 2,000 API minutes a month for mokxi simulate and mokxi run --cloud (an account that still has Ultra keeps CI and its 5,000 minutes).

Wokwi Pro cuesta EUR 25 por lugar al mes, o EUR 20 al mes con cobro anual (según wokwi.com/pricing, verificado el 26-10-2026).

Consulta Pruebas de simulación en CI para la referencia completa de comandos y escenarios.