1. Strona główna
2. ScanDoc Development
3. Przewodnik po J2534
4. Opis funkcji PassThru

PassThruScanForDevices v5.0

Skanowanie urządzeń

Ostatnia modyfikacja: 13 stycznia 2026 r.

Opis

Funkcja skanuje dostępne adaptery ScanDoc i zwraca liczbę znalezionych urządzeń. Funkcja ta jest częścią standardu SAE J2534-1 i służy do wykrywania urządzeń przed wywołaniem PassThruOpen().

long PassThruScanForDevices(unsigned long* pDeviceCount)

Parametry

• pDeviceCount - Wskaźnik na zmienną typu unsigned long, przydzieloną przez aplikację. Po pomyślnym wykonaniu funkcji zmienna będzie zawierać liczbę znalezionych urządzeń.

Algorytm działania

Funkcja wykonuje następujące działania:

1. Skanuje dostępne urządzenia ScanDoc w sieci lokalnej (LAN/WLAN)
2. Przy włączonym BLE skanuje urządzenia BLE
3. Zapisuje liczbę znalezionych urządzeń w pDeviceCount
4. Zapisuje listę urządzeń do późniejszego pobrania przez PassThruGetNextDevice()

Kolejność wywoływania funkcji

PassThruScanForDevices()  → Skanuj dostępne urządzenia
    ↓
PassThruGetNextDevice()   → Pobierz informacje o każdym urządzeniu (powtórz N razy)
    ↓
PassThruOpen()            → Otwórz połączenie z wybranym urządzeniem
    ↓
...

Limity czasu

Limit czasu skanowania sieci: 2000 ms. Limit czasu skanowania BLE: 3000 ms. Całkowity czas wykonania funkcji może wynosić do 5 sekund przy włączonym BLE.

Zwracane kody błędów

Kod	Opis	Możliwe przyczyny i rozwiązania
STATUS_NOERROR	Funkcja wykonana pomyślnie	Liczba znalezionych urządzeń została zapisana w pDeviceCount (może wynosić 0)
ERR_NULL_PARAMETER	Nie podano wskaźnika pDeviceCount	Przekaż prawidłowy wskaźnik na zmienną unsigned long
ERR_CONCURRENT_API_CALL	Funkcja J2534 API jest już wykonywana	Inna funkcja J2534 jeszcze nie zakończyła wykonywania Rozwiązanie: poczekaj na zakończenie poprzedniego wywołania
ERR_NOT_SUPPORTED	Funkcja nie jest obsługiwana	DLL nie obsługuje dynamicznego skanowania urządzeń Rozwiązanie: użyj PassThruOpen() bezpośrednio ze znanymi parametrami
ERR_FAILED	Błąd wewnętrzny	Błąd interfejsu sieciowego Błąd inicjalizacji BLE Rozwiązanie: użyj PassThruGetLastError(), aby uzyskać szczegóły

Przykłady

Przykład w C/C++

#include "j2534_dll.hpp"

unsigned long deviceCount = 0;

// Skanujemy urządzenia
long ret = PassThruScanForDevices(&deviceCount);
if (ret != STATUS_NOERROR)
{
    char error[256];
    PassThruGetLastError(error);
    printf("Błąd skanowania: %s\n", error);
    return;
}

printf("Znaleziono urządzeń: %lu\n", deviceCount);

if (deviceCount == 0)
{
    printf("Nie znaleziono urządzeń\n");
    return;
}

// Pobieramy informacje o każdym urządzeniu
SDEVICE deviceInfo;
for (unsigned long i = 0; i < deviceCount; i++)
{
    ret = PassThruGetNextDevice(&deviceInfo);
    if (ret == STATUS_NOERROR)
    {
        printf("Urządzenie %lu: %s\n", i + 1, deviceInfo.DeviceName);
    }
}

Przykład w Kotlin (Android)

val j2534 = J2534JNI(context)

// Skanujemy urządzenia
val scanResult = j2534.ptScanForDevices()

if (scanResult.status == STATUS_NOERROR) {
    Log.i("J2534", "Znaleziono urządzeń: ${scanResult.deviceCount}")

    // Pobieramy informacje o każdym urządzeniu
    for (i in 0 until scanResult.deviceCount) {
        val deviceInfo = j2534.ptGetNextDevice()
        if (deviceInfo.status == STATUS_NOERROR) {
            Log.i("J2534", "Urządzenie ${i + 1}: ${deviceInfo.deviceName}")
        }
    }
} else {
    Log.e("J2534", "Błąd skanowania: ${scanResult.status}")
}

Przykład w Python (ctypes)

from ctypes import *
import platform

# Ładowanie biblioteki
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()

# Skanujemy urządzenia
ret = j2534.PassThruScanForDevices(byref(device_count))

if ret == 0:  # STATUS_NOERROR
    print(f"Znaleziono urządzeń: {device_count.value}")

    # Struktura SDEVICE do pobierania informacji o urządzeniu
    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)
        ]

    # Pobieramy informacje o każdym urządzeniu
    for i in range(device_count.value):
        device_info = SDEVICE()
        ret = j2534.PassThruGetNextDevice(byref(device_info))
        if ret == 0:
            print(f"Urządzenie {i + 1}: {device_info.DeviceName.decode()}")
else:
    error = create_string_buffer(256)
    j2534.PassThruGetLastError(error)
    print(f"Błąd: {error.value.decode()}")

Przykład w 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);
}

// Użycie:
uint deviceCount;
int ret = J2534.PassThruScanForDevices(out deviceCount);

if (ret == 0) // STATUS_NOERROR
{
    Console.WriteLine($"Znaleziono urządzeń: {deviceCount}");

    for (uint i = 0; i < deviceCount; i++)
    {
        SDEVICE deviceInfo;
        ret = J2534.PassThruGetNextDevice(out deviceInfo);
        if (ret == 0)
        {
            Console.WriteLine($"Urządzenie {i + 1}: {deviceInfo.DeviceName}");
        }
    }
}
else
{
    var error = new System.Text.StringBuilder(256);
    J2534.PassThruGetLastError(error);
    Console.WriteLine($"Błąd: {error}");
}

Powiązane funkcje

• PassThruGetNextDevice() - Pobieranie informacji o znalezionych urządzeniach
• PassThruOpen() - Nawiązanie połączenia z adapterem

1. do góry