دليل rs300-v4l2-driver: تشغيل وحدة التصوير الحراري MINI2 مع Raspberry Pi

تم بناء هذا الدليل من التفاصيل الأساسية لمشروع rs300-v4l2-driver - مركزًا على مشغل rs300 (العمود الفقري البرمجي) وMIPI CSI-2 (الرابط المادي) لجعل وحدتك MINI2 تتواصل مع Raspberry Pi.

حول هذا الدليل

نحن الشركة المصنعة لوحدة التصوير الحراري MINI2. معظم المشاكل التي يواجهها المستخدمون عند التوصيل مع Raspberry Pi تتلخص في أمرين: عدم إعداد مُشغّل rs300 بشكل صحيح، أو سوء استخدام واجهة MIPI CSI-2. يشرح هذا المستند كليهما بطريقة أشبه بملاحظات مختبرية خطوة بخطوة — بدون مصطلحات تقنية معقدة، فقط ما يعمل.

المتطلبات الأساسية أولاً

قبل أن تبدأ، تأكد من توفر:

• Raspberry Pi (4B أو 5 أو Zero 2 W — جميعها تعمل مع MIPI CSI-2 بشكل أصلي)
• نظام تشغيل Raspberry Pi: Raspbian 11 (Bullseye) أو 12 (Bookworm) (الإصدارات الأقدم تفتقر لمكتبات مُشغّل rs300)
• الأدوات الأساسية: git, gcc, make, و linux-headers (سنقوم بتثبيتها إذا كانت مفقودة)

تثبيت مُشغّل rs300 (خطوة حاسمة!)

مُشغّل rs300 هو الطريقة التي تتواصل بها وحدة MINI2 مع Raspberry Pi. اتبع هذه الخطوات بدقة— وهي مأخوذة مباشرة من ملف README:

الخطوة 1: تثبيت التبعيات

افتح الطرفية في Raspberry Pi ونفّذ هذا الأمر للحصول على الأدوات اللازمة لمُشغّل rs300:

sudo apt-get update && sudo apt-get install -y git gcc make linux-headers-$(uname -r)

لماذا؟ linux-headers يطابق نواة Pi الخاصة بك — بدونه، لن يتم تجميع المُشغّل.

الخطوة 2: استنساخ مستودع مُشغّل rs300

احصل على ملفات المُشغّل من GitHub:

git clone https://github.com/Kodrea/rs300-v4l2-driver.git

ثم انتقل إلى مجلد المُشغّل:

cd rs300-v4l2-driver

الخطوة 3: تجميع وتثبيت المُشغّل

قم بتجميع المُشغّل أولاً (يستغرق ذلك 1-2 دقيقة):
make

إذا لم تظهر أي أخطاء، قم بتثبيته:
sudo make install

الخطوة 4: ضبط التشغيل التلقائي لمُشغّل rs300

لتجنب إعادة التثبيت عند كل إقلاع، أضف المُشغّل إلى بدء التشغيل:

sudo echo "rs300" >> /etc/modules

أعد تشغيل Pi للاختبار:

sudo reboot

تحقق مما إذا كان قد نجح: بعد إعادة التشغيل، نفّذ lsmod | grep rs300. إذا رأيت “rs300” في المخرجات، فهذا يعني أن مُشغّل rs300 قد تم تحميله!

التوصيل عبر واجهة MIPI CSI-2 (خطوة الأجهزة)

منفذ MIPI CSI-2 هو الطريقة التي تتصل بها وحدة MINI2 فعلياً مع Raspberry Pi. جميع نماذج Pi المدعومة تحتوي على منفذ MIPI CSI-2 قياسي — لا حاجة لأي محولات.

كيفية التوصيل:

1. قم بإيقاف تشغيل Raspberry Pi أولاً! (تنبيه: التشغيل المباشر = إتلاف منفذ MIPI CSI-2 أو الوحدة.)
2. ابحث عن منفذ MIPI CSI-2 على Pi: وهو فتحة صغيرة من النوع الشريطي (عادةً ما تكون معنونة بـ “CSI” أو بالقرب من أيقونة الكاميرا).
3. اسحب مزلاج المنفذ في Pi برفق.
4. قم بمحاذاة شريط MIPI CSI-2 الخاص بوحدة MINI2 (الجانب الأزرق لأعلى، طابق التجاويف!) وأدخله في المنفذ.
5. اضغط على المزلاج لأسفل لتثبيته.

ملاحظات خاصة بالطراز:

• Pi 4B/5: منفذ MIPI CSI-2 موجود على الحافة العلوية (بالقرب من منافذ HDMI).
• Pi Zero 2 W: المنفذ أصغر ولكنه يستخدم نفس تخطيط الأطراف—استخدم شريط MIPI CSI-2 المدمج الخاص بـ MINI2 (مرفق مع معظم الوحدات).

المشكلات الشائعة والإصلاحات (من ملف README)

حتى مع الخطوات المثالية، تحدث مشكلات. إليك كيفية إصلاح أكثر المشكلات شيوعًا مع برنامج تشغيل rs300 و MIPI CSI-2:

المشكلة 1: فشل “make” (لن يتم ترجمة برنامج التشغيل)

• تحقق من التبعيات: أعد تشغيل أمر apt-get install من الخطوة 1—المفقود linux-headers هو السبب #1.
• قم بتحديث نظام التشغيل: شغّل sudo apt update && sudo apt upgrade -y—النوى القديمة تعطل ترجمة برنامج تشغيل rs300.

المشكلة 2: لا توجد صورة حرارية (الوحدة لا تعمل)

1. تحقق من اتصال MIPI CSI-2: أوقف التشغيل، ارفع المزلاج، وأعد تركيب الشريط—الاتصالات غير المحكمة شائعة جدًا.
2. تحقق من تحميل برنامج التشغيل: شغّل lsmod | grep rs300. إذا لم يظهر شيء، أعد تثبيت برنامج تشغيل rs300 (كرر القسم 2).
3. تمكين CSI على Pi: شغّل sudo raspi-config, ، اذهب إلى “Interface Options” → “Camera”، اختر “Enable”، ثم أعد التشغيل.

المشكلة 3: لا يكتشف Pi منفذ MIPI CSI-2

• تحقق من إعدادات Pi: بعض وحدات Pi تأتي مع تعطيل MIPI CSI-2 افتراضيًا. استخدم raspi-config (أعلاه) لتشغيله.
• اختبر بكابل آخر: شرائط MIPI CSI-2 المعيبة تحدث—استبدلها بواحدة احتياطية إذا كانت لديك.

ملاحظات التوافق

• إصدارات برنامج تشغيل rs300: استخدم دائمًا أحدث إصدار من GitHub (المستودع يُحدث كثيرًا!). تشمل الإصلاحات الحديثة سرعة أفضل لـ MIPI CSI-2 على Pi 5.
• نظام تشغيل غير مدعوم: Raspbian 10 (Buster) أو أقدم لن يعمل—التزم بـ Bullseye (11) أو Bookworm (12).

هل تحتاج إلى مزيد من المساعدة؟

بصفتنا الشركة المصنعة لـ MINI2، نحن ندعمك:

• هل تريد دليلًا مرئيًا؟ يمكننا إرسال صور لخطوات اتصال MIPI CSI-2.
• عالق في ترجمة برنامج التشغيل؟ شارك سجلات الطرفية الخاصة بك، وسنقوم بتصحيح مشكلة برنامج تشغيل rs300 .
• تستخدم طراز Pi نادر؟ اسأل—لقد اختبرنا توافق MIPI CSI-2 لمعظم الطرازات.

فقط تواصل معنا، وسنقوم بتشغيل وحدة MINI2 الخاصة بك مع Raspberry Pi بسرعة!