الجواب المختصر
اضغط إرسال إلى اللوحة في رأس المحرر (يقع بجانب تصدير). تفتح بطاقة بالخطوات المناسبة للوحتك ومتصفحك. إرسال الكود إلى لوحة حقيقية، عبر الرفع أو عبر ملف .hex أو .bin أو .uf2، هو ميزة ضمن باقة Pro، وفي الباقة المجانية يعرض الزر ما تقدمه باقة Pro ويوفر تجربة مجانية لمدة 7 أيام (يلزم إدخال بطاقة، ولا يُخصم أي مبلغ إذا ألغيت قبل انتهائها). البناء والمحاكاة يبقيان مجانيين، وخطوات Arduino IDE لأي لوحة تبقى مجانية في كل الباقات، والطلاب في الفصل والأطفال دون 13 عامًا يواصلون الإرسال إلى اللوحات أيًا كانت الباقة.
- Chrome أو Edge على حاسوب أو Chromebook: يبني Mokxi الكود ويكتبه إلى اللوحة عبر سلك USB. اضغط رفع واختر منفذ اللوحة.
- Safari أو Firefox أو iPad أو iPhone: لا تستطيع هذه المتصفحات التواصل مع لوحة USB، لذا لا يوجد زر رفع يعمل. تخبرك البطاقة بذلك، وتعطيك الملف لتنزيله وخطوات الإكمال عبر Arduino IDE.
ما تحصل عليه كل لوحة
| اللوحة | في Chrome أو Edge | في أي متصفح آخر |
|---|---|---|
| Arduino Uno، Nano، Mega 2560، Leonardo، Micro، Pro Mini، Pro Micro | رفع عبر USB | نزّل ملف .hex، ثم Arduino IDE أو avrdude |
| ESP32-C3 DevKitM-1، XIAO ESP32-C3، ESP32-C3 SuperMini | رفع عبر USB (يقول الزر رفع إلى اللوحة) | نزّل ملف .bin، ثم esptool أو Arduino IDE |
| Raspberry Pi Pico، Pico W، XIAO RP2040، RP2040-Zero، Nano RP2040 Connect، XIAO SAMD21 | ملف .uf2 تسحبه إلى وحدة تخزين USB الخاصة باللوحة | الملف نفسه، من حاسوب |
| micro:bit V2 | ملف .hex تسحبه إلى وحدة MICROBIT | الملف نفسه، من حاسوب |
| ATtiny85، ATmega328P على لوحة تجارب | نزّل ملف .hex واكتبه باستخدام مبرمجة (USBasp، أو Uno تعمل بـ ArduinoISP) | الأمر نفسه |
| لوحات ESP32 وESP32-S3 وESP32-C6 وESP8266 بدون خيار رفع | ضعه على لوحتك: خطوات Arduino IDE، بالإضافة إلى اختبار الاتصال، الذي يذكر الشريحة الموجودة على المنفذ | خطوات Arduino IDE |
| كل لوحة أخرى (Uno R4، STM32) | ضعه على لوحتك: خطوات Arduino IDE الخاصة بتلك اللوحة | الأمر نفسه |
اختبار الاتصال
كل بطاقة فيها زر رفع، وبطاقة Arduino IDE لكل لوحة ESP، فيها أيضًا اختبار الاتصال. لا يكتب شيئًا. يطلب المنفذ، ويعيد تشغيل اللوحة، ويجرّب كل محمّل إقلاع يتحدث معه Mokxi (محملات Arduino بسرعتي 115200 و57600 باود، ومحمّل Mega، ومحمّل شريحة ESP)، ويقرأ توقيع الشريحة أو معرّفها، ويدع الكود الذي كان على اللوحة يعمل مرة أخرى. ثم يخبرك بما وجده وما إذا كانت هي اللوحة المخصصة للمشروع:
- "تم العثور على ATmega328P (بالتوقيع 1E 95 0F)، وهي الشريحة الموجودة في Uno أو Nano أو Pro Mini، مع محمّل إقلاع Arduino بسرعة 115200 باود. هذا يطابق Arduino Uno. جاهز للرفع."
- "تم العثور على ESP32-S3، في محمّل الشريحة الخاص بها، لكن المشروع مخصص لـ ESP32-C3 DevKitM-1 (ESP32-C3). اختر لوحة ESP32-S3 (...) في Mokxi وحاول مرة أخرى، أو وصّل ESP32-C3 DevKitM-1."
- على Nano، عندما تكون النسخة تحمل محمّل الإقلاع القديم: تنتقل قائمة اللوحة في البطاقة تلقائيًا إلى Arduino Nano (old bootloader) من أجلك.
اضغطه أولًا عندما لا تكون متأكدًا أي لوحة متصلة بالكابل، أو أي منفذ هو أي واحد، أو ما إذا كان الكابل والتعريف يعملان أصلًا. على Leonardo أو Micro أو Pro Micro يعيد تشغيل اللوحة ويطلب منك اختيار المنفذ مرة أخرى، كما يفعل الرفع.
سجل الرفع
بعد أي عملية رفع أو اختبار اتصال، تعرض البطاقة سجل الرفع مطويًا. يحتوي على كل بايت أُرسلت إلى اللوحة أو استُقبلت منها، وكل تغيير في خطوط إعادة التشغيل، ووقت كل ذلك، مع اسم اللوحة والشريحة والمتصفح في الأعلى. لا يحتوي على أي شيء شخصي. اضغط نسخ السجل أو تنزيل السجل وألصقه في تقرير: به يمكن قراءة سبب الفشل دون أن تكون اللوحة على المنضدة. زر «أخبرنا» بجانب أي خطأ يرسله تلقائيًا.
لا يمكن بعد إرسال كود يستخدم WiFi من Mokxi (على ESP32-C3 أو Pico W)، لأن WiFi هنا محاكى. أرسل كودًا بدون WiFi، أو ابنِ ذلك الكود في Arduino IDE باسم شبكتك وكلمة مرورك.
على Pico أو Pico W أو XIAO RP2040 أو RP2040-Zero، يخرج Serial على الطرفين GP0 (TX) وGP1 (RX) في اللوحة الحقيقية (طرفا TX وRX على Nano RP2040 Connect)، وليس عبر كابل USB: اقرأه باستخدام محوّل تسلسلي USB بجهد 3.3V.
كيف أرسل برنامجًا إلى Uno الخاص بي؟
- افتح مشروعك في Chrome أو Edge على حاسوب أو Chromebook.
- وصّل Uno به عبر كابل USB.
- اضغط إرسال إلى اللوحة ثم اختبار الاتصال، واختر منفذ Uno من القائمة التي يعرضها المتصفح. تخبرك البطاقة بما وجدته؛ وعبارة «جاهز للرفع» تعني أن الخطوة التالية ستنجح.
- اضغط رفع واختر المنفذ نفسه.
- انتظر حتى يكتمل الشريط. يكتب Mokxi الكود، ويقرأ كل بايت مرتدًا، وعندها فقط يعرض تم. الكود يعمل الآن على اللوحة.
إذا كانت القائمة فارغة أو لم تكن لوحتك فيها، انظر القسم التالي. إذا فشل الرفع مرة واحدة، أغلق Arduino IDE وأي شاشة تسلسلية أولًا: برنامج واحد فقط يمكنه حجز المنفذ.
قائمة المنافذ فارغة، أو لوحتي ليست فيها
يعرض المتصفح اللوحات التي يراها فقط. عندما تكون لوحتك مفقودة، تفتح البطاقة اللوحة ليست في القائمة؟ مع هذه الفحوصات وزر حاول مرة أخرى:
- كابل بيانات. كثير من كابلات USB للشحن فقط: تضيء اللوحة لكن لا يظهر أي منفذ. جرّب كابلًا تعرف أنه ينقل البيانات.
- تعريف شريحة USB. انظر إلى الشريحة الصغيرة بجانب منفذ USB في اللوحة، ثبّت تعريفها، ثم افصل اللوحة وأعد توصيلها.
- CH340 or CH341 (most clones): Windows، macOS. Linux وChromeOS يضمّنانه افتراضيًا.
- CP2102 or CP2104: Windows وmacOS. Linux وChromeOS يضمّنانه افتراضيًا.
- لا تحتاج لوحات Uno أو Mega أو Leonardo الأصلية إلى شيء على macOS أو Linux أو ChromeOS؛ وعلى Windows، يؤدي تثبيت Arduino IDE إلى إضافة تعريفها.
- ESP32-C3 على منفذ USB الخاص بها (XIAO أو SuperMini، وتظهر باسم "USB JTAG/serial debug unit") لا تحتاج إلى تعريف. إذا لم تظهر في القائمة، استمر بالضغط على BOOT أثناء توصيلها.
- لا شيء آخر يستخدم المنفذ. أغلق الشاشة التسلسلية وراسم المنحنيات في Arduino IDE، وPlatformIO، وأي تبويب آخر فيه Mokxi مفتوح. اللوحة التي تظهر في القائمة لكنها لا تفتح يحتجزها عادةً أحد هذه البرامج. على Linux، إن لم يكن هناك شيء آخر يحتجزها، أضف نفسك إلى مجموعة
dialout(sudo usermod -aG dialout $USER)، ثم سجّل الخروج وسجّل الدخول مرة أخرى. - Chrome أو Edge على حاسوب. لا يستطيع Safari وFirefox وكل متصفح على iPhone أو iPad الوصول إلى لوحات USB، لذا تعطيك البطاقة ملف .hex أو .bin لتنزيله بدلًا من ذلك، مع خطوات Arduino IDE.
كيف أنقل برنامجي إلى Arduino من iPad؟
يعمل Mokxi في Safari على iPad: يمكنك بناء الدائرة وكتابة الكود وتشغيله هناك. الإرسال إلى لوحة هو الشيء الوحيد الذي لا يستطيع iPad فعله، لأن Safari، وChrome على iPad (وهو Safari في الأساس)، لا يملكان طريقة للوصول إلى لوحة USB.
طريقتان للإنهاء:
- استخدم حاسوبًا للخطوة الأخيرة. سجّل الدخول، وافتح المشروع نفسه على حاسوب فيه Chrome أو Edge واضغط إرسال إلى اللوحة. مشاريعك محفوظة في حسابك، لذا تتبعك أينما ذهبت.
- نزّل الملف واستخدم Arduino IDE. اضغط إرسال إلى اللوحة ثم تنزيل .hex، ثم افتحه في Arduino IDE (أو انسخ الكود إليه) على حاسوب.
على Chromebook
يمتلك Chrome على Chromebook وصولًا إلى USB، لذا يعمل الرفع للوحات في الجدول أعلاه دون تثبيت أي شيء. على Chromebook تديره المدرسة يمكن للمشرف تعطيل وصول USB (سياسة DefaultSerialGuardSetting). إذا بقيت قائمة المنافذ فارغة، اطلب من فريق تقنية المعلومات السماح به لموقع mokxi.com، أو استخدم خطوات التنزيل بدلًا من ذلك.
استخدام الملف المنزّل
بالنسبة للوحات Arduino، تعرض البطاقة سطر avrdude الخاص بلوحتك. في Arduino IDE يمكنك أيضًا نسخ الكود (نسخ الكود)، واختيار لوحتك من الأدوات ثم اللوحة والضغط على Upload. أما ESP32-C3 فتعرض البطاقة سطر esptool والإزاحة التي يُكتب عندها ملف .bin.
Related
- تصدير وتنزيل: كل الملفات التي ينشئها Mokxi، بما فيها الكود كملف zip لـ Arduino IDE أو PlatformIO.
- تشغيل برنامج ثابت جاهز: العكس: ملف بنيته تشغّله في Mokxi.
- تثبيت Mokxi كتطبيق