Yakha Iskena se-OBD1 Esisekelwe ku-Arduino seJeep yango-1991–95

Yini i-xj-scanner?

xj-scanner ixhuma ilaptop kukhompyutha yenjini yeJeep yango-1991–95 isebenzisa i-Arduino Nano engu-5 V engabizi. Izintambo ezintathu zisuka kusixhumi sokuxilonga esingaphansi kwe-hood ziye ku-Nano, yona exhunywa kwilaptop nge-USB.

Uma isixhunyiwe, le phrojekthi ingafunda amakhodi amaphutha futhi ibonise idatha yenjini ebukhoma, igcine ulwazi ngesikhathi sokushayela, futhi isebenzise izivivinyo zama-actuator ezakhelwe kukhompyutha yenjini. I-Claude Code, i-Codex, noma enye i-agent yokubhala ikhodi ingakuqondisa ekusetheni nasekuhumusheni imiyalelo ekurepository.

Le phrojekthi yakhiwa futhi yahlolwa ku-Jeep Cherokee XJ yango-1994 enenjini engu-4.0L nenombolo yengxenye yekhompyutha engu-56030117. Amanye amakhompyutha e-Chrysler neJeep SBEC/OBD1 yango-1991–95 angafana, kodwa ukuhambisana akuqinisekisiwe. Hlala ulinganisa isixhumi sakho sokuxilonga ngaphambi kokuxhuma ihardware.

Izici ezibalulekile

• Ifunda amakhodi amaphutha ekhompuyutha yenjini.
• Ibonisa amapharamitha enjini abukhoma namanani awo akaliwe.
• Igcina idatha ebukhoma kumafayela angaphansi kwe-pc/logs/.
• Isekela izivivinyo zama-actuator ezakhelwe kukhompyutha yenjini.
• Ihlanganisa imodi yeJeep elingisiwe yokuhlola isofthiwe yelaptop ngaphandle kwemoto.
• Ihlinzeka nge-sketch yokulungisa izintambo ze-Nano kanye ne-firmware enkulu yebhuloho.
• Ihlanganisa amathuluzi awusizo okufingqa amalogi, ukuskena amapharamitha, nokuhlola inombolo yengxenye yekhompyutha.
• Ihlinzeka ngezinhlelo eziqondiswe kuma-agent zokufaka nokuqeda izinkinga ngokuqondiswa.

Ihardware oyidingayo

Izindleko zehardware ezilindelekile zingaba ngu-$15. Qoqa lezi zingxenye ngaphambi kokuqala:

• I-clone ye-Arduino Nano engu-5 V ene-USB-C noma i-mini-USB nekhebula elihambisanayo.
• I-breadboard encane.
• Izintambo ezimbalwa ze-breadboard jumper.
• Izintambo ezintathu ezinde ngokwanele ukusuka kusixhumi esingaphansi kwe-hood ukuya endaweni ekuyo ilaptop.
• Ama-terminal amathathu e-spade owesilisa angu-1/4-inch angena kusixhumi sokuxilonga.
• I-multimeter.

Isexwayiso esibalulekile sokuphepha

I-cavity 6 iphethe ama-volts angu-12 uma ukhiye wokuthungela uvuliwe. Ungalokothi uxhume i-Arduino noma noma yiluphi ucingo lweskena ku-cavity 6.

Ungawakhombi ama-cavity esixhumi ngombala wentambo. Emotweni ehloliwe, i-cavity 6 yayisebenzisa umbala wentambo omnyama nomhlophe ofanayo nowentambo yomhlaba. Ukuxhuma ngephutha kungadalula i-Nano noma ilaptop kumandla kagesi emoto.

Ngaphambi kokuxhuma noma yini, sebenzisa i-multimeter ukuhlola yonke i-cavity. Qhathanisa izilinganiso zakho nokufundwayo okulindelekile ku-docs/connector.md. Izintambo ezahlolwa kurepository zixhuma amaphini e-Nano D10, D11, ne-GND kuma-cavity 4, 3, no-2 epulaki lokuxilonga ngokulandelana, kodwa kufanele uqale uqinisekise isixhumi semoto yakho.

Indlela 1: Vumela i-agent ye-AI yokubhala ikhodi ikuqondise ekusetheni

Indlela elula yokufaka ukusebenzisa i-Claude Code, i-Codex, noma enye i-agent ekwazi ukuqonda i-repository.

1. Clone i-repository ye-xj-scanner uyifake kwilaptop yakho.
2. Vula i-repository ku-agent yakho yokubhala ikhodi.
3. Buza: Ngisize ngixhume lokhu kuJeep yami.
4. Landela imiyalelo isinyathelo ngesinyathelo.

I-agent ingafunda i-AGENTS.md nama-playbook angaphansi kwe-.claude/skills/. Le miyalelo ihlanganisa ukusethwa kwesofthiwe, ukuhlanganiswa kwe-breadboard, ukukhomba ama-cavity esixhumi nge-meter, nokuthatha ukufundwa kokuqala. Uma umyalelo ungaqondakali, cela i-agent iwuchaze ngamagama alula ngaphambi kokuqhubeka.

Indlela 2: Faka futhi usebenzise i-xj-scanner ngesandla

1. Dala indawo ye-Python

Kusuka empandeni ye-repository, dala indawo ebonakalayo bese ufaka okuncike kukho iskena:

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

2. Hlola isofthiwe yelaptop ngemodi yedemo

Ngaphambi kokuxhuma kuJeep, sebenzisa iskena emotweni yayo elingisiwe:

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

Lokhu kuqinisekisa ukuthi ingxenye yePython iyasebenza ngaphandle kokudinga i-Arduino noma ikhompyutha yenjini. Uma imodi yedemo yehluleka, lungisa inkinga eseceleni kwelaptop ngaphambi kokuqhubekela ezintanjeni zemoto.

3. Faka i-Arduino CLI ne-AVR core

I-README inikeza imiyalo elandelayo ye-macOS ene-Homebrew:

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

Uma usebenzisa olunye uhlelo lokusebenza, faka i-arduino-cli ngendlela efanele yaleyo nkundla, bese ufaka i-core ye-arduino:avr.

4. Xhuma futhi ukhombe i-Nano

Xhuma i-Arduino Nano kwilaptop nge-USB. Thola i-serial port yayo, bese ushintsha u-/dev/cu.usbserial-XXXX emyalweni wokulayisha ufake i-port yangempela.

Isibonelo sisebenzisa isikhombi sebhodi esithi arduino:avr:nano:cpu=atmega328old, esikhetha ukucushwa kwe-bootloader endala okusetshenziswa ama-clone amaningi e-Nano.

5. Hlanganisa bese ulayisha i-firmware yebhuloho

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

I-xj_bridge sketch iguqula i-Nano ibe yibhuloho lokuxhumana phakathi kweskena esikwilaptop nekhompyutha yenjini yeJeep.

6. Qinisekisa futhi uhlanganise izintambo

Njengoba izintambo zemoto zingakaxhunywa ku-Nano, sebenzisa i-multimeter ukukhomba ama-cavity esixhumi sokuxilonga. Bheka uhla lwe-docs/ kurepository ukuze uthole izilinganiso zesixhumi, ukuhlelwa kwe-breadboard, nemininingwane yezintambo.

Emotweni ehloliwe, ukuxhumana kwezimpawu ezintathu kungokulandelayo:

• I-Nano D10 iye ku-cavity 4 yesixhumi sokuxilonga.
• I-Nano D11 iye ku-cavity 3 yesixhumi sokuxilonga.
• I-Nano GND iye ku-cavity 2 yesixhumi sokuxilonga.

Ungaqhubeki usebenzisa lolu hlu kuphela. Qinisekisa imbobo ngayinye emotweni yakho futhi ugcine zonke izintambo zikude nembobo yesi-6.

7. Funda amakhodi amaphutha nedatha ebukhoma

Uma i-firmware nezintambo eziqinisekisiwe sezilungile, vula ukhiye wokuthungela uye ku-ON bese usebenzisa:

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

Kumodi ezenzakalelayo, iskena ifunda amakhodi amaphutha bese iqoqa idatha ebukhoma. Amalogi abhalwa ngaphansi kwe-pc/logs/.

Ukuqonda ukuhlelwa kwe-repository

• arduino/: Iqukethe i-Nano sketch eyinhloko ye-xj_bridge kanye ne-sketch ye-xj_sniff yokulungisa izinkinga zezintambo.
• pc/: Iqukethe i-xj_scan.py, ephatha amakhodi amaphutha, idatha ebukhoma, ukuloga, nokuhlolwa kwama-actuator.
• tools/: Iqukethe amathuluzi okufingqa amalogi, ukuhlola yonke ipharamitha, nokubheka inombolo yengxenye yekhompyutha yenjini.
• docs/: Ichaza isixhumi, izintambo, iphrothokholi yokuxhumana, amapharamitha, amafomula okukala, nezinqubo zokuxazulula izinkinga.
• .claude/skills/: Iqukethe iziqondiso ezinezinyathelo nezinyathelo i-ejenti ye-AI engazilandela kanye nawe.

Indlela yokusebenza eyisisekelo

Iseshini yokuqala enokuqapha kufanele ilandele lolu hlelo:

1. Qalisa imodi ye-DEMO ukuze uqinisekise i-Python nezinto ezincike kuyo.
2. Faka i-xj_bridge ku-Nano.
3. Nqamula izintambo ezisohlangothini lwemoto bese ukala yonke imbobo yesixhumi.
4. Qinisekisa izimbobo zomhlaba nezokuxhumana usebenzisa imibhalo.
5. Yakha isekethe ye-breadboard bese uhlola kabusha konke ukuxhumana.
6. Vula ukhiye uye ku-ON ngaphandle kokuqalisa injini.
7. Qalisa iskena nge---cli auto.
8. Buyekeza amakhodi amaphutha abikiwe futhi uqinisekise ukuthi ilogi ivela ku-pc/logs/.

Amathiphu athuthukile

Sebenzisa i-debug sketch uma ukuxhumana kwehluleka

I-sketch ye-arduino/xj_sniff ifakiwe ukuze kuhlonzwe izinkinga zezintambo. Yisebenzise kanye nezinto zokuxazulula izinkinga eziku-docs/ lapho i-bridge ingakwazi ukuxhumana nekhompyutha yenjini. Gwema ukushintsha izintambo ngenkathi uhlelo lunikwe amandla.

Fingqa amalogi ohambo

Ngemva kokuqopha idatha ebukhoma, hlola amathuluzi asizayo aku-tools/. I-repository ihlanganisa ithuluzi lokufingqa ilogi elingenza ukuqoshwa okude kube lula ukukubuyekeza. Sebenza ngekhophi yelogi uma ufuna ukugcina idatha yoqobo ingashintshiwe.

Hlola amapharamitha atholakalayo ngokucophelela

Ithuluzi elisizayo lingahlola yonke ipharamitha eyaziwa yiphrojekthi. Bheka imibhalo yephrothokholi namapharamitha ngaphambi kokuyisebenzisa ukuze uqonde okucelwayo nokuthi inani ngalinye elingahluziwe likalwa kanjani.

Hlola inombolo yengxenye yekhompyutha yenjini

Ngenxa yokuthi iphrojekthi yaqinisekiswa kukhompyutha yenjini engu-56030117, sebenzisa ithuluzi lenombolo yengxenye elinikeziwe lapho uphenya enye imoto. Enye ikhompyutha ye-SBEC/OBD1 ingase iziphathe ngendlela efanayo, kodwa i-README ayiqinisekisi ukusekelwa.

Qaphela ngokuhlolwa kwama-actuator

Iskena se-PC sisekela ukuhlolwa kwama-actuator okwakhelwe ngaphakathi. Lokhu kuhlola kungathumela imiyalo ezingxenyeni zemoto, ngakho kusebenzise kuphela uma uqonda ukuhlolwa okuthile, imoto ibekwe endaweni ephephile, futhi izingxenye ezihambayo noma ezinikwe amandla zingenakubangela ukulimala noma umonakalo.

Sebenzisa imibhalo eningiliziwe yokukala

Ifolda ye-docs/ ichaza amapharamitha atholakalayo namafomula okukala. Yibheke lapho uhumusha ukufundwa okungahluziwe, ikakhulukazi uma uhlaziya i-fuel trim noma uqhathanisa inani nelinye ithuluzi lokuskena.

Uhlu lokuhlola lokuxazulula izinkinga

• Qinisekisa ukuthi i---cli DEMO iyasebenza ngaphambi kokuhlola ukuxhumana kwemoto.
• Qinisekisa ukuthi i-Nano iyavela embotsheni ye-USB serial elindelekile.
• Qinisekisa ukuthi i-firmware yafakwa kukhethwe i-bootloader efanele ye-Nano.
• Kala isixhumi sokuxilonga esikhundleni sokuthembela emibaleni yezintambo.
• Qinisekisa ukuthi akukho ntambo exhunywe embobeni yesi-6.
• Hlola izindlela ze-breadboard ze-D10, D11, ne-GND uziqhathanise nemibhalo yezintambo.
• Sebenzisa i-xj_sniff nomhlahlandlela wokuxazulula izinkinga lapho ukusethwa kukagesi kubonakala kulungile kodwa ukuxhumana kusahluleka.
• Khumbula ukuthi amakhompyutha e-Chrysler noma e-Jeep angahloliwe angahluka emotweni yokuhlola eyi-1994 Cherokee.

Isiphetho

i-xj-scanner inikeza indlela engabizi yokuhlola ikhompyutha yenjini ye-OBD1 ye-Jeep ehambisanayo usebenzisa ikhompuyutha ephathekayo ne-Arduino Nano. Qala ngemodi ye-demo, qinisekisa yonke imbobo yesixhumi usebenzisa i-multimeter, futhi ulandele imibhalo ye-repository ngokucophelela. Iphrojekthi iyisofthiwe yokuzilibazisa ye-GPLv3 exhumana nezinto zikagesi zemoto, ngakho yisebenzise ngokuzibeka wena engozini futhi ubeke ukuphepha kukagesi kuqala.

Iphrojekthi yakhela emsebenzini wephrothokholi, amapharamitha, ukukala, namakhodi amaphutha ovela ku-ChryslerScanner, kanti ukukalwa kwe-fuel trim kusekelwe kulwazi oluvela ku-ikhodi ye-SBEC ehlukanisiwe.