التغيير المكون من سطرين
على 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 للاطلاع على الأمر الكامل ومرجع السيناريوهات.