Руководство по J2534 для разработчиков

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

Что такое J2534?

J2534 (часто называемый Pass-Thru) — это стандарт, разработанный SAE (Обществом автомобильных инженеров), который решает важную задачу: он позволяет одному и тому же программному обеспечению для диагностики работать с диагностическими адаптерами от разных производителей.

Основная идея:

Представьте, что вы пишете программу для диагностики автомобилей. Без стандарта J2534 вам пришлось бы писать уникальный код для каждого адаптера (K-Line, CAN-адаптер и т.д.), который вы хотите поддержать. Это сложно и дорого.

Стандарт J2534 определяет единый API (программный интерфейс), который производители адаптеров должны реализовать в своих драйверах. Стандарт определяет этот API только как DLL-библиотеку для Windows

Для разработчика это означает:

Универсальность: Вы пишете код, который вызывает стандартные функции J2534 (например, PassThruOpen, PassThruReadMsg).
Независимость от оборудования: Ваша программа будет работать с любым адаптером, у которого есть J2534-совместимый драйвер. Вам не нужно знать, как устроен адаптер внутри.
Простота: API предоставляет набор функций для подключения к автомобилю, чтения и отправки сообщений по различным протоколам (CAN, ISO9141, KWP2000 и др.), не требуя от вас глубоких знаний о физическом уровне каждого протокола.

Таким образом, J2534 — это "мост" между вашим приложением и диагностическим адаптером, который скрывает сложности конкретного оборудования и позволяет сосредоточиться на логике диагностики.

Многие разработчики, кроме Windows, хотят использовать альтернативные платформы. Мы предлагаем помимо стандартной DLL для Windows, также библиотеки для Linux, macOS, а также мобильных платформ Android и iOS.

Что J2534 не делает (Ваша зона ответственности)

Важно понимать, что J2534 — это стандарт для транспортного уровня. Он берёт на себя всю работу по отправке и приёму байтов данных по выбранному физическому интерфейсу (CAN, K-Line и т.д.).

Однако, стандарт J2534 не определяет:

Содержание диагностических команд.
Способ интерпретации ответов от ЭБУ.

Это остаётся задачей вашего приложения. Вы, как разработчик, должны знать, какие именно байты нужно отправить, чтобы запросить, например, коды ошибок или текущие параметры, и как разобрать ответ от блока управления.

Для этого вам потребуются знания прикладных протоколов диагностики, таких как:

SAE J1979 / ISO 15031-5: Стандартный протокол OBD-II, описывающий режимы (Services) и параметры (PIDs) для диагностики систем, влияющих на экологию.
ISO 14229 (UDS): Unified Diagnostic Services — современный стандарт, используемый большинством автопроизводителей для дилерской диагностики.
ISO 14230 (KWP2000): Более старый, но всё ещё широко распространённый протокол.
Специфичные протоколы автопроизводителей.

J2534 DLL доставит ваши байты до ЭБУ, но что это за байты и что делать с ответом — решает ваша программа.

Обзор стандартов

Стандарт J2534 является частью большого семейства стандартов, регулирующих автомобильную диагностику. Для глубокого понимания рекомендуется ознакомиться с официальными документами.

SAE J2534-1 - Основной стандарт, описывающий API. Существует три версии стандарта
- 02.02 - устаревшая версия, которая уже нигде не применяется. Не поддерживается адаптером ScanDoc
- 04.04 - наиболее популярная версия, которая используется множеством дилерских программ. Поддерживается адаптером ScanDoc
- 05.00 - текущая версия стандарта. Поддерживается в данный момент очень малым количеством программ. Пока не поддерживается адаптером ScanDoc
SAE J2534-2 — Расширение стандарта, добавляющее поддержку дополнительных протоколов и функций.

Подробная таблица соотношения протоколов и стандартов

Адаптер ScanDoc реализует не полный вариант стандарта J2534-1 и некоторые расширения из J2534-2, а также имеет собственные функции для расширения возможностей.

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

Стандарт J2534 определяет набор протоколов физического и транспортного уровня, через которые происходит обмен данными с ЭБУ автомобиля. Ниже описан каждый протокол, поддерживаемый адаптером ScanDoc.

ISO 15765 (CAN с транспортным уровнем)

Основной протокол для диагностики современных автомобилей. ISO 15765 (также известен как ISO-TP) реализует транспортный уровень поверх CAN-шины: он автоматически выполняет сегментацию длинных сообщений на CAN-кадры, управление потоком (Flow Control) и сборку ответа из нескольких кадров.

Именно этот протокол используется для диагностики по UDS (ISO 14229) и OBD-II на CAN-шине. Если ваша задача — отправлять диагностические запросы и получать ответы от ЭБУ, используйте ISO15765.

Физический уровень: CAN-шина, выводы OBD-II 6 (CAN-H) и 14 (CAN-L)
Идентификаторы: 11-бит (стандартный) или 29-бит (расширенный), флаг CAN_29BIT_ID
Типичные скорости: 500 кбит/с, 250 кбит/с
Фильтры: только FLOW_CONTROL_FILTER (до 16 на канал)
Расширенная адресация: 5-байтный заголовок (4 байта CAN ID + 1 байт адрес), флаг ISO15765_ADDR_TYPE

// Подключение по ISO 15765 на 500 кбит/с
PassThruConnect(deviceID, ISO15765, 0, 500000, &channelID);

CAN (необработанный поток)

Протокол CAN предоставляет доступ к необработанному потоку CAN-кадров без транспортного уровня. Каждое сообщение — это один CAN-кадр (до 8 байт данных). Адаптер не выполняет сегментацию и сборку — вы получаете и отправляете кадры как есть.

Используйте этот протокол, когда вам нужно работать с CAN-шиной напрямую: мониторинг трафика, отправка отдельных кадров, работа с нестандартными протоколами поверх CAN.

Физический уровень: CAN-шина, выводы OBD-II 6 (CAN-H) и 14 (CAN-L)
Идентификаторы: 11-бит или 29-бит, флаг CAN_29BIT_ID
Типичные скорости: 500 кбит/с, 250 кбит/с, 125 кбит/с, 1 Мбит/с
Фильтры: PASS_FILTER и BLOCK_FILTER (до 10 каждого типа)
Совместимость: может работать одновременно с ISO 15765 на тех же выводах, при совпадении скорости

// Подключение CAN на 500 кбит/с с 29-битными ID
PassThruConnect(deviceID, CAN, CAN_29BIT_ID, 500000, &channelID);

ISO 14230 (KWP2000)

Протокол диагностики по K-линии, широко применяемый в автомобилях 2000-х годов (особенно европейских). Поддерживает два способа инициализации соединения: 5-бодовую (медленную) и быструю (fast init). После инициализации обмен идёт на скорости, согласованной с ЭБУ.

Используется для дилерской диагностики по KWP2000 и для OBD-II на K-линии.

Физический уровень: K-линия (вывод OBD-II 7) и опционально L-линия (вывод 15)
Инициализация: 5-бодовая (FIVE_BAUD_INIT) или быстрая (FAST_INIT) через PassThruIoctl
Типичная скорость: 10400 бод
Флаг ISO9141_K_LINE: если установлен, инициализация только по K-линии (без L-линии)
Параметры таймингов: P1, P2, P3, P4, W0-W5 — настраиваются через SET_CONFIG

// Подключение по ISO 14230 на 10400 бод, только K-линия
PassThruConnect(deviceID, ISO14230, ISO9141_K_LINE, 10400, &channelID);

ISO 9141

Более ранний протокол K-линии, определённый стандартом ISO 9141-2. Используется для OBD-II диагностики в старых автомобилях (до 2004-2008 годов в зависимости от региона). Поддерживает только 5-бодовую инициализацию.

Физический уровень: K-линия (вывод OBD-II 7) и L-линия (вывод 15)
Инициализация: только 5-бодовая через FIVE_BAUD_INIT
Типичная скорость: 10400 бод
Отличие от ISO 14230: не поддерживает быструю инициализацию, более простой формат пакетов

// Подключение по ISO 9141 на 10400 бод
PassThruConnect(deviceID, ISO9141, 0, 10400, &channelID);

SAE J1850 VPW

Протокол с модуляцией переменной ширины импульса (Variable Pulse Width), использовавшийся в автомобилях General Motors для OBD-II диагностики. Работает на скорости 10,4 кбит/с по одному проводу.

Физический уровень: вывод OBD-II 2 (VPW)
Скорость: 10400 бит/с
Применение: GM автомобили до ~2008 года

// Подключение по J1850 VPW
PassThruConnect(deviceID, J1850VPW, 0, 10400, &channelID);

SAE J1850 PWM

Протокол с модуляцией ширины импульса (Pulse Width Modulation), использовавшийся в автомобилях Ford для OBD-II диагностики. Работает на скорости 41,6 кбит/с по двум проводам.

Физический уровень: выводы OBD-II 2 (BUS+) и 10 (BUS-)
Скорость: 41600 бит/с
Применение: Ford автомобили до ~2008 года

// Подключение по J1850 PWM
PassThruConnect(deviceID, J1850PWM, 0, 41600, &channelID);

Как начать работу (Пошаговое руководство)

Работа с J2534-адаптером из вашего приложения обычно следует этому алгоритму:

Шаг 1: Поиск и загрузка J2534 DLL

Каждый производитель J2534-адаптера предоставляет свою реализацию API в виде DLL-файла. При установке драйвера информация об этой DLL (путь к файлу) записывается в реестр Windows.

Ваше приложение должно:

Найти доступные J2534-устройства в системном реестре.
Предоставить пользователю выбор, какой адаптер использовать (если их несколько).
Загрузить соответствующую DLL в память с помощью функции LoadLibrary (в Windows).

Шаг 2: Основной цикл работы с адаптером

После загрузки DLL и получения указателей на функции, типичный сеанс диагностики выглядит так:

Открыть соединение с адаптером:
Вызовите функцию PassThruOpen(), чтобы инициализировать связь с физическим устройством. В ответ вы получите DeviceID — уникальный идентификатор этого сеанса.
```
// Пример
unsigned long deviceID;
long result = PassThruOpen(NULL, &deviceID);
```
Установить канал связи с ЭБУ:
Вызовите PassThruConnect(), чтобы установить логический канал связи с автомобилем по определённому протоколу (например, ISO15765 для CAN-шины). Вы указываете протокол, скорость и другие параметры. В ответ вы получаете ChannelID.
```
// Пример
unsigned long channelID;
result = PassThruConnect(deviceID, ISO15765, 0, 500000, &channelID);
```
Установить фильтры:
Настройка фильтров — обязательный шаг. По умолчанию адаптер не будет принимать входящие сообщения, пока не будет сконфигурирован хотя бы один фильтр. Фильтры позволяют отсеять весь ненужный трафик в шине и получать только интересующие вас данные (например, ответы от конкретного ЭБУ). Для создания и настройки фильтров используется функция PassThruStartMsgFilter().
Обмен данными:
Процесс обмена данными является асинхронным и построен на очередях:
- Отправка данных: Вызов функции PassThruWriteMsg() не отправляет сообщение в шину немедленно. Вместо этого, она помещает одно или несколько сообщений в очередь на отправку и сразу же возвращает управление. Драйвер адаптера самостоятельно отправит эти сообщения из очереди, как только появится такая возможность.
- Чтение данных: Приходящие из шины сообщения (например, ответы от ЭБУ) накапливаются во внутренней очереди приема. Функция PassThruReadMsg() используется для извлечения сообщений из этой очереди.
Важное замечание: Библиотека J2534 является однопоточной. Это значит, что все вызовы функций (PassThruWriteMsg, PassThruReadMsg и др.) для одного канала должны выполняться строго последовательно. Нельзя вызывать одну функцию, пока не завершилось выполнение предыдущей. Попытка одновременного вызова функций из разных потоков для одного и того же канала приведет к непредсказуемому поведению.
Закрыть канал связи:
После завершения работы с ЭБУ, закройте канал с помощью PassThruDisconnect().
```
// Пример
result = PassThruDisconnect(channelID);
```
Закрыть соединение с адаптером:
В самом конце, когда работа с адаптером полностью завершена, вызовите PassThruClose(), чтобы освободить устройство.
```
// Пример
result = PassThruClose(deviceID);
```

Этот цикл — основа любого J2534-приложения. В следующих разделах подробно описана каждая функция API и её параметры.

Обработка ошибок

Каждая функция J2534 API возвращает код состояния. Успешное выполнение всегда возвращает STATUS_NOERROR (значение 0). Любое другое значение указывает на конкретную ошибку (например, ERR_TIMEOUT, ERR_INVALID_CHANNEL_ID и т.д.).

Крайне важно проверять возвращаемое значение после каждого вызова функции.

Особый код ошибки — ERR_FAILED. Это общая, неспецифичная ошибка. Только в этом случае следует вызывать функцию PassThruGetLastError(), чтобы получить от драйвера более детальное, текстовое описание проблемы.

// Пример правильной обработки ошибок
long result = PassThruConnect(deviceID, ISO15765, 0, 500000, &channelID);
if (result != STATUS_NOERROR)
{
    printf("Ошибка PassThruConnect. Код: %ld\n", result);

    // Если ошибка общая, запрашиваем детали
    if (result == ERR_FAILED)
    {
        char errorDescription[80];
        PassThruGetLastError(&errorDescription[0], 80);
        printf("  Дополнительная информация: %s\n", errorDescription);
    }
    
    // Здесь может быть логика обработки других кодов ошибок
    // switch (result) { case ERR_TIMEOUT: ... }

    return; // Прерываем выполнение
}

Справочник стандартных функций J2534

Подробное описание каждой функции стандарта J2534 вынесено в справочник функций.