ScanDoc για Προγραμματιστές

Προδιαγραφή J2534 και αναφορά λειτουργιών ›
Προδιαγραφή ELM327 και αναφορά εντολών ›

Η διεπαφή ELM327 είναι διαθέσιμη στο Nano ET. Οι υπόλοιποι προσαρμογείς ScanDoc χρησιμοποιούν το πρωτόκολλο J2534 PassThru.

Νέα για προγραμματιστές

Αλλαγές στο J2534 DLL, στο ELM327 και στο υλικολογισμικό των προσαρμογέων ScanDoc που αφορούν την ενσωμάτωση: νέες λειτουργίες, πρωτόκολλα και παράμετροι — με παραδείγματα χρήσης.

---

DLL 2.0.0.200, υλικολογισμικό Nano ET build 83 04.08.2026

Λήψη βιβλιοθηκών J2534 2.0.0.200 — Windows x86/x64/ARM64 (ξεχωριστά builds για Windows 7), macOS (universal), Linux (x64, x86, ARM, ARM64), Android (arm64-v8a, armeabi-v7a, x86, x86_64), iOS.

Υλικολογισμικό Nano ET — build 83

Νέα

• DoIP (ISO 13400) και BMW HSFZ — νέα πρωτόκολλα ISO13400_PS (0x8FFD) και HSFZ_PS (0x8FFC). Δεν ανήκουν στο πρότυπο SAE J2534 — είναι ιδιόκτητη επέκταση ScanDoc: διάγνωση μέσω Ethernet — εντοπισμός οχημάτων στο δίκτυο (VIN, λογική διεύθυνση), σύνδεση TCP, routing activation, ανταλλαγή UDS. Η διεύθυνση tester είναι προεπιλεγμένα 0 — ορίστε το ISO13400_SOURCE_ADDR πριν από το routing activation, αλλιώς η πύλη θα αρνηθεί· η διεύθυνση του ECU μεταδίδεται σε κάθε μήνυμα ([TA][SA][UDS]), το ISO13400_TARGET_ADDR δεν ορίζεται μέσω Set/GetConfig. Η αποστολή σειριοποιείται με P2: ένα εκκρεμές αίτημα UDS κάθε φορά, το NRC 7F xx 78 παρατείνει την αναμονή έως P2*max (6 s). Νέα παράμετρος καναλιού ISO13400_P3_DOIP (0x8108) — παύση μεταξύ μηνυμάτων.
  Παράδειγμα

  uint32_t ch, code = 0;
  pt_config_t sa  = { ISO13400_SOURCE_ADDR, 0x0E80 };
  pt_config_list_t cfg = { 1, &sa };
  
  PassThruConnect(dev, ISO13400_PS, 0, 0, &ch);
  PassThruIoctl(ch, SET_CONFIG, &cfg, NULL);                 /* SA — πριν από το routing activation */
  PassThruIoctl(ch, ISO13400_DISCOVER_VEHICLES, NULL, NULL); /* η IP του ECU απομνημονεύεται αυτόματα */
  PassThruIoctl(ch, ISO13400_CONNECT_TCP, NULL, NULL);
  PassThruIoctl(ch, ISO13400_ACTIVATE_ROUTING, NULL, &code); /* 0x10 = επιτυχία */
  /* έπειτα PassThruWriteMsgs / PassThruReadMsgs — κανονικό UDS */

• Διάγνωση διαύλου — το bus-off (κομμένη καλωδίωση/βραχυκύκλωμα, χωρίς ACK) και η λανθασμένη ταχύτητα CAN επιστρέφουν πλέον κατατοπιστικό κείμενο σφάλματος με το baud rate αντί για γενικό κωδικό αποτυχίας.
• Μία θύρα TCP για J2534 και ELM327 — η ξεχωριστή θύρα 35000 του ELM327 καταργήθηκε, και τα δύο πρωτόκολλα εξυπηρετούνται στη θύρα εντολών 53983. Το πρωτόκολλο αναγνωρίζεται από το πρώτο byte της σύνδεσης: 0x55 (δείκτης πλαισίου J2534) — J2534, οτιδήποτε άλλο (εντολή AT σε κείμενο) — ELM327.
• BLE — εναλλασσόμενη διεύθυνση MAC (RPA): οι σαρωτές βλέπουν τυχαία διεύθυνση, οι συζευγμένες συσκευές την επιλύουν μέσω IRK· γίνονται δεκτές μόνο συνδέσεις Secure Connections.

Διορθώσεις

• Φίλτρα CAN κατά bytes δεδομένων — το PassThruStartMsgFilter συνέκρινε μόνο τα 4 bytes του CAN ID, αγνοώντας το δηλωμένο μήκος φίλτρου. Πλέον το πλαίσιο συγκρίνεται σε όλο το μήκος, όπως απαιτεί το πρότυπο: τα PASS/BLOCK κατά περιεχόμενο πλαισίου λειτουργούν.
  Παράδειγμα

  /* Καταστολή απαντήσεων TesterPresent (07E8 02 7E ...) στην ουρά λήψης */
  pt_msg_t mask = {0}, pattern = {0};
  mask.protocol_id = pattern.protocol_id = CAN;
  mask.data_size   = pattern.data_size   = 6;   /* 4 bytes CAN ID + 2 bytes δεδομένων */
  memcpy(mask.data,    "\xFF\xFF\xFF\xFF\xFF\xFF", 6);
  memcpy(pattern.data, "\x00\x00\x07\xE8\x02\x7E", 6);
  uint32_t fid;
  PassThruStartMsgFilter(ch, BLOCK_FILTER, &mask, &pattern, NULL, &fid);

• J2534 — κάθε ληφθέν πλαίσιο παίρνει ατομική χρονοσφραγίδα τη στιγμή της λήψης, όπως απαιτεί η προδιαγραφή (πριν — κοινή ανά δέσμη)· η ηχώ του απεσταλμένου πλαισίου CAN επιστρέφεται μόνο σε επιτυχή αποστολή — η ηχώ σε αποτυχία TX παραπλανούσε τον host για την κατάσταση του διαύλου.
• ELM327 — η εντολή AT SH σε ενεργό κανάλι CAN χαλούσε το Flow Control (το FC έφευγε χωρίς padding, DLC=3 — η πύλη δεν έστελνε Consecutive Frames) και αντικαθιστούσε το φίλτρο λήψης με το δικό της TX ID (η λήψη χωρίς AT CRA χαλούσε). Σύμφωνα με το datasheet, το AT SH ορίζει μόνο την κεφαλίδα αποστολής — το φίλτρο λήψης ελέγχεται πλέον μόνο από τα AT CRA/CF/CM.
• Σύζευξη BLE με Android 14+ (Pixel) — αποτύγχανε όταν το Fast Pair / Find My Device του συστήματος ξεκινούσε σύζευξη παράλληλα με τη συσκευή.
• K-Line/KWP — χανόταν το τελευταίο byte της απάντησης σε πυκνή κίνηση· το μπλοκ ACK έφευγε ~70 ms αργότερα και διέκοπτε την αναγνώριση· το κανάλι κολλούσε μετά από αποτυχημένη σύνδεση.
• Το PassThruStopPeriodicMsg μπορούσε να στείλει ένα επιπλέον πλαίσιο μετά τη διακοπή.
• TP2.0/TP1.6 _PS — η επιλογή ακίδων μέσω SET_CONFIG(J1962_PINS) δεν εφαρμοζόταν, τα πλαίσια δεν έφταναν στον δίαυλο.
• Χειρισμός εσφαλμένων δεδομένων — επικύρωση κατεστραμμένων πλαισίων (ISO15765 First/Single Frame, μήκος πακέτου DoIP, συναρμολόγηση TP2.0/TP1.6) και παραμέτρων host (ReadMsgs, IOCTL): αντί να κολλάει ή να αλλοιώνει τη μνήμη, η συσκευή επιστρέφει κανονικούς κωδικούς σφάλματος J2534.

Βιβλιοθήκες J2534 — 2.0.0.200

Διορθώσεις

• Το timeout των εντολών ελέγχου μέσω WLAN/LAN αυξήθηκε στα 1000 ms — σε αργά ή φορτωμένα δίκτυα οι εντολές ελέγχου προς τη συσκευή έληγαν με timeout.

---