مراجعة تعديلات شجرة الأجهزة بمساعدة الذكاء الاصطناعي: من سجل الإقلاع إلى الطرفية الفعلية

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

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

1. قدم أدلة اللوحة إلى مساعد الصياغة

قدم إصدارات اللوحة والتجميع الدقيقة، وSoC، والتزام النواة، وتعديلات المورد، وسلسلة تضمين DTS/DTSI القائمة، وآلية اختيار محمّل الإقلاع. أرفق صفحات المخطط التي تبين الناقل وتوصيلات تحديد العنوان وخط التغذية ومقاومات السحب والمقاطعة الاختيارية. قدم أيضا تعريف الارتباط وبرنامج التشغيل من شجرة النواة التي تُبنى فعليا. توجّه وثائق المشروع الأصلي المراجعة، لكن نواة المورد قد تختلف.

في هذا المثال التعليمي، نفترض أن TMP102 متصل بالمتحكم ذي الوسم i2c2، وأن عنوانه ذي السبعة بتات مضبوط على 0x48، وتغذيته موصولة بمصدر مسمى، وأن ALERT غير موصول. ونفترض أن المعدل الأولي المراجع للناقل هو 100 kHz. هذه مدخلات صريحة للسيناريو وليست خصائص مستنتجة من لوحة Obeita موجودة.

اطلب أصغر تعديل لملف اللوحة، وتفسيرا لكل خاصية مضافة، وقائمة تبعيات وخطة تحقق. امنع اختراع مجموعات pinctrl وأرقام GPIO ونصوص compatible. إذا كانت شجرة SoC المضمنة تعرف ساعات المتحكم أو إعادة ضبطه بالفعل، فيجب الحفاظ على ذلك التنظيم بدلا من نسخه من مثال غير ذي صلة.

2. حدد لماذا تظل المسودة المعقولة خاطئة

/* Deliberately flawed draft for an illustrative board. */
&i2c2 {
    status = "okay";
    clock-frequency = <1000000>;
    sensor@90 {
        compatible = "ti,tmp102";
        reg = <0x90>;
        interrupt-parent = <&gpio1>;
        interrupts = <7 2>;
    };
};

العنوان خطأ تمثيل شائع: تمثل 0x90 بايت عنوان كتابة للعنوان ذي السبعة بتات 0x48، بينما يجب أن تستخدم خاصية reg للعقدة الفرعية التمثيل الذي يتطلبه ارتباط الناقل. نسخ بايت المعاملة من ورقة البيانات إلى العقدة يصف عنوانا آخر دون وضوح. يتفق عنوان الوحدة وreg، لذا فإن اتفاقهما وحده دليل ضعيف.

مدخلات المشروع لا تدعم معدل 1 MHz. وقد خُمّنت خصائص المقاطعة رغم عدم توصيل ALERT. تخفي أعلام المقاطعة الرقمية معناها أيضا، وقد تخص ارتباط متحكم مختلف. وقد يكون غياب pinctrl ومعلومات التغذية مهما بالقدر نفسه، رغم أن بعض اللوحات ترث إعداداتها بصورة صحيحة من موضع آخر. يجب فحص سلسلة التضمين قبل اعتبار أي خاصية إلزامية دائما.

يوفر ارتباط TMP102 في المصدر الأصلي مرجعا محددا لنص compatible وخاصية reg والمقاطعة الاختيارية وlabel وvcc-supply، لكنه لا يبين توصيلات هذه اللوحة. يمنع هذا التفريق تحول إجابة ذكاء اصطناعي سليمة نحويا إلى مخطط مختلق.

3. راجع مقطعا مصححا بأقل تغيير

/* Partial teaching patch. Labels must exist in the board tree. */
&i2c2 {
    pinctrl-names = "default";
    pinctrl-0 = <&i2c2_board_pins>;
    clock-frequency = <100000>;
    status = "okay";

    temperature-sensor@48 {
        compatible = "ti,tmp102";
        reg = <0x48>;
        vcc-supply = <&sensor_vcc>;
        label = "board-ambient";
    };
};

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

قد يكون التصحيح أصغر من هذا المقطع. فإذا وفر تضمين اللوحة القائم حالة pinctrl أو clock-frequency الصحيحة، فقد يكون الإبقاء عليه أفضل. تجنب تنظيفا مولدا يعيد تنظيم متحكمات غير مرتبطة أو يغير تغذية مشتركة أو يضيف overlays لمجرد تشغيل حساس واحد. يساعد الفرق المحدود على إثبات السبب والنتيجة.

4. تحقق من النواة المختارة ثم من ملف الإقلاع المختار

نفذ التحقق من المخطط ضمن شجرة النواة الفعلية. يميز دليل التحقق من الارتباطات بين dt_binding_check للمخططات وdtbs_check لأشجار الأجهزة، ويشير إلى أن dtbs_check قد يتجاوز المخططات غير الصالحة. إذا تغير ارتباط، فتحقق منه أيضا. احتفظ بسجلات كاملة وافصل الإخفاقات الجديدة عن السابقة.

# Proposed checks in the exact configured kernel source tree:
make ARCH=<target-arch> CROSS_COMPILE=<tool-prefix> dtbs_check   DT_SCHEMA_FILES=hwmon/ti,tmp102.yaml

# On a target that exposes its live tree, with appropriate access:
dtc -I fs -O dts /sys/firmware/devicetree/base > running.dts
# Review the actual controller path, compatible, reg and supply.
# Discover the matching hwmon device; do not assume hwmon0.

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

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

5. استخدم سجلات الإقلاع لتحديد طبقة الفشل

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

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

6. تحقق من الطرفية الفعلية، بما في ذلك السلوك عند الخلل

• الهوية والمسار: أثبت أن العقدة العاملة والناقل الفعلي وبرنامج التشغيل المرتبط تشير إلى الحساس المقصود. ظهور مجلد في sysfs لا يكفي دليلا على قياسات مفيدة.
• مدخل مضبوط: قارن القراءات بمرجع مستقل مناسب في ظروف مستقرة، ثم طبق تغييرا حراريا آمنا ومضبوطا. حدد التفاوت وزمن الاستقرار قبل الاختبار من متطلبات المشروع ومواصفات الحساس.
• السلوك الكهربائي: إذا فشل الاتصال، افحص جهد التغذية وسلوك إعادة الضبط أو التمكين عند انطباقه وموجات الناقل بمعدات مناسبة. يجب أن يثبت الالتقاط المنطقي العنوان وسلوك ACK والتوقيت، لكنه لا يثبت دقة القياس وحده.
• دورة الحياة: اقترح إقلاعا باردا متكررا وإعادة تشغيل دافئة ودورات تعليق واستئناف مدعومة. سجل هل يُكتشف الحساس باستمرار ويتعافى في الوقت المتفق عليه.
• معالجة الأعطال: حاكِ انقطاع التغذية أو غياب الحساس على تجهيز آمن. يجب أن يتطلب القبول خطأ مرئيا وسياسة تعافٍ، بدلا من قيمة قديمة معقولة تُعرض كبيانات جديدة.

تجنب مسح الناقل عشوائيا على عتاد مجهول، ومعاملات I2C الخام التي تنافس برنامج تشغيل نواة مرتبطا. استخدم واجهة التشغيل المعتمدة وإجراء تشخيص مضبوطا. احتفظ بنسخة DTB الأساسية ومسار استعادة موثق قبل تجارب الإقلاع.

7. ما الذي تتضمنه المراجعة النهائية

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

ترتبط خدمة Obeita لتشخيص البرامج الثابتة وBSP بهذا المسار لتهيئة اللوحة. ويوفر مشروع الطرفية المدمجة RK3566 سياقا قريبا لتكامل BSP والطرفيات، لكنه لا يثبت أن تعديل TMP102 الافتراضي كان جزءا من ذلك المشروع.