صايب سكانير OBD1 مبني على Arduino لجيب ديال 1991–95

شنو هو xj-scanner؟

xj-scanner كيربط الحاسوب المحمول مع كمبيوتر الموتور ديال Jeep من 1991 حتى 1995 باستعمال Arduino Nano رخيص خدام بـ 5 V. كاينين ثلاثة ديال السلاك كيمشيو من موصل التشخيص اللي كاين تحت الكابو حتى للـ Nano، والـ Nano كيربط مع الحاسوب عبر USB.

منين كيتربط، المشروع يقدر يقرا رموز الأعطال وبيانات الموتور المباشرة، ويسجل المعلومات أثناء السياقة، ويشغل اختبارات المشغلات المدمجة فكمبيوتر الموتور. Claude Code أو Codex أو شي وكيل برمجي آخر يقدر يرافقك فالإعداد ويفسر التعليمات الموجودة فالمستودع.

المشروع تبنى وتجرب على Jeep Cherokee XJ موديل 1994 بموتور 4.0L وكمبيوتر برقم القطعة 56030117. حواسيب Chrysler وJeep SBEC/OBD1 الأخرى ديال 1991 حتى 1995 تقدر تكون مشابهة، ولكن التوافق ماشي مضمون. ديما قس موصل التشخيص ديالك قبل ما تركب أي جهاز.

المزايا الرئيسية

• كيقرا رموز أعطال كمبيوتر الموتور.
• كيعرض معطيات الموتور المباشرة والقيم ديالها بعد التحويل.
• كيسجل البيانات المباشرة فملفات داخل pc/logs/.
• كيدعم اختبارات المشغلات المدمجة فكمبيوتر الموتور.
• فيه وضع Jeep محاكى لاختبار برنامج الحاسوب بلا سيارة.
• فيه برنامج للتصحيح ديال توصيلات Nano، بالإضافة للبرنامج الرئيسي ديال الجسر.
• فيه أدوات مساعدة لتلخيص السجلات، وفحص المعطيات بالتتابع، والتحقق من رقم قطعة الكمبيوتر.
• كيوفر دلائل موجهة للوكلاء البرمجيين من أجل التثبيت الموجه وحل المشاكل.

الأجهزة اللي خاصك

التكلفة المتوقعة ديال الأجهزة هي تقريباً 15$. جمع المكونات التالية قبل ما تبدا:

• Arduino Nano مقلد خدام بـ 5 V، فيه USB-C أو mini-USB، مع الكابل المناسب.
• لوحة تجارب صغيرة.
• شي سلاك توصيل ديال لوحة التجارب.
• ثلاثة ديال السلاك طوال بما يكفي يوصلو من موصل اللي تحت الكابو حتى لبلاصة الحاسوب.
• ثلاثة ديال أطراف spade ذكور بقياس 1/4 بوصة، مناسبين لموصل التشخيص.
• ملتيميتر.

تحذير مهم للسلامة

التجويف 6 فيه 12 فولت ملي مفتاح الإشعال كيكون شاعل. ممنوع تربط Arduino أو أي سلك ديال جهاز التشخيص بالتجويف 6.

ما تعتمدش على لون السلك باش تحدد تجاويف الموصل. فالعربة اللي تجربات، التجويف 6 كان فيه نفس لون السلك لكحل والأبيض ديال سلك الأرضي. أي توصيل غالط يقدر يعرض Nano أو الحاسوب لجهد السيارة.

قبل ما توصل أي حاجة، استعمل ملتيميتر وفحص كل تجويف. قارن القياسات ديالك مع القراءات المتوقعة فـ docs/connector.md. التوصيلة اللي تجربات فالمستودع كتوصل أطراف Nano D10 وD11 وGND بتجاويف موصل التشخيص 4 و3 و2 على التوالي، ولكن خاصك تتحقق من الموصل ديال سيارتك قبل.

الخيار 1: خلي وكيل برمجي بالذكاء الاصطناعي يوجهك فالإعداد

أسهل طريقة للتثبيت هي تستعمل Claude Code أو Codex أو شي وكيل برمجي آخر كيقدر يفهم المستودع.

1. نسخ مستودع xj-scanner للحاسوب المحمول ديالك.
2. حل المستودع فوكيل البرمجة ديالك.
3. سول: عاونّي نربط هاد الشي بالـ Jeep ديالي.
4. تبع التعليمات خطوة بخطوة.

الوكيل يقدر يقرا AGENTS.md والأدلة الموجودة فـ .claude/skills/. هاد التعليمات كتشمل إعداد البرنامج، تركيب لوحة التجارب، تحديد تجاويف الموصل بالملتيميتر، وأخذ أول قراءة. إلا كانت شي تعليمة ما واضحةش، طلب من الوكيل يشرحها ليك بطريقة أبسط قبل ما تكمل.

الخيار 2: ثبت وشغل xj-scanner يدوياً

1. وجد بيئة Python

من جذر المستودع، وجد بيئة افتراضية وثبت الاعتماديات ديال جهاز التشخيص:

python3 -m venv .venv && .venv/bin/pip install -r pc/requirements.txt

2. جرب برنامج الحاسوب فالوضع التجريبي

قبل ما تربط مع Jeep، شغل جهاز التشخيص باستعمال السيارة المحاكية ديالو:

.venv/bin/python pc/xj_scan.py --cli DEMO

هاد الشي كيأكد بأن جانب Python خدام بلا ما تحتاج Arduino أو كمبيوتر الموتور. إلا فشل الوضع التجريبي، حل المشكل اللي فجهة الحاسوب قبل ما تدوز لتوصيلات السيارة.

3. ثبت Arduino CLI وAVR core

الـ README كيعطي الأوامر التالية لـ macOS باستعمال Homebrew:

brew install arduino-cli
arduino-cli core install arduino:avr

إلا كنت كتستعمل نظام تشغيل آخر، ثبت arduino-cli بالطريقة المناسبة لهاد النظام، ومن بعد ثبت core ديال arduino:avr.

4. ربط وحدد Nano

ربط Arduino Nano بالحاسوب عبر USB. حدد المنفذ التسلسلي ديالو، ومن بعد عوض /dev/cu.usbserial-XXXX فالأمر ديال الرفع بالمنفذ الحقيقي.

المثال كيستعمل معرف اللوحة arduino:avr:nano:cpu=atmega328old، واللي كيختار إعداد محمل الإقلاع القديم المستعمل فبزاف ديال نسخ Nano المقلدة.

5. جمع ورفع برنامج جسر الاتصال

arduino-cli compile --upload -p /dev/cu.usbserial-XXXX --fqbn arduino:avr:nano:cpu=atmega328old arduino/xj_bridge

البرنامج xj_bridge كيحول Nano لجسر اتصال بين جهاز التشخيص فالحاسوب وكمبيوتر موتور Jeep.

6. تحقق وركب التوصيلات

والتوصيلات ديال السيارة مفصولة على Nano، استعمل الملتيميتر باش تحدد تجاويف موصل التشخيص. راجع المجلد docs/ فالمستودع باش تلقى قياسات الموصل، وتخطيط لوحة التجارب، وتفاصيل التوصيل.

بالنسبة للعربة اللي تجربات، توصيلات الإشارة الثلاثة هي:

• Nano D10 مع تجويف موصل التشخيص 4.
• Nano D11 مع تجويف موصل التشخيص 3.
• Nano GND مع تجويف موصل التشخيص 2.

ما تكملش اعتماداً غير على هاد اللائحة. تأكد من كل تجويف فطوموبيلتك وبعّد جميع الأسلاك على التجويف 6.

7. قرا رموز الأعطال والبيانات المباشرة

منين تكون الفيرموير والتوصيلات اللي تراجعات واجدين، دور مفتاح التشغيل على ON وشغّل:

.venv/bin/python pc/xj_scan.py --cli auto

فالوضع التلقائي، السكانير كيقرا رموز الأعطال ومن بعد كيجمع البيانات المباشرة. السجلات كتتكتب فـ pc/logs/.

فهم بنية المستودع

• arduino/: فيه سكيتش Nano الرئيسي xj_bridge وسكيتش تصحيح التوصيلات xj_sniff.
• pc/: فيه xj_scan.py، اللي كيتكلف برموز الأعطال، والبيانات المباشرة، والتسجيل، واختبارات المشغلات.
• tools/: فيه أدوات لتلخيص السجلات، وفحص كل المعاملات، والتحقق من الرقم المرجعي ديال كمبيوتر المحرك.
• docs/: كيوثق الموصل، والتوصيلات، وبروتوكول التواصل، والمعاملات، وصيغ التحجيم، وإجراءات حل المشاكل.
• .claude/skills/: فيه دلائل عملية خطوة بخطوة يقدر وكيل ذكاء اصطناعي يتبعها معاك.

طريقة العمل الأساسية

الجلسة الأولى خاصها تكون بحذر وبهذا الترتيب:

1. شغّل الوضع DEMO باش تتأكد من Python والاعتماديات ديالو.
2. حمّل xj_bridge فالـ Nano.
3. فصل التوصيلات من جهة الطوموبيل وقس كل تجويف فالموصل.
4. تأكد من تجاويف الأرضي والتواصل بالاعتماد على الوثائق.
5. ركّب الدارة فوق لوحة التجارب وعاود راجع كل توصيلة.
6. دور المفتاح على ON بلا ما تشغّل المحرك.
7. شغّل السكانير بـ --cli auto.
8. راجع رموز الأعطال المبلّغ عليها وتأكد بلي تسجلات شي سجل فـ pc/logs/.

نصائح متقدمة

استعمل سكيتش التصحيح ملي يفشل التواصل

السكيتش arduino/xj_sniff مضمّن لتشخيص التوصيلات. استعملو مع مواد حل المشاكل فـ docs/ ملي الجسر ما يقدرش يتواصل مع كمبيوتر المحرك. ما تبدلش التوصيلات وهي مشحونة بالكهرباء.

لخّص سجلات السياقة

من بعد ما تسجل البيانات المباشرة، تفقد الأدوات المساعدة اللي فـ tools/. المستودع فيه أداة لتلخيص السجلات، تقدر تسهّل مراجعة تسجيل طويل. خدم على نسخة من السجل إلا بغيتي تحافظ على البيانات الأصلية بلا تغيير.

فحص المعاملات المتاحة بحذر

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

تحقق من الرقم المرجعي ديال كمبيوتر المحرك

حيت المشروع تراجع على كمبيوتر المحرك 56030117، استعمل أداة الرقم المرجعي الموفرة ملي كتفحص طوموبيلة أخرى. كمبيوتر SBEC/OBD1 مختلف يقدر يتصرف بطريقة مشابهة، ولكن ملف README ما كيضمنش الدعم.

كون حذر مع اختبارات المشغلات

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

استعمل وثائق التحجيم المفصلة

الدليل docs/ كيوصف المعاملات المتاحة وصيغ التحجيم. رجع ليه ملي كتفسر القراءات الخام، خصوصاً إلا كنت كتحلل تصحيح خليط الوقود أو كتقارن قيمة مع أداة فحص أخرى.

لائحة التحقق لحل المشاكل

• تأكد بلي --cli DEMO خدام قبل ما تشخص الاتصال بالطوموبيل.
• تحقق بلي الـ Nano باين فالمخرج التسلسلي USB المتوقع.
• تأكد بلي الفيرموير ترفع باختيار محمّل الإقلاع الصحيح ديال Nano.
• قس الموصل التشخيصي وما تعتمدش غير على ألوان الأسلاك.
• تأكد ما كاين حتى سلك مربوط بالتجويف 6.
• راجع مسارات D10 وD11 وGND فوق لوحة التجارب مقارنة مع وثائق التوصيلات.
• استعمل xj_sniff ودليل حل المشاكل ملي كيبان الإعداد الكهربائي صحيح ولكن التواصل ما زال ما خدامش.
• تذكر بلي كمبيوترات Chrysler أو Jeep اللي ما تجرّباتش تقدر تختلف على طوموبيلة Cherokee ديال الاختبار من سنة 1994.

الخلاصة

xj-scanner كيوفر طريقة قليلة التكلفة باش تستكشف كمبيوتر محرك OBD1 ديال Jeep متوافقة باستعمال حاسوب محمول وArduino Nano. بدا بوضع demo، وتأكد من كل تجويف فالموصل باستعمال ملتيمتر، وتبع وثائق المستودع بدقة. المشروع برنامج هواة مرخّص بـ GPLv3 وكيتواصل مع إلكترونيات الطوموبيل، لذلك استعملو على مسؤوليتك وخلي السلامة الكهربائية هي الأولوية.

المشروع مبني على أعمال البروتوكول، والمعاملات، والتحجيم، ورموز الأعطال من ChryslerScanner، مع تحجيم تصحيح خليط الوقود مستند إلى كود SBEC المفكك.