Contas e planos

Migrar do Wokwi CI

Mova um workflow do Wokwi CI para o Mokxi mudando duas linhas. Sua pasta de projeto, o diagram.json, o wokwi.toml e os arquivos de cenário ficam como estão.

A mudança de duas linhas

No GitHub Actions, mude a linha uses: e o secret que a entrada token lê. Todo o resto do passo fica como está.

 - 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.

A action aceita os nomes de entrada do Wokwi (path, timeout, scenario, expect_text, fail_text, serial_log_file, elf, diagram_file, timeout_exit_code, args) com os significados do Wokwi: um timeout sozinho é em milissegundos, path: / é a raiz do repositório, scenario é lido em relação à pasta do projeto, e args é uma linha de opções separadas por espaços.

De um shell, wokwi-cli <dir> vira npx @mokxi/cli run <dir>, e as opções mantêm seus nomes (--timeout, --expect-text, --fail-text, --scenario, --serial-log-file, --elf, --diagram-file, --timeout-exit-code, --screenshot-part, --screenshot-time, --screenshot-file, --vcd-file).

O que roda sem mudanças

  • Arquivos do projeto. diagram.json, o sketch e suas abas, libraries.txt e wokwi.toml. Quando o wokwi.toml aponta um arquivo de firmware que existe (um build do PlatformIO, ESP-IDF, arduino-cli ou Rust), esse build é executado, como o Wokwi faz. Quando ele não existe, o Mokxi compila o sketch por conta própria, então um repositório só com código-fonte também funciona.
  • Passos de cenário. wait-serial, write-serial (texto ou uma lista de bytes), delay, set-control, expect-pin (com pin e control, ou a chave mais nova name), take-screenshot com save-to e compare-with, e touch, touch-press, touch-move e touch-release nos painéis de toque ILI9341.
  • Ids de componentes. Um passo nomeia um componente pelo seu id no seu diagram.json.

Três coisas se comportam de forma diferente:

  • O código de saída padrão para um timeout é 1. O do Wokwi é 42. Defina timeout_exit_code: 42 (ou --timeout-exit-code 42) se seu workflow verifica isso.
  • Placas nível Uno levam 65 ms para iniciar. A Uno, a Nano e outras placas ATmega modelam o atraso de inicialização do chip ao ligar, então um pino verificado nos primeiros 70 ms ou mais de uma execução lê um valor diferente do Wokwi. Comece um cenário com delay: 100ms ou um wait-serial.
  • Capturas de tela do circuito inteiro são SVG. Uma captura de um componente de display (um OLED, um TFT, um LCD de caracteres, e-paper ou uma tela Nokia) é um PNG dos próprios pixels do painel, e o compare-with o confere com sua referência pixel a pixel. Uma captura de qualquer outro componente é um desenho SVG, e o compare-with não é verificado nesse caso. Tire suas imagens de referência de novo com o Mokxi: a primeira execução de um compare-with sem arquivo de referência salva a imagem lá para você conferir e fazer commit.

Um componente do Wokwi sem equivalente no Mokxi é deixado de fora e citado no log, igual a quando você importa o projeto para o editor. Importando de outras ferramentas lista o que é trazido.

Como eles se comparam

Mokxi Wokwi CI
Onde a simulação roda No seu runner de CI Nos servidores do Wokwi
Compila o sketch no CI Sim, com o próprio compilador do editor, em cache Não, você compila antes
CI grátis Repositórios públicos, sem limite de execuções (elas rodam no seu runner) Cerca de 50 minutos de CI por mês (segundo a docs do Wokwi, verificado em 26/10/2026)
CI pago Repositórios privados com Pro; sem contagem de minutos no seu runner Pro, from one seat, 2,000 CI minutes a month
Arquivos de cenário do Wokwi Sim, sem mudanças Sim
Passos extras press, click, set, wait-pin, expect-toggles (temporização), expect-led, expect-probe, expect-display
Verificações de display expect-display (pixels acesos, uma região, um pixel, em branco) e PNG compare-with PNG compare-with
Relatório JUnit Sim Não está na docs do Wokwi
Resumo do job e anotações Sim: uma tabela de resultados, cada falha na linha do cenário com as últimas linhas da saída serial Não está na docs do Wokwi
Analisador lógico para VCD --vcd-file --vcd-file
Tempo simulado e tempo real Reportado a cada execução
Dividido entre jobs --shard 1/3
Outros CI (GitLab, Jenkins, CircleCI) Sim, qualquer máquina com Node 18 Sim
Lint de diagrama mokxi lint wokwi-cli lint
Monitoramento de heap do ESP-IDF Not yet Sim
Imagens de cartão SD Not yet Sim
Servidor GDB Not yet Sim
Cobertura de código Not yet Sim
Chips personalizados Not yet Sim
Digitar em uma execução pelo stdin Not yet --interactive

Preços

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).

O Wokwi Pro custa EUR 25 por vaga por mês, ou EUR 20 por mês cobrados anualmente (segundo wokwi.com/pricing, verificado em 26/10/2026).

Veja Testes de simulação no CI para a referência completa de comandos e cenários.