الطريقة الأسرع: mokxi.com/ قبل الرابط
اكتب mokxi.com/ قبل رابط Wokwi أو CircuitJS أو GitHub أو gist أو GitLab أو Bitbucket أو Codeberg أو موقع لصق النصوص أو Dropbox أو Google Drive أو Instructables أو Arduino Project Hub أو Hackster أو رابط Arduino Cloud مشارَكًا في شريط عنوان المتصفح، مثل mokxi.com/wokwi.com/projects/322062421191557714، ثم اضغط Enter. يُفتح المحرر مع استيراد ذلك المشروع. لا تحتاج إلى حساب. رابط Tinkercad ينقلك إلى صفحة الاستيراد بدلًا من ذلك، مع خطوات Tinkercad. رابط Cirkit Designer لا يعمل بهذه الطريقة: الصقه في صفحة الاستيراد.
أين تستورد
Open the صفحة الاستيراد، أو افتح في المحرر ▾ beside
Save and choose Import a project. You can also paste a project link, a
diagram.json or a sketch anywhere on the canvas, or drop files, a folder or
a zip straight onto the editor. Mokxi works out what the project is from what
is inside it, not from its name.
ماذا يحدث عند الفتح
- المشروع الذي كان مفتوحًا يبقى محفوظًا. «تراجع» على سطر ملخص الاستيراد يعيده، وحفظ ▾ > العودة إلى مشروعي الأخير يفتحه لاحقًا.
- سطر الملخص يخبرك بما تم نقله. اضغط عليه للحصول على التقرير الكامل: ما أصبح ملاحظة على مساحة العمل، وما هو ناقص (توصيلات وملفات ومكتبات)، كل منها مع سببها.
- القطع التي لا يملكها Mokxi تصبح ملاحظات وردية في مواضعها، وسطر «أُترك خارجًا:» في التقرير يسمي كل واحدة.
- التوصيلات تُرتَّب لك. حيث رسم المصدر توصيلاته (Wokwi، Cirkit، وكثير من ملفات Fritzing)، تسير على المسار نفسه. وحيث لم يفعل (مخطط، netlist، ملف لوحة Tinkercad)، يُرتِّب الاستيراد ما يصل إلى 30 سلكًا باستخدام «ترتيب التوصيلات» عند الفتح. الأكبر من ذلك يبقي الأسلاك مستقيمة: اضغط T لترتيبها.
- بإمكان Mokxi AI أن يكمله. عندما يُترك شيء خارجًا، يعرض سطر الملخص «اطلب من Mokxi AI إكماله». Mokxi AI يقترح أقرب قطعة Mokxi لكل ملاحظة، بأطرافها موصولة، والمكتبة المطلوب تثبيتها أو
#includeالمطلوب تغييره لكل قطعة ناقصة. يُتحقق من كل قطعة وطرف مقابل الكتالوج الفعلي أولًا. لا شيء يتغير حتى تضغط زرًا على سطر («إضافة إلى مساحة العمل»، «تثبيت»، «تغيير include»)، وكل ضغطة خطوة تراجع واحدة. - «أخبرنا» يرسل مصدر المشروع وما كان ناقصًا (لا يرسل كودك أبدًا). شخص حقيقي يقرأ كل تقرير. الاستيراد الذي يفشل يعرض «حاول مرة أخرى» إذا كان تكرار المحاولة قد يفيد.
المصادر في هذه الصفحة
Wokwi، Cirkit Designer، GitHub، GitLab و Bitbucket و Codeberg، مواقع اللصق، Dropbox و Google Drive، Instructables، Project Hub و Hackster و Arduino Cloud، Fritzing، SimulIDE، KiCad، EasyEDA، Qucs و gEDA، Falstad CircuitJS، Tinkercad، PlatformIO، بيئة Arduino IDE، ملف .hex مترجَم، رابط Mokxi، نصًا ملصوقًا، صورة، LTspice، و Proteus و Multisim و CircuitMaker.
من Wokwi
Full guide: استيراد مشروع Wokwi، برابط يفتح المشروع المستورد.
هل انتقلت إلى Mokxi قادمًا من Wokwi؟ صفحة القادمون من Wokwi تعرض هنا كل فكرة من Wokwi بجانب اسمها، وتوضح ما الذي يتغيّر.
استخدم أيًّا من هذه:
- رابط. الصق رابط مشروع عام، مثل
https://wokwi.com/projects/322062421191557714. يجلب خادم Mokxi ملفات المشروع من wokwi.com ومنه فقط، ثم يقرأها متصفحك. لا يمكن لأحد سواك جلب مشروع خاص: افتحه على Wokwi، ونزّل ملف zip للمشروع، وأفلته هنا بدلًا من ذلك. - الملفات. أفلت أو اختر
diagram.json، والكود (sketch.inoأو أي اسم آخر)، وأي تبويبات.hو.cppإضافية، وlibraries.txt. - ملف zip. ملف zip للمشروع الذي نزّلته من Wokwi يعمل كما هو.
ما ينتقل:
- القطع. اللوحات وLED والمقاومات والأزرار والمفاتيح المنزلقة والمقاومات المتغيرة ومحركات السيرفو والطنّانات وشاشات LCD الحرفية (مع حزمة I2C أو بدونها) وشاشات OLED وNeoPixels والحلقات والشرائط وشاشات الأرقام السبعة وTM1637 ومصفوفات MAX7219 وشاشات ILI9341 وحسّاسات HC-SR04 وDHT22 وPIR وDS18B20 وMPU6050 وDS1307 وHX711 ولوحات المفاتيح والمُرمِّزات الدوارة وعصي التحكم والمرحّلات ومشغّلات المحركات الخطوية والمحركات الخطوية ومسجّلات الإزاحة وبطاقات microSD والبوابات المنطقية، كلها تصبح القطعة المقابلة في Mokxi، مع لونها وقيمتها وعنوان I2C وعدد البكسلات.
- الأسلاك. كل توصيل بين قطعتين لهما قطعة مقابلة يصبح سلكًا، مع ترجمة أسماء الأطراف (
GND.2هو الطرف GND الثاني على اللوحة، وV+على محرك السيرفو هو VCC، وهكذا) وبأقرب لون سلك في Mokxi. يتبع السلك المسار المرسوم في Wokwi؛ والسلك بلا مسار يحصل على زاوية واحدة. اضغط ترتيب الأسلاك لتوجيهها حول القطع. - لوحات التجارب. القطعة الموصّلة بلوحة تجارب في Wokwi توصَّل في الثقوب نفسها على لوحة التجارب في Mokxi. وعندما يكون حجم القطعة في Mokxi مختلفًا (المقاومة أقصر هنا)، يثبت أحد طرفيها في ثقبه وتُوصَّل بقية الأطراف بأسلاك إلى ثقوبها.
- التسميات. تسمية نصية في Wokwi تصبح ملاحظة لاصقة.
- الكود. الكود وتبويباته تصبح ملفات اللوحة.
ما لا ينتقل، وكيف يتم إبلاغك:
- Custom chips come across as parts that run their own code when the
chip's files come with them (
<name>.chip.jsonand<name>.chip.c, a barechip.jsonandchip.c, a chip in a folder of its own, or a builtchip.wasm), or whendiagram.jsonnames them underdependencies. See الشرائح المخصصة. لا يصبح كود الشريحة أبدًا تبويبًا في كود اللوحة. الشريحة الناقصة ملفاتها تظهر كملاحظة لاصقة وردية، ويذكر التقرير ما كان ناقصًا، مثل.chip.cthat came without its.chip.json. - القطع التي لا تتوفر في Mokxi بعد تصبح ملاحظة وردية في مساحة العمل حيث كانت القطعة، مع ذكر اسمها. وتُدرج أسلاكها في التقرير.
- توصيلات الشاشة التسلسلية في Wokwi تُهمل: فالشاشة التسلسلية في Mokxi متصلة باللوحة دائمًا.
- مشاريع MicroPython تعمل على Raspberry Pi Pico ولوحات ESP32 الكلاسيكية (DevKit V1 وDevKitC وLOLIN32 Lite). على اللوحات الأخرى تُحفظ ملفات
.pyكنص لكنها لا تعمل. - مشاريع CircuitPython (ملف
code.py) تعمل على Raspberry Pi Pico وArduino Nano RP2040 Connect، على البرنامج الثابت الرسمي لـCircuitPython. على اللوحات الأخرى يُحفظcode.pyكنص، ويوضّح التقرير السبب.
من Cirkit Designer
Full guide: افتح رابط مشروع Cirkit Designer، مع قائمة القطع والخطوات.
الصق رابط مشروع مشارَك (https://app.cirkitdesigner.com/project/<id>، مع رقم إصدار في النهاية أو بدونه) في صفحة الاستيراد أو في مساحة العمل. يجلب خادم Mokxi ملف المشروع من Cirkit ومنه فقط، دون تسجيل دخول. لا يمكن قراءة مشروع غير مشارَك.
- القطع. Arduino Uno وNano وMega، وESP32 وESP32-S3، وRaspberry Pi Pico، وLED وLED RGB، والمقاومات بقيمها، والأزرار الضاغطة، والطنّابات، ومحركات السيرفو، والمقاومات المتغيرة، وDHT11 وDHT22، وHC-SR04، وشاشات OLED من نوع SSD1306، وشاشات LCD مقاس 16x2 (مع I2C أو بدونه)، والمرحّلات، و74HC595، وL298N، وDS18B20، وMPU6050، ومستقبلات الأشعة تحت الحمراء، وحسّاسات PIR، ووحدات حساس الضوء، ولوحات المفاتيح، وNeoPixels والحلقات والشرائط، وشاشات TM1637 وMAX7219 وشاشات الأرقام السبعة.
- الأسلاك تتبع المسارات المرسومة في Cirkit.
- الكود. كود اللوحة ينتقل إلى تلك اللوحة.
- أي شيء آخر يصبح ملاحظة وردية تذكر اسمه، ويُدرجه التقرير.
من GitHub
Full guide: من GitHub إلى Mokxi، خطوة بخطوة، مع مثال يفتح هنا.
الصق رابطًا لمستودع عام، أو مجلد داخله، أو ملف .ino واحد، أو gist. ينتقل مشروع PlatformIO أو مجلد كود Arduino مع كوده وقائمة مكتباته. رابط إلى platformio.ini، أو إلى ملف داخل مجلد src/ في مشروع PlatformIO، يجلب المشروع بأكمله حوله. يجلب خادم Mokxi المشاريع العامة من GitHub فقط، ولا يرسل أي تسجيل دخول من أي نوع، ويضع حدًا أقصى للحجم (10 MB للمستودع، و2 MB للملف أو الـ gist). أما المستودع الخاص فنزّل ملف الـ zip من GitHub وأفلته هنا بدلًا من ذلك.
من GitLab وBitbucket وCodeberg
الأمر نفسه كما مع GitHub: الصق رابطًا لمستودع عام، أو مجلد داخله، أو ملف كود واحد على gitlab.com أو bitbucket.org أو codeberg.org. يقرأ Mokxi ملف الـ zip الذي يجهزه الموقع نفسه للمستودع (10 MB كحد أقصى) ويفتح المجلد الذي وصل رابطه، أو الملف (2 MB كحد أقصى). المستودعات الخاصة تحتاج تسجيل دخول لا يرسله Mokxi أبدًا، لذا نزّل ملف الـ zip من هناك وأفلته هنا بدلًا من ذلك.
من مواقع اللصق
الصق رابطًا إلى لصقة واحدة على pastebin.com أو paste.ee أو dpaste.org أو hastebin.com. يجلب Mokxi نصها الخام ويقرؤه كما يقرأ أي شيء ملصوق: كود، أو diagram.json، أو ملف تصدير من CircuitJS. اللصقة التي يخفيها الموقع خلف تسجيل دخول (وhastebin.com يطلبه الآن) لا يمكن قراءتها؛ انسخ نصها والصقه مباشرة بدلًا من ذلك.
من Dropbox وGoogle Drive
يعمل رابط ملف أو مجلد من Dropbox، ورابط ملف من Google Drive، عندما يمكن لأي شخص يملك الرابط فتحه دون تسجيل دخول. يأتي مجلد Dropbox على شكل ملف الـ zip الذي ينشئه Dropbox نفسه، ويُقرأ مثل أي zip مفلت. أما مجلد Drive، أو مستند Google، أو ملف يطلب منك تسجيل الدخول، أو ملف أكبر من أن يفحصه Drive بحثًا عن الفيروسات، فلا يمكن قراءته: سيخبرك Mokxi بذلك، ويمكنك تنزيل الملف وإفلاته بدلًا من ذلك. الحد الأقصى للملفات 2 MB، ولملفات الـ zip 10 MB.
من Instructables
الصق عنوان المشروع (instructables.com/<Project-Name>/). يقرأ Mokxi روابط مرفقات الصفحة ويفتح ملفات .ino و.zip و.fzz المرفقة بها، إضافة إلى أي مرفق .txt يحتوي على كود. يقرأ من instructables.com ومستضيف ملفاته فقط، وبحد أقصى ثمانية مرفقات بحجم إجمالي 8 MB. المشاريع التي لا تحتوي على ملفات مرفقة لا يوجد ما يُقرأ فيها: انسخ الكود من خطواتها والصقه بنفسك.
من Arduino Project Hub وHackster وArduino Cloud
Full guides: Arduino Project Hub، Hackster and Arduino Cloud، كل منها مع الخطوات وما تقرؤه الصفحة.
الصق عنوان صفحة المشروع (projecthub.arduino.cc/<user>/<project> أو hackster.io/<user>/<project>). يقرأ Mokxi الكود الملصق في الصفحة (قسم Code فيها، وأي كتلة ضمن الشرح تكون كودًا)، والملفات المرفقة .ino و.zip و.fzz و.h و.cpp وملفات .txt التي تحمل كودًا. يُفتح أول كود باسم <project>.ino؛ وتصبح كتل الكود الأخرى تبويبات له، ويُحفظ كود كامل ثانٍ (كثيرًا ما تعرض الصفحات نسختين) كتبويب .txt. أما أوامر الطرفية وجداول القطع فلا تُنقل. عندما لا تحتوي الصفحة على كود خاص بها لكنها ترتبط إلى GitHub، يفتح Mokxi مشروع GitHub المرتبط به بدلًا منه. القطع المذكورة في الصفحة تنتقل كملاحظة في التقرير، لا كقطع: ضعها بنفسك. صور المخططات ولوحات التجارب، وملفات الطباعة ثلاثية الأبعاد، والفيديوهات لا تنتقل. يقرأ Mokxi من موقع الصفحة نفسه ومستضيف ملفاتها فقط، وبحد أقصى ثمانية ملفات بحجم إجمالي 8 MB.
الكودات المشتركة على Arduino Cloud (رابط app.arduino.cc/sketches/<id>، أو رابط create.arduino.cc/editor/.../preview من مشاركة الكود) تُفتح مع ملفات الكود الخاصة بها، إذا كان صاحبها قد ضبطها على عام، يمكن لأي شخص لديه الرابط عرض الكود. أما الكود الخاص فلا يمكن قراءته دون تسجيل الدخول: نزّله هناك (تنزيل الكود، ويعطيك ملف zip) ثم أفلت ملف الـ zip في صفحة الاستيراد.
من Fritzing
Full guide: من Fritzing إلى Mokxi، خطوة بخطوة، مع مثال يفتح هنا.
أفلت ملف .fzz (خيار File ثم Save في Fritzing ينشئ واحدًا). إنه ملف zip يحتوي على المشروع والكود من تبويب Code في Fritzing، وكلاهما يُنقل معًا. ملف .fz المجرّد يعمل أيضًا، مع إفلات ملف .ino بجانبه.
- ما الذي يُقرأ. عرض لوحة التجارب: كل قطعة وموضعها، وكل سلك، وشرائح لوحة التجارب. أما عرضا المخطط والـ PCB فلا يُقرآن، لأن السلك المرسوم فيهما فقط لم يكن أبدًا على لوحة التجارب؛ ويسرد التقرير القطع الموجودة هناك فقط.
- القطع. مكتبة Fritzing الأساسية: Arduino Uno و Nano و Mega 2560، والمقاومات بقيمتها، وLED بألوانها، وLED RGB، والأزرار الضاغطة، ومفاتيح التبديل والميلان والمغناطيسية (reed)، والمقاومات المتغيرة، والمكثفات السيراميكية والكهربائية، والدايودات والدايودات الزينر، وترانزستورات NPN و PNP، وترانزستور MOSFET بقناة N، ومنظّم الجهد 7805، وحساسات الضوء LDR، والحساسات الحرارية، وLM35، وحساسات القوة FSR، وHC-SR04، وRHT03 (DHT22)، وسماعات البيزو، ومحركات السيرفو، ومحركات التيار المستمر، وشاشة LCD مقاس 16x2، وشاشة من سبعة أجزاء، والدائرة 555، و74HC595، وجسر H L293D، وبطاريات 9 V و AA؛ وكذلك دايودات ومكثفات ومنظّمات جهد بكل الأشكال، ومنافذ تيار مستمر DC، وشريحة يملكها Mokxi برقمها (مثل LM358، أو 4N35، أو الدائرة العامة في Fritzing الموسومة 595)، وشريحة ATmega168 أو 328 مجردة (تعمل كوحدة Uno التي هي قلبها)، ومصادر المحاكي وملتيميتره وراسم الإشارة.
- الشرائط النحاسية. تُربط الشرائط النحاسية، والشقوق فيها، بأسلاك تمامًا كما تُربط شرائط لوحة التجارب.
- رؤوس الأطراف وأسلاك القياس موصّلات وليست قطعًا: تُترك جانبًا، والأسلاك التي كانت تلتقي عندها تظل متصلة ببعضها.
- لوحات التجارب. لا تُنقل لوحة التجارب نفسها. بدلًا من ذلك تُربط القطع في كل شريط منها بأسلاك، وهذا يوصل الأطراف نفسها بالضبط.
- الملاحظات. تصبح ملاحظات Fritzing ملاحظات لاصقة.
- القطع من المكتبات الأخرى، والقطع المخصصة، تصبح ملاحظة وردية تذكر أسماءها.
من SimulIDE
Full guide: من SimulIDE إلى Mokxi، خطوة بخطوة، مع مثال يفتح هنا.
أفلت ملف الدائرة: .sim1 من SimulIDE 1.0 فما فوق، أو .simu من الإصدارات الأقدم.
- ما الذي يُقرأ. كل مكوّن وموضعه واتجاهه، وكل سلك، وعقد التوصيل، والأنفاق (نفقان بالاسم نفسه يعدّان توصيلة واحدة). وتصبح التسميات النصية ملاحظات لاصقة.
- القطع. المقاومات، والمكثفات، والملفات، وLED، والدايودات والدايودات الزينر، والمقاومات المتغيرة، وحساسات الضوء LDR، والحساسات الحرارية، والأرضي، والجهود الثابتة، والقضبان والبطاريات، وترانزستورات BJT، وترانزستورات MOSFET، والمضخّمات التشغيلية، وLM555، والأزرار الضاغطة والمفاتيح، ومحركات التيار المستمر، ومحركات السيرفو، وDHT22، وHC-SR04، وشاشة HD44780 LCD، وشاشات سبعة أجزاء، وبوابات AND و OR و XOR ثنائية المدخل، والساعات، وArduino Uno و Nano و Mega (تُقرأ أطرافها من تسمياتها، مثل
D13وA0)؛ وكذلك شرائح 74xx و CD4000، وصفوف المقاومات، وأعمدة LED، والشاشات متعددة الأرقام، والبوابات بأكثر من مدخلين (كسلسلة بوابات ثنائية المدخل)، والمجسات، والمقاييس، وراسم الإشارة والمحلل المنطقي، وشاشات Nokia 5110 و SSD1306 و ILI9341، وشريحة ATmega مجردة (كوحدة Uno). يزوّد SimulIDE شرائحه وشاشاته بالطاقة دون أسلاك، لذا يقوم الاستيراد بتوصيل الطاقة لها بدلًا منه. - الكود. يحتفظ SimulIDE بالكود في محرره الخاص ويحمّل ملف
.hexمترجمًا إلى اللوحة، بينما يبني Mokxi من المصدر، لذا ضع ملف.inoفي المجلد أو ملف zip مع الدائرة. يذكر التقرير متى كان مسار.hexوحده موجودًا.
من KiCad
Full guide: من KiCad إلى Mokxi، خطوة بخطوة، مع مثال يفتح هنا.
أفلت المخطط: ملف .kicad_sch (KiCad 6 وما بعده)، أو ملف .kicad_pro، أو ملف zip لمجلد المشروع (يفتح Mokxi المخطط الجذري للمشروع)، أو ملف .sch من KiCad 4 و5. نسخ نص الملف ولصقه يعمل أيضًا.
- ما يُقرأ. كل رمز، ومكانه، وكيف تم تدويره وعكسه، وكل سلك ووصلة، والتسميات، والتسميات العامة، ورموز التغذية. تُنشأ الشبكات بالطريقة نفسها التي ينشئها بها KiCad: نهايات الأسلاك والأطراف والتسميات المتلاقية تُربط معًا، وطرف أو تسمية في منتصف سلك تنضم إليه، أما الأسلاك المتقاطعة فقط فلا تنضم، والتسميات أو رموز التغذية التي تحمل الاسم نفسه هي شبكة واحدة. الأطراف المخفية للتغذية في الشرائح (مثل VCC وGND في 74HC595) تنضم إلى الشبكة التي تحمل اسمها، كما في KiCad.
- القطع. لوحات Arduino Uno وNano وMega، ووحدات ESP32 وESP32-S3 وESP32-C3 وPico، والمقاومات، والمكثفات، والملفات، وLED وRGB LED، والدايودات والدايودات الزينر، والمقاومات المتغيرة، والأزرار ذات الطرفين، والمفاتيح المنزلقة ذات الثلاثة أطراف، والترانزستورات وMOSFET، والصفارات، والبطاريات، وشرائح 74xx وCD4000، والشريحة 555، ومكبرات التشغيل، ومنظّمات الجهد الخطية (78xx، AMS1117)، وNeoPixels، ووحدات الحساسات والشاشات الشائعة بالاسم. تحافظ القطع ذات الطرفين على الاتجاه الذي يرسمها به المخطط.
- ما يُترك كملاحظات. أي رمز لا يوجد في Mokxi قطعة مشابهة له يصبح ملاحظة موسومة في مكانه، ويذكرها التقرير مع الوصلات التي أخذها معها. لا تُطابق القطعة إلا عندما تكون فعلًا تلك القطعة: مصفوفة دايودات TVS ليست دايودًا، ومحرك التيار المتردد ليس محرك تيار مستمر، ومفتاح بأربعة أطراف أو مفتاح SPST ليس مفتاح Mokxi، وموصل موسوم بـ "OLED" يبقى رأس أطراف. رؤوس الأطراف ونقاط الاختبار وثقوب التثبيت هي مواضع توصيل الكابلات، لذا تُترك ويُذكر اسمها في التقرير.
- أوراق داخل أوراق. الورقة الفرعية التي يأتي ملفها مع الملفات المرفوعة وتُستخدم مرة واحدة، تُقرأ وتُوصل عبر تسمياتها الهرمية وأطراف الورقة في الأصل. أما الورقة الفرعية الغائبة عن الملفات المرفوعة أو المستخدمة أكثر من مرة، فتُترك ويُذكر اسمها في التقرير.
- الملفات الأقدم. ملف
.schمن KiCad 4 أو 5 لا يحمل رموزه، لذا تُبحث أطرافها في ملف-cache.libأو.libالمرفق معه. أضفه إلى الملفات المرفوعة. بدونه تصبح القطع ملاحظات ويذكر التقرير السبب؛ لا يُخمَّن أي طرف. - الكود. لا يحتوي المخطط على كود. أضف ملف
.inoإلى الملفات المرفوعة وسيُوضع على اللوحة. - ما لا يُقرأ. النواقل (أسلاك النواقل ومداخلها وتسميات مثل
D[0..7])، وتخطيط اللوحة (.kicad_pcb)، ونماذج المحاكاة، والرموز الموسومة بأنها لا تُعبّأ. - المواضع. تحتفظ القطع بمواضعها النسبية على الورقة. تُنسّق الأسلاك مع «الترتيب» عند فتح المشروع (حتى 30 سلكًا)؛ أما المخطط الأكبر فتكون أسلاكه مستقيمة، من طرف إلى طرف، إلى أن تضغط ترتيب الأسلاك.
من EasyEDA
Full guide: من EasyEDA إلى Mokxi، خطوة بخطوة، مع مثال يفتح هنا.
افتح المخطط في محرر EasyEDA Standard، واختر File ثم Export ثم EasyEDA Source، وأفلت ملف .json هنا (أو الصق نصه). رابط مشروع EasyEDA أو OSHWLab لا يُنزَّل: يخبرك Mokxi بهذه الخطوات بدلًا منه. مشاريع EasyEDA Pro (.epro) بصيغة مختلفة ولا تُقرأ بعد. الملفات الأكبر من 1 MB تُتجاهل، فصدّر المخطط وحده عندما يكون المشروع كبيرًا.
- ما يُقرأ. كل قطعة مع رمزها التصميمي وقيمتها وحزمتها وأطرافها؛ والأسلاك؛ والوصلات؛ وتسميات الشبكات؛ وأعلام التغذية والأرضي. ملف مصدر EasyEDA لا يحتوي netlist، لذا يجد Mokxi الوصلات بالطريقة التي يرسمها بها المحرر: السلك يربط كل ما عليه، والتسميات والأعلام التي تحمل الاسم نفسه هي وصلة واحدة، في كل ورقة. تُرتَّب الأوراق جنبًا إلى جنب.
- القطع. المقاومات، والمكثفات، والملفات، وLED، والدايودات، والترانزستورات، والمفاتيح، والمقاومات المتغيرة، والوحدات الشائعة، وشرائح 74xx وCD4000، ولوحات طراز Arduino، وفق رمزها التصميمي وقيمتها وحزمتها وأسماء أطرافها (الجدول نفسه الذي تستخدمه قارئات KiCad وSPICE). القطعة التي لا مقابل لها في Mokxi تصبح ملاحظة وردية تحمل اسمها، ويذكرها التقرير.
- الأطراف. الطرف الذي لا مقابل له في قطعة Mokxi يُذكر في التقرير ويُترك غير موصول، ولا يُخمَّن أبدًا.
- ما لا يُقرأ. اللوحة (PCB) في المشروع نفسه، والرسومات والنصوص على الورقة، ومكتبات القطع. يُترك الإطار أو الشعار الذي بلا أطراف.
- الكود. لا يحتوي المخطط على كود. أضف ملف
.inoإلى الملفات المرفوعة وسيُوضع على اللوحة.
من Qucs وgEDA
Full guides: Qucs and gEDA وLepton EDA، كل منها مع مثال مخطط يُفتح هنا.
أفلت المخطط، ملف .sch. يقرأ Mokxi محتواه ليحدد أي أداة حفظته: Qucs (وQucs-S وQucsStudio، التي تحفظ بالطريقة نفسها) أو gEDA gschem (وLepton EDA، التي تواصل مسار gEDA). يمكنك أيضًا لصق نص الملف في الصندوق.
- القطع. المقاومات، والمكثفات، والملفات، والدايودات والدايودات الزينر، وترانزستورات BJT (NPN وPNP)، وMOSFET، والأرضي، ومصادر جهد تيار مستمر ومصادر جيبية، من كلتا الأداتين؛ ومن gEDA أيضًا LED، والبطاريات، والمقاومات المتغيرة، والأزرار، ورموز التغذية (
Vcc،+5V،+3.3V). أي شيء آخر يصبح ملاحظة لاصقة تحمل اسمه، ويذكرها التقرير. - الأطراف والشبكات. لا يذكر أي من الملفين مواضع أطراف القطعة: يحتفظ بها Qucs في برنامجه وgEDA في ملف
.symلكل رمز. يعرف Mokxi أطراف القطع القياسية أعلاه، ويستنتج موضع كل طرف مع تدوير القطعة وعكسها. الأسلاك والشبكات الملتقية تتّصل ببعضها، وتسميات أسلاك Qucs وأسماء شبكات gEDA المتطابقة تكون شبكة واحدة، ورموز تغذية gEDA شبكات مسماة. رمز gEDA المضمَّن في المخطط يحمل أطرافه الخاصة، لذا يُقرأ أيضًا. - لم تُدخَل. كتل المحاكاة (
.DC،.TR)، والمعادلات، والمخططات، وتوجيهات وموديلات SPICE، وكتل العناوين والرسومات: يشغّل Mokxi الدائرة بنفسه، لذا ضع مجسًّا أو ملتيميتر أو راسم إشارة حيث تريد المراقبة. القيمة التي يأخذها Qucs من متغير (R = Rload) تحصل على القيمة الافتراضية في Mokxi، ويذكر التقرير أيّها. - KiCad. ملف
.schمن KiCad بصيغة مختلفة: انظر «من KiCad» أعلاه.
من Falstad CircuitJS
Full guide: من Falstad CircuitJS إلى Mokxi، خطوة بخطوة، مع مثال يفتح هنا.
استخدم أيًّا من هذه:
- رابط. الصق رابط CircuitJS يحتوي على
?ctz=أو?cct=، من قائمة File ثم Export As Link. الدائرة مخزّنة في الرابط نفسه، لذا يقرأها Mokxi من هناك ولا يجلب أي شيء آخر. - النص. الصق النص من File ثم Export As Text، أو أفلت ملف دائرة محفوظًا. تُقرأ الصيغة النصية القديمة وصيغة XML الأحدث كلتاهما.
ما ينتقل: المقاومات، المكثفات، الملفات، مصادر الجهود المستمرة ومسارات التغذية، المصادر الجيبية والمربعة والمثلثية والمنشارية والنبضية (كمولّد)، الأرضي، المفاتيح، الدايودات، الزينر، LED بألوانها، ترانزستورات NPN وPNP، ترانزستورات MOSFET، مكبرات العمليات، المقاومات المتغيرة، المتكاملة 555، مقاومات الضوء LDR، الثيرمستورات، محركات التيار المستمر، البوابات المنطقية (أكثر من مدخلين تتحول إلى سلسلة بوابات بمدخلين)، العواكس، المداخل والمخارج المنطقية، القلابات D وJK، العدادات، المُركِّبات والمفاتيح التناظرية (كشرائح 74HC وCD4000 مع تغذيتها)، المرحلات، المصابيح، الشاشات ذات الأجزاء السبعة وشاشات الأرقام، والفولتميترات والأميترات (كملتيميتر). العقد المسماة تربط كل عقدة تحمل الاسم نفسه، والنص يصبح ملاحظة لاصقة.
أمران مختلفان في Mokxi، ويذكر التقرير ذلك: مكبر العمليات في CircuitJS يعمل دون أسلاك، لذا يضيف الاستيراد له تغذية وأرضيًا؛ وCircuitJS لا يحتاج رمز أرضي، فأضف واحدًا عند نقطة 0 V في الدائرة إن لم يكن لديها واحد. كل عنصر آخر (محولات، خطوط نقل، دوائر فرعية مخصصة وما شابه) يصبح ملاحظة وردية تذكر اسمه.
من Tinkercad
Full guide: من Tinkercad إلى Mokxi، خطوة بخطوة، مع مثال يفتح هنا.
يمكن لـ Tinkercad Circuits تصدير الدائرة كملف لوحة يحتوي على كل قطعة وكل سلك. ومع الكود بجانبه، ينتقل المشروع كاملًا موصولًا:
- الدائرة. افتح الدائرة في Tinkercad، اضغط تصدير ونزّل ملف
.brd. - الكود. افتح الكود، بدّل إلى نص، واضغط زر التنزيل لحفظ
.ino(أو حدد الكود كله وانسخه). - أفلِت الملفين على صفحة الاستيراد أو على المحرر، معًا.
يضع Mokxi كل قطعة يملكها في موضعها: لوحة Uno وmicro:bit، وLED بألوانها، وLED RGB، والمقاومات والمقاومات المتغيرة بقيمتها، والأزرار، والمفاتيح المنزلقة ومفاتيح DIP، والبيزو، ومحركات السيرفو، ومحركات التيار المستمر ومحركات التروس، وTMP36، ومقاومات الضوء والترانزستورات الضوئية، وHC-SR04، وPIR، ومستقبل الأشعة تحت الحمراء، وحساسات التربة والقوة والغاز، ولوحة المفاتيح 4x4، وشاشات LCD مقاس 16x2 وI2C، والشاشات ذات الأجزاء السبعة، وNeoPixels، والترانزستورات، والدايودات، والمكثفات، وبطارية 9 V ومصدر التغذية، والمرحلات، و7805، وL293D، وLM741، و555، وشرائح 74HC وCD4511. كلٌّ منها موصول كما كان في Tinkercad، ويوضع الكود على اللوحة. لوحة التجارب لا تنتقل: مساراتها موجودة بالفعل في التوصيلات. القطعة التي لا يملكها Mokxi (حساس Parallax PING مثلًا) تصبح ملاحظة تذكر اسمها، ويسردها التقرير.
ملف اللوحة لا يحتوي على كود ولا إعدادات مثل جهد مصدر التغذية (يضبط على 5 V) أو عنوان I2C، لذا يذكر التقرير ذلك عندما تكون مهمة.
لا يوجد ملف .brd؟ انسخ جدول Component List (أو نزّله كملف CSV)، والصقه في مربع الاستيراد مع الكود تحته، أو أفلت ملفي .csv و.ino معًا. تصل القطع في صفوف مع قيمها، لتوصيلها بنفسك.
لا يقرأ Mokxi صفحات Tinkercad إطلاقًا: فالرابط من Tinkercad يتطلب تسجيل الدخول، ولذلك تشرح صفحة الاستيراد كيفية التصدير بدلًا من ذلك.
من PlatformIO
Full guide: من PlatformIO إلى Mokxi، خطوة بخطوة، مع مثال يفتح هنا.
أفلت مجلد المشروع، أو ملف مضغوط منه، بحيث يحتوي على platformio.ini في المستوى الأعلى.
- اللوحة تأتي من البيئة التي تُبني افتراضيًا (
default_envs، وإلا فأول[env:...])، ويُقرأ اسمboardفيها بالطريقة نفسها التي يكتبها بها تصدير PlatformIO، ويمكنك اختيار لوحة أخرى. - الكود. يصبح الملف
src/main.cppملفsketch.inoالخاص باللوحة (يعمل#include <Arduino.h>والتصريحات فيه كما هي)، وتُنقل بقية الملفات فيsrc/وinclude/إلى جانبه. أما الملفات داخل المجلدات الفرعية فيsrc/فلا تُنقل، لأن مشروع Mokxi لا يحتوي على مجلدات. - المكتبات. يُفحص كل إدخال في
lib_depsكسطر في ملفlibraries.txtالخاص بـ Wokwi، وتُنقل مكتبات المشروع نفسه منlib/كمكتبات خاصة بالمشروع. أما المكتبة التي يجلبها PlatformIO من رابط Git فتُدرج كمكتبة مفقودة. - أطر العمل الأخرى. يبني Mokxi كود Arduino؛ ويذكر التقرير ذلك عندما يستخدم المشروع إطار عمل آخر مثل ESP-IDF.
من Arduino IDE
Full guide: افتح ملف .ino عبر الإنترنت، مع تخمين اللوحة، والتوصيلات التي يضيفها Mokxi، وكود مثال.
أفلت ملف .ino، أو مجلد الكود بالكامل، أو ملفًا مضغوطًا منه، أو الصق الكود في مربع الاستيراد. كل تبويب .ino أو .h أو .cpp أو .c بجوار الكود يُنقل معه. أما الملفات داخل المجلدات الفرعية للكود (مثل src/) فلا تُنقل، لأن مشروع Mokxi لا يحتوي على مجلدات: انقلها إلى جوار الكود وأدرجها بالاسم.
إذا كان مجلد الكود يحتوي على sketch.yaml (في Arduino IDE 2 وarduino-cli) أو sketch.json (في تنزيل من Arduino Cloud)، فتُؤخذ اللوحة منه، وتُفحص المكتبات، مع سطر depends= الخاص بكل مكتبة في مجلد libraries/. يُحتفظ بملف thingProperties.h الخاص بأكواد Arduino Cloud، لكن اللوحة المُحاكاة لا تستطيع الوصول إلى Arduino IoT Cloud، لذلك تحتفظ متغيرات السحابة بقيمها الابتدائية.
وإلا، فإن Arduino IDE لا يسجّل اللوحة، فيخمّنها Mokxi من الكود: وجود WiFi.h أو ledcWrite يعني ESP32، وESP8266WiFi.h تعني ESP8266، وSerial1 أو الطرف 40 يعني Mega، وA7 يعني Nano، وهكذا. اختر اللوحة الصحيحة من قائمة اللوحة قبل الفتح.
يأتي الكود بدون دائرة، فيوصّل Mokxi دائرة بناءً على ما يقوله الكود: المكتبات التي يتضمنها (Servo وDHT وLiquidCrystal_I2C وAdafruit_SSD1306 وAdafruit_NeoPixel وغيرها)، والأطراف التي يهيّئها ويستخدمها. تحصل كل LED على مقاومتها 220 أوم. يوضّح الملخص ما تم توصيله، مثل «وصّلنا: محرك سيرفو على 9، وLED على 13 (مع 220 أوم)»؛ انقل أو أعد توصيل أي شيء يختلف عن دائرتك. وعندما لا يقول الكود شيئًا عمّا هو موصول، يبدأ المشروع باللوحة وحدها، جاهزة لتوصيلها بنفسك. وللرد على منشور في منتدى بكود شخص ما مُصلحًا ويعمل، استخدم mokxi.com/fix (انظر ساعد شخصًا في إصلاح كوده).
من ملف .hex مُترجم
Drop a compiled program, the .hex file the Arduino IDE saves with
Sketch, Export Compiled Binary, or one somebody sent you, and it runs
as it is: the project opens with the board alone, running that program as the
one uploaded in its لوحة البرنامج الثابت. يبدأ على Uno، أو على Mega 2560 عندما يكون البرنامج أكبر من أن يسع Uno. ملف .hex does
not say which board it was built for, so pick the right one from the Board
list before opening: the list offers the AVR boards whose flash holds it (Uno,
Nano, Mega 2560, Leonardo, Pro Mini and ATtiny85). When the Arduino IDE saved
two, the one without with_bootloader in its name is used.
البرنامج المُترجم لا يحتوي على كود قابل للتعديل. وصّل القطع بأطرافه كالمعتاد؛ ولتغيير ما يفعله، استورد الكود الذي بُني منه بدلًا من ذلك.
رابط Mokxi
رابط Mokxi يُلصق في مربع الاستيراد، مثل mokxi.com/p/... أو رابط مشاركة من المحرر على app.mokxi.com، هو في الأصل مشروع Mokxi، فلا يوجد ما يُستورد: المربع يوضّح ذلك ويفتحه.
اللصق
يقرأ مربع الاستيراد ما تلصقه مساعدات الدردشة والمنتديات: كوداً داخل أسوار Markdown (```)، وملف diagram.json من Wokwi مع كوده في كتلتين ضمن رد واحد، ومشروعاً محاطاً بالكلمات. ويشرح رابطٌ لموقع لا يستطيع Mokxi قراءته أين يحفظ ذلك الموقع المشروع وكيف تنقله إلى هنا (مجلد في Drive، أو رابط OneDrive أو Mega، أو فيديو على YouTube).
صورة أو لقطة شاشة
لا يستطيع Mokxi قراءة صورة لدائرة بحد ذاتها. أفلِت واحدة وسيقدّم الاستيراد خيار نسخ توجيه الصورة: أعطِ ذلك التوجيه مع الصورة إلى ChatGPT أو Claude أو Gemini، ثم الصق جوابه هنا. سيكتب الدائرة بصيغة مشروع Mokxi بالذكاء الاصطناعي ويسرد ما اضطر إلى تخمينه.
من LTspice
Full guide: من LTspice إلى Mokxi، خطوة بخطوة، مع مثال يفتح هنا.
أفلِت المخطط (.asc) على صفحة الاستيراد أو على المحرر، أو الصق نصّه. يحفظ LTspice موقع كل رمز ومسار كل سلك، لا أي الأطراف متصلة ببعضها، لذا يستنتج Mokxi الشبكات بالطريقة نفسها التي يعمل بها LTspice: طرف أو نهاية سلك أو راية على النقطة نفسها تُعدّ عقدة واحدة، ونهاية سلك تهبط على سلك آخر تنضم إليه، والأسلاك التي تتقاطع فقط لا تنضم، والرايات التي تحمل الاسم نفسه تشكّل شبكة واحدة. الراية المسماة 0 هي الأرضي، وتتحول كل واحدة منها إلى قطعة أرضي.
ما ينتقل: المقاومات، والمكثفات (بما فيها القطبية منها)، والملفات الحثية، والدايودات (بما فيها Schottky والزينر)، وLED، والترانزستورات NPN وPNP، وموسفتات القناة N والقناة P، ومصادر الجهد المستمر (كمصدر عائم)، ومصادر الإشارة الجيبية والنبضية (كمولّد، عندما يكون الطرف السالب للمصدر على الأرضي)، ومكبرات العمليات ذات الأطراف الخمسة (UniversalOpamp2، opamp2) عندما يكون طرف التغذية السالب لها على الأرضي. يُحتفظ باسم الموديل إذا كانت لدى Mokxi القطعة نفسها بالضبط (2N3904، 1N4007، IRLZ44N؛ فمجموعة كسب مثل BC337-40 تُعدّ قطعتها)، وإلا فالقطعة هي الافتراضية في Mokxi من نوعها، ويذكر التقرير ذلك. يُستخدم سطر .param لتعبئة {name} في قيمة. وتتحول التعليقات إلى ملاحظات لاصقة.
The simulation commands (.tran, .op, .ac, .step and the rest) are read
into the report's notes. Mokxi runs live, so press Run and watch the nodes
with a scope or a meter; a frequency or DC sweep is not carried.
ما لا يُستورد، وكل واحد منها يتحوّل إلى ملاحظة وردية تسمّيه: مصادر التيار، والمصادر السلوكية، وPWL وغيرها من المصادر الخاصة، ومصدر جيبي أو نبضي طرفه السالب ليس على الأرضي، ومضخم تشغيلي بتغذية سالبة، وكل رمز ليس من الرموز القياسية أعلاه (الدوائر المتكاملة، المفاتيح، خطوط النقل، الدوائر الفرعية)، لأن مواقع أطرافها موجودة في ملف الرمز الذي يحتفظ به LTspice وليست في المخطط. ولا تُستورد بطاقات الموديلات والمكتبات (.model، .lib). ولا حاجة إلى LTspice نفسه، ولا يُنفَّذ أي شيء في الملف.
ملف netlist بصيغة SPICE يصدّره LTspice (View > SPICE Netlist، أو ملف .net، أو .cir) يُفتح كملف netlist، كما في المقطع التالي.
من Proteus وMultisim وCircuitMaker
يحفظ Proteus وMultisim وCircuitMaker تصاميمها في صيغ مغلقة خاصة بها لا تفتحها سواها. من Multisim، اختر نقل، ثم Export Netlist؛ من CircuitMaker، اختر File، ثم Export، ثم SPICE Netlist. افتح .cir بـ حفظ ▾ > فتح JSON أو SPICE. من Proteus، خذ لقطة شاشة واستخدم مطالبة الصورة. ملف netlist من LTspice (.net، من View > SPICE Netlist) يُفتح بالطريقة نفسها كأي ملف SPICE، أما المخطط من LTspice (.asc) فيُستورد مباشرة (انظر من LTspice).
المكتبات
يتحقق التقرير من كل مكتبة يذكرها المشروع، في libraries.txt الخاص بـ Wokwi، وlib_deps الخاص بـ PlatformIO، وأسطر #include في الكود:
- مدمجة افتراضيًا. يبنيها Mokxi كما هي، مثل
Servo.hوLiquidCrystal_I2C.hوAdafruit_SSD1306.hوAdafruit_NeoPixel.hوDHT.h. - استخدمها بدلًا منها. لدى Mokxi مشغّل يقوم بنفس المهمة باسم آخر، ويذكر التقرير أي ملف رأسي يجب تضمينه.
- مفقودة. لا شيء في Mokxi يوفّرها.
ملف zip مع مجلد libraries/ (تخطيط مجلد sketchbook في Arduino)، أو مجلد PlatformIO lib/ المجلد يجلّب مكتباته معه كمكتبات خاصة بالمشروع، في كل الباقات. انظر الباقات.
إخراج مشروع من Mokxi
لا شيء يحبس مشروعًا داخل Mokxi. زر تصدير في رأس المحرر يُنزّل المشروع كمشروع Wokwi (diagram.json و sketch.ino و libraries.txt في ملف مضغوط)، أو كمجلد كود Arduino IDE، أو كمشروع PlatformIO. تصدير Wokxi يجلب القطع والتوصيلات إلى جانب الكود؛ القطع التي لا مقابل لها في Wokwi تُذكر في ملف README الخاص به، وتتحول شرائط لوحة التجارب إلى أسلاك مباشرة.
الأمان
لا يتم تشغيل أي شيء تستورده أثناء قراءته. عمليات الرفع والملفات المضغوطة والنصوص الملصقة لها حد أقصى للحجم؛ المسار الذي يخرج من حدود المشروع (../) أو يبدأ من محرك أقراص يُرفض ويُذكر اسمه في التقرير؛ لا تُحفظ إلا ملفات المصدر والمشروع؛ ملفات XML التي تُعرّف نوع مستند أو كيانات تُرفض، فلا يتم توسيع أي كيان أو جلبه أبدًا؛ ويُفك ضغط رابط CircuitJS بحد أقصى؛ وتخضع ملفات المكتبات لنفس قواعد المكتبة التي تُرفع في المحرر.
Related
- القادمون من Wokwi: كل فكرة من Wokwi بجانب اسمها في Mokxi.
- ساعد أحدهم على إصلاح كوده: كود من منتدى، موصّل ويعمل، مع رد جاهز للصق.
- قوائم netlist لـ SPICE و الشرائح المخصصة.