شاشة Raspberry Pi لا تعمل؟ حلول مشاكل DSI و HDMI واللمس لـ Pi 4 و Pi 5

ابدأ من هنا: أي نوع توصيل تستخدم؟

اعمل على القسم الخاص بنوع التوصيل لديك بالترتيب. كل خطوة تستبعد سبباً واحداً، والخطوات الأولى هي الأكثر تسبباً في المشكلات.

شاشة DSI: شاشة سوداء أو إضاءة خلفية فقط

1. استخدم كابل الشريط المناسب لجهاز Pi الخاص بك

تمتلك Raspberry Pi 5 موصل DSI أصغر من الطرازات السابقة، لذا فإن الكابل المرفق مع الشاشات الأقدم لا يناسبها. وفقًا لوثائق Raspberry Pi:

• Raspberry Pi 4 والإصدارات الأقدم: كابل مرن مسطح (FFC) من 15 مساراً إلى 15 مساراً.
• Raspberry Pi 5: كابل FFC من 22 مساراً إلى 15 مساراً (Standard – Mini). الطرف ذو الـ 22 مساراً هو الطرف الأصغر ويدخل في جهاز Pi؛ والطرف الأكبر يدخل في الشاشة.
• Touch Display 2 مقاس 10 إنش على Raspberry Pi 5: كابل FFC المرفق من 22 مساراً إلى 22 مساراً من نوع Mini – Mini.

طرازات Raspberry Pi Zero لا تحتوي على موصل DSI، لذا لا يمكن استخدام شاشة DSI عليها إطلاقاً.

2. تحقق من تركيب الكابل بإحكام وباتجاهه الصحيح

افتح مشبك التثبيت الخاص بالموصل، وادفع الكابل بالكامل حتى نهايته ثم أغلق المشبك. في Raspberry Pi 4B والطرازات الأقدم، موصل الشاشة مُعلَّم بـ DISPLAY (وليس CAMERA)، وتواجه التلامسات المعدنية منافذ Ethernet وUSB-A. الكابل المعكوس أو المُركَّب جزئياً أو الموضوع في موصل الكاميرا يعطي العَرَض نفسه تماماً كاللوحة التالفة.

3. وفّر للشاشة تغذية 5 V مستقلة

الشاشات الرسمية تُغذّى بشكل منفصل عن كابل DSI:

• Touch Display الأصلية: أسلاك توصيل (jumper) من رأس GPIO لجهاز Pi، الأسود إلى الطرف 6 (GND) والأحمر إلى الطرف 4 (5 V)، أو الطرف 2 إذا كان الطرف 4 مستخدماً. يمكنك استخدام مزوّد micro USB بدلاً من ذلك، لكن عندئذٍ لا توصِل أسلاك تغذية GPIO أيضاً.
• Touch Display 2: كابل تغذية GPIO المرفق، الطرف الصغير إلى منفذ J1 في الشاشة، والأحمر إلى الطرف 2 والأسود إلى الطرف 6.

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

4. لا تُضِف سطر dtoverlay لا تحتاجه

يأتي نظام Raspberry Pi OS مع الإعداد display_auto_detect=1 في الملف /boot/firmware/config.txt، وبوجوده يحمّل البرنامج الثابت (firmware) الـ overlay لشاشات DSI المعتمدة تلقائياً. لذلك لا تحتاج الشاشات الرسمية على جهاز Raspberry Pi قياسي إلى أي سطر dtoverlay. وإضافة هذا السطر يدوياً، بمقاس خاطئ أو لمنفذ خاطئ، سبب شائع للشاشة السوداء.

وحدات Raspberry Pi Compute Modules مختلفة: فهي لا تكتشف شاشات DSI تلقائياً، لذا تضيف الـ overlay بنفسك:

• Touch Display 2 مقاس 5 إنش: dtoverlay=vc4-kms-dsi-ili9881-5inch
• Touch Display 2 مقاس 7 إنش: dtoverlay=vc4-kms-dsi-ili9881-7inch
• Touch Display 2 مقاس 10 إنش: dtoverlay=vc4-kms-dsi-ili79600-10-1inch
• شاشة Touch Display الأصلية مقاس 7 إنش: dtoverlay=vc4-kms-dsi-7inch

الافتراضي هو المنفذ المُعلَّم بـ 1؛ أضف ,dsi0 لاستخدام المنفذ 0 (على سبيل المثال dtoverlay=vc4-kms-dsi-7inch,dsi0). وللشاشة الأصلية، احذف أيضاً أي سطر display_auto_detect.

5. لوحات DSI من جهات خارجية تحتاج إلى overlay خاص بها

الاكتشاف التلقائي يشمل فقط الشاشات التي يتعرف عليها البرنامج الثابت. تحتاج لوحة MIPI DSI من جهة خارجية إلى device-tree overlay يطابق وحدة التحكم فيها وعدد القنوات (lanes) والتوقيتات، ويُزوَّد عادةً من مورّد اللوحة. إذا كان overlay المورّد موجهاً لنواة (kernel) أقدم أو طراز Pi آخر، فقد تبقى اللوحة سوداء حتى مع التوصيل الصحيح. اطلب overlay مُختبَراً على طراز Pi وإصدار نظام التشغيل لديك تحديداً. تغطي ملاحظات شاشات Raspberry Pi 5 ونظرة عامة على شاشات MIPI DSI لدينا ما ينبغي طلبه.

شاشة HDMI: رسالة "no signal" أو دقة خاطئة

1. استخدم منفذ HDMI الأول

في Raspberry Pi 4B و5، المنفذ المُسمّى HDMI0 على اللوحة هو مخرج العرض الأول (HDMI-A-1 في لينكس). وصّل شاشة واحدة هناك قبل تجربة أي شيء آخر.

2. إعدادات HDMI القديمة في config.txt لم تعد تعمل

لا تزال العديد من الأدلّة تُرشدك إلى ضبط hdmi_force_hotplug وhdmi_group وhdmi_mode في config.txt. لكن وثائق Raspberry Pi تُدرج هذه الخيارات الآن كخيارات قديمة "لا تعمل مع Raspberry Pi OS Bookworm والإصدارات الأحدث". مع تعريف الرسوميات KMS، يدير لينكس مسار العرض بالكامل، بما في ذلك مخرجات HDMI.

3. فرض نمط عرض باستخدام video= في cmdline.txt

دون تحديد نمط عرض، يقرأ الـ Pi بيانات EDID من الشاشة ويختار دقة مناسبة. أحيانًا تُبلّغ لوحات تشغيل HDMI الصغيرة عن بيانات EDID لا تطابق اللوحة النقية (panel)، مما يؤدي إلى "no signal" أو صورة مقصوصة. فرض النمط الأصلي للوحة بإضافة مُعامل video= إلى السطر الوحيد في /boot/firmware/cmdline.txt، مثلًا video=HDMI-A-1:1024x600M@60 للوحة 1024×600 بتردد 60 هرتز.

الصيغة هي video=<display>:<width>x<height>M@<refresh>. استخدم HDMI-A-2 لمنفذ HDMI الثاني وDSI-1 لشاشة DSI أو DPI. خذ الدقة وتردد التحديث من ورقة بيانات اللوحة النقية. حافظ على كل محتوى cmdline.txt في سطر واحد.

الصورة مُدارة أو معكوسة

• سطح المكتب: من Preferences > Control Centre > Screens، اختر الشاشة، ثم اضبط Orientation على Normal أو Left أو Inverted أو Right.
• لوحدة التحكم فقط: وسّع مُعامل video=، مثلًا video=DSI-1:720x1280@60,rotate=90. استخدم reflect_x أو reflect_y أو reflect_xy للانعكاس.

هناك قيدان: جميع الشاشات المتصلة تتشارك نفس إعداد rotate=، كما أن rotate= يُدير وحدة التحكم النصية فقط. التطبيقات التي ترسم مباشرة عبر DRM، مثل cvlc أو تطبيقات libcamera، تحتاج إلى خيار تدوير خاص بها.

اللمس لا يطابق الصورة

على سطح المكتب، اضبط الاتجاه من Control Centre وسيتبعه اللمس تلقائيًا. في إعداد غير سطح المكتب مع شاشة مُدارة، أضف مُعاملات اللمس إلى overlay الخاص بالشاشة في config.txt: invx وinvy يعكسان محورًا، وswapxy يبدّلهما، وdisable_touch يُوقف اللمس. مثلًا، dtoverlay=vc4-kms-dsi-ili9881-7inch,invx,invy يعكس المحورين على شاشة Touch Display 2 مقاس 7 بوصات.

بالنسبة للشاشة الأصلية مقاس 7 بوصات، أزل display_auto_detect=1 عند إضافة overlay لمس بهذه الطريقة. تُشير Raspberry Pi إلى أن تدوير اللمس في شجرة الأجهزة (device tree) قد يتعارض مع مكتبة الإدخال لديك، لذا دوّر أحداث اللمس في المكتبة أو سطح المكتب كلما أمكن.

الشاشة تتحول إلى السواد بعد عشر دقائق

هذا هو إطفاء الشاشة (screen blanking)، وليس عطلًا. عندما يكون مُفعّلًا، يُطفئ Raspberry Pi OS الشاشة بعد 600 ثانية من عدم النشاط. أوقفه من Control Centre (مفتاح Screen Blanking) أو عبر sudo raspi-config > 2 Display Options > D2 Screen Blanking. لوحدة التحكم النصية، أضف consoleblank=0 إلى cmdline.txt لمنع الإطفاء نهائيًا.

عندما تكون المشكلة في اللوحة النقية وليس في الـ Pi

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