Perubahan dua baris
Di GitHub Actions, ubah baris uses: dan secret yang dibaca input token. Semua hal lain dalam step tetap sama.
- 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.
Action ini memakai nama input Wokwi (path, timeout, scenario, expect_text, fail_text, serial_log_file, elf, diagram_file, timeout_exit_code, args) dengan arti yang sama seperti di Wokwi: timeout saja berarti milidetik, path: / berarti root repositori, scenario dibaca relatif terhadap folder proyek, dan args adalah satu baris opsi yang dipisah spasi.
Dari shell, wokwi-cli <dir> menjadi npx @mokxi/cli run <dir>, dan opsi-opsinya tetap memakai nama yang sama (--timeout, --expect-text, --fail-text, --scenario, --serial-log-file, --elf, --diagram-file, --timeout-exit-code, --screenshot-part, --screenshot-time, --screenshot-file, --vcd-file).
Apa yang berjalan tanpa perubahan
- File proyek.
diagram.json, sketch beserta tab-tabnya,libraries.txt, danwokwi.toml. Saatwokwi.tomlmenyebut file firmware yang ada (build PlatformIO, ESP-IDF, arduino-cli, atau Rust), build itulah yang dijalankan, seperti Wokwi. Kalau file itu tidak ada, Mokxi mengompilasi sketch-nya sendiri, jadi repositori yang hanya berisi kode sumber juga bisa jalan. - Langkah skenario.
wait-serial,write-serial(teks atau daftar byte),delay,set-control,expect-pin(dengan kuncipindancontrol, atau kunci baruname),take-screenshotdengansave-todancompare-with, sertatouch,touch-press,touch-movedantouch-releasepada panel sentuh ILI9341. - Id komponen. Sebuah langkah menyebut komponen lewat id-nya di
diagram.json-mu.
Tiga hal berperilaku berbeda:
- Kode keluar default untuk timeout adalah 1. Milik Wokwi adalah 42. Atur
timeout_exit_code: 42(atau--timeout-exit-code 42) jika workflow-mu memeriksanya. - Board kelas Uno butuh 65 ms untuk menyala. Uno, Nano, dan board ATmega lainnya memodelkan jeda start-up saat chip dinyalakan, jadi pin yang dicek pada 70 ms pertama atau sekitar itu dalam satu run akan terbaca berbeda dari Wokwi. Mulailah skenario dengan
delay: 100msatauwait-serial. - Tangkapan layar satu rangkaian penuh berupa SVG. Tangkapan layar komponen layar (OLED, TFT, LCD karakter, e-paper, atau layar Nokia) berupa PNG dari piksel panel itu sendiri, dan
compare-withmemeriksanya terhadap referensimu piksel demi piksel. Tangkapan layar komponen lain berupa gambar SVG, dancompare-withtidak diperiksa untuk itu. Ambil ulang gambar referensimu dengan Mokxi: run pertama daricompare-withtanpa file referensi akan menyimpan gambarnya di sana supaya kamu bisa memeriksa dan menyimpannya.
Komponen Wokwi yang tidak punya padanan di Mokxi ditinggalkan dan disebutkan di log, sama seperti saat kamu mengimpor proyek ke editor. Mengimpor dari alat lain mencantumkan apa saja yang ikut pindah.
Perbandingannya
| Mokxi | Wokwi CI | |
|---|---|---|
| Di mana simulasi berjalan | Di runner CI-mu | Di server Wokwi |
| Mengompilasi sketch di CI | Ya, dengan compiler milik editor, di-cache | Tidak, kamu build dulu |
| CI gratis | Repositori publik, tanpa batas jumlah run (run dijalankan di runner kamu) | Sekitar 50 menit CI per bulan (menurut dokumentasi Wokwi, dicek 26-10-2026) |
| CI berbayar | Repositori pribadi dengan Pro; tanpa hitungan menit di runner kamu | Pro, from one seat, 2,000 CI minutes a month |
| File skenario Wokwi | Ya, tanpa perubahan | Ya |
| Langkah tambahan | press, click, set, wait-pin, expect-toggles (timing), expect-led, expect-probe, expect-display |
|
| Pemeriksaan tampilan | expect-display (piksel menyala, sebuah area, satu piksel, kosong) dan PNG compare-with |
PNG compare-with |
| Laporan JUnit | Ya | Tidak ada di dokumentasi Wokwi |
| Ringkasan job dan anotasi | Ya: tabel hasil, setiap kegagalan muncul di baris skenario dengan baris terakhir output serial | Tidak ada di dokumentasi Wokwi |
| Logic analyzer ke VCD | --vcd-file |
--vcd-file |
| Waktu simulasi dan waktu nyata | Dilaporkan pada setiap run | |
| Dibagi antar job | --shard 1/3 |
|
| CI lain (GitLab, Jenkins, CircleCI) | Ya, mesin apa pun dengan Node 18 | Ya |
| Lint diagram | mokxi lint |
wokwi-cli lint |
| Pemantauan heap ESP-IDF | Not yet | Ya |
| Image kartu SD | Not yet | Ya |
| Server GDB | Not yet | Ya |
| Cakupan kode | Not yet | Ya |
| Chip kustom | Not yet | Ya |
| Mengetik ke dalam run dari stdin | Not yet | --interactive |
Harga
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 seharga EUR 25 per kursi per bulan, atau EUR 20 per bulan dengan tagihan tahunan (menurut wokwi.com/pricing, dicek 26-10-2026).
Lihat Simulation tests in CI untuk referensi lengkap perintah dan skenario.