Panduan Penggunaan MEKANIK.AI
Konsol diagnostik untuk kendaraan ringan hingga mining haul truck: adapter yang didukung, koneksi live, profil J1939, library DTC tambang, wizard 9 langkah, dan safety gate.
Versi panduan 2.0 · diperbarui 30 Juli 2026
Prinsip utama
MEKANIK.AI adalah alat bantu diagnosis, bukan pengganti prosedur resmi pabrikan. Setiap tindakan pada unit wajib melewati safety gate A0–A4, dan perbaikan berbiaya tinggi memerlukan persetujuan dua orang. Dokumen dan data OEM dalam edisi demo harus diverifikasi dengan library resmi masing-masing pabrikan sebelum dipakai di produksi.
Siapa yang menggunakan panduan ini
- •Mekanik dan teknisi lapangan yang menjalankan sesi diagnosis serta koneksi kendaraan.
- •Supervisor dan fleet manager yang meninjau sesi, menyetujui perbaikan, dan memantau kesehatan armada.
- •Admin dan super admin yang mengelola pengguna, peran, konfigurasi sistem, serta audit.
- •Viewer/pemangku kepentingan yang hanya membaca dashboard, sesi, dan laporan.
Daftar isi
Ringkasan aplikasi
MEKANIK.AI adalah konsol diagnostik hybrid (web dengan pendamping desktop opsional) untuk teknisi kendaraan ringan hingga alat berat tambang. Cakupannya meliputi kendaraan penumpang, pickup, truk ringan, dump truck, prime mover, bus, excavator, wheel loader, dan mining haul truck ultra-class.
Kemampuan inti
- •Wizard sesi diagnosis 9 langkah dengan safety gate A0–A4.
- •Koneksi kendaraan nyata via OBD-II (ELM327) atau J1939 (companion service).
- •Engine rules hybrid: aturan deterministik digabung skor probabilistik.
- •Approval dua orang untuk perbaikan berbiaya tinggi (di atas Rp 5 juta).
- •Report PDF A4 lengkap dengan tanda tangan digital, evidence, dan audit trail.
- •Kontrol akses berbasis peran: super_admin, admin, fleet_manager, supervisor, mechanic, viewer.
- •Multi-tenant: masuk dengan email atau Google, data profil tersimpan dengan Row-Level Security.
Yang baru di edisi v2
- •Profil SAE J1939 HD lengkap: baud rate, konektor, source address, tabel FMI, dan katalog SPN.
- •Library DTC tambang lintas OEM (Caterpillar, Komatsu, Liebherr, Hitachi, BelAZ).
- •Simulator mining haul truck dengan skenario coolant creep, boost abnormal, dan fan clutch.
- •Knowledge base AI per kategori kendaraan: fault umum, service interval, konektivitas, safety gate.
- •Kategori baru mining_haul_truck dengan wizard dan verifikasi khusus tambang.
Status dokumen
Edisi ini bersifat demo. Untuk deployment produksi, konsultasikan library OEM resmi masing-masing pabrikan.
Perangkat & adapter yang didukung
Pilih adapter sesuai kelas kendaraan. Kendaraan ringan memakai OBD-II, sedangkan kendaraan berat dan alat berat memakai J1939 melalui companion service di desktop.
2.1 Kendaraan ringan (OBD-II)
| Adapter | Protokol | Antarmuka | Catatan |
|---|---|---|---|
| ELM327 USB | ISO 15765-4 CAN, ISO 9141, KWP2000 | Serial | Chrome/Edge, port serial. |
| ELM327 Bluetooth (BLE) | CAN OBD-II | Web Bluetooth (GATT) | Butuh pairing OS; layanan Nordic NUS/Vgate/HM-10. |
| ELM327 Bluetooth (Classic SPP) | CAN OBD-II | OS Bluetooth + Web Serial | OS memetakan SPP → COM/tty. |
| ELM327 Wi-Fi | CAN OBD-II | TCP (via companion) | Standalone dengan companion desktop. |
| OBDLink MX+ / EX | CAN OBD-II high-speed | Web Serial / Bluetooth | Direkomendasikan untuk PID streaming. |
2.2 Kendaraan berat & alat berat (J1939)
| Adapter | Protokol | Antarmuka | Catatan |
|---|---|---|---|
| Nexiq USB-Link 2 / 3 | SAE J1939 250k & 500k, J1708 | USB (RP1210 via companion) | Standar industri HD truck. |
| DPA5 Pro (Dearborn) | J1939, J1708, ISO15765 | USB / Bluetooth | Multi-brand, RP1210 compliant. |
| Peak PCAN-USB | Raw CAN 250k/500k | USB | Debugging & data acquisition. |
| Kvaser Leaf Light | CAN / J1939 | USB | Alternatif PCAN, cross-platform. |
| Cat CA3 + Cat ET | J1939 + Cat proprietary | USB | Wajib untuk Cat 777/793/793F. |
| Komatsu VHMS/KOMTRAX+ | J1939 + Komatsu OEM | Konektor 14-pin | Full akses Komatsu 830E/930E. |
| MTU DiaSys / MEDC | MTU proprietary | USB | BelAZ 75710 dual-engine MTU 4000. |
Companion service
Companion service adalah aplikasi desktop yang menjembatani driver native RP1210/PCAN di Windows/Linux ke aplikasi web MEKANIK.AI melalui WebSocket lokal (ws://127.0.0.1:8787). Service ini perlu dipasang di workstation teknisi kendaraan berat.
Cara koneksi secara live
Koneksi dilakukan lewat wizard tiga langkah, lalu dilanjutkan sesuai jenis transport yang dipilih.
3.1 Alur umum
- 01Pilih transport: ELM327 Web Serial, ELM327 Web Bluetooth, J1939 Companion, atau Simulator.
- 02Preflight & permissions: verifikasi browser, HTTPS, dan pairing OS, lalu klik “Minta Izin Perangkat”.
- 03Eksekusi koneksi: handshake, baca VIN, discover ECU/SA, dan mulai streaming PID.
3.2 Web Serial (ELM327 USB / SPP Bluetooth)
- •Gunakan Chrome/Edge pada HTTPS. Sambungkan ELM327 hingga OS mendeteksi COMx atau /dev/ttyUSBx.
- •Klik “Minta Izin Perangkat” lalu pilih port pada dialog browser.
- •Aplikasi mengirim ATZ (reset), ATE0 (echo off), ATH1 (headers on), ATSP0 (auto protocol).
- •Verifikasi VIN via Mode 09 PID 02; jika VIN kembali, koneksi valid.
3.3 Web Bluetooth (GATT — ELM327 BLE)
- •Wajib HTTPS dan Chrome/Edge desktop atau Android.
- •OS harus sudah memasangkan adapter (Settings → Bluetooth); aplikasi tidak melakukan pairing.
- •Klik “Pilih Perangkat Bluetooth” untuk menampilkan device dengan layanan UART.
- •Probe otomatis Nordic NUS, Vgate, dan HM-10.
- •Setelah service dipilih, aplikasi berlangganan notification pada karakteristik TX dan mengirim command.
3.4 J1939 Companion (HD & alat berat)
- •Pasang MEKANIK.AI Companion di desktop Windows/Linux.
- •Companion menemukan adapter RP1210/PCAN lalu membuka WebSocket ws://127.0.0.1:8787.
- •Pada wizard, pilih “J1939 Companion” agar aplikasi menyambung ke WebSocket tersebut.
- •Companion mengirim frame CAN raw / PGN terdekode; aplikasi mengirim RQST dan DM11.
- •Baud rate default 250 kbps dan otomatis beralih ke 500 kbps pada powertrain modern.
Profil J1939 HD (reference card)
Ringkasan lapisan fisik, diagnostic message, kode FMI, katalog SPN, dan prasyarat clear DTC untuk jaringan SAE J1939.
4.1 Physical layer & konektor
- •Konektor: Type-I 9-pin Deutsch (250k, hitam), Type-II 9-pin Deutsch (500k, hijau), OBD-II 16-pin (light-duty).
- •Terminator 120Ω wajib di kedua ujung backbone; total impedansi bus sekitar 60Ω.
- •Address Claim (PGN 60928): semua ECU mengklaim SA saat power-on; konflik diselesaikan dengan prioritas NAME.
- •Transport protocol: BAM untuk broadcast >8 byte tanpa handshake; CMDT untuk peer-to-peer.
| Kbps | Spec | Pemakaian |
|---|---|---|
| 250 | SAE J1939-11 / -15 | Default HD truk, bus, prime mover, mesin diesel industri. |
| 500 | SAE J1939-14 | Powertrain modern (pasca-2016) dengan aftertreatment kompleks. |
4.2 Diagnostic messages (DM)
| DM | PGN | Fungsi |
|---|---|---|
| DM1 | 65226 | Active DTC — broadcast tiap 1 detik selama ada DTC. |
| DM2 | 65227 | Previously Active DTC — dibaca on-request. |
| DM3 | 65228 | Clear Previously Active DTC. |
| DM11 | 65235 | Clear Active DTC — butuh prasyarat (lihat 4.5). |
| DM19 | 54016 | Calibration Verification Number. |
4.3 FMI (Failure Mode Identifier)
| FMI | Arti |
|---|---|
| 0 | Data valid, di atas normal (severe) |
| 1 | Data valid, di bawah normal (severe) |
| 2 | Data intermittent / erratic |
| 3 | Voltage tinggi / short-to-high |
| 4 | Voltage rendah / short-to-ground |
| 5 | Open circuit |
| 6 | Grounded circuit |
| 7 | Sistem mekanis tidak merespon |
| 8 | Frekuensi / PWM abnormal |
| 9 | Update rate abnormal |
| 10 | Rate of change abnormal |
| 11 | Root cause tidak diketahui |
| 12 | Bad device / component |
| 13 | Out of calibration |
| 14 | Special instruction |
| 15/16 | Data sedikit/moderat di atas normal |
| 17/18 | Data sedikit/moderat di bawah normal |
| 19 | Data error dari sumber lain di jaringan |
| 20/21 | Drift high / low |
| 31 | Condition exists |
4.4 Katalog SPN yang paling sering ditemui
| SPN | Sistem | Label | Catatan lapangan |
|---|---|---|---|
| 100 | Engine | Engine oil pressure (kPa) | FMI 1/17: oli rendah — risiko kegagalan mesin. |
| 102 | Engine | Boost pressure (kPa) | FMI 0/16: CAC restriction / waste-gate stuck. |
| 105 | Engine | Intake manifold air temperature (°C) | FMI 16: CAC fouling / ambient tinggi. |
| 110 | Cooling | Engine coolant temperature (°C) | FMI 0/16: overheating — fan / pump / radiator. |
| 111 | Cooling | Coolant level (%) | FMI 1/17: coolant rendah — kebocoran. |
| 157 | Fuel | Rail pressure (MPa) | FMI 1/17: pompa CP / regulator. |
| 190 | Engine | Engine speed (rpm) | FMI 8: crank/cam sensor drop-out. |
| 411 | Aftertreatment | EGR differential pressure (kPa) | FMI 0/16: EGR cooler fouling. |
| 651 | Engine | Injector cyl #1 | FMI 5: open circuit injektor. |
| 975 | Cooling | Engine fan speed (rpm) | FMI 7: fan diperintah tapi tidak berputar. |
| 1127 | Engine | Turbo 1 boost (kPa) | FMI 0/16: over-boost. |
| 1636 | Engine | Intake air restriction (kPa) | FMI 0: filter udara / pre-cleaner tersumbat. |
| 3226 | Aftertreatment | SCR outlet NOx (ppm) | FMI 0/16: DEF/urea/dosing/catalyst issue. |
| 3251 | Aftertreatment | DPF differential pressure (kPa) | FMI 0/16: DPF regen gagal. |
| 3719 | Aftertreatment | DPF soot load (%) | FMI 0: soot di atas 100% — parked regen wajib. |
| 4364 | Aftertreatment | SCR conversion efficiency (%) | FMI 18: DEF/catalyst rusak. |
4.5 DM11 (clear DTC) — prasyarat wajib
- •Mesin mati (KOEO — Key On Engine Off) untuk mayoritas OEM HD.
- •Parking brake aktif, roda tersanggah, dan area kerja aman.
- •Tidak ada aktuator test aktif; scan tool memiliki hak akses tingkat 2.
- •Perintah dikirim ke SA target (0x00 engine, 0x03 TCM), bukan broadcast.
- •Verifikasi DM1 broadcast setelah clear: DTC yang sama tidak muncul kembali dalam 60 detik operasi.
Kendaraan yang didukung
Registry aset mengelompokkan unit berdasarkan kategori sehingga wizard otomatis memuat profil jaringan dan adapter yang sesuai.
5.1 Kendaraan ringan
| Kategori | Contoh | Jaringan | Adapter utama |
|---|---|---|---|
| Passenger car | Camry, CR-V, Xpander | OBD-II CAN 500k | ELM327 USB/BLE, OBDLink MX+ |
| Pickup / D-cab | Hilux, Ranger, Triton | OBD-II CAN + body CAN | ELM327 + OEM tool |
| Light truck | Elf NPR, Dutro, Colt Diesel | OBD-II atau J1939 250k | ELM327 / Nexiq |
5.2 Kendaraan berat
| Kategori | Contoh | Jaringan | Adapter utama |
|---|---|---|---|
| Dump truck | Hino 500, Giga, Quester | J1939 250k | Nexiq USB-Link 2/3, DPA5 |
| Prime mover | Scania R500, MAN TGS, Actros | J1939 250k + 500k | Nexiq / DPA5 + OEM SDP3/MAN-cats |
| Bus | OH1626, Hino RN8, K410 | J1939 250k + FMS gateway | Nexiq / DPA5 |
5.3 Alat berat
| Kategori | Contoh | Jaringan | Adapter utama |
|---|---|---|---|
| Excavator | PC300-8, Cat 330, ZX350 | J1939 + CANopen OEM | Cat ET, KomtraxPlus |
| Wheel loader | WA380-8, 966H, L120 | J1939 250k | Cat ET, Komatsu |
5.4 Mining haul truck (ultra-class)
| Model | Payload | Powertrain | Diagnostic entry |
|---|---|---|---|
| Caterpillar 777G | 100 t | C32 diesel, mekanik | J1939 + Cat ET (CA3) |
| Caterpillar 793F | 240 t | C175-16 diesel, mekanik | J1939 + Cat ET |
| Komatsu 830E-AC | 220 t | SSDA16V160, AC drive (GE) | VHMS + J1939 + GE panel |
| Komatsu 930E-4 | 290 t | MTU 4000, AC drive Siemens/GE | VHMS + MTU MEDC |
| Liebherr T 264 | 240 t | Cummins QSK60, AC drive | J1939 + Liebherr LIDAT |
| Liebherr T 284 | 363 t | Cummins QSK95, AC drive | J1939 + LIDAT |
| Hitachi EH5000AC-3 | 296 t | MTU 16V4000, AC drive Hitachi | J1939 + Hitachi Wenco |
| BelAZ 75710 | 450 t | Dual MTU 16V4000, AC drive | MTU DiaSys + BelAZ OEM |
Library DTC tambang
Isi lengkap tersedia pada menu Knowledge → Mining DTC Library. Ringkasan berikut mencakup skenario yang paling sering dieskalasi.
6.1 Preventive maintenance tambang
| Interval | Kategori | Task |
|---|---|---|
| Setiap shift | Walkaround | Cek level oli/coolant/hidrolik; tire visual; leak inspection. |
| 250 jam | Filter & fluida | Filter oli engine, filter solar; sampling oli hidrolik & transmisi. |
| 500 jam | Cooling | Ultrasonic clean radiator + CAC; test fan clutch respons. |
| 500 jam | Electric drive | Megger DC link + kabel wheel motor; bersihkan cabinet GE. |
| 1000 jam | Aftertreatment | Ash cleaning DPF; kalibrasi dosing SCR; refresh DEF. |
| 2000 jam | Suspension | Recharge nitrogen strut; inspeksi seal; kalibrasi payload. |
| Kode | Model | Sistem | Ringkasan |
|---|---|---|---|
| SPN 110 / FMI 16 | Cat 793F | Cooling | Coolant creep haul cycle — CAC/radiator fouling, fan clutch drift. |
| SPN 102 / FMI 16 | Cat 777G/793F | Engine | Boost abnormal — CAC restriction / waste-gate stuck. |
| SPN 975 / FMI 7 | Cat 789D/793F | Cooling | Fan clutch tidak merespon perintah PWM. |
| SPN 1636 / FMI 0 | Cat 777/793 | Engine | Restriction filter udara — pre-cleaner tambang saturasi. |
| E-217 | Komatsu 830E-AC | Electric drive | Ground fault rectifier — insulator lembab / kabel wheel motor. |
| E-431 | Komatsu 830E/930E | Hoist | Hoist pressure drop — seal silinder / counter-balance valve. |
| SPN 3251 / FMI 16 | Liebherr T 264 | Aftertreatment | DPF backpressure — duty cycle low-load, regen gagal. |
| BEL-DUAL-101 | BelAZ 75710 | Engine | Dual-engine desync — CAN bridge / firmware / fuel imbalance. |
| SPN 3226 / FMI 18 | Hitachi EH5000AC-3 | Aftertreatment | SCR efficiency low — DEF, dosing, catalyst poisoning. |
| VIMS-PL-201 | Cat VIMS 3G | Telemetri | Payload di atas 110% target — risiko frame & tire. |
| SUSP-STRUT-DIFF | Komatsu 830E/930E | Suspension | Delta pressure strut kiri-kanan di atas 20% — nitrogen/seal. |
Wizard sesi diagnosis (9 langkah)
Setiap sesi diagnosis mengikuti sembilan langkah berurutan agar hasil dapat diaudit dari keluhan awal sampai verifikasi pasca-perbaikan.
1. Pilih aset & keluhan
Pilih unit dari registry (kategori dimuat otomatis), lalu isi keluhan operator dan konteks operasi.
2. Safety gates A0–A4
Konfirmasi APD, lockout, depressurize hidrolik, dan tindakan pencegahan engine-on. A4 mewajibkan sign-off dua orang.
3. Koneksi & handshake
Pilih transport (ELM327, Web Bluetooth, J1939 Companion, atau Simulator), baca VIN, lalu discover ECU/SA.
4. Baca DTC
Mode 03 untuk OBD atau DM1 untuk J1939, kemudian klasifikasikan sebagai info, warning, atau critical.
5. Streaming PID / SPN
Live chart coolant, boost, fan PWM, oil pressure, rpm, dan load; rekam sebagai evidence.
6. AI analysis
Engine hybrid menggabungkan rules deterministik dengan skor probabilistik untuk menghasilkan hipotesis berperingkat.
7. Cost estimate & parts
Kalkulasi biaya minimum, likely, dan maximum, beserta estimasi downtime dan ketersediaan part.
8. Approval
Approval satu orang untuk perbaikan di bawah Rp 5 juta; dua orang (mechanic + supervisor) untuk Rp 5 juta ke atas.
9. Verifikasi post-repair
DM11 clear DTC sesuai prasyarat, live retest, road/haul-cycle test, lalu terbitkan report PDF.
Safety gates A0–A4
Gate keselamatan wajib dilalui berurutan. Sesi tidak dapat berlanjut sebelum gate pada tingkat yang relevan dikonfirmasi.
| Gate | Nama | Syarat |
|---|---|---|
| A0 | Awareness | APD lengkap, area kerja aman, briefing radio. |
| A1 | Isolate | Lock-out tag-out battery isolator, kunci kontak, parking brake. |
| A2 | Depressurize | Buang tekanan hidrolik/pneumatik/refrigerant; verifikasi gauge nol. |
| A3 | Engine ON test | Aktuator test dengan mesin hidup — spotter wajib, PPE ganda. |
| A4 | Two-person approval | Dua tanda tangan (mechanic + supervisor/fleet manager) sebelum eksekusi berbiaya tinggi atau clear DTC berisiko. |
Troubleshooting koneksi
Gejala paling umum saat menyambungkan adapter beserta langkah perbaikannya.
| Gejala | Kemungkinan | Solusi |
|---|---|---|
| Dialog port serial kosong | Driver USB-serial belum terpasang | Install driver FTDI/CH340; cek Device Manager. |
| BLE tidak muncul di dialog | Adapter belum di-pair di OS | Pair via Settings → Bluetooth, lalu ulangi request. |
| VIN kosong | Protokol salah atau kunci OFF | Set ATSP0; putar kunci ke ON; ulangi handshake. |
| DM1 tidak masuk | Terminator hilang atau baud rate salah | Cek 60Ω pada bus; toggle 250k ↔ 500k. |
| DM11 ditolak | Prasyarat tidak terpenuhi | Matikan mesin, aktifkan parking brake, kirim ke SA target. |
| WebSocket companion offline | Service belum berjalan atau port bentrok | Jalankan companion service; cek ws://127.0.0.1:8787. |
Role, approval, & keamanan
Akses dibatasi per peran dengan prinsip hak minimum. Setiap tindakan penting tercatat pada audit trail.
Kontrol keamanan
- •Autentikasi melalui backend terkelola: email/kata sandi, magic link, atau Google OAuth.
- •Row-Level Security aktif pada data profil, peran, koneksi kendaraan, pembacaan DTC, sampel PID, dan event kendaraan.
- •Pengecekan peran memakai fungsi security definer sehingga bebas rekursi kebijakan.
- •Perlindungan tambahan di produksi: source map dinonaktifkan serta pembatasan akses alat pengembang.
| Role | Kemampuan |
|---|---|
| super_admin | Kelola semua pengguna dan peran (termasuk pemberian admin/super_admin). Tanpa batas. |
| admin | Kelola pengguna non-admin, konfigurasi sistem, akses seluruh audit. |
| fleet_manager | Menyetujui perbaikan berbiaya tinggi dan memantau kesehatan armada. |
| supervisor | Menyetujui perbaikan standar, meninjau sesi, sign-off verifikasi. |
| mechanic | Menjalankan wizard diagnosis, koneksi kendaraan, dan eksekusi perbaikan. |
| viewer | Read-only: dashboard, sesi, dan report. |
Glosarium status
- BAM
- Broadcast Announce Message — transport protocol J1939 untuk pesan lebih dari 8 byte.
- CAC
- Charge Air Cooler — intercooler intake diesel turbo.
- DEF/AdBlue
- Diesel Exhaust Fluid — larutan urea 32,5% untuk SCR.
- DM1/DM11
- Diagnostic Message 1 (DTC aktif) dan 11 (clear DTC) pada J1939.
- DPF
- Diesel Particulate Filter — perangkap soot di aftertreatment.
- ECU/ECM
- Electronic Control Unit / Module.
- EGR
- Exhaust Gas Recirculation.
- FMI
- Failure Mode Identifier — jenis kegagalan (0–31) pada J1939.
- KOEO / KOER
- Key On Engine Off / Key On Engine Running.
- PGN
- Parameter Group Number — pengenal pesan J1939.
- PWM
- Pulse-Width Modulation — sinyal kontrol aktuator.
- RP1210
- API standar Windows untuk vehicle diagnostic adapter.
- SA
- Source Address — 0..255, identitas ECU pada bus J1939.
- SCR
- Selective Catalytic Reduction — reduksi NOx dengan urea.
- SPN
- Suspect Parameter Number — parameter atau sinyal tertentu pada J1939.
- TCM
- Transmission Control Module.
- VIMS
- Vital Information Management System — telemetri Caterpillar.
- VGT
- Variable Geometry Turbocharger.
Catatan perubahan
Panduan ini mengikuti implementasi aplikasi pada 30 Juli 2026. Apabila menu, peran, penyedia, harga, atau workflow berubah setelah tanggal tersebut, dokumentasi akan diperbarui agar tetap sama dengan aplikasi. Pertanyaan teknis dapat dikirim ke halo@nagatama.id.