PassThruStartPeriodicMsg v4.04 v5.0

Uruchomienie komunikatu cyklicznego

Ostatnia zmiana: 11 stycznia 2026 r.

Opis

Uruchamia automatyczne cykliczne wysyłanie komunikatu na magistralę z zadanym interwałem. Używana do podtrzymywania sesji diagnostycznej (Tester Present) lub cyklicznego odpytywania czujników.

long PassThruStartPeriodicMsg(unsigned long ChannelID, PASSTHRU_MSG* pMsg, unsigned long* pMsgID, unsigned long TimeInterval)

Parametry

unsigned long ChannelID — identyfikator kanału uzyskany z PassThruConnect.
PASSTHRU_MSG* pMsg — wskaźnik na strukturę komunikatu. Maksymalny rozmiar danych — 12 bajtów (z nagłówkiem protokołu). Komunikat cykliczny ma wysoki priorytet w kolejce, ale nie narusza taktowania P3min.
unsigned long* pMsgID — wskaźnik do odebrania identyfikatora komunikatu cyklicznego. Identyfikator ten jest niezbędny do późniejszego zatrzymania za pomocą PassThruStopPeriodicMsg.
unsigned long TimeInterval — interwał wysyłania w milisekundach. Dopuszczalny zakres: 5–65535 ms.

Zwracane kody błędów

Kod	Opis	Możliwe przyczyny i rozwiązania
STATUS_NOERROR	Funkcja wykonana pomyślnie	—
ERR_NULL_PARAMETER	Nie podano wskaźnika pMsg	Przekazano `nullptr` zamiast wskaźnika na komunikat Rozwiązanie: przekaż poprawny wskaźnik na strukturę PASSTHRU_MSG
ERR_INVALID_MSG	Nieprawidłowa struktura komunikatu	Rozmiar danych równy 0 lub przekracza 12 bajtów Rozwiązanie: upewnij się, że `DataSize` mieści się w zakresie 1–12
ERR_INVALID_CHANNEL_ID	Nieprawidłowy identyfikator kanału	Kanał nie został otwarty lub został już zamknięty Rozwiązanie: użyj ChannelID uzyskanego z `PassThruConnect`
ERR_DEVICE_NOT_CONNECTED	Brak połączenia z adapterem	Adapter wyłączony, utracona sieć, błędny adres IP Rozwiązanie: sprawdź zasilanie adaptera i połączenie sieciowe
ERR_INVALID_DEVICE_ID	Nieprawidłowy identyfikator urządzenia	DeviceID nie został uzyskany przez `PassThruOpen` lub urządzenie jest zamknięte Rozwiązanie: użyj DeviceID uzyskanego z `PassThruOpen`
ERR_INVALID_TIME_INTERVAL	Niedopuszczalny interwał czasu	Wartość TimeInterval poza zakresem 5–65535 ms Rozwiązanie: użyj interwału z dopuszczalnego zakresu
ERR_NOT_SUPPORTED	Parametry nieobsługiwane przez adapter	Interwał poniżej 20 ms nie jest obsługiwany przez firmware Rozwiązanie: zwiększ TimeInterval do 20 ms i więcej
ERR_MSG_PROTOCOL_ID	Niezgodność protokołu	ProtocolID w komunikacie nie zgadza się z protokołem kanału Rozwiązanie: ustaw w pMsg->ProtocolID ten sam protokół, który podano przy `PassThruConnect`
ERR_EXCEEDED_LIMIT	Przekroczono limit komunikatów cyklicznych	Adapter obsługuje ograniczoną liczbę komunikatów cyklicznych (zwykle 10) Rozwiązanie: zatrzymaj nieużywane komunikaty cykliczne za pomocą `PassThruStopPeriodicMsg`
ERR_FAILED	Błąd wewnętrzny	Błąd w bibliotece DLL lub firmware adaptera Rozwiązanie: wywołaj `PassThruGetLastError()`, aby uzyskać szczegóły

Przykłady

Przykład w C/C++

#include "j2534_lib.hpp"

unsigned long ChannelID; // ID kanału
unsigned long MsgID;     // ID dla nowego komunikatu cyklicznego
long Ret;
PASSTHRU_MSG Msg;

// Komunikat "Tester Present" dla ISO15765
Msg.ProtocolID = ISO15765;
Msg.TxFlags = ISO15765_FRAME_PAD;
Msg.DataSize = 5;
Msg.Data[0] = 0x00;
Msg.Data[1] = 0x00;
Msg.Data[2] = 0x07;
Msg.Data[3] = 0xDF; // Adres ECU
Msg.Data[4] = 0x3E; // Komenda Tester Present

// Uruchamiamy wysyłanie co 2000 ms
Ret = PassThruStartPeriodicMsg(ChannelID, &Msg, &MsgID, 2000);
if (Ret != STATUS_NOERROR)
{
    // Obsługa błędu
}

Przykład w Kotlinie (Android)

// channelID uzyskano wcześniej
val timeInterval = 2000 // ms

// Komunikat "Tester Present" dla ISO15765
val msg = PassThruMsg(
    protocolID = ISO15765,
    dataSize = 5,
    txFlags = ISO15765_FRAME_PAD,
    data = byteArrayOf(0x00, 0x00, 0x07, 0xDF.toByte(), 0x3E)
)

val result = j2534.ptStartPeriodicMsg(channelID, msg, timeInterval)
if (result.status == STATUS_NOERROR) {
    val msgID = result.msgId
    // Komunikat cykliczny uruchomiony pomyślnie
    Log.i("J2534", "Uruchomiono komunikat cykliczny, MsgID: $msgID")
} else {
    // Obsługa błędu
    Log.e("J2534", "Błąd uruchomienia komunikatu cyklicznego: ${result.status}")
}

Przykład w Pythonie

import ctypes

# Załadowanie biblioteki
j2534 = ctypes.CDLL("libj2534_v04_04.so")  # Linux
# j2534 = ctypes.WinDLL("j2534sd_v04_04_x64.dll")  # Windows

# channel_id uzyskano wcześniej
time_interval = 2000  # ms

# Struktura komunikatu
class PASSTHRU_MSG(ctypes.Structure):
    _fields_ = [
        ("ProtocolID", ctypes.c_ulong),
        ("RxStatus", ctypes.c_ulong),
        ("TxFlags", ctypes.c_ulong),
        ("Timestamp", ctypes.c_ulong),
        ("DataSize", ctypes.c_ulong),
        ("ExtraDataIndex", ctypes.c_ulong),
        ("Data", ctypes.c_ubyte * 4128)
    ]

msg = PASSTHRU_MSG()
msg.ProtocolID = 6  # ISO15765
msg.TxFlags = 0x40  # ISO15765_FRAME_PAD
msg.DataSize = 5
msg.Data[0:5] = [0x00, 0x00, 0x07, 0xDF, 0x3E]  # Tester Present

msg_id = ctypes.c_ulong()
ret = j2534.PassThruStartPeriodicMsg(channel_id, ctypes.byref(msg), ctypes.byref(msg_id), time_interval)
if ret == 0:  # STATUS_NOERROR
    print(f"Komunikat cykliczny uruchomiony, MsgID: {msg_id.value}")

Przykład w C#

using System;
using System.Runtime.InteropServices;

// channel_id uzyskano wcześniej
uint timeInterval = 2000; // ms

var msg = new PASSTHRU_MSG
{
    ProtocolID = 6, // ISO15765
    TxFlags = 0x40, // ISO15765_FRAME_PAD
    DataSize = 5,
    Data = new byte[4128]
};
msg.Data[0] = 0x00;
msg.Data[1] = 0x00;
msg.Data[2] = 0x07;
msg.Data[3] = 0xDF;
msg.Data[4] = 0x3E; // Tester Present

uint msgId;
int ret = J2534.PassThruStartPeriodicMsg(channelId, ref msg, out msgId, timeInterval);
if (ret == 0) // STATUS_NOERROR
{
    Console.WriteLine($"Komunikat cykliczny uruchomiony, MsgID: {msgId}");
}