RK3576 لینکس کیمرہ برانگ-اپ: سینسر ڈرائیور سے پہلا فریم تک

RK3576 ایک پروسیسر ہے جو راک چِپ نے صنعتی ویژن، اسمارٹ سیکیورٹی اور آرٹیفیشل انٹیلی جنس ویژن ٹرمینلز کے لیے تیار کیا ہے۔ اس میں ایک آئی ایس پی ورژن 3.9 امیج سگنل پروسیسر (زیادہ سے زیادہ 16 میگا پکسل تک سپورٹ کرتا ہے) اور تین MIPI CSI-2 ریسیور ماڈیولز (دو D-PHY ورژن 2.0 ماڈیولز اور ایک C/D-PHY ماڈیول) کا اندراج ہے۔ ہر D-PHY لین 4.5 Gbps کی زیادہ سے زیادہ رفتار سپورٹ کرتی ہے، ہر C-PHY ٹریو 2.5 Gsps سپورٹ کرتا ہے، اور ہر CSI پورٹ چار ورچوئل چینلز کو سپورٹ کرتا ہے۔

RK3576 کیمرہ حل لینکس میڈیا فریم ورک اور V4L2-سب ڈیوائس سب ڈیوائس ماڈل کے گرد ڈیزائن کیا گیا ہے۔ مکمل ڈیٹا پاتھ یہ ہے: امیج سینسر → MIPI CSI ریسیور کنٹرولر → VICAP ویڈیو کیپچر یونٹ → ISP ورژن 3.9۔ سینسر ایک خودمختار سب ڈیوائس کے طور پر کام کرتا ہے اور MIPI CSI، VICAP اور ISP کے ساتھ مل کر ایک مکمل امیج حاصل کرنے کا پائپ لائن تشکیل دیتا ہے۔

اگرچہ RK3576 تین MIPI CSI وصول کرنے والے چینل فراہم کرتا ہے اور VICAP ایک ساتھ متعدد تصویری سٹریمز وصول کر سکتا ہے، ISP V3.9 ایک واحد چینل والے ہارڈ ویئر ہے اور یہ صرف ایک ہی تصویری سٹریم پر ISP الگورتھم کی پروسیسنگ ایک وقت میں انجام دے سکتا ہے۔

منصوبے کی ڈی بگنگ کے دوران مسائل میں غیر معمولی I2C رابطہ، غیر مستحکم MIPI لنک، یا میڈیا پائپ لائن قائم کرنے میں ناکامی شامل ہو سکتی ہے، جس کا آخری نتیجہ پہلی تصویری فریم کا اخراج نہ ہونا ہوتا ہے۔ اس مضمون میں انجینئرنگ عملدرآمد کے نقطہ نظر سے مکمل ڈی بگنگ کا طریقہ کار پیش کیا گیا ہے، جو مضمر وژن ڈی بگنگ کے لیے حوالہ کے طور پر استعمال کیا جا سکتا ہے۔

1. ہارڈ ویئر اور کرنل کی تیاری: ڈی بگنگ سے پہلے کم درجے کے ہارڈ ویئر کے مسائل کو ختم کرنا

ڈرائیور کی ڈی بگنگ کے دوران، ہم جن زیادہ تر مسائل کا سامنا کرتے ہیں وہ عام طور پر ڈرائیور کے کوڈ کی وجہ سے نہیں ہوتے، بلکہ ہارڈ ویئر کی وائرنگ، پاور سیکوئنسنگ، یا کرنل کی غیر موجود ترتیبات جیسے بنیادی مسائل کی وجہ سے ہوتے ہیں۔ اس لیے سینسر ڈرائیور کی ترقی شروع کرنے سے پہلے، بنیادی ہارڈ ویئر اور کرنل کے ماحول کی جانچ اور تصدیق پہلے کر لینی چاہیے۔

اہم ہارڈ ویئر کی جانچ میں سینسر کی پاور ریلز، آئی ٹو سی بس، MIPI ڈفرنشل لنکس، اور ری سیٹ / پاور کنٹرول جی پی آئی او پن شامل ہیں۔

سینسر کی پاور اپ سیکوئنسنگ ڈی بگنگ کے سب سے اہم حصوں میں سے ایک ہے۔ AVDD، DOVDD، اور DVDD جیسی متعدد پاور ریلز کو سینسر کے ذریعہ مخصوص پاور اپ سیکوئنس کی سختی سے پابند ہونا ضروری ہے۔ زیادہ سپلائی وولٹیج کا انحراف یا غلط پاور اپ / پاور ڈاؤن ٹائمِنگ براہ راست آئی ٹو سی کمیونیکیشن کی ناکامی اور سینسر کے غیر معمولی کام کا باعث بن سکتی ہے۔

آئی ٹو سی بس: پن ملٹی پلیکسنگ کی ترتیب اور سینسر کے سلیو ایڈریس کی جانچ کریں، اور یہ تصدیق کریں کہ آئی ٹو سی پُل اپ ریزسٹرز مناسب طریقے سے لگائے گئے ہیں۔

MIPI: ہارڈ ویئر کے ذریعے استعمال ہونے والے CSI چینل، MIPI لینز کی تعداد، اور مختلف سگنل لائنز پر مزاحمت کا مطابقت پذیری کی تصدیق کریں۔ اس کے علاوہ، RK3576 سے نکلنے والی سینسر ریفرنس گھڑی (XVCLK) کے درست طریقے سے کام کرنے کی بھی تصدیق کریں۔

ری سیٹ / پاور ڈاؤن کنٹرول پن: فعال سطح کے منطق (ایکٹیو ہائی / ایکٹیو لو) کا تعین کریں، اور یقینی بنائیں کہ GPIO کی ترتیب سکیمیٹک کے مطابق ہو۔

کرنل کی ترتیب: میڈیا سبسسٹم، V4L2-سب ڈیوائسز، MIPI CSI کنٹرولر اور PHY ڈرائیورز، VICAP، اور ISP V3.9 کے لیے کرنل کے اختیارات کی جانچ کریں۔ اگر کوئی ضروری اجزاء کرنل میں شامل نہ ہو، یا ماڈیول کی شکل میں شامل ہو لیکن درست طریقے سے لوڈ نہ ہو سکے، تو میڈیا پائپ لائن کیمرہ ہارڈ ویئر کو شناخت نہیں کر پائے گی۔ کرنل کے تعمیر اور فلیش ہونے کے بعد، پہلے ہر ڈرائیور ماڈیول کی لوڈنگ کی حیثیت کی جانچ کریں۔ dmesg لاگ کا جائزہ لیں اور یہ تصدیق کریں کہ کوئی غلطیاں جیسے ماڈیولز کا غائب ہونا یا ابتدائیہ کارروائی میں ناکامی نہ ہوں۔

2. ڈیوائس ٹری (DTS) کی ترتیب: آلات کے درمیان رابطوں کی تشکیل

RK3576 کیمرہ ڈیوائس ٹری: یہ ہارڈ ویئر وسائل کی وضاحت کرتی ہے اور تصویر کے پائپ لائن لنکس کو سینسر، MIPI CSI، VICAP، اور ISP کے درمیان باندھنے کے لیے پورٹ اور اینڈ پوائنٹ نوڈس کا استعمال کرتی ہے۔

سینسر نوڈ متعلقہ I2C بس نوڈ کے تحت منسلک ہوتا ہے اور I2C سلیو ایڈریس، ری سیٹ پن، پاور ڈاؤن کنٹرول پن، اور سینسر ریفرنس کلاک کی وضاحت کرتا ہے۔ خصوصیات کو اس طرح ترتیب دیا جا سکتا ہے کہ سینسر کی شروعات کو MIPI CSI PHY ہارڈ ویئر تیار ہونے تک مؤخر کر دیا جائے، جس سے غیر تیار PHY کی وجہ سے وقتی تنازعات سے بچا جا سکے۔ سینسر نوڈ کے پورٹ کے اندر موجود اینڈ پوائنٹ MIPI CSI ان پُٹ کی طرف اشارہ کرتا ہے اور MIPI ڈیٹا لینز کی تعداد کو مخصوص کرتا ہے۔

MIPI CSI کنٹرولر نوڈ میں دو پورٹس ہوتے ہیں: ان پُٹ تصویر سینسر سے منسلک ہوتا ہے، اور آؤٹ پُٹ VICAP یونٹ سے جڑتا ہے۔ اس کے بعد VICAP تصویر کے ڈیٹا کو ISP V3.9 کو بھیجتا ہے۔ نوٹ کریں کہ اختتامی نقاط ایک دوسرے کو دونوں سمتوں سے حوالہ دینے کے لیے ضروری ہیں، اور دونوں سروں پر ریموٹ-انڈ پوائنٹ خصوصیات ایک سے ایک کے تناسب میں مطابقت رکھنی چاہییں۔ اگر دونوں سمتوں کا بانڈنگ مطابقت نہ رکھتا ہو تو میڈیا فریم ورک مکمل ڈیٹا راستہ کو پہچان نہیں سکتا۔ DTS کو ترمیم، کمپائل اور فلیش کرنے کے بعد، سب سے پہلے dmesg لاگ کا جائزہ لیں تاکہ یقینی بنایا جا سکے کہ تمام ڈیوائس نوڈز عام حالت میں ہیں اور کوئی مستقل موخر شدہ-پروب کی غلطیاں نہیں ہو رہی ہیں۔ بار بار موخر شدہ پروب عام طور پر غلط GPIO، گھڑی یا بجلی کے وسائل کی ترتیب کی نشاندہی کرتا ہے۔

3. سینسر سب ڈیوائس ڈرائیور کی ترقی: V4L2-سب ڈیوائس ماڈل

آر کے 3576 پلیٹ فارم سینسر ڈرائیور وی 4 ایل 2-سب ڈیوائس فریم ورک کی بنیاد پر تیار کیا گیا ہے۔ سینسر ڈرائیور کوئی /دیو/ویڈیو نوڈ تخلیق نہیں کرتا؛ بلکہ یہ صرف ایک میڈیا سب ڈیوائس اینٹیٹی کے طور پر موجود ہوتا ہے۔ اس کے اہم ذمہ داریوں میں سینسر رجسٹر کی ترتیب، بجلی اور ری سیٹ کا انتظام، تصویر کے فارمیٹ کی ترتیب، اور سٹریم شروع/روکنے کا کنٹرول شامل ہیں۔

ڈرائیور کو بنیادی طور پر پانچ ماڈیولز میں تقسیم کیا گیا ہے: آئی 2 سی پروب، بجلی/ری سیٹ کنٹرول، موڈ رجسٹر ٹیبلز، پیڈ فارمیٹ کی ترتیب، اور سٹریم شروع/روکنے کا کنٹرول۔

ڈرائیور کے ٹیسٹ مرحلے کے دوران، سینسر چِپ آئی ڈی آئی ٹو سی کے ذریعے پڑھی جاتی ہے تاکہ یہ تصدیق کی جا سکے کہ چِپ درست طریقے سے پہچانی گئی ہے۔ اگر آئی ڈی پڑھنے میں ناکامی ہو جائے تو، مسئلہ حل کرنے کا عمل براہ راست آئی ٹو سی، بجلی کی فراہمی اور ری سیٹ سے متعلقہ ہارڈ ویئر خرابیوں پر مرکوز کیا جا سکتا ہے۔ بجلی کی فراہمی اور ری سیٹ کے افعال سینسر کو مکمل طور پر آن اور آف کرنے کا تسلسل نافذ کرتے ہیں: آن کرنے کے دوران، ہر بجلی کی لائن کو ترتیب وار چالو کیا جاتا ہے، ری سیٹ پن کو مخصوص تاخیر کے لیے دبایا جاتا ہے، پھر ری سیٹ کو آزاد کر دیا جاتا ہے اور سینسر کو اندرونی طور پر مستحکم ہونے کا وقت دیا جاتا ہے۔ آف کرنے کے عمل میں الٹے آپریشنز انجام دیے جاتے ہیں۔

موڈ رجسٹر جدول مختلف وضاحتیں، فریم کی شرح اور MIPI کی شرح کے لیے مکمل سینسر رجسٹر کی ترتیبات ذخیرہ کرتے ہیں۔ جب اوپری لیئر کیپچر پیرامیٹرز تبدیل کرتی ہے، تو ڈرائیور متعلقہ مکمل رجسٹر سیٹ لکھتا ہے۔ پیڈ-فارمیٹ انٹرفیس میڈیا-بس تصویر کے فارمیٹ کو ترتیب دیتا ہے، جو سینسر کے بائر فارمیٹ آؤٹ پٹ (جیسے BGGR یا RGGB) کے ساتھ بالکل مطابقت رکھنا ضروری ہے۔ غلط ترتیب براہِ راست تصویر کے رنگ کی غلطیاں پیدا کرتی ہے۔ اسٹریم-کنٹرول انٹرفیس stream_on کا استعمال رجسٹر کمانڈز لکھنے کے لیے کرتا ہے جو سینسر کے MIPI تصویر آؤٹ پٹ کو فعال کرتے ہیں، جبکہ stream_off تصویر کے انتقال کو روک دیتا ہے۔ ڈرائیور کے نفاذ کے بعد، بلڈ آپشنز کرنل Kconfig اور Makefile میں شامل کی جاتی ہیں تاکہ ڈرائیور کو یا تو کرنل میں بلڈ کیا جا سکے یا لوڈ کی جانے والی کرنل ماڈیول کے طور پر کمپائل کیا جا سکے۔

4. مرحلہ وار ڈیباگنگ: پہلا فریم مرحلہ وار حاصل کرنا

تصویر کی حاصل کرنے کی فوری کوشش کرنا تجویز نہیں کی جاتی۔ مسئلہ حل کرنے کے لیے تین مراحل پر مشتمل ایک طبقہ وار نقطہ نظر استعمال کریں: ڈرائیور کی تصدیق کریں کہ وہ کامیابی سے تشخیص کرتا ہے → میڈیا پائپ لائن کی مکمل طور پر منسلک ہونے کی تصدیق کریں → V4L2 کے ساتھ خام تصاویر حاصل کریں۔

مرحلہ 1: سینسر ڈرائیور کی کامیاب تشخیص کی تصدیق کریں

سیسٹم کے بوٹ ہونے کے بعد، dmesg کا جائزہ لیں اور سینسر ڈرائیور کے ذریعہ شائع کردہ لاگ پیغامات تلاش کریں۔ متعلقہ I2C بس کو اسکین کرنے کے لیے i2cdetect کا استعمال کریں اور یہ تصدیق کریں کہ آیا سینسر کا غلام ایڈریس دریافت کیا گیا ہے۔

• اگر کوئی I2C ڈیوائس دریافت نہیں کیا گیا ہے: سینسر کی بجلی، ری سیٹ لا جک، I2C ہارڈ ویئر کی سولڈرنگ، اور پن ملٹی پلیکسنگ کی جانچ کریں۔
• اگر I2C ایڈریس دریافت کیا جا سکتا ہے لیکن چپ آئی ڈی کا قاری غیر معمولی ہے: I2C ہارڈ ویئر کا راستہ کام کر رہا ہے، اور مسئلہ اکثر غلط رجسٹر ایڈریس یا سینسر ماڈل کے غیر مطابقت سے متعلق ہوتا ہے۔

مرحلہ 2: میڈیا فریم ورک پائپ لائن کی تصدیق کریں

میڈیا-کنٹرول کا استعمال کر کے میڈیا ڈیوائس اینٹیٹیز کی فہرست دیکھیں۔ عام حالات میں، سینسر، مائیپی_سی ایس آئی، ویکیپ، اور آئی ایس پی39 جیسی سب ڈیوائس اینٹیٹیز نظر آنی چاہییں، جن میں سے ہر ایک پیڈ پورٹ صحیح طریقے سے پہچانی گئی ہو۔

• اگر سینسر اینٹیٹی نظر نہ آ رہی ہو تو اس کا مطلب ہے کہ سینسر ڈرائیور کا پروب ناکام ہو گیا ہے۔
• اگر اینٹیٹیز موجود ہوں لیکن لنک منقطع ہو تو اس کا مطلب ہے کہ ڈی ٹی ایس میں اینڈ پوائنٹ بائی ڈائریکشنل جوڑی بندی غلط ہے۔

ڈی بگنگ کے دوران، میڈیا-کنٹرول کا استعمال پورے پائپ لائن کو دستی طور پر کنفیگر کرنے کے لیے کیا جا سکتا ہے: اینٹیٹیز کے درمیان لنکس قائم کرنا، اور ہر سب ڈیوائس مرحلے کے لیے تصویر کے فارمیٹ، ریزولوشن، اور لین کنفیگریشن سیٹ کرنا۔ میڈیا-کنٹرول سے آنے والی خرابیاں عام طور پر لین کی تعداد، میڈیا-بس فارمیٹ، یا ریزولوشن کے پیرامیٹر کی وجہ سے ہوتی ہیں جو سینسر کی ہارڈ ویئر صلاحیتوں سے تجاوز کرتے ہیں۔ میڈیا-کنٹرول کی کامیاب کنفیگریشن سے یہ ظاہر ہوتا ہے کہ سینسر سے آئی ایس پی تک سافٹ ویئر راستہ قائم کر لیا گیا ہے۔

مرحلہ 3: وی 4 ایل 2 کے ساتھ تصویر کی کیپچر کرنا اور پہلا را فریم حاصل کرنا

ویکیپ/آئی ایس پی ویڈیو نوڈ /dev/video تیار کرتا ہے، جو تصویر کی دریافت کے لیے صارف کے سپیس داخلی نقطہ کا کام کرتا ہے۔ بایر را کے ڈیٹا کو میپ کرنے کے لیے v4l2-ctl استعمال کریں تاکہ تصویر کا پکسل فارمیٹ طے کیا جا سکے، ایک واحد فریم کو mmap کے ذریعے دریافت کیا جا سکے، اور بایر را ڈیٹا کو محفوظ کیا جا سکے۔ اگر تیار شدہ را فائل کا سائز تھیوریٹیکل انتظار کے مطابق ہو تو پہلا تصویر فریم کامیابی کے ساتھ دریافت کر لیا گیا ہے۔ بعد ازاں را فائل کو ایک پیشہ ورانہ تصویر تجزیہ کے آلے کے ذریعے دیکھا جا سکتا ہے تاکہ اصل بایر تصویر کا معائنہ کیا جا سکے۔

5. عام تنقیدی حل کے طریقے

• منسلکہ کو ترتیب دینے کے دوران میڈیا-کنٹرول خرابی کی رپورٹ کرتا ہے: پہلے دوطرفہ ڈی ٹی ایس اینڈ پوائنٹ بانڈنگ کی جانچ کریں، پھر میڈیا-بس فارمیٹ، وضاحت اور لین کاؤنٹ کے پیرامیٹرز کی تصدیق کریں۔
• وی 4 ایل 2 فریم کیپچر کا وقت ختم ہو جاتا ہے اور کوئی تصویری ڈیٹا آؤٹ پٹ نہیں ہوتا: یہ تصدیق کریں کہ ڈرائیور کے اندر stream_on صحیح طریقے سے انجام دیا گیا ہے، سی ایس آئی فزیکل لیئر نے گھڑی لاک حاصل کر لی ہے، اور سینسر درحقیقت مائی پی آئی ڈیٹا اسٹریم کو باہر بھیج رہا ہے۔
• خراب تصویریں یا دھاری دار شور: ممکنہ وجوہات میں غلط MIPI گھڑی کی شرح، غلط لین کی تعداد، بائر پیٹرن کا عدم مطابقت، یا سینسر کی بجلی کی فراہمی پر زیادہ رپل شامل ہیں۔
• تصویر کا غیر مستقل آؤٹ پٹ یا اچانک فریم گرنے کا واقعہ: سینسر کی بجلی چالو/ری سیٹ ٹائمِنگ ضروریات پر پورا نہیں اتر رہی ہو سکتی، یا ہارڈ ویئر کی بجلی کی فراہمی کافی مستحکم نہیں ہو سکتی۔

ہمارے پاس ایک پختہ RK3576 حل اور کسٹم ترقی، ہارڈ ویئر کی مناسبت، اور بڑے پیمانے پر پیداوار کے نفاذ میں ماہرانہ صلاحیتیں ہیں۔ مختلف تصویری سینسرز اور وضاحت/فریم رفتار کی ضروریات کے لیے، ہم ہارڈ ویئر کی اصلاحات، ڈرائیور کی خرابی دور کرنے کی خدمات، اور مکمل نظام کی بہتری فراہم کر سکتے ہیں تاکہ صنعتی ویژن، اسمارٹ سیکیورٹی، AI ویژن ٹرمینلز، اور دیگر درجہ بندیوں میں کسٹم منصوبوں کی موثر طریقے سے حمایت کی جا سکے۔ ہم سے رابطہ کریں۔ [email protected].