Hesaplar ve planlar

Wokwi CI'dan geçiş

İki satırı değiştirerek bir Wokwi CI iş akışını Mokxi'ye taşı. Proje klasörün, diagram.json, wokwi.toml ve senaryo dosyaların olduğu gibi kalır.

İki satırlık değişiklik

GitHub Actions üzerinde uses: satırını ve token girişinin okuduğu gizli anahtarı değiştir. Adımdaki diğer her şey kalır.

 - 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, Wokwi'nin giriş adlarını alır (path, timeout, scenario, expect_text, fail_text, serial_log_file, elf, diagram_file, timeout_exit_code, args) Wokwi anlamlarıyla: tek başına timeout milisaniyedir, path: / depo köküdür, scenario proje klasörüne göre okunur ve args boşluklarla ayrılan tek satırlık seçeneklerdir.

Bir kabuktan wokwi-cli <dir> komutu npx @mokxi/cli run <dir> olur ve seçenekler adlarını korur (--timeout, --expect-text, --fail-text, --scenario, --serial-log-file, --elf, --diagram-file, --timeout-exit-code, --screenshot-part, --screenshot-time, --screenshot-file, --vcd-file).

Değişmeden çalışanlar

  • Proje dosyaları. diagram.json, kod ve sekmeleri, libraries.txt ve wokwi.toml. wokwi.toml var olan bir firmware dosyasını adlandırdığında (bir PlatformIO, ESP-IDF, arduino-cli veya Rust derlemesi), Wokwi'nin yaptığı gibi o derleme çalıştırılır. Yoksa Mokxi kodu kendisi derler, böylece yalnızca kaynak kodu olan bir depo da çalışır.
  • Senaryo adımları. wait-serial, write-serial (metin veya bayt listesi), delay, set-control, expect-pin (pin ve control ile, ya da daha yeni olan name anahtarı ile), save-to ve compare-with ile take-screenshot, ayrıca ILI9341 dokunmatik panellerde touch, touch-press, touch-move ve touch-release.
  • Parça kimlikleri. Bir adım, parçayı diagram.json içindeki kimliğiyle adlandırır.

Üç şey farklı davranır:

  • Zaman aşımı için varsayılan çıkış kodu 1'dir. Wokwi'ninki 42'dir. İş akışın buna bakıyorsa timeout_exit_code: 42 (veya --timeout-exit-code 42) ayarla.
  • Uno sınıfı kartlar başlamak için 65 ms alır. Uno, Nano ve diğer ATmega kartları çipin açılış başlama gecikmesini modeller, bu yüzden bir çalıştırmanın ilk 70 ms'sinde ya da civarında denetlenen bir pin Wokwi'den farklı okunur. Senaryoya delay: 100ms veya bir wait-serial ile başla.
  • Tüm devrenin ekran görüntüleri SVG'dir. Bir ekran parçasının (OLED, TFT, karakter LCD, e-kağıt veya Nokia ekran) ekran görüntüsü, panelin kendi piksellerinden oluşan bir PNG'dir ve compare-with bunu referansınla piksel piksel karşılaştırır. Diğer herhangi bir parçanın ekran görüntüsü bir SVG çizimidir ve compare-with bunun için kontrol edilmez. Referans görsellerini Mokxi ile yeniden al: referans dosyası olmayan bir compare-with çalıştırması, kontrol edip kaydetmen için görselini oraya kaydeder.

Mokxi karşılığı olmayan bir Wokwi parçası atlanır ve günlükte adı geçer, tıpkı projeyi düzenleyiciye aktardığındaki gibi. Diğer araçlardan aktarma nelerin geldiğini listeler.

Karşılaştırma

Mokxi Wokwi CI
Simülasyon nerede çalışır Senin CI çalıştırıcında Wokwi'nin sunucularında
Kodu CI'da derler Evet, düzenleyicinin kendi derleyicisiyle, önbellekli Hayır, önce sen derlersin
Ücretsiz CI Herkese açık depolar, çalıştırma sayısı sınırı yok (kendi runner'ında çalışır) Ayda yaklaşık 50 CI dakikası (Wokwi belgelerine göre, 26.10.2026'da kontrol edildi)
Ücretli CI Pro ile gizli depolar; kendi runner'ında dakika sayısı yok Pro, from one seat, 2,000 CI minutes a month
Wokwi senaryo dosyaları Evet, değişmeden Evet
Ek adımlar press, click, set, wait-pin, expect-toggles (zamanlama), expect-led, expect-probe, expect-display
Ekran kontrolleri expect-display (yanan pikseller, bir bölge, tek piksel, boş) ve PNG compare-with PNG compare-with
JUnit raporu Evet Wokwi belgelerinde yok
İş özeti ve ek açıklamalar Evet: sonuç tablosu, her hata senaryonun satırında seri çıkışının son satırlarıyla birlikte Wokwi belgelerinde yok
Mantık analizöründen VCD'ye --vcd-file --vcd-file
Simülasyon ve gerçek süre Her çalıştırma için bildirilir
İşler arasında bölünür --shard 1/3
Diğer CI (GitLab, Jenkins, CircleCI) Evet, Node 18 olan herhangi bir makine Evet
Diyagram lint mokxi lint wokwi-cli lint
ESP-IDF bellek izleme Not yet Evet
SD kart kalıpları Not yet Evet
GDB sunucusu Not yet Evet
Kod kapsamı Not yet Evet
Özel çipler Not yet Evet
Bir çalıştırmaya stdin'den yazma Not yet --interactive

Fiyatlar

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 ile gelir, 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 koltuk başına ayda 25 EUR, ya da yıllık ödemede ayda 20 EUR (wokwi.com/pricing sayfasına göre, 26.10.2026'da kontrol edildi).

Tam komut ve senaryo başvurusu için CI'da simülasyon testleri sayfasına bak.