Quantex GmbH
DE RU EN EL
Ihre Region: Europa
  1. Startseite
  2. ScanDoc Development
  3. J2534-Handbuch

Beschreibung der PassThru-DLL-Funktionen nach J2534-1/2

Letzte Änderung:

Versionen des J2534-Standards

Es gibt zwei Versionen des SAE J2534-Standards:

Version Pfad in der Windows-Registry Besonderheiten
v04.04 HKLM\SOFTWARE\PassThruSupport.04.04 Grundlegender Satz an PassThru-Funktionen
v05.00 HKLM\SOFTWARE\PassThruSupport.05.00 Die Funktionen PassThruScanForDevices und PassThruGetNextDevice zur dynamischen Geräteerkennung wurden hinzugefügt

Kompatibilität: Die Versionen sind untereinander nicht kompatibel. Diagnoseprogramme suchen die DLL ausschließlich anhand ihrer eigenen Registry-Version:

Arbeit mit Geräten

v04.04: Unterstützt gleichzeitig nur ein Gerät, dessen Parameter in der Registry eingetragen sind. Die Anwendung lädt die DLL und ruft PassThruOpen(NULL) auf, um sich mit dem in der Registry angegebenen Gerät zu verbinden.

v05.00: Unterstützt die dynamische Geräteerkennung. Typischer Ablauf:

  1. Die Anwendung liest den Registry-Zweig PassThruSupport.05.00 und zeigt dem Benutzer die Liste der Hersteller (Vendor) an
  2. Der Benutzer wählt einen Hersteller aus, die Anwendung lädt die entsprechende DLL
  3. Aufruf von PassThruScanForDevices zum Scannen angeschlossener Geräte (kabelgebunden und drahtlos)
  4. Aufruf von PassThruGetNextDevice in einer Schleife zum Abrufen der Informationen zu jedem gefundenen Gerät
  5. Die Anwendung zeigt die Liste der Geräte an, der Benutzer wählt das gewünschte aus
  6. Aufruf von PassThruOpen mit dem Namen des ausgewählten Geräts

Multithreading

Wichtig: Das J2534-API ist nicht thread-sicher. Das Protokoll ist anfrage-/antwortbasiert. Eine neue Funktion darf erst aufgerufen werden, wenn die vorherige abgeschlossen ist. Die Anwendung darf keine asynchronen Aufrufe der DLL aus unterschiedlichen Threads ausführen.
Version Verhalten bei parallelen Aufrufen
v04.04 Innerhalb der DLL wird ein Mutex verwendet — parallele Aufrufe werden bis zum Abschluss des aktuellen blockiert
v05.00 Es wird der Fehler ERR_CONCURRENT_API_CALL zurückgegeben

Funktionen des PassThru-API

PassThruScanForDevices Suche nach allen angeschlossenen Geräten v5.0
PassThruGetNextDevice Abrufen der Liste der durch PassThruScanForDevices gefundenen Geräte v5.0
PassThruOpen Verbindungsaufbau zum Adapter v4.04 v5.0
PassThruClose Beenden der Verbindung zum Adapter v4.04 v5.0
PassThruConnect Aufbau einer Protokollverbindung v4.04 v5.0
PassThruDisconnect Trennen der Verbindung v4.04 v5.0
PassThruReadMsgs Lesen empfangener Nachrichten v4.04 v5.0
PassThruWriteMsgs Senden von Nachrichten v4.04
PassThruStartPeriodicMsg Starten einer periodischen Nachricht v4.04 v5.0
PassThruStopPeriodicMsg Entfernen einer periodischen Nachricht v4.04 v5.0
PassThruStartMsgFilter Setzen eines Nachrichtenfilters v4.04 v5.0
PassThruStopMsgFilter Entfernen eines Nachrichtenfilters v4.04 v5.0
PassThruIoctl Ein-/Ausgabesteuerung v4.04 v5.0
GET_CONFIG / SET_CONFIG Protokollparameter v4.04 v5.0
GET_DEVICE_INFO / GET_PROTOCOL_INFO Geräteinformationen J2534-2
DoIP (ISO 13400) Diagnose über Ethernet Quantex
PassThruSetProgrammingVoltage Einstellen der Programmierspannung v4.04 v5.0
PassThruReadVersion Abfrage der Versionsinformationen zu DLL und Adapter v4.04 v5.0
PassThruLogicalConnect Aufbau eines logischen Kanals über einer physischen Verbindung v5.0
PassThruLogicalDisconnect Schließen eines logischen Kanals v5.0
PassThruSelect Auswahl von Kanälen zur Überwachung v5.0
PassThruQueueMsgs Einreihen von Nachrichten in die Sendewarteschlange des Kanals v5.0

Weiterführende Materialien

Format der J2534 v2-Logs Beschreibung des Formats der DLL- und Bibliotheks-Logdateien

  1. nach oben