تعلّم

كيف تصحح أخطاء كود Arduino، من الطباعة التسلسلية إلى نقاط التوقف

مبتدئ

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: مقبض وLEDمباشر0.000 s 0.00x
اضغط لفتحه في المحرر
مقاومة متغيرة على A0 تتحكم بLED على الطرف 9. افتحها، والصق المثال المحلول، وأدر المقبض والشاشة التسلسلية مفتوحة.

ليس على Arduino شاشة، فعندما يسلك الكود سلوكًا غريبًا لا يمكنك رؤية ما يجري في خلده. كذلك لا يمكن التنقل خطوة بخطوة في Uno وNano الكلاسيكيين داخل Arduino IDE: مصحح أخطاء الـIDE يدعم لوحات أحدث معينة، وليس لوحات AVR التي تستخدمها أغلب الفصول والمجموعات. لذلك يصحح معظم الناس أخطاءهم باستخدام Serial.print، وهو يفيد فعلًا متى استخدمته عن قصد.

هذه الصفحة طريقة لتضييق الخلل، ثم ثلاث أدوات: الطباعة، والرسم البياني، وإيقاف اللوحة عند سطر معين. الدائرة أعلاه هي Uno مع مقاومة متغيرة على A0 وLED على الطرف 9، وهذا يكفي لعرض الأدوات الثلاث، بما في ذلك خلل حقيقي يحدث على Uno فقط.

اجعل الخلل صغيرًا قبل مطاردته

اكتب ما توقعت وما حدث فعلًا، في جملة واحدة لكل منهما. «يجب أن يزداد سطوع الLED تدريجيًا مع إدارة المقبض، لكنه يصبح ساطعًا ثم معتمًا ثم ساطعًا» خلل يمكنك اختباره؛ أما «لا يعمل» فليس خللًا قابلًا للاختبار.

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

Serial.print، عن قصد

ابدأ المنفذ في setup() باستخدام Serial.begin، وعلى لوحة حقيقية اضبط الشاشة التسلسلية على معدل الباود نفسه، وإلا حصلت على رموز غير مفهومة. اطبع شيئًا ما مرة واحدة في نهاية setup(). إذا ظهر ذلك السطر مرارًا وتكرارًا، فاللوحة تُعاد تهيئتها، وهذا يعني عادة أن محركًا أو محرك سيرفو يسحب الجهد إلى الأسفل.

ضع تسمية لكل قيمة، فيكون button: pressed بدلًا من مجرد 0. اطبع عند تغيّر شيء، لا في كل دورة عبر loop()، فذلك يغرق الشاشة أسرع من أن تقرأها. وضمّن الطباعات داخل macro، بحيث يمكن إيقافها من مكان واحد بدلًا من حذفها وإعادة كتابتها عند عودة الخلل.

طباعات موسومة، عند التغيير، خلف مفتاح واحد
#define DEBUG 1

#if DEBUG
#define DEBUG_PRINT(x) Serial.print(x)
#define DEBUG_PRINTLN(x) Serial.println(x)
#else
#define DEBUG_PRINT(x)
#define DEBUG_PRINTLN(x)
#endif

const int BUTTON_PIN = 2;
int lastState = HIGH;

void setup() {
  Serial.begin(115200);
  pinMode(BUTTON_PIN, INPUT_PULLUP);
  DEBUG_PRINTLN("setup done");  // printed again on every reset
}

void loop() {
  int state = digitalRead(BUTTON_PIN);
  if (state != lastState) {  // print on a change, not on every pass
    DEBUG_PRINT("button: ");
    DEBUG_PRINTLN(state == LOW ? "pressed" : "released");
    lastState = state;
  }
}

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

الطباعة تستغرق وقتًا

يستغرق كل محرف نحو ملي ثانية للإرسال عند 9600 باود، فالسطر من 20 محرفًا يكلف نحو 20 ميلي ثانية. تخفي Uno الحقيقية أول 64 بايت في ذاكرة إرسال مؤقتة، لكن كودًا يطبع في كل دورة يملؤها سريعًا ثم ينتظر عند كل محرف. استخدم 115200 باود، وهو أسرع باثني عشر ضعفًا، واطبع أقل.

ولهذا السبب أيضًا تختفي بعض العلل أحيانًا عند إضافة طباعة. إذا أصلح الخللَ إبطاءُالكود، فالخلل يتعلق بالتوقيت: قراءة زر سريعة أكثر من اللازم، أو قراءة حساس قبل جهوزيته، أو مقاطعة تسبق الحلقة الرئيسية. هذا دليل، وليس إصلاحًا. لا تطبع داخل معالج مقاطعة إطلاقًا؛ اضبط علمًا هناك واطبع من loop().

مثال محلول: المعدّل الذي يصبح سالبًا

إليك خللًا حقيقيًا. يأخذ الكود معدل 64 قراءة للمقاومة المتغيرة لتنعيمها. مع دائرة التعتيم أعلاه والمقبض عند 100، يطبع total:6400 average:100، وهذا صحيح. أدر المقبض إلى المنتصف، 512، فيطبع total:-32768 average:-512. وعند الأقصى، 1023، يطبع total:-64 average:-1.

تجعل الطباعات السبب مرئيًا: المجموع خاطئ، فحساب المتوسط ليس المشكلة. على Uno يكون int بعرض 16 بتًا ويحمل 32,767 كحد أقصى، و64 قراءة بقيمة 1023 تجمع إلى 65,472، فيلتف المجموع إلى قيمة سالبة. الكود نفسه يعمل على ESP32 حيث يكون int بعرض 32 بتًا، وهذا بالضبط نوع الاختلاف الذي يجعل الخلل يبدو عشوائيًا. الإصلاح هو long total = 0;. لولا طباعة المجموع، لرأيت متوسطًا سيئًا فقط ولبحثت على الأرجح في المكان الخطأ.

الخلل، وإصلاحه بكلمة واحدة في التعليق
const int SENSOR_PIN = A0;

void setup() {
  Serial.begin(115200);
}

void loop() {
  int total = 0;  // the bug: make this long
  for (int i = 0; i < 64; i++) {
    total += analogRead(SENSOR_PIN);
  }
  Serial.print("total:");
  Serial.print(total);
  Serial.print(" average:");
  Serial.println(total / 64);
  delay(250);
}

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

ارسم الأرقام بدلًا من قراءتها

القيمة التي تتغير بمرور الوقت أسهل تقديرًا كخط بياني. يقرأ Serial Plotter في Arduino IDE وتبويب الرسم في Mokxi الصيغة نفسها: أرقام في سطر واحد تفصلها مسافات أو فواصل، وكل منها موسوم اختياريًا بصيغة name:value. المثال المحلول أعلاه يطبع بهذه الصيغة أصلًا، فافتح تبويب الرسم وأدر المقبض، ويمكنك مشاهدة المجموع وهو ينقلب إلى أرقام سالبة عند منتصف المدى.

طباعة قيمة حدّ بجانب القراءة، بصيغة reading:512 threshold:600، ترسم الحد كخط مستقيم، فترى بالضبط متى يتجاوز حساسٌ ذلك الحد ومدى تشوّشه قرب الحافة. هذا يجيب عن سؤال «لماذا يومض حساس الضوء على غير انتظام عند الغسق» بنظرة واحدة.

أوقف اللوحة عند سطر

في Mokxi يمكنك إيقاف أي لوحة عند نقطة توقف، بما في ذلك Uno، لأن الشريحة محاكاة وليست موصولة عبر USB. اضغط في الهامش يسار رقم السطر، فتظهر نقطة حمراء؛ اضغط «تشغيل»، فتتوقف اللوحة قبل تنفيذ ذلك السطر. تتوقف الدائرة كلها معها، فيبقى LED بنفس السطوع تمامًا ولا تقفز millis() أثناء تفحصك.

ثم يعرض تبويب Debug مكان توقف اللوحة، وسجلاتها الداخلية، وقائمة مراقبة للمتغيرات العامة. «تجاوز الخطوة» ينفّذ سطرًا واحدًا في كل مرة. قائمة المراقبة تقرأ المتغيرات العامة فقط، لذا قد يساعد أثناء التصحيح أن تجعل المتغير الذي يهمك متغيرًا عامًا. على ESP32 وESP8266، يعمل «إيقاف مؤقت» وقائمة المراقبة، لكن نقاط التوقف لا تعمل، لأن مترجم المتصفح لا يستطيع البناء لهاتين الشريحتين. مثال نقاط التوقف أدناه يشرح ذلك خطوة بخطوة على ESP32-C3.

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

افتح الدائرة

الأسئلة

هل يمكن تصحيح أخطاء Arduino Uno باستخدام نقاط التوقف؟

ليس مع مصحح أخطاء Arduino IDE، فهو لا يدعم لوحات AVR. تحتوي شريحة ATmega328P على واجهة تصحيح بسلك واحد اسمها debugWIRE، لكنها تحتاج إلى مصحح أخطاء عتادي منفصل. أما في Mokxi فتعمل نقاط التوقف مباشرة على Uno المحاكاة.

لماذا تعرض الشاشة التسلسلية رموزًا غير مفهومة؟

على لوحة حقيقية، لا تتطابق سرعة الشاشة مع قيمة Serial.begin. اضبط كليهما على الرقم نفسه، مثل 115200.

لماذا تختفي المشكلة عند إضافة Serial.print؟

الطباعة تبطئ الكود، فتصبح المشكلة متعلقة بالتوقيت: قراءة تحدث مبكرًا جدًا، أو غياب إزالة الارتداد، أو متغيّر مشترك مع مقاطعة.

هل أترك رسائل الطباعة في كود نهائي؟

عطّلها بدلًا من حذفها باستخدام ماكرو DEBUG مثل المذكور أعلاه. تستهلك وقتًا وذاكرة عند تشغيلها، ولا تستهلك شيئًا عند تعطيلها.

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

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