الغرض منه
الوميض من LED يخبرك أن اللوحة حيّة، لكنه لا يخبرك ما قيمة count عندما انطفأ الضوء، أو هل اتُّخذ الفرع الذي كتبتَه للتو. مصحح الأخطاء يفعل: اضغط «تشغيل»، أوقف اللوحة عند سطر، واقرأ السجلات ومتغيراتك نفسها في تلك اللحظة.
عندما تتوقف اللوحة يتوقف كل شيء آخر معها. يحتفظ LED بدرجة سطوعه، ويبقى محرك سيرفو على زاويته، وتتوقف مؤقتات الشريحة حيث كانت. فعندما تضغط «متابعة»، يكمل millis() من التعليمة التي كنت تنظر إليها بدلًا من القفز للأمام بمقدار ما قضيتَه في القراءة.
وضع نقطة توقف
اضغط في الشريط الضيق إلى يسار أرقام الأسطر. ستظهر نقطة حمراء، وستتوقف اللوحة قبل تنفيذ ذلك السطر: ما تراه على الشاشة لم يحدث بعد.
اضغط «تشغيل». اللوحة التي عليها نقطة توقف تُبنى دائمًا من الملفات أمامك، حتى لو كان قسم Firmware في اللوحة يذكر برنامجًا مدمجًا. فنقطة التوقف تقع على سطر من هذا الكود، والبرامج المدمجة تأتي دون المعلومة التي تحدد أي تعليمة يقابلها السطر.
اضغط النقطة مرة أخرى لإزالتها. زر مسح الكل في تبويب Debug يزيل كل نقاط التوقف على تلك اللوحة دفعة واحدة.
تبويب لغة التجميع فيه الشريط نفسه ويعمل بالطريقة نفسها. نقطة التوقف على سطر من ملف .S توقف عند ذلك السطر، لأن أرقام الأسطر التي يسجلها البناء هي أرقام التبويب نفسه وليست أرقام النسخة المعالجة مسبقًا.
نقطة مجوّفة
النقطة المجوّفة تعني أن نقطة التوقف حيث وضعتها لكنها لا تفعل شيئًا: لم يولّد المترجم أي تعليمة لذلك السطر. الأسطر الفارغة، والتعليقات، والتصريحات الخالية من كود، والأسطر التي حذفها المُحسِّن تبدو كلها هكذا. انقلها إلى السطر التالي الذي يفعل شيئًا.
الشريط بجانب «تشغيل»
إيقاف مؤقت يوقف اللوحة أينما كانت. ويتحول إلى متابعة، الذي يتركها تواصل.
تخطي السطر ينفّذ سطرًا واحدًا من الكود المصدري، مع كل ما يستدعيه: سطر يستدعي delay(500) يستغرق 500 ms من وقت المحاكاة وتعيش بقية الدائرة كلها خلالها، لأن هذا ما يحدث فعلًا.
الدخول إلى السطر يتابع التنفيذ حتى السطر التالي الذي تصل إليه اللوحة، وهو أول سطر في دالة يستدعيها السطر الحالي.
قد تُختصر الخطوة بنقطة توقف أبعد، فتتوقف عندها وتُخبرك بذلك. نقطة التوقف الوحيدة التي لا تختصر خطوة أبدًا هي التي بدأت منها الخطوة: فالمقاطعة التي تحدث في تلك اللحظة (مؤقت، أو طرف، أو نبضة millis() العدّادة) تنفّذ معالجها ثم تعيد اللوحة إلى السطر نفسه الذي كنت عليه، والتوقف هناك كان يعني أن ضغطتك لم تفعل شيئًا على الإطلاق.
الخروج من الدالة رمادي، وتلميحه يوضح السبب: كان عليه أن يعرف إلى أين تعود الدالة الحالية، ومصحح الأخطاء لا يقرأ مكدس الاستدعاءات. ضع نقطة توقف على السطر بعد الاستدعاء بدلًا من ذلك.
خطوة تعليمة، في قسم Disassembly من تبويب Debug، ينفّذ تعليمة آلة واحدة فقط بدلًا من سطر كامل.
على الهاتف ينتقل الشريط إلى تبويب Debug، حيث توجد مساحة له.
تبويب Debug
بجانب الشاشة التسلسلية أسفل النافذة (له تبويب خاص به في الورقة على الهاتف)، وفيه خمسة أشياء.
مكان التوقف، في سطر واحد: الملف والسطر، والعنوان، وسبب التوقف: نقطة توقف، أو خطوة، أو إيقاف مؤقت. عندما لا يغطي جدول الأسطر العنوان، يعرض العنوان ويقول ذلك، بدلًا من تسمية سطر غير متأكد منه. "داخل sketch.ino:14" يعني أن اللوحة في منتصف ذلك السطر، لا في بدايته، ويُرسم التظليل في لوحة الكود أفتح لمطابقته.
السجلات، بالأسماء التي يستخدمها النواة نفسها: a0 وsp على ESP32-C3، وr24 وsreg على Uno. تُقرأ من النواة عند التوقف، فهي ما تحمله الآن لا ما كانت تحمله سابقًا. يأتي pc أولًا، وهو التعليمة التي ستُنفَّذ بعد ذلك.
سجل الحالة يُكتب تفصيلًا بجانب رقمه أيضًا، لأن ثمانية بتات ليست قيمة واحدة. على AVR، يعرض sreg أعلامه كـ ITHSVNZC، بنقطة مكان كل علم غير مفعّل، فبعد توقف يلي cp مباشرةً ترى بنظرة واحدة هل سيُتّخذ الفرع. وعلى لوحة ARM، يعرض xpsr الأعلام N Z C V Q بالطريقة نفسها.
التفكيك إلى لغة التجميع هو كود الآلة حول نقطة التوقف. كل صف تعليمة واحدة: عنوانها، وبايتاتها، والتعليمة نفسها بالتهجئة التي يستخدمها llvm-objdump، وسطر الكود المصدري الذي تبدأ منه، وهو زر ينقلك إلى ذلك السطر في لوحة الكود. التعليمة التي على وشك التنفيذ معلّمة. زر خطوة تعليمة، أعلى القسم، ينفّذ تلك التعليمة الواحدة ويعيد رسم القائمة.
هذا هو العرض المناسب لتبويب .S: السطر الذي كتبتَه بجانب البايتات التي تُجمّع إليها. ويعمل جيدًا على الكود العادي أيضًا، حيث يعرض ما صنعه المترجم من سطر C++. أما اللوحة التي لم تُبنَ من ملفاتها فتقول ذلك بدلًا من العرض، لأنه لا يوجد برنامج ليُقرأ حتى تضغط «تشغيل».
المراقبة تأخذ اسم متغير عام. ابدأ الكتابة وسيقترح الأسماء الموجودة في برنامجك. يعرض كل صف النوع كما سجّله المترجم وعدد بايتات ذلك النوع، ثم القيمة، مقروءة من ذاكرة اللوحة عند كل توقّف. الاسم غير الموجود في البرنامج يقول ذلك بدلًا من إظهار صفر. البنية أو المصفوفة تعرض بايتاتها، العنوان الأدنى أولًا، لأنها بايتات وليست رقمًا واحدًا.
نقاط التوقف تسرد كل نقطة على هذه اللوحة مع العنوان الذي حُلّت إليه. اضغط واحدة للانتقال إليها في الكود.
ما تفعله الشاشة التسلسلية في هذه الأثناء
لا شيء يتغيّر. كل ما طبعته اللوحة قبل التوقّف يبقى في مكانه، وأي شيء تطبعه بعد الاستئناف يأتي بعده. إيقاف لوحة لا يعني إيقاف التشغيل.
لوحتان
لكل لوحة نقاط توقفها الخاصة، وقائمة مراقبتها الخاصة، وتوقّفها الخاص. يعمل مصحح الأخطاء على اللوحة التي يعرضها جزء الكود، وهي اللوحة التي يسمّيها المنتقي أعلى الألسنة.
اللوحات التي يعمل عليها
كلّها. كل لوحة في Mokxi تجيب مصحح الأخطاء: ESP32-C3 و ESP32-C6، و ESP32 و ESP8266، و Arduino Uno و Nano و Mega و Leonardo و Uno R4 Minima، و ATtiny85، و Raspberry Pi Pico و Pico W، و STM32 Black Pill و Blue Pill، و BBC micro:bit و Seeed XIAO SAMD21.
السجلات هي السجلات التي يملكها نواة اللوحة نفسها، بالأسماء التي تستخدمها وثائقها: a0 و sp على ESP32-C3، و r24 و sreg على AVR، و r0 و lr و xpsr على أي لوحة فيها معالج ARM، و a0 إلى a15 على لوحات Xtensa (ESP32 و ESP32-S3 و ESP8266). لذا ما تقرأه في اللوحة هو ما كنت ستقرأه على القطعة الحقيقية.
خيار الخروج من الخطوة رمادي على كل اللوحات، للسبب الذي يذكره تلميحه.
يمكن للشريط أن يصبح رماديًا لسبب لا علاقة له بأي لوحة هي: لا شيء يعمل بعد، أو أن القطعة التي يعرضها جزء الكود لا تشغّل أي برنامج أصلًا (المقاومة لا يمكن إيقافها). أما اللوحة التي لا يستطيع مصحح الأخطاء الوصول إليها فستسمّي نفسها ("مصحح الأخطاء لا يدعم mega1 بعد.")، ولا توجد لوحة تفعل ذلك الآن. واللوحة التي يصل إليها لا تصبح رمادية أبدًا لعدم وجود نقطة توقف: زر إيقاف مؤقت يعمل لحظة تشغيل اللوحة، مع نقطة توقف أو بدونها.
Related
- محرر الكود والترجمة
- كتابة لغة التجميع
- التشغيل والشاشة التسلسلية
- لا يظهر شيء في الشاشة التسلسلية
- كيف تصحح أخطاء كود Arduino: منهجية، وطباعة تسلسلية، وراسم بياني، مع مثال عملي