PassThru ReadVersion Чтение информации о dll и адаптере

Последнее изменение: 22 октября 2025 г.

Описание

Функция выдаёт информацию о версии dll, версии стандарта J2534 и версии программы в адаптере.

long PassThruReadVersion(unsigned long DeviceID, char* pFirmwareVersion, char* pDllVersion, char* pApiVersion)

Параметры

unsigned long DeviceID - Сохранённый при установлении связи командой PassThruOpen идентификатор.
char* pFirmwareVersion - Указатель на массив из 80 байт со строкой версии программы в адаптере
char* pDllVersion - Указатель на массив из 80 байт со строкой версии dll
char* pApiVersion - Указатель на массив из 80 байт со строкой версии API J2534. Поддерживаемая версия стандарта "04.04"

Возвращаемые коды ошибок

Определение	Описание
STATUS_NOERROR	Функция выполнена успешно
ERR_DEVICE_NOT_CONNECTED	Нет соединения с адаптером. Возможные причины: Адаптер выключен, нет сети, или не правильно задан IP адрес.
ERR_INVALID_DEVICE_ID	Задан не существующий идентификатор адаптера DeviceID
ERR_NULL_PARAMETER	Один из указателей равен NULL

Примеры

Пример на C/C++

#include "j2534_lib.hpp"

unsigned long DeviceID; // ID, полученный от PassThruOpen
long Ret;
char pFirmwareVersion[80];
char pDllVersion[80];
char pApiVersion[80];

Ret = PassThruReadVersion(DeviceID, pFirmwareVersion, pDllVersion, pApiVersion);
if (Ret == STATUS_NOERROR)
{
    // Версии успешно прочитаны
    printf("Версия прошивки: %s\n", pFirmwareVersion);
    printf("Версия DLL: %s\n", pDllVersion);
    printf("Версия API: %s\n", pApiVersion);
}

Пример на Kotlin (Android)

// deviceID получен ранее от ptOpen
val result = j2534.ptReadVersion(deviceID)
if (result.status == STATUS_NOERROR) {
    // Версии успешно прочитаны
    Log.i("J2534", "Версия прошивки: ${result.firmwareVersion}")
    Log.i("J2534", "Версия DLL: ${result.dllVersion}")
    Log.i("J2534", "Версия API: ${result.apiVersion}")
} else {
    // Обработка ошибки
    Log.e("J2534", "Ошибка чтения версий: ${result.status}")
}