GET_DEVICE_INFO / GET_PROTOCOL_INFO J2534-2

Информация об устройстве

Последнее изменение: 11 января 2026 г.

GET_DEVICE_INFO — Информация об устройстве

Возвращает информацию о возможностях устройства: поддерживаемые протоколы, количество одновременных каналов, серийный номер и другие характеристики. Вызывается с DeviceID, полученным от PassThruOpen.

IoctlID	0x800C
pInput	SCONFIG_LIST* — список запрашиваемых параметров
pOutput	NULL (результат записывается в pInput)

В отличие от GET_CONFIG, функция GET_DEVICE_INFO вызывается с DeviceID, а не с ChannelID.

GET_PROTOCOL_INFO — Информация о протоколе

Возвращает информацию о возможностях конкретного протокола: максимальные размеры буферов, количество фильтров, поддерживаемые параметры. Вызывается с ChannelID, полученным от PassThruConnect.

IoctlID	0x800D
pInput	SCONFIG_LIST* — список запрашиваемых параметров
pOutput	NULL (результат записывается в pInput)

Структуры данных

typedef struct {
    unsigned long Parameter;  // Идентификатор параметра
    unsigned long Value;      // Возвращаемое значение
} SCONFIG;

typedef struct {
    unsigned long NumOfParams;  // Количество параметров в списке
    SCONFIG *ConfigPtr;         // Указатель на массив SCONFIG
} SCONFIG_LIST;

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

Код	Описание	Возможные причины и решения
STATUS_NOERROR	Функция выполнена успешно	—
ERR_DEVICE_NOT_CONNECTED	Нет соединения с адаптером	Адаптер выключен или вне зоны доступа Решение: проверьте питание и подключение
ERR_INVALID_DEVICE_ID	Недействительный идентификатор устройства	DeviceID не был получен через PassThruOpen Решение: выполните PassThruOpen
ERR_INVALID_CHANNEL_ID	Недействительный идентификатор канала	ChannelID не был получен через PassThruConnect (для GET_PROTOCOL_INFO) Решение: выполните PassThruConnect
ERR_NULL_PARAMETER	Передан NULL вместо указателя	pInput равен NULL Решение: передайте указатель на SCONFIG_LIST
ERR_NOT_SUPPORTED	Параметр не поддерживается	Запрошенный параметр недоступен Решение: проверьте список поддерживаемых параметров
ERR_FAILED	Неопределённая ошибка	Внутренняя ошибка Решение: вызовите `PassThruGetLastError()`

Параметры GET_DEVICE_INFO

Идентификация устройства

Параметр	Значение	Описание
SERIAL_NUMBER	0x01	Серийный номер устройства (строка)
PART_NUMBER	0x49	Артикул устройства

Поддержка протоколов

Возвращают SUPPORTED (1) или NOT_SUPPORTED (0).

Параметр	Значение	Протокол
J1850PWM_SUPPORTED	0x02	J1850 PWM (Ford)
J1850VPW_SUPPORTED	0x03	J1850 VPW (GM)
ISO9141_SUPPORTED	0x04	ISO 9141-2
ISO14230_SUPPORTED	0x05	ISO 14230 (KWP2000)
CAN_SUPPORTED	0x06	CAN (raw)
ISO15765_SUPPORTED	0x07	ISO 15765 (CAN UDS)
SCI_A_ENGINE_SUPPORTED	0x08	SCI-A Engine (Chrysler)
SCI_A_TRANS_SUPPORTED	0x09	SCI-A Transmission (Chrysler)
SCI_B_ENGINE_SUPPORTED	0x0A	SCI-B Engine (Chrysler)
SCI_B_TRANS_SUPPORTED	0x0B	SCI-B Transmission (Chrysler)
SW_ISO15765_SUPPORTED	0x0C	Single-Wire ISO 15765
SW_CAN_SUPPORTED	0x0D	Single-Wire CAN (GM)
GM_UART_SUPPORTED	0x0E	GM UART
UART_ECHO_BYTE_SUPPORTED	0x0F	UART Echo Byte
HONDA_DIAGH_SUPPORTED	0x10	Honda DIAG-H
J1939_SUPPORTED	0x11	J1939 (грузовые)
J1708_SUPPORTED	0x12	J1708 (грузовые)
TP2_0_SUPPORTED	0x13	TP 2.0 (VAG)
J2610_SUPPORTED	0x14	J2610 (Chrysler DRB-III)
ANALOG_IN_SUPPORTED	0x15	Аналоговые входы
FT_CAN_SUPPORTED	0x31	Fault-Tolerant CAN
FT_ISO15765_SUPPORTED	0x32	FT ISO 15765
FD_CAN_SUPPORTED	0x4C	CAN FD
FD_ISO15765_SUPPORTED	0x4D	ISO 15765 через CAN FD
ETHERNET_NDIS_SUPPORTED	0x54	Ethernet NDIS (DoIP)

Одновременные каналы

Количество каналов, которые могут быть открыты одновременно для каждого протокола.

Параметр	Значение	Протокол
J1850PWM_SIMULTANEOUS	0x35	J1850 PWM
J1850VPW_SIMULTANEOUS	0x36	J1850 VPW
ISO9141_SIMULTANEOUS	0x37	ISO 9141
ISO14230_SIMULTANEOUS	0x38	ISO 14230
CAN_SIMULTANEOUS	0x39	CAN
ISO15765_SIMULTANEOUS	0x3A	ISO 15765
SW_CAN_SIMULTANEOUS	0x40	SW-CAN
J1939_SIMULTANEOUS	0x44	J1939
TP2_0_SIMULTANEOUS	0x46	TP 2.0
FD_CAN_SIMULTANEOUS	0x4E	CAN FD
FD_ISO15765_SIMULTANEOUS	0x4F	ISO 15765 FD

Назначение контактов J1962

Возвращают маску контактов OBD-II, используемых для протокола.

Параметр	Значение	Протокол
CAN_PS_J1962	0x1F	CAN (Pin 6, 14)
ISO15765_PS_J1962	0x20	ISO 15765 (Pin 6, 14)
ISO9141_PS_K_LINE_J1962	0x1B	ISO 9141 K-Line (Pin 7)
ISO9141_PS_L_LINE_J1962	0x1C	ISO 9141 L-Line (Pin 15)
ISO14230_PS_K_LINE_J1962	0x1D	ISO 14230 K-Line (Pin 7)
ISO14230_PS_L_LINE_J1962	0x1E	ISO 14230 L-Line (Pin 15)
SW_CAN_PS_J1962	0x21	SW-CAN (Pin 1)
J1850PWM_PS_J1962	0x19	J1850 PWM (Pin 2, 10)
J1850VPW_PS_J1962	0x1A	J1850 VPW (Pin 2)
FD_CAN_PS_J1962	0x50	CAN FD (Pin 6, 14)
FD_ISO15765_PS_J1962	0x51	ISO 15765 FD (Pin 6, 14)

Дополнительные возможности

Параметр	Значение	Описание
MAX_NON_VOLATILE_STORAGE	0x16	Размер энергонезависимой памяти (байт)
SHORT_TO_GND_J1962	0x17	Поддержка определения КЗ на землю
PGM_VOLTAGE_J1962	0x18	Поддержка напряжения программирования
READ_J1962PIN_VOLTAGE_SUPPORTED	0x52	Поддержка чтения напряжения на контактах
READ_J1962PIN_VOLTAGE_MAX	0x53	Максимальное напряжение для чтения (мВ)

Параметры GET_PROTOCOL_INFO

Параметр	Значение	Описание
MAX_RX_BUFFER_SIZE	0x01	Максимальный размер приёмного буфера (байт)
MAX_PASS_FILTER	0x02	Максимальное количество PASS_FILTER
MAX_BLOCK_FILTER	0x03	Максимальное количество BLOCK_FILTER
MAX_FILTER_MSG_LENGTH	0x04	Максимальная длина сообщения фильтра (байт)
MAX_PERIODIC_MSGS	0x05	Максимальное количество периодических сообщений
MAX_PERIODIC_MSG_LENGTH	0x06	Максимальная длина периодического сообщения (байт)
DESIRED_DATA_RATE	0x07	Рекомендуемая скорость передачи (бит/с)
MAX_FLOW_CONTROL_FILTER	0x12	Максимальное количество FLOW_CONTROL_FILTER
MAX_ISO15765_WFT_MAX	0x13	Максимальное значение ISO15765_WFT_MAX
NETWORK_LINE_SUPPORTED	0x0A	Поддержка выбора сетевой линии
MAX_FUNCT_MSG_LOOKUP	0x0B	Максимальный размер таблицы функциональных адресов
PARITY_SUPPORTED	0x0C	Поддержка настройки чётности
DATA_BITS_SUPPORTED	0x0D	Поддержка настройки бит данных (7/8)
FIVE_BAUD_MOD_SUPPORTED	0x0E	Поддержка режимов 5-бод инициализации
L_LINE_SUPPORTED	0x0F	Поддержка L-линии
CAN_11_29_IDS_SUPPORTED	0x10	Поддержка 11-бит и 29-бит CAN ID
CAN_MIXED_FORMAT_SUPPORTED	0x11	Поддержка смешанного формата CAN
TIMESTAMP_RESOLUTION	0x1B	Разрешение временных меток (мкс)
FD_CAN_DATA_PHASE_DATA_RATE_SUPPORTED	0x6C	Поддерживаемые скорости CAN FD

Примеры

GET_DEVICE_INFO — получение возможностей устройства

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

#include "j2534_dll.hpp"

unsigned long DeviceID;  // Получен от PassThruOpen
SCONFIG Config[5];
SCONFIG_LIST ConfigList;
long ret;

// Запрашиваем информацию о поддержке протоколов
Config[0].Parameter = CAN_SUPPORTED;
Config[1].Parameter = ISO15765_SUPPORTED;
Config[2].Parameter = ISO14230_SUPPORTED;
Config[3].Parameter = FD_CAN_SUPPORTED;
Config[4].Parameter = TP2_0_SUPPORTED;

ConfigList.NumOfParams = 5;
ConfigList.ConfigPtr = Config;

ret = PassThruIoctl(DeviceID, GET_DEVICE_INFO, &ConfigList, NULL);
if (ret == STATUS_NOERROR)
{
    printf("CAN: %s\n", Config[0].Value ? "поддерживается" : "нет");
    printf("ISO 15765: %s\n", Config[1].Value ? "поддерживается" : "нет");
    printf("ISO 14230: %s\n", Config[2].Value ? "поддерживается" : "нет");
    printf("CAN FD: %s\n", Config[3].Value ? "поддерживается" : "нет");
    printf("TP 2.0: %s\n", Config[4].Value ? "поддерживается" : "нет");
}

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

// deviceID получен от ptOpen
val params = listOf(
    PtConfig(parameter = CAN_SUPPORTED, value = 0u),
    PtConfig(parameter = ISO15765_SUPPORTED, value = 0u),
    PtConfig(parameter = FD_CAN_SUPPORTED, value = 0u)
)

val result = j2534.ptIoctl(deviceID, GET_DEVICE_INFO, params.size, params.toByteArray())
if (result.status == STATUS_NOERROR) {
    val resultParams = result.toConfigList()
    Log.i("J2534", "CAN: ${if (resultParams[0].value > 0u) "да" else "нет"}")
    Log.i("J2534", "ISO 15765: ${if (resultParams[1].value > 0u) "да" else "нет"}")
    Log.i("J2534", "CAN FD: ${if (resultParams[2].value > 0u) "да" else "нет"}")
}

Пример на Python

from ctypes import *

config = (SCONFIG * 3)()
config[0].Parameter = CAN_SUPPORTED
config[1].Parameter = ISO15765_SUPPORTED
config[2].Parameter = FD_CAN_SUPPORTED

config_list = SCONFIG_LIST()
config_list.NumOfParams = 3
config_list.ConfigPtr = config

ret = j2534.PassThruIoctl(device_id, GET_DEVICE_INFO, byref(config_list), None)
if ret == 0:
    print(f"CAN: {'да' if config[0].Value else 'нет'}")
    print(f"ISO 15765: {'да' if config[1].Value else 'нет'}")
    print(f"CAN FD: {'да' if config[2].Value else 'нет'}")

Пример на C#

var configs = new SCONFIG[3];
configs[0].Parameter = CAN_SUPPORTED;
configs[1].Parameter = ISO15765_SUPPORTED;
configs[2].Parameter = FD_CAN_SUPPORTED;

var configList = new SCONFIG_LIST {
    NumOfParams = 3,
    ConfigPtr = configs
};

int ret = J2534.PassThruIoctl(deviceId, GET_DEVICE_INFO, ref configList, IntPtr.Zero);
if (ret == 0)
{
    Console.WriteLine($"CAN: {(configs[0].Value > 0 ? "да" : "нет")}");
    Console.WriteLine($"ISO 15765: {(configs[1].Value > 0 ? "да" : "нет")}");
    Console.WriteLine($"CAN FD: {(configs[2].Value > 0 ? "да" : "нет")}");
}

GET_PROTOCOL_INFO — получение информации о протоколе

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

#include "j2534_dll.hpp"

unsigned long ChannelID;  // Получен от PassThruConnect для ISO15765
SCONFIG Config[4];
SCONFIG_LIST ConfigList;
long ret;

// Запрашиваем лимиты протокола
Config[0].Parameter = MAX_RX_BUFFER_SIZE;
Config[1].Parameter = MAX_FLOW_CONTROL_FILTER;
Config[2].Parameter = MAX_PERIODIC_MSGS;
Config[3].Parameter = TIMESTAMP_RESOLUTION;

ConfigList.NumOfParams = 4;
ConfigList.ConfigPtr = Config;

ret = PassThruIoctl(ChannelID, GET_PROTOCOL_INFO, &ConfigList, NULL);
if (ret == STATUS_NOERROR)
{
    printf("Макс. размер RX буфера: %lu байт\n", Config[0].Value);
    printf("Макс. FLOW_CONTROL фильтров: %lu\n", Config[1].Value);
    printf("Макс. периодических сообщений: %lu\n", Config[2].Value);
    printf("Разрешение timestamp: %lu мкс\n", Config[3].Value);
}

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

// channelID получен от ptConnect
val params = listOf(
    PtConfig(parameter = MAX_RX_BUFFER_SIZE, value = 0u),
    PtConfig(parameter = MAX_FLOW_CONTROL_FILTER, value = 0u),
    PtConfig(parameter = MAX_PERIODIC_MSGS, value = 0u)
)

val result = j2534.ptIoctl(channelID, GET_PROTOCOL_INFO, params.size, params.toByteArray())
if (result.status == STATUS_NOERROR) {
    val resultParams = result.toConfigList()
    Log.i("J2534", "Макс. RX буфер: ${resultParams[0].value} байт")
    Log.i("J2534", "Макс. FC фильтров: ${resultParams[1].value}")
    Log.i("J2534", "Макс. периодических: ${resultParams[2].value}")
}

Пример на Python

from ctypes import *

config = (SCONFIG * 3)()
config[0].Parameter = MAX_RX_BUFFER_SIZE
config[1].Parameter = MAX_FLOW_CONTROL_FILTER
config[2].Parameter = MAX_PERIODIC_MSGS

config_list = SCONFIG_LIST()
config_list.NumOfParams = 3
config_list.ConfigPtr = config

ret = j2534.PassThruIoctl(channel_id, GET_PROTOCOL_INFO, byref(config_list), None)
if ret == 0:
    print(f"Макс. RX буфер: {config[0].Value} байт")
    print(f"Макс. FC фильтров: {config[1].Value}")
    print(f"Макс. периодических: {config[2].Value}")

Полная проверка возможностей устройства

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

#include "j2534_dll.hpp"
#include <stdio.h>

void PrintDeviceCapabilities(unsigned long DeviceID)
{
    // Список всех протоколов для проверки
    struct {
        unsigned long param;
        const char* name;
    } protocols[] = {
        {CAN_SUPPORTED, "CAN"},
        {ISO15765_SUPPORTED, "ISO 15765"},
        {ISO14230_SUPPORTED, "ISO 14230 (KWP2000)"},
        {ISO9141_SUPPORTED, "ISO 9141"},
        {J1850PWM_SUPPORTED, "J1850 PWM"},
        {J1850VPW_SUPPORTED, "J1850 VPW"},
        {FD_CAN_SUPPORTED, "CAN FD"},
        {FD_ISO15765_SUPPORTED, "ISO 15765 FD"},
        {TP2_0_SUPPORTED, "TP 2.0 (VAG)"},
        {J1939_SUPPORTED, "J1939"},
        {SW_CAN_SUPPORTED, "Single-Wire CAN"}
    };

    const int count = sizeof(protocols) / sizeof(protocols[0]);
    SCONFIG* config = new SCONFIG[count];
    SCONFIG_LIST configList;

    for (int i = 0; i < count; i++) {
        config[i].Parameter = protocols[i].param;
        config[i].Value = 0;
    }

    configList.NumOfParams = count;
    configList.ConfigPtr = config;

    long ret = PassThruIoctl(DeviceID, GET_DEVICE_INFO, &configList, NULL);
    if (ret == STATUS_NOERROR) {
        printf("=== Поддерживаемые протоколы ===\n");
        for (int i = 0; i < count; i++) {
            printf("%-20s: %s\n", protocols[i].name,
                   config[i].Value ? "Да" : "Нет");
        }
    }

    delete[] config;
}