Описание команд PassThru адаптера (ver 1.0.0)

Глоссарий

Адаптер - Аппаратный и программный интерфейс поддерживающий протокол J2534.
Сообщение - Пакет данных принятый или переданный по диагностическому протоколу.
Протокол - Диагностический протокол для связи с автомобилем.
Канал - Установленное соединение с ЭБУ по заданному протоколу.

Что такое J2534?

J2534 — это стандарт API, разработанный SAE, который позволяет использовать универсальный программный интерфейс для связи с автомобилем через разъем OBD-II. Он обеспечивает доступ к диагностике и перепрограммированию электронных блоков управления (ЭБУ) различных автомобилей, поддерживая протоколы CAN, ISO9141, J1850 и другие, и упрощает создание ПО, совместимого с любым транспортным средством, поддерживающим OBD-II. API предназначено для работы в среде Windows и взаимодейсвует с прикладной програмой через динамическую библиотеку (DLL).

Версии J2534

На данным момент существует две версии API 04.04 и 5.00. Для каждой версии API, создаётся своя dll, со своим набором функций.

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

J2534/1-2002 (версия 02.02) — первая версия стандарта, поддерживающая базовые функции диагностики и перепрограммирования для легковых автомобилей. Версия устарела и не исползуется.
SAE J1850 (версия 04.04) — уточнены требования к совместимости и добавлены дополнительные протоколы. На данный момент используется большинством прикладных программ.
SAE J2534/1-2022 (версия 05.00) — самая новая версия стандарта. Были добавлены функции поиска и выбора адаптеров, а так же понятие виртуалных каналов.
SAE J2534/2-2020 — расширение для стандартов J2534-1 обоих версий, добавляющее поддержку дополнительных функций и протоколов (например VW TP2.0, CAN FD, J1939 и других). J2534-2 включает новые функции для работы с низкоуровневыми настройками.

Сопутствующие стандарты, которые понадобятся при разработке прикладной программы.

Диагностические сервисы и функции (высший уровень)

SAE J1979 — это стандарт, который определяет методы запроса данных с электронных блоков управления (ЭБУ) через OBD-II протокол. Он описывает диагностические сервисы и параметры, такие как чтение кодов неисправностей (DTCs) и данные от датчиков.
ISO 14230-1:2012 — предназначен для обмена данными между электронными блоками управления (ЭБУ) в автомобилях, использовался в американских автомобилях с начала 1990-х годов. Применяется для диагностики и передачи данных, в основном в протоколах PWM (Ford) и VPW (GM).
ISO 14230-1:2012 — часть KWP2000 (Keyword Protocol 2000), стандарт обмена данными по K линии. Используется в основном в европейских автомобилях, начиная с середины 1990-х годов.

Cтандарты физического уровня.

Как работает J2534?

Каждое устройство J2534 поставляется с комплетом dll для него. Установочная программа устанавливает в систему dll и создаёт свою запись с настройками в реестре Windows. Для каждой версии API исползуется своя версия dll.
Прикладная программа считывает из реестра путь к списку типов адаптеров совместимых с J2534. В настройках так же есть пути к dll для соответсвующеего адаптера.
Пользователь выбирает тип адаптера. программ загружает dll и может взаимодействовать с машиной через функции API.

	7 прикладной	6 представительный	5 сессионный	4 транспортный	3 сетевой	2 канальный	1 физический	0 разьёмы
SAE J1850		SAE J2178‑2 SAE J2178‑3 SAE J2178‑4				SAE J2178‑1	10.4 Kbps VPW
SAE J1850		SAE J2178‑2 SAE J2178‑3 SAE J2178‑4				SAE J2178‑1	41.6 Kbps PWM
KWP2000	ISO 14230‑3					ISO 14230‑2	ISO 14230‑1
KWP2000	ISO 14230‑3					SAE J3054	CAN 11bit
KW 1281				SAE J2818	SAE J2818	SAE J2818	SAE J2818
KW 1281						SAE J3054	CAN 11bit
TP2.0				SAE J2819	SAE J2819	SAE J2819	SAE J2819
GM UART				SAE J2740	SAE J2740	SAE J2740	K‑line
ISO 15765 (DoCAN)	ISO 15765‑3		ISO 15765‑3	ISO 15765‑2	ISO 15765‑2	ISO 11898‑1	SAE J2284‑1 SAE J2284‑2 SAE J2284‑3 SAE J2284‑4
OBDII	SAE J1979 ISO 15031‑5				ISO 15765‑4	ISO 15765‑4	ISO 15765‑4
						SAE J2178‑1	10.4 Kbps VPW
						SAE J2178‑1	41.6 Kbps PWM
						ISO 9141‑2	ISO 9141‑2
						ISO 14230‑2	ISO 14230‑1
UDS	ISO 14229‑1	ISO 14229‑1	ISO 14229‑2	ISO 15765‑2	ISO 15765‑2	ISO 11898‑1		SAE J1962 ISO 15031‑3
				ISO 20794‑3	ISO 20794‑3	ISO 20794‑4
						SAE J3054
UDSonCAN	ISO 14229‑3	ISO 14229‑3	ISO 14229‑2			ISO 11898‑1
UDSonCAN	ISO 14229‑3	ISO 14229‑3	ISO 14229‑2	ISO 20794‑3	ISO 20794‑3	ISO 20794‑4
UDSonCXPI	ISO 14229‑8	ISO 14229‑8	ISO 14229‑8	ISO 20794‑3	ISO 20794‑3	ISO 20794‑4
DoIP	ISO 14229‑1		ISO 14229‑2	ISO 13400‑2	ISO 13400‑2	ISO 13400‑3	IEEE 802.3	ISO 13400‑4
WWH‑OBD	ISO 27145‑3	ISO 27145‑2	ISO 14229‑2	ISO 13400‑2	ISO 13400‑2	ISO 13400‑3	IEEE 802.3	ISO 13400‑4
GM LAN	GMW 3110				OSEK‑COM (USDT/UUDT Protocol)	ISO 11898‑1	GMW 3122 (DW‑CAN) GMW 3089 (SW‑CAN)	GMW 3173

Как работает прикладная программа?

Адаптер реализует не полный вариант стандарта и SAE J2534/2-2010. Перед началом работы необходимо приобрести эти стандарты у SAE. Так же адаптер имеет собственные расширения стандарта, для реализации протоколов не входящих в стандарт.

Описание функций dll стандарта J2534-1/2 ver 04.04

PassThruOpen Установление связи с адаптером
PassThruClose Прекращение связи с адаптером
PassThruConnect Создание соединения по протоколу
PassThruDisconnect Удаление соединения
PassThruReadMsgs Чтение принятых сообщений
PassThruWriteMsgs Передача сообщений
PassThruStartPeriodicMsg Запуск периодического сообщения
PassThruStopPeriodicMsg Удаление периодического сообщения
PassThruStartMsgFilter Установка фильтра сообщений
PassThruStopMsgFilter Удаление фильтра сообщений
PassThruIoctl Управление вводом выводом
PassThruSetProgrammingVoltage Установка напряжения программирования
PassThruReadVersion Чтение информации о dll и адаптере

Функции адаптера

SetKey Установка ключа пользователя
StartBoot Перевод адаптера в режим загрузки обновления
HwTest Запуск теста с внешней тестовой заглушкой
LinkTest Запуск теста связи