obd2_kit: Dart Library for ELM327 and OBD-II
Résumé
Pixel shares an overview of obd2_kit, a Dart library that handles ELM327 sessions and SAE J1979 vehicle diagnostics over Bluetooth, BLE, Wi-Fi, or USB. It covers live PIDs, trouble codes, multi-ECU and multi-frame responses, command queues, timeouts, and cancellation—useful details for building more reliable diagnostic apps.
DEV Community
obd2_kit: التخاطب مع محوّلات ELM327 و OBD-II من Dart عبر أي وسيلة اتصال
قراءة بيانات السيارة تبدو بسيطة على الورق. تركّب محوّل ELM327 صغيرًا في منفذ OBD-II، ترسل 010C، فتحصل على سرعة دوران المحرك. لكن في الواقع المحوّل عبارة عن طرفية نصية لها عاداتها: يعيد إليك الأمر الذي أرسلته (echo)، ويطبع SEARCHING... وهو يبحث عن الناقل (bus)، ويجيب على دفعات صغيرة، ويبلّغ عن الأخطاء بكلمات عادية مثل NO DATA أو BUS BUSY. وقد تأتي الردود من عدة وحدات تحكم (ECU) في الوقت نفسه، والرد الطويل مثل رقم الهيكل (VIN) يُقسَّم على عدة إطارات (frames). وفوق ذلك، الاتصال بالمحوّل يختلف من تطبيق لآخر: Bluetooth SPP أو BLE UART أو Wi-Fi TCP أو USB serial. obd2_kit مكتبة Dart تتكفل بجانب البروتوكول وتترك لك وسيلة الاتصال. تعمل فوق أي ناقل بايتات (byte transport)، وتغطي جلسة المحوّل، وخدمات SAE J1979، والردود متعددة الـ ECU ومتعددة الإطارات، والقراءة الحيّة. ماذا تقدّم جلسة ELM327. الصنف Elm327 ينفّذ تسلسل التهيئة (ATZ، ATE0، ATL0، ATS0، ATH1 أو ATH0، ATAT1، ATSP0)، ثم يرسل طلب 0100 الذي يشغّل البحث عن البروتوكول، ويقرأ البروتوكول الذي وجده المحوّل بـ ATDPN. ينتظر علامة > حتى لو وصل الرد على دفعات صغيرة كثيرة، ويحذف صدى الأمر وSEARCHING... وBUS INIT: ...OK. أما ردود الخطأ فتتحول إلى ElmErrorException يحمل قيمة ElmError، فتتعامل مع نوع محدد بدل مقارنة النصوص. الأوامر تمر عبر طابور FIFO يرسل أمرًا واحدًا في كل مرة. لكل أمر مهلة (timeout)، ويمكن أن يأخذ ObdCancelToken. الأمر المنتظر في الطابور إذا أُلغي لا يُرسل أبدًا. والأمر الجاري إذا انتهت مهلته أو أُلغي يُقاطَع: ترسل الجلسة بايتًا واحدًا، تنتظر علامة الجاهزية، ثم تكمل، فلا يُنسب رد متأخر إلى الأمر التالي أبدًا. خدمات J1979. الصنف ObdClient يغطي هذه الأوضاع (modes): Mode 01، البيانات الحالية: readPid تُرجع الرد من أصغر معرّف ECU، وreadPidAll تُرجع ردود كل الـ ECU، وsupportedPids تمر على خرائط البتات عند 00 و20 و40 و60 و80 وA0 وC0. Mode 02، الـ freeze frame، ومنه PID 02 (الرمز الذي سبّب تخزين الإطار). Mode 03 للرموز المخزّنة، و Mode 07 للرموز المعلّقة، و Mode 0A للرموز الدائمة، مجمّعة حسب الـ ECU. Mode 04 لمسح الرموز، ولا يعمل إلا بـ clearDtcs(confirm: true). Mode 09: رقم VIN، ومعرّفات المعايرة (calibration IDs)، واسم الـ ECU، والـ PIDs المدعومة. الإطارات. الدالة parseObdLines تقرأ الردود والترويسات مفعّلة: CAN بـ 11 بت (7E8 ...)، و CAN بـ 29 بت، وبايتات الترويسة الثلاثة مع الـ checksum في ISO 9141-2 و ISO 14230-4 KWP و SAE J1850. ردود عدة ECU تُفصل حسب المعرّف. وتعيد تجميع إطارات ISO 15765-2 (المفرد، والأول، والمتتابعة) لكل ECU، مع التحقق من أرقام التسلسل، ومنها الانتقال من F إلى 0. وعند إطفاء الترويسات تقرأ تنسيق الـ ELM الخاص بالردود متعددة الإطارات. وتُحلَّل الردود سواء كانت الفراغات مفعّلة أم لا. قيم PID لها أنواع. الدالة decodePid تُرجع NumericValue (قيمة مع ObdUnit)، أو MonitorStatusValue، أو ObdStandardValue، أو SupportedPidsValue، أو DtcValue، أو RawValue للـ PIDs التي لا تفكّها المكتبة. القائمة المدعومة فيها PID 01 (لمبة العطل MIL، وعدد الرموز، ومراقبات الجاهزية)، وحمل المحرك، وحرارة سائل التبريد، وتصحيحات الوقود، وعدد الدورات، والسرعة، وغيرها كثير. القائمة الكاملة في الـ README. رموز الأعطال. الصنف Dtc يفكّ ويحلّل رموز P و C و B و U مثل P0133، ويصنّفها إلى عامة (generic) أو خاصة بالمصنّع أو محجوزة حسب نطاقات SAE J2012، ويعطي مجموعة النظام الفرعي لرموز P0 (مثل misfire، وقياس الوقود والهواء، وغيرها). المراقبة الحيّة. الصنف ObdMonitor يستعلم عن مجموعة PIDs، كل واحد بفاصله الزمني، ويُصدر Stream. طلب واحد فقط يكون جاريًا في كل لحظة. الـ PID الأكثر تأخرًا يذهب أولًا، وعند التساوي يكون الدور بالتناوب، فيأخذ كل PID دوره حتى لو كان المحوّل أبطأ من المعدلات التي طلبتها. أخطاء الطلبات تخرج كأخطاء في الـ stream، ويستمر الاستعلام. طريقة الاستعمال أضِفها من GitHub: dependencies:
obd2_kit:
git: https://github.com/AbdeldjalilChougui/obd2_kit
المكتبة فيها transport جاهز لمحوّلات Wi-Fi عبر TCP في package:obd2_kit/io.dart. أغلب هذه المحوّلات تستمع على 192.168.0.10:35000: import 'package:obd2_kit/io.dart';
import 'package:obd2_kit/obd2_kit.dart';
Future main() async {
final transport = await TcpObdTransport.connect('192.168.0.10', 35000);
final elm = Elm327(transport);
final info = await elm.initialize(); // headers on, automatic protocol
print('${i...

Powered by Readybot.io