Quantex GmbH
Votre région : Europe

Description des fonctions de la dll PassThru du standard J2534-1/2

Dernière modification :

Versions du standard J2534

Il existe deux versions du standard SAE J2534 :

Version Chemin dans le registre Windows Particularités
v04.04 HKLM\SOFTWARE\PassThruSupport.04.04 Ensemble de base des fonctions PassThru
v05.00 HKLM\SOFTWARE\PassThruSupport.05.00 Ajout des fonctions PassThruScanForDevices et PassThruGetNextDevice pour la détection dynamique des dispositifs

Compatibilité : Les versions ne sont pas compatibles entre elles. Les programmes de diagnostic recherchent la DLL uniquement selon leur propre version du registre :

Travail avec les dispositifs

v04.04 : Prend en charge simultanément un seul dispositif, dont les paramètres sont inscrits dans le registre. L'application charge la DLL et appelle PassThruOpen(NULL) pour se connecter au dispositif indiqué dans le registre.

v05.00 : Prend en charge la détection dynamique des dispositifs. Algorithme de travail typique :

  1. L'application lit le registre PassThruSupport.05.00 et affiche à l'utilisateur la liste des fabricants (Vendor)
  2. L'utilisateur sélectionne un fabricant, l'application charge la DLL correspondante
  3. Appel à PassThruScanForDevices pour scanner les dispositifs connectés (filaires et sans fil)
  4. Appel à PassThruGetNextDevice dans une boucle pour obtenir les informations de chaque dispositif trouvé
  5. L'application affiche la liste des dispositifs, l'utilisateur sélectionne celui dont il a besoin
  6. Appel à PassThruOpen avec le nom du dispositif sélectionné

Multithreading

Important : L'API J2534 n'est pas thread-safe. Le protocole est de type requête-réponse. Tant qu'une fonction n'a pas terminé, on ne peut pas appeler la suivante. L'application ne doit pas effectuer d'appels asynchrones à la DLL depuis différents threads.
Version Comportement lors d'un appel parallèle
v04.04 Un mutex est utilisé à l'intérieur de la DLL — les appels parallèles sont bloqués jusqu'à la fin de l'appel en cours
v05.00 L'erreur ERR_CONCURRENT_API_CALL est renvoyée

Fonctions PassThru API

PassThruScanForDevices Recherche de tous les dispositifs connectés v5.0
PassThruGetNextDevice Obtention de la liste des dispositifs trouvés lors de l'appel à PassThruScanForDevices v5.0
PassThruOpen Établissement de la connexion avec l'adaptateur v4.04 v5.0
PassThruClose Fin de la connexion avec l'adaptateur v4.04 v5.0
PassThruConnect Création d'une connexion via le protocole v4.04 v5.0
PassThruDisconnect Suppression de la connexion v4.04 v5.0
PassThruReadMsgs Lecture des messages reçus v4.04 v5.0
PassThruWriteMsgs Transmission de messages v4.04
PassThruStartPeriodicMsg Démarrage d'un message périodique v4.04 v5.0
PassThruStopPeriodicMsg Suppression d'un message périodique v4.04 v5.0
PassThruStartMsgFilter Mise en place d'un filtre de messages v4.04 v5.0
PassThruStopMsgFilter Suppression d'un filtre de messages v4.04 v5.0
PassThruIoctl Contrôle des entrées-sorties v4.04 v5.0
GET_CONFIG / SET_CONFIG Paramètres des protocoles v4.04 v5.0
GET_DEVICE_INFO / GET_PROTOCOL_INFO Informations sur le dispositif J2534-2
DoIP (ISO 13400) Diagnostic via Ethernet Quantex
PassThruSetProgrammingVoltage Réglage de la tension de programmation v4.04 v5.0
PassThruReadVersion Lecture des informations sur la dll et l'adaptateur v4.04 v5.0
PassThruLogicalConnect Création d'un canal de communication logique au-dessus d'une connexion physique v5.0
PassThruLogicalDisconnect Fermeture d'un canal de communication logique v5.0
PassThruSelect Sélection des canaux à surveiller v5.0
PassThruQueueMsgs Mise en file d'attente des messages du canal en vue de leur envoi v5.0

Documents complémentaires

Format des logs J2534 v2 Description du format des fichiers de journalisation de la DLL et des bibliothèques