حل المشكلات

فشل الرفع إلى لوحة حقيقية

ماذا تعني كل رسالة في بطاقة الرفع إلى اللوحة، وما الذي يمكنك تجربته.

ما تراه

يفتح الإرسال إلى اللوحة بطاقة للوحة في مشروعك. تعتمد البطاقة على اللوحة:

  • الرفع إلى اللوحة، مع Uno أو Nano أو Pro Mini أو Mega أو Leonardo أو Micro أو Pro Micro: اضغط ارفع، واختر المنفذ، فيكتب Mokxi الكود عبر USB من Chrome أو Edge.
  • الرفع إلى اللوحة، مع ESP32-C3 DevKitM-1 أو XIAO ESP32-C3 أو ESP32-C3 SuperMini: الأمر نفسه، عبر أداة التحميل الخاصة بالشريحة.
  • التنزيل للوحتك، مع Raspberry Pi Pico أو Pico W أو XIAO RP2040 أو RP2040-Zero أو Nano RP2040 Connect أو XIAO SAMD21 أو micro:bit V2: يبني Mokxi ملف .uf2 أو .hex، وتسحبه إلى محرّك الأقراص الذي تعرضه اللوحة.
  • ضعه على لوحتك، مع كل لوحة أخرى: خطوات Arduino IDE. مع لوحات ESP32 أو ESP32-S3 أو ESP32-C6 أو ESP8266 تتوفر أيضًا اختبار الاتصال، التي تبيّن اسم الشريحة على المنفذ.

كل بطاقة فيها رفع تضم أيضًا اختبار الاتصال، التي لا تكتب شيئًا، وبعد أي محاولة سجل الرفع مطويًا يضم كل بايت أُرسل واستُقبل. اضغط نسخ السجل وألصقه في تقريرك: فهو يخبر أكثر من الرسالة.

While it works the card shows what it is doing, and a message in place of Done. Your sketch is running on the board. when it stops. Find it below. How the cards work is in إرسال برنامج إلى لوحة حقيقية. الرفع والملفات المنزّلة جزء من باقة Pro؛ وتبقى خطوات Arduino IDE مجانية في كل الباقات.

لا يوجد زر «رفع»، أو أن البطاقة تعرض تنزيلًا فقط

ليس لدى Safari وFirefox وكل متصفح على iPad أو iPhone طريقة للوصول إلى لوحة USB. افتح المشروع في Chrome أو Edge على حاسوب أو Chromebook، أو اضغط تنزيل .hex (أو .bin) وأكمل باستخدام Arduino IDE أو أمر avrdude أو esptool الذي تعرضه البطاقة.

تعني عبارة "هذه الصفحة غير مسموح لها باستخدام المنافذ التسلسلية" أن الصفحة داخل شيء يحجبها، مثل إطار موقع آخر. افتح Mokxi في علامة تبويب مستقلة في Chrome أو Edge.

ليس لدى ATtiny85، ولا ATmega328P على لوحة تجارب، أداة تحميل USB. تعرض البطاقة كيفية الكتابة عليه بواسطة مبرمجة بدلًا من ذلك.

اللوحة غير موجودة في قائمة المنافذ

تعني عبارة "لم يُختر أي منفذ" أن القائمة أُغلقت دون اختيار شيء. افتح اللوحة غير موجودة في القائمة؟ في البطاقة، وتحقّق من هذه الأمور، ثم اضغط حاول مرة أخرى:

  • جرّب سلكًا آخر. كثير من الأسلاك للشحن فقط: تُضاء اللوحة، لكن لا يظهر أي منفذ.
  • ثبّت المشغّل. انظر إلى الشريحة الصغيرة بجانب منفذ USB. تحتاج CH340 أو CH341 (معظم النسخ المقلّدة) أو CP2102 إلى مشغّلها على Windows وmacOS؛ وتربط البطاقة برابطه. أما Linux وChromeOS فيضمنانه.
  • أغلق أي شيء آخر يستخدم المنفذ: الشاشة التسلسلية أو الراسم البياني التسلسلي في Arduino IDE، أو PlatformIO، أو علامة تبويب أخرى فيها Mokxi مفتوح.
  • على جهاز Chromebook مدرسي، قد يكون قسم تقنية المعلومات قد عطّل USB على المواقع. اطلب منه السماح بذلك لـ mokxi.com، أو استخدم التنزيل.
  • مع Leonardo أو Micro أو Pro Micro، اضغط reset مرتين بسرعة (مع Pro Micro، المس RST بـ GND مرتين)، ثم اضغط لوحتي تنتظر واخترها خلال ثوانٍ قليلة.
  • مع ESP32-C3، استمر بالضغط على BOOT أثناء توصيلها. تظهر XIAO أو SuperMini باسم "USB JTAG/serial debug unit" ولا تحتاج إلى مشغّل.

"هذا المنفذ قيد الاستخدام"

برنامج واحد فقط يمكنه الإمساك بالمنفذ. أغلق الشاشة التسلسلية في Arduino IDE وأي شيء آخر يستخدم اللوحة، ثم حاول مرة أخرى. على Linux، إن لم يكن لديك شيء آخر يفتحه، فقد يحتاج حسابك إلى أن يكون ضمن مجموعة dialout: تعطيك الرسالة الأمر المطلوب.

"لم يُعثر على لوحة" أو "لم تُجب أي لوحة على هذا المنفذ"

انفتح المنفذ لكن لم يُجب أي محمّل تخزين. تنتهي الرسالة بعبارة "اضغط اختبار الاتصال لتعرف ما هو متصل بهذا المنفذ." افعل ذلك: فهو يجرب كل محمّل تخزين يتحدث Mokxi لغته ويذكر اسم ما يُجيب. وإلا فتحقّق من أن:

  • اللوحة التي اخترتها في Mokxi هي نفسها اللوحة الموصولة بالكابل؛
  • الكابل ينقل البيانات؛
  • اخترت المنفذ الصحيح.

على نسخة Nano مقلّدة، اختر Arduino Nano (old bootloader) في قائمة اللوحة على البطاقة وحاول مرة أخرى. على ESP32-C3، اضغط باستمرار على BOOT، واضغط RESET بلمسة سريعة، ثم اترك BOOT واضغط «رفع» مرة أخرى.

"لم يُجب أي محمّل تخزين على هذا المنفذ، بأي سرعة"

طلب اختبار الاتصال كل محمّلات التخزين ولم يُجب أحد. تحقّق من الكابل (بعضها للشحن فقط)، ومن المنفذ، ومن أنه لا يوجد شيء آخر يحتكره. على لوحة ESP، اضغط باستمرار على BOOT، واضغط RESET بلمسة سريعة، ثم اترك BOOT واختبر مرة أخرى. أما Leonardo أو Micro أو Pro Micro فيتطلب الضغط على زر إعادة التعيين مرتين أولًا، ثم لوحتي تنتظر.

"وجدت ...، لكن المشروع مخصص لـ ..."

وجد اختبار الاتصال لوحة، لكنها ليست الموجودة في مشروعك. تذكر الرسالة ما وجدته (الشريحة، أو بصمتها، أو معرّف الشريحة، ومحمّل التخزين) واللوحة التي يجب اختيارها في Mokxi: "وجدت ATmega2560 (بصمة 1E 98 01)، وهي الشريحة في Arduino Mega 2560، ... لكن المشروع مخصص لـ Arduino Uno التي تحمل ATmega328P. اختر Arduino Mega 2560 في Mokxi، أو وصّل Arduino Uno." اختر تلك اللوحة، أو وصّل اللوحة الصحيحة، واختبر مرة أخرى.

تعني عبارة "الشريحة صحيحة، لكن محمّل التخزين يُجيب بسرعة 57600 baud وليس 115200" أنها نسخة Nano مقلّدة بمحمّل التخزين القديم: تبدّل البطاقة قائمة اللوحة إلى Arduino Nano (old bootloader) من أجلك. اضغط «رفع».

"تحتوي هذه اللوحة على ...، وليس ..." أو "هذه ...، لكن المشروع مخصص لـ ..."

وصل الرفع إلى محمّل تخزين، لكن الشريحة ليست تلك التي بُني الكود من أجلها: "تحتوي هذه اللوحة على ATmega2560 (بصمة 1E 98 01)، وهي الشريحة في Arduino Mega 2560، وليس ATmega328P الموجودة في Uno أو Nano. اختر Arduino Mega 2560 في Mokxi وحاول مرة أخرى." أو "هذه ESP32-S3، لكن المشروع مخصص لـ ESP32-C3. اختر لوحة ESP32-S3 (...) في Mokxi وحاول مرة أخرى، أو وصّل ESP32-C3." لم يُكتب شيء. اختر اللوحة التي تملكها فعلًا في Mokxi، وارفع مرة أخرى.

"توقّف الاختبار. لم يُكتب شيء إلى اللوحة."

ضغطت إيقاف أثناء اختبار الاتصال. لم يتغيّر شيء على اللوحة.

توقّف في منتصف الطريق

تعني عبارات "توقفت اللوحة عن الإجابة في منتصف العملية"، و"أجابت بشيء غير متوقع"، و"أجابت مرة ثم سكتت"، و"توقّفت الكتابة عند البايت ..."، و"توقفت اللوحة عن قبول البيانات"، و"تم فصل اللوحة" جميعها أن الحوار انقطع. افصل اللوحة، وأعد توصيلها، وحاول مرة أخرى. السبب المعتاد هو كابل مفكوك أو وصلة USB وسيطة. على ESP32-C3، اضغط باستمرار على BOOT، واضغط RESET بلمسة سريعة، ثم اترك BOOT أولًا.

"قرأت اللوحة شيئًا مختلفًا عما كُتب"

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

"توقّف الرفع"

ضغطت إيقاف. محمّل التخزين على اللوحة سالم، لكنها قد لا تشغّل أي كود حتى يُكتب واحد، لذا اضغط «رفع» مرة أخرى.

"هذا الكود لا يُبنى بعد"

There is nothing to send until the code builds. Fix the error the card names (see أخطاء البناء بكلمات بسيطة)، ثم اضغط «رفع» مرة أخرى.

"يستخدم هذا الكود WiFi، وهي التي يحاكيها Mokxi"

شبكة WiFi في Mokxi محاكاة، لذا لا يمكن رفع كود يستخدمها أو تنزيله من Mokxi بعد. ارفع كودًا بدون WiFi، أو ابنِ هذا الكود في Arduino IDE باسم شبكتك وكلمة مرورك. انظر WiFi.

لا يظهر محرك الأقراص، أو لا يبدأ الكود

بالنسبة للوحات التنزيل، تذكر البطاقة الخطوات:

  • Pico و Pico W: اضغط باستمرار على BOOTSEL أثناء توصيلها، ثم اتركه. ينفتح محرك أقراص باسم RPI-RP2. اسحب ملف .uf2 إليه.
  • XIAO RP2040 و RP2040-Zero: اضغط باستمرار على BOOT (المعلّم بحرف B على XIAO) أثناء توصيلها. ينفتح محرك أقراص RPI-RP2.
  • Nano RP2040 Connect: صِل طرف REC بطرف GND أثناء توصيلها، ثم أزل السلك. ينفتح محرك أقراص RPI-RP2.
  • XIAO SAMD21: المس نقطتي RST معًا مرتين بسرعة. ينفتح محرك أقراص. اسحب ملف .uf2 إليه.
  • micro:bit V2: ينفتح محرك أقراص باسم MICROBIT عند توصيلها. اسحب ملف .hex إليه.

يُغلق محرك الأقراص من تلقاء نفسه ويبدأ الكود. على لوحات RP2040 و XIAO SAMD21، يخرج المخرج التسلسلي من طرفين لا عبر كابل USB: وتذكر البطاقة اسميهما. استخدم محوّل USB تسلسلي بجهد 3.3V لقراءته. على Pico W، لا تضيء LED المدمجة من هذا التنزيل: استخدم LED على طرف GP.

ما زلت عالقًا

راسلنا من /support مع اسم اللوحة، والرسالة الدقيقة، والمتصفح الذي استخدمته، وسجل الرفع من البطاقة (افتحه أسفل الرسالة واضغط نسخ السجل).