الحسابات والباقات

الانتقال من Wokwi CI

انقل سير عمل Wokwi CI إلى Mokxi بتغيير سطرين. يبقى مجلد المشروع وdiagram.json وwokwi.toml وملفات السيناريو كما هي.

التغيير المكون من سطرين

على GitHub Actions، غيّر سطر uses: والسرّ الذي يقرأه مُدخل token. يبقى كل شيء آخر في الخطوة كما هو.

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

يأخذ الإجراء أسماء مدخلات Wokwi‏ (path وtimeout وscenario وexpect_text وfail_text وserial_log_file وelf وdiagram_file وtimeout_exit_code وargs) بمعاني Wokwi نفسها: قيمة timeout المجردة بالمللي ثانية، وpath: / هي جذر المستودع، وscenario يُقرأ نسبياً إلى مجلد المشروع، وargs سطر واحد من الخيارات مفصولة بمسافات.

من سطر الأوامر، يصبح wokwi-cli <dir> هو npx @mokxi/cli run <dir>، وتحتفظ الخيارات بأسمائها (--timeout، --expect-text، --fail-text، --scenario، --serial-log-file، --elf، --diagram-file، --timeout-exit-code، --screenshot-part، --screenshot-time، --screenshot-file، --vcd-file).

ما يعمل دون تغيير

  • ملفات المشروع. diagram.json والكود وتبويباته وlibraries.txt وwokwi.toml. عندما يذكر wokwi.toml ملف برنامج ثابت موجوداً (بناء PlatformIO أو ESP-IDF أو arduino-cli أو Rust)، يُشغَّل ذلك البناء، كما يفعل Wokwi. وعندما لا يكون موجوداً، يترجم Mokxi الكود بنفسه، لذا يعمل المستودع الذي يحتوي على الكود المصدري فقط أيضاً.
  • خطوات السيناريو. wait-serial، write-serial (نص أو قائمة بايتات)، delay، set-control، expect-pin (مع المفتاحين pin وcontrol، أو المفتاح الأحدث name)، take-screenshot مع save-to وcompare-with، وكذلك touch وtouch-press وtouch-move وtouch-release على لوحات اللمس ILI9341.
  • معرّفات القطع. تذكر الخطوة قطعة بمعرّفها في diagram.json لديك.

ثلاثة أمور تختلف في سلوكها:

  • رمز الخروج الافتراضي عند انتهاء المهلة هو 1. أما في Wokwi فهو 42. اضبط timeout_exit_code: 42 (أو --timeout-exit-code 42) إذا كان سير عملك يتحقق منه.
  • لوحات فئة Uno تحتاج 65 ms للإقلاع. تُحاكي لوحات Uno وNano وغيرها من لوحات ATmega تأخير إقلاع الشريحة عند التشغيل، لذا فإن الطرف الذي يُفحص خلال أول 70 ms تقريباً من التشغيل يُقرأ بقيمة مختلفة عن Wokwi. ابدأ السيناريو بـ delay: 100ms أو بخطوة wait-serial.
  • لقطات الدائرة الكاملة بصيغة SVG. لقطة قطعة شاشة (شاشة OLED أو TFT أو LCD حرفي أو e-paper أو شاشة Nokia) هي ملف PNG من بكسلات اللوحة نفسها، ويتحقق compare-with منه مقابل صورتك المرجعية بكسلاً ببكسل. أما لقطة أي قطعة أخرى فرسم SVG، ولا يُتحقق من compare-with لها. أعد التقاط صورك المرجعية باستخدام Mokxi: أول تشغيل لخطوة compare-with دون ملف مرجعي يحفظ صورتها هناك لتراجعها وتُدرجها في المستودع.

تُستبعد قطعة Wokwi التي لا مقابل لها في Mokxi ويُذكر اسمها في السجل، كما هو الحال عند استيراد المشروع إلى المحرر. يسرد الاستيراد من أدوات أخرى ما ينتقل منها.

كيف تتم المقارنة

Mokxi Wokwi CI
أين تعمل المحاكاة على مشغّل CI لديك على خوادم Wokwi
يترجم الكود في CI نعم، بالمترجم نفسه المستخدم في المحرر، مع التخزين المؤقت لا، عليك بناؤه أولاً
‏CI مجاني المستودعات العامة، بلا حد لعدد مرات التشغيل (تعمل على أداة التشغيل الخاصة بك) نحو 50 دقيقة CI شهريًا (حسب وثائق Wokwi، تم التحقق في 2026-10-26)
CI مدفوع المستودعات الخاصة مع Pro؛ بدون عدّ دقائق على أداة التشغيل الخاصة بك Pro, from one seat, 2,000 CI minutes a month
ملفات سيناريو Wokwi نعم، دون تغيير نعم
خطوات إضافية press, click, set, wait-pin, expect-toggles (التوقيت), expect-led, expect-probe, expect-display
فحوص الشاشة expect-display (النقاط المضيئة، منطقة، نقطة واحدة، شاشة فارغة) وPNG عبر compare-with مقارنة PNG عبر compare-with
تقرير JUnit نعم غير موجود في وثائق Wokwi
ملخص المهمة والملاحظات نعم: جدول بالنتائج، وكل فشل على سطر السيناريو مع آخر أسطر المخرج التسلسلي غير موجود في وثائق Wokwi
محلل منطقي إلى ملف VCD --vcd-file --vcd-file
وقت المحاكاة والوقت الفعلي يُبلَّغ عنه مع كل تشغيل
موزّعة على المهام --shard 1/3
أنظمة CI أخرى (GitLab، Jenkins، CircleCI) نعم، أي جهاز فيه Node 18 نعم
فحص المخطط mokxi lint wokwi-cli lint
مراقبة ذاكرة ESP-IDF Not yet نعم
صور بطاقات SD Not yet نعم
خادم GDB Not yet نعم
تغطية الكود Not yet نعم
الشرائح المخصصة Not yet نعم
الكتابة أثناء التشغيل من stdin Not yet --interactive

الأسعار

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 يكلّف EUR 25 لكل مقعد شهريًا، أو EUR 20 شهريًا عند الدفع سنويًا (حسب wokwi.com/pricing، تم التحقق في 2026-10-26).

طالع اختبارات المحاكاة في CI للاطلاع على الأمر الكامل ومرجع السيناريوهات.