Akun dan paket

Pindah dari Wokwi CI

Pindahkan workflow Wokwi CI ke Mokxi dengan mengubah dua baris. Folder proyekmu, diagram.json, wokwi.toml, dan file scenario tetap apa adanya.

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, dan wokwi.toml. Saat wokwi.toml menyebut 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 kunci pin dan control, atau kunci baru name), take-screenshot dengan save-to dan compare-with, serta touch, touch-press, touch-move dan touch-release pada 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: 100ms atau wait-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-with memeriksanya terhadap referensimu piksel demi piksel. Tangkapan layar komponen lain berupa gambar SVG, dan compare-with tidak diperiksa untuk itu. Ambil ulang gambar referensimu dengan Mokxi: run pertama dari compare-with tanpa 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.