المحرر

شرائح مخصصة مكتوبة بلغة C

الشريحة المخصصة قطعة سلوكها عبارة عن كود: حساس لا توجد له قطعة في Mokxi، أو مشغّل شاشة، أو ذاكرة. تعمل شرائح Wokwi كما هي.

These are different from the الشرائح التي تصنعها من القطع. تلك دائرة منطوية في صندوق. أما الشريحة المخصصة فهي برنامج.

أحضر شريحة من Wokwi

تأتي الشريحة مع المشروع الذي هي فيه. استورد المشروع بالطريقة المعتادة وتأتي شرائحه معه كقطع، بأطرافها وأسلاكها:

  • كل شريحة في مشروع Wokwi for VS Code أو Wokwi CLI تأتي مبنيّة بالفعل: الملف chip.wasm الذي يسمّيه wokwi.toml، بجوار ملف chip.json. يشغّل Mokxi ذلك الملف.
  • في مشروع من wokwi.com تكون كل شريحة عبارة عن ملفين، <name>.chip.json و<name>.chip.c. أحضِر الملفين معًا. ويعمل أيضًا ملفا chip.json وchip.c منفردَين، أو شريحة في مجلد خاص بها، أو ملفا chip.json وsrc/main.c من مشروع Wokwi for VS Code، وكذلك ملفات الترويسة التي يضمّها كود الشريحة من بجانبها.
  • أي شريحة يسمّيها المشروع تحت dependencies في ملف diagram.json الخاص به، مثل "chip-pwm": "github:Dlloydev/Wokwi-Chip-PWM@1.0.6"، يتم تنزيلها من ذلك الإصدار على GitHub، تمامًا كما يفعل Wokwi.

يخبرك تقرير الاستيراد بالشرائح التي تم استيرادها، وما كان ناقصًا في أيٍّ منها. أما الشريحة التي لم تكن ملفاتها ضمن الملفات المرفوعة، فتظهر ملاحظة على مساحة العمل في المكان الذي كانت فيه.

كود الشريحة لا يكون أبدًا جزءًا من كود اللوحة. ملف .c يضمّن wokwi-api.h لكنه جاء بدون ملفه .chip.json يُذكر في التقرير: أضِف ملف .chip.json الخاص به واستورد مرة أخرى لتشغيله. أما كود الشريحة الملصوق في أحد ألسنة اللوحة فيُستثنى من بناء اللوحة، مع تحذير على ذلك اللسان يوضّح أنه شريحة مخصصة، حتى يظل الكود يعمل. لتشغيله، أنشئ شريحة عبر شريحة مخصصة جديدة والصق الكود في ملفها .chip.c.

اكتب شريحتك الخاصة

افتح قائمة «المزيد» في شريط أدوات مساحة العمل واختر New custom chip…. أعطِها اسمًا، فتُوضع الشريحة على مساحة العمل، وتبدأ كعاكس إشارة (inverter). كما تظهر في لوحة القطع تحت الشرائح في هذا المشروع، فيمكنك وضع ما تحتاج منها.

يُفتح ملفا الشريحة في لوحة الكود، وتختار منهما كما تختار ملفات اللوحة من القائمة في أعلاها:

  • يحدد <name>.chip.json أطراف الشريحة، بالترتيب بدءًا من الطرف 1، ويمكنه إضافة منزلقات (controls) وشاشة. مكان الطرف في القائمة هو موضعه على الشريحة: نزولًا على الجانب الأيسر، ثم صعودًا على الأيمن.
  • ملف <name>.chip.c هو ما تفعله الشريحة، بلغة C، باستخدام واجهة شرائح Wokwi: pin_init، وpin_watch، وpin_write، وtimer_start، وattr_read، وi2c_init، وspi_init، وuart_init وما تبقى من الدوال.

اضغط «تشغيل» فيبني Mokxi كود الشريحة أولاً، في متصفحك. إذا كان في الكود خطأ يظهر على سطر البناء فوق الكود، والضغط عليه ينقلك إلى السطر المعني. الشريحة المكتوبة في Mokxi هي شريحة Wokwi أيضاً: الملفان نفسيهما يعملان هناك.

شغّله

اضغط «تشغيل». تعمل كل شريحة بكودها الخاص بجانب الدائرة، وبسرعة المحاكاة: مؤقّت الشريحة الذي يستغرق ملي ثانية ينطلق بعد ملي ثانية واحدة مُحاكاة.

  • ما تطبعه الشريحة باستخدام printf يظهر في الشاشة التسلسلية، تحت معرّف الشريحة.
  • الشريحة ذات الشاشة ترسم على جسمها.
  • الشريحة ذات عناصر التحكم (درجة حرارة، مستوى إضاءة) فيها منزلق لكل عنصر في لوحتها. اضغط على الشريحة وحرّك منزلقًا أثناء عمل الدائرة؛ فتقرأ الشريحة القيمة الجديدة فورًا.

بقية إعدادات الشريحة هي خصائصها، كما في ملف diagram.json الخاص بـ Wokwi.

آمنة للتشغيل

يعمل كود الشريحة في صندوق خاص بها. لا يمكنه الوصول إلى الصفحة أو ملفاتك أو الشبكة أو أي جزء آخر من الدائرة إلا من خلال أطرافه. يحصل على 16 MB من الذاكرة كحد أقصى. وإذا علق كوده في حلقة لا تنتهي، يوقف Mokxi تلك الشريحة وحدها ويذكر ذلك في الشاشة التسلسلية، وتبقى بقية الدائرة تعمل.

كيف يختلف عن Wokwi

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

دوال Wokwi التجريبية لقراءة ذاكرة المتحكم الدقيق تُبنى لكنها لا تفعل شيئًا في Mokxi بعد: تُعيد 0، والشريحة التي تستخدمها تذكر ذلك في الشاشة التسلسلية.

الشرائح المكتوبة بلغة Rust تعمل كما أصدرها أصحابها (ملف chip.wasm الخاص بها)، وما تطبعه باستخدام debugPrint يظهر في الشاشة التسلسلية أيضًا.