PassThruScanForDevices v5.0

Gerätescan

Letzte Änderung: 13. Januar 2026

Beschreibung

Die Funktion scannt die verfügbaren ScanDoc-Adapter und gibt die Anzahl der gefundenen Geräte zurück. Sie ist Teil des Standards SAE J2534-1 und dient der Geräteerkennung vor dem Aufruf von PassThruOpen().

long PassThruScanForDevices(unsigned long* pDeviceCount)

Hinweis: Verwenden Sie nach dem Aufruf dieser Funktion PassThruGetNextDevice(), um die Informationen zu jedem gefundenen Gerät abzurufen.

Parameter

pDeviceCount - Zeiger auf eine von der Anwendung bereitgestellte Variable vom Typ unsigned long. Nach erfolgreicher Ausführung der Funktion enthält die Variable die Anzahl der gefundenen Geräte.

Funktionsweise

Die Funktion führt folgende Schritte aus:

Sucht nach verfügbaren ScanDoc-Geräten im lokalen Netzwerk (LAN/WiFi)
Scannt bei aktiviertem Bluetooth nach BLE-Geräten
Schreibt die Anzahl der gefundenen Geräte in pDeviceCount
Speichert die Geräteliste für den späteren Abruf über PassThruGetNextDevice()

Aufrufreihenfolge der Funktionen

PassThruScanForDevices()  → Verfügbare Geräte scannen
    ↓
PassThruGetNextDevice()   → Informationen zu jedem Gerät abrufen (N-mal wiederholen)
    ↓
PassThruOpen()            → Verbindung zum ausgewählten Gerät öffnen
    ↓
...

Wichtig: Der Aufruf von PassThruScanForDevices() ist nicht zwingend erforderlich. Wenn der Gerätename bereits bekannt ist, kann direkt PassThruOpen() mit den gewünschten Verbindungsparametern aufgerufen werden.

Timeouts

Timeout für den Netzwerkscan: 2000 ms. Timeout für den BLE-Scan: 3000 ms. Die gesamte Ausführungszeit der Funktion kann bei aktiviertem Bluetooth bis zu 5 Sekunden betragen.

Rückgabe-Fehlercodes

Code	Beschreibung	Mögliche Ursachen und Lösungen
STATUS_NOERROR	Funktion erfolgreich ausgeführt	Die Anzahl der gefundenen Geräte wurde in `pDeviceCount` geschrieben (kann 0 sein)
ERR_NULL_PARAMETER	Der Zeiger pDeviceCount ist nicht gesetzt	Übergeben Sie einen gültigen Zeiger auf eine `unsigned long`-Variable
ERR_CONCURRENT_API_CALL	Eine J2534-API-Funktion wird bereits ausgeführt	Eine andere J2534-Funktion ist noch nicht abgeschlossen Lösung: Warten Sie, bis der vorherige Aufruf beendet ist
ERR_NOT_SUPPORTED	Funktion wird nicht unterstützt	Die DLL unterstützt kein dynamisches Gerätescannen Lösung: Verwenden Sie `PassThruOpen()` direkt mit den bekannten Parametern
ERR_FAILED	Interner Fehler	Fehler der Netzwerkschnittstelle Fehler bei der Bluetooth-Initialisierung Lösung: Verwenden Sie `PassThruGetLastError()`, um Details zu erhalten

Beispiele

Beispiel in C/C++

#include "j2534_dll.hpp"

unsigned long deviceCount = 0;

// Geräte scannen
long ret = PassThruScanForDevices(&deviceCount);
if (ret != STATUS_NOERROR)
{
    char error[256];
    PassThruGetLastError(error);
    printf("Scan-Fehler: %s\n", error);
    return;
}

printf("Gefundene Geräte: %lu\n", deviceCount);

if (deviceCount == 0)
{
    printf("Keine Geräte gefunden\n");
    return;
}

// Informationen zu jedem Gerät abrufen
SDEVICE deviceInfo;
for (unsigned long i = 0; i < deviceCount; i++)
{
    ret = PassThruGetNextDevice(&deviceInfo);
    if (ret == STATUS_NOERROR)
    {
        printf("Gerät %lu: %s\n", i + 1, deviceInfo.DeviceName);
    }
}

Beispiel in Kotlin (Android)

val j2534 = J2534JNI(context)

// Geräte scannen
val scanResult = j2534.ptScanForDevices()

if (scanResult.status == STATUS_NOERROR) {
    Log.i("J2534", "Gefundene Geräte: ${scanResult.deviceCount}")

    // Informationen zu jedem Gerät abrufen
    for (i in 0 until scanResult.deviceCount) {
        val deviceInfo = j2534.ptGetNextDevice()
        if (deviceInfo.status == STATUS_NOERROR) {
            Log.i("J2534", "Gerät ${i + 1}: ${deviceInfo.deviceName}")
        }
    }
} else {
    Log.e("J2534", "Scan-Fehler: ${scanResult.status}")
}

Beispiel in Python (ctypes)

from ctypes import *
import platform

# Bibliothek laden
if platform.system() == "Windows":
    j2534 = windll.LoadLibrary("j2534sd_v05_00_x64.dll")
elif platform.system() == "Darwin":
    j2534 = cdll.LoadLibrary("libj2534_v05_00.dylib")
else:
    j2534 = cdll.LoadLibrary("libj2534_v05_00.so")

device_count = c_ulong()

# Geräte scannen
ret = j2534.PassThruScanForDevices(byref(device_count))

if ret == 0:  # STATUS_NOERROR
    print(f"Gefundene Geräte: {device_count.value}")

    # SDEVICE-Struktur zum Abrufen der Geräteinformationen
    class SDEVICE(Structure):
        _fields_ = [
            ("DeviceName", c_char * 80),
            ("DeviceAvailable", c_ulong),
            ("DeviceDLLFWStatus", c_ulong),
            ("DeviceConnectMedia", c_ulong),
            ("DeviceConnectSpeed", c_ulong),
            ("DeviceSignalQuality", c_ulong),
            ("DeviceSignalStrength", c_ulong)
        ]

    # Informationen zu jedem Gerät abrufen
    for i in range(device_count.value):
        device_info = SDEVICE()
        ret = j2534.PassThruGetNextDevice(byref(device_info))
        if ret == 0:
            print(f"Gerät {i + 1}: {device_info.DeviceName.decode()}")
else:
    error = create_string_buffer(256)
    j2534.PassThruGetLastError(error)
    print(f"Fehler: {error.value.decode()}")

Beispiel in C# (P/Invoke)

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Ansi)]
public struct SDEVICE
{
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 80)]
    public string DeviceName;
    public uint DeviceAvailable;
    public uint DeviceDLLFWStatus;
    public uint DeviceConnectMedia;
    public uint DeviceConnectSpeed;
    public uint DeviceSignalQuality;
    public uint DeviceSignalStrength;
}

class J2534
{
    [DllImport("j2534sd_v05_00_x64.dll", CallingConvention = CallingConvention.StdCall)]
    public static extern int PassThruScanForDevices(out uint pDeviceCount);

    [DllImport("j2534sd_v05_00_x64.dll", CallingConvention = CallingConvention.StdCall)]
    public static extern int PassThruGetNextDevice(out SDEVICE psDevice);

    [DllImport("j2534sd_v05_00_x64.dll", CallingConvention = CallingConvention.StdCall)]
    public static extern int PassThruGetLastError(
        [MarshalAs(UnmanagedType.LPStr)] System.Text.StringBuilder pErrorDescription);
}

// Verwendung:
uint deviceCount;
int ret = J2534.PassThruScanForDevices(out deviceCount);

if (ret == 0) // STATUS_NOERROR
{
    Console.WriteLine($"Gefundene Geräte: {deviceCount}");

    for (uint i = 0; i < deviceCount; i++)
    {
        SDEVICE deviceInfo;
        ret = J2534.PassThruGetNextDevice(out deviceInfo);
        if (ret == 0)
        {
            Console.WriteLine($"Gerät {i + 1}: {deviceInfo.DeviceName}");
        }
    }
}
else
{
    var error = new System.Text.StringBuilder(256);
    J2534.PassThruGetLastError(error);
    Console.WriteLine($"Fehler: {error}");
}