تعلّم

Arduino "exit status 1": ماذا يعني وأين يوجد الخطأ الحقيقي

مبتدئ

أو تصفّح كل الدروس.

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: اقرأ مقياسًا دائريًا، جاهز للكسرمباشر0.000 s 0.00x
اضغط لفتحه في المحرر
أدِر المقياس الدائري؛ سيطبع الكود قراءته على الشاشة التسلسلية في المحرر. افتحها، اكسر سطرًا، ثم اضغط «تشغيل» لقراءة لسان البناء.

"exit status 1" ليست رسالة خطأ. إنها آخر سطر يطبعه Arduino IDE عندما يتوقف برنامج شغّله، المترجم أو أداة الرفع، ويُبلغ عن فشل. كل فشل ينتهي بها، من فاصلة منقوطة ناقصة إلى لوحة غير موصولة، ولهذا السبب فإن البحث عنها وحدها يعطيك ألف إجابة مختلفة.

الرسالة الحقيقية توجد فوقها. تشرح هذه الصفحة أين تجدها، وكيف تُصلح الرسائل القليلة التي تقف خلف معظمها. الدائرة في الأعلى تقرأ مقياسًا دائريًا على A0 وتطبع قراءته؛ افتحها في المحرر واكسرها عمدًا للتدرّب على قراءة البناء.

أين تنظر

في Arduino IDE 1.8 تكون الأسطر الأخيرة exit status 1 وError compiling for board Arduino Uno. مع اسم اللوحة التي اخترتها. أما Arduino IDE 2 فيعرض Compilation error: exit status 1 في نافذة منبثقة، أو يضع نص أول خطأ مكانها. في الحالتين، مرّر المخرجات إلى أعلى حتى أول سطر يحتوي على error:. يبدأ باسم ملف ورقمين، مثل sketch.ino:12:5: error:، وهما رقم السطر ورقم العمود.

إذا كانت المخرجات قصيرة ولا يظهر فيها سطر خطأ، فعّل File ثم Preferences ثم "Show verbose output during compilation" وأعد البناء. وخيار "Compiler warnings: All" في المكان نفسه يعرض التحذيرات أيضًا، وهي كثيرًا ما تشير إلى الخلل الحقيقي في كود يُترجم بنجاح لكنه لا يعمل كما ينبغي.

لا يوجد في Mokxi سطر exit status. تبويبة البناء فيها تعرض رسائل المترجم نفسها كأسطر يمكنك الضغط عليها، وكل سطر ينقلك إلى ملفه وسطره وعموده، وكل خطأ يُخطَط تحته في سطره داخل المحرر.

إذا فشلت الترجمة

خطأ في الصياغة أو الاسم له رقم سطر وهو في الكود الخاص بك. أكثر الخطأين شيوعًا، "was not declared in this scope" و"expected ';' before"، لكل منهما صفحة خاصة، والرابط إليها في أسفل هذه الصفحة.

المكتبة المفقودة تظهر بهذا الشكل LiquidCrystal_I2C.h: No such file or directory (clang: 'LiquidCrystal_I2C.h' file not found). تعليمة #include تشير إلى ملف ترويسة لا يستطيع الـ IDE إيجاده، لأن المكتبة غير مثبّتة أو لأن اسمها مكتوب بشكل مختلف. ثبّتها من «أدوات» ثم «إدارة المكتبات». في Mokxi المكتبات الشائعة موجودة مسبقًا بأسمائها المعتادة، وبالنسبة لغيرها تعرض لك تبويبة البناء تثبيت مكتبة من نفس Arduino Library Manager.

خطأ الرابط (linker) لا يحمل رقم سطر. رسالة undefined reference to 'loop' (Mokxi: undefined symbol: loop()) تعني أن الكود لا يحتوي على loop() إطلاقًا، أو أنها مكتوبة Loop. أما multiple definition of فتعني عادة وجود نسختين من مكتبة، أو نسخ ملف .cpp الخاص بمكتبة إلى مجلد الكود. يعرض الـ IDE قائمة المكتبات التي استخدمها تحت عبارة "Multiple libraries were found"، وهذه القائمة هي أول ما يجب فحصه.

نقص الذاكرة هو النوع الأخير. عبارة "Sketch too big" تعني أن البرنامج لا يتسع في ذاكرة الفلاش، وعبارة "Not enough memory" أو data section exceeds available space in board تعني أن المتغيرات العامة لا تتسع في 2 KB من ذاكرة RAM الخاصة بـ Uno؛ يقول Mokxi global variables do not fit in the 2 KB SRAM. النص داخل Serial.print("...") هو السبب المعتاد على Uno. وإذا غُلّف بـ F("...") يبقى في الفلاش ولا يستهلك أي RAM، في Mokxi كما على Uno حقيقي، ويمكن نقل الجدول الكبير إلى الفلاش باستخدام PROGMEM؛ ودليل الذاكرة المنخفضة يقيس كليهما.

كود المقبض، مع نصّه في الفلاش؛ أفسد شيئًا واحدًا في كل مرة
const int KNOB = A0;

void setup() {
  Serial.begin(9600);
  Serial.println(F("Knob on A0"));
}

void loop() {
  int raw = analogRead(KNOB);
  Serial.print(F("A0 = "));
  Serial.println(raw);
  delay(200);
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

إذا فشل الأمر أثناء الرفع

عندما تظهر رسالة exit status 1 بعد أن تقول الحالة إن الرفع جارٍ، فهذا يعني أن الكود تُرجم بنجاح وأن avrdude، أي برنامج الرفع، هو من فشل. الأسطر التي تسبقها تبدأ بـ avrdude:. الأكثر شيوعًا هو stk500_getsync(): not in sync، ويعني أن محمّل الإقلاع على اللوحة لم يرد أبدًا، وتبدأ قائمة التحقق الخاصة به بالمنفذ، وعلى نسخة Nano مقلّدة بإعداد Old Bootloader.

تدرّب على الكود أعلاه: احذف الفاصلة المنقوطة بعد Serial.begin(9600)، ثم اكتب KNOB بالشكل Knob، ثم احذف آخر قوس إغلاق، خطأ واحد في كل مرة. كل حالة تعطي خطأ أول مختلفًا، وفي كل مرة يكون هذا الخطأ الأول هو ما يجب قراءته.

عندما تطلب المساعدة

إذا بقي الخطأ الأول بلا معنى، فاسأل، لكن أحضر الأسطر الصحيحة. لا يمكن الرد على منشور في منتدى يقول فقط "exit status 1"، لأنه السطر نفسه في كل فشل. انسخ أول سطر يحتوي على error: والسطرين أو الثلاثة التي تليه، والتي تعرض الكود الذي يشير إليه، واذكر أي لوحة اخترت وأي إصدار من الـ IDE تستخدم.

ثم انشر الكود كاملًا، داخل وسوم الكود في المنتدى حتى تنجو علامات الاقتباس والأقواس فيه. معظم الأخطاء تقع على بُعد أسطر قليلة فوق المكان الذي أُبلغ عنه، ومن يساعدك يحتاج تلك الأسطر أيضًا. إذا كان الكود يستخدم مكتبة، فسمِّها واذكر من أين جاءت، لأن عدة مكتبات تتشارك نفس اسم ملف الترويسة.

افتح هذه الدائرة في المحرر. Arduino Uno: قراءة مقبض، على وشك التعطل، موصّل أثناء تشغيله أعلى هذه الصفحة. غيّر قطعة أو قيمة واضغط «تشغيل» مرة أخرى.

افتح الدائرة

الأسئلة

هل حالة الخروج 1 خطأ ترجمة أم خطأ رفع؟

كلاهما ممكن. فهي تخبرك فقط أن آخر برنامج شغّله الـ IDE قد فشل. إذا كانت الأسطر التي فوقها تبدأ باسم ملف و"error:"، فهذا يعني أن الكود لم تتم ترجمته؛ وإذا بدأت بـ "avrdude:"، فهذا يعني أن الرفع قد فشل.

ماذا يعني "Error compiling for board Arduino Uno"؟

أن الكود لم تتم ترجمته للوحة المحددة في Tools ثم Board. والسبب هو أول سطر "error:" فوقها. الكود المكتوب للوحة مختلفة، مثلًا باستخدام Serial1، قد تتم ترجمته على تلك اللوحة ويفشل على Uno.

كيف أرى الخطأ كاملًا في Arduino IDE؟

كبّر لوحة المخرجات، ومرّر إلى الأعلى، وفعّل في File ثم Preferences خيار "Show verbose output during compilation". وإذا بحثت عن الخطأ، انسخ أول سطر خطأ، لا السطر الأخير.

هل يعرض Mokxi حالة الخروج 1؟

لا. تبين تبويبة البناء رسائل المترجم نفسه، وكل رسالة قابلة للنقر للانتقال إلى سطرها، والرفع الفاشل يشرح سببه بالكلمات. الرسائل صادرة عن clang، لذا تختلف صياغتها عن رسائل GCC التي يعرضها Arduino IDE.

ابنِ هذا على أرض الواقع

افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.