Protohaund: Как получить диагностический контекст автомобиля VAG по данным ODIS

Разбирая обмен с ЭБУ VAG часто возникает вопрос: откуда диагностическая программа знает, куда обращаться и как разбирает ответы? По ответам на некоторые запросы ещё можно догадаться что к чему: когда ответ текстовый, то понимаешь что это, но в трассе полно бинарных запросов, а иметь человеческое описание хочется для любых запросов.

Фрагмент вывода трассы в Protohaund без/с использования/ем диагностическим контеста

В этой заметке на примере UDS панели 1Z0920843Q, которая уже хорошо нам знакома, и данным установленного ODIS Service мы проследим, как от VIN можно дойти до проекта с детальным описанием диагностической модели панели. Если у вас ODIS Engineering, искать придётся те же связи, хотя имена и расположение файлов могут отличаться.

С чего начать поиски?

Что нужно узнатьГде искатьЧто дает
Применимость проекта к автомобилюАрхивы de.volkswagen.odis.vaudas.artifact.vrtvpt-*.jar. Внутри — корневые таблицы VRT и таблицы проектов VPTРедакцию поставки, архив, имена XML и все подходящие строки
Состав конкретной редакции проектаDatabaseVersionInfo.txt, index.xml, rt_index.xml, _META/*CRC_RTD.propertiesИмя проекта, версию проекта и формата, хеши использованных файлов
Маршрут к блокуVEHICLE-INFO-SPEC и LOGICAL-LINK в ODX либо контейнер .vi.db в VW-MCDЛогический адрес, базовый вариант, транспорт и параметры связи
Условия выбора ЭБУ и схемы сообщенийBASE-VARIANT, ECU-VARIANT, родительские слои и словари данных либо соответствующие .db и .keyИдентификаторы объектов и их ссылки, условия сопоставления, схему нужной службы
Подписи на нужном языкеDIDB, связанный с исследуемой поставкойКлюч перевода, язык и точный текст.
Фактически установленный блок и его ответыДиагностическая трасса либо журнал чтения с автомобиля или стендаВремя и направление обмена, адреса, исходные байты, результат ISO-TP и значения DID

Первым делом смотрим, как разложены данные установленного ODIS. В plugins (обычно в C:\Program Files\OS) ищем архивы применимости, а за самими проектами идём в MCD-Projects (обычно в C:\ProgramData\OS). Файлы JAR открываются как ZIP.

Структура файлов диагностической базы может немного отличаться в зависимости от версии формата. В этой статье я разбираю проект VW‑MCD в формате 0018. Версию формата своего проекта можно посмотреть в файле DatabaseVersionInfo.txt. По опыту, разница между форматами несущественная (даже в сравнении с древней 0016), поэтому подход можно назвать универсальным.

Чтобы узнать, в какой папке лежат XML, заглядываем в plugin.xml и смотрим artifactDirectory/@resource. В одних архивах это artifact/, в других встречается vrt/ (напомню, если вы работаете с Postsetup, проекты могут лежать во вложенных архивах 7z). Таблицы применимости и переводы ищем в отдельных архивах той же поставки.

У каждого проекта есть удобное оглавление — index.xml. В нём можно найти имя исходного документа .odx и тут же обнаружить, что на диске лежат соответствующие .db и .key. Тогда смотрим rt_index.xml, берём индексы и таблицы строк нужного проекта и проверяем, куда ведёт ссылка на объект. Имена из оглавления помогают понять, за какой файл браться.

Какой проект соответствует нашему VIN?

Начнём с VIN. Что именно искать в трассе, зависит от того, по какому протоколу опрашивали блок.

  • UDS. Ищем запрос 22 F1 90 и положительный ответ 62 F1 90 …. На классическом CAN ответ с 17 символами VIN занимает несколько кадров. Собираем его по ISO-TP и берём VIN из данных F190.
  • KWP2000. Сначала смотрим, как читается VIN в описании этого блока. Один из вариантов — запрос идентификации 1A 90 и ответ 5A 90 …. Если обмен идёт по CAN через TP2.0, собираем ответ по кадрам открытого канала. Если это K-Line, выделяем целое сообщение по его длине и проверяем контрольную сумму.

В обоих случаях смотрим, какой блок ответил. Если разные ЭБУ вернули разные VIN, то это уже “ретрофит” и повод вернуться к трассе и разобраться с каждым ответом отдельно o_O

Для Škoda в нашем примере нужны всего три места в VIN:

  • первые три символа дают код изготовителя;
  • седьмой и восьмой — тип автомобиля;
  • десятый — код модельного года.

Возьмём для примера TMB / 1Z / B и посмотрим, куда эта комбинация нас заведёт.

  1. В корневой таблице VRT ищем EXPECTEDIDENTS с VIN-WMI="TMB". Из совпавших строк выписываем все ссылки VEHICLEPROJECTTABLE. Один WMI может встретиться в нескольких фрагментах каталога.
  2. Переходим в указанные VPT и ищем там пару VIN-VEHICLE-TYPE="1Z" и VIN-MODEL-YEAR="B".
  3. Смотрим, есть ли у подходящей строки дополнительные условия. Если указан PR-NUMBER, сверяем его с данными комплектации. Пока код неизвестен, совпадение по этой строке остаётся условным.
  4. Выписываем все найденные DIAGPROJECT и сверяем редакции проектов, которые есть в поставке. Если вариантов несколько, сохраняем все строки и условия. Если не нашлось ни одного, проверяем, как прочитали VIN и все ли нужные файлы есть в поставке.

Здесь легко ошибиться с годом. В VIN записан код модельного года, а машина могла выйти с завода в другом календарном году. Кроме того, коды повторяются. Если разбираете другую марку, сначала проверьте, какие позиции VIN использует именно она.

Пример на установленном ODIS Service

В моём примере обе ссылки для TMB нашлись в de.volkswagen.odis.vaudas.artifact.vrtvpt-c_51.0.0.jar. Одна ведёт в VPT_SKODA_Service_KWP, вторая — в VPT_SKODA_Service_UDS. Заглядываем в обе таблицы и получаем интересную картину. Тип автомобиля один и тот же, 1Z, а замена кода года меняет проект. Для сравнения добавил строку с более новой Octavia NX.

WMI / тип / код годаСтрока в таблицеРезультат
TMB / 1Z / 7VPT_SKODA_Service_KWPSK35x_1Z_6
TMB / 1Z / BVPT_SKODA_Service_UDSSK35X
TMB / NX / LVPT_SKODA_Service_UDSSK38X

Чтобы увидеть сами XML-строки, достаточно PowerShell и tar. Подставляем путь к своему архиву и сверяем имена вложенных файлов по выводу tar -tf. В примере ниже смотрим строку VRT для TMB и строку VPT для 1Z / B. Для своего VIN проходим по всем таблицам из совпавших строк VRT и проверяем дополнительные условия в каждой из них (ниже код для Powershell).

$jar = 'C:/ProgramData/OS/configuration/plugins/de.volkswagen.odis.vaudas.artifact.vrtvpt-c_51.0.0.jar'
Get-FileHash -LiteralPath $jar -Algorithm SHA256
tar -tf $jar

$rootXml = [xml]((tar -xOf $jar 'artifact/VRT_VW-GROUP.xml') -join "`n")
$vptXml = [xml]((tar -xOf $jar 'artifact/VPT_SKODA_Service_UDS.xml') -join "`n")
$rootRule = "//*[local-name()='EXPECTEDIDENTS' and @VIN-WMI='TMB']"
$vptRule = "//*[local-name()='EXPECTEDIDENTS' and @VIN-VEHICLE-TYPE='1Z' and @VIN-MODEL-YEAR='B']"
$rootXml.SelectNodes($rootRule).OuterXml
$vptXml.SelectNodes($vptRule).OuterXml

Вот что возвращает первый вызов для VRT_VW-GROUP.xml.

<EXPECTEDIDENTS VIN-WMI="TMB" xmlns="vrtvpt">
  <VEHICLEPROJECTTABLE>VPT_SKODA_Service_KWP</VEHICLEPROJECTTABLE>
  <VEHICLEPROJECTTABLE>VPT_SKODA_Service_UDS</VEHICLEPROJECTTABLE>
</EXPECTEDIDENTS>

Дальше смотрим результат из VPT_SKODA_Service_UDS.xml. Здесь у строки 1Z / B уже указано имя проекта.

<EXPECTEDIDENTS VIN-VEHICLE-TYPE="1Z" VIN-MODEL-YEAR="B" xmlns="vrtvpt">
  <DIAGPROJECT>SK35X</DIAGPROJECT>
</EXPECTEDIDENTS>

Где в проекте находится приборка?

Итак, для TMB / 1Z / B вышли на SK35X. Теперь нужно найти в нём приборку. Начинаем с описания автомобиля. В ODX этот раздел называется VEHICLE-INFO-SPEC, а в моей редакции SK35X 2100.2.220 за него отвечает 0.0.0@VI_SK35X.vi.db с индексом .vi.key.

Самое интересное здесь — записи MCD_DB_LOGICAL_LINK. В них сходятся назначение блока, базовый вариант, протокол и физический интерфейс. По смещению 2208 нашлась LL_DashBoardUDS, а по 4110 — ещё одна связь для панели, уже через KWP2000. Вот фрагмент таблицы, полученный из этих двух записей.

Смещение в .vi.db, байтИмя записи MCD_DB_LOGICAL_LINKВнешний ключ подписи (LabelExternalId)ПротоколБазовый вариантФизический интерфейс
2208LL_DashBoardUDSSFT00017PR_UDSOnCANBV_DashBoardUDSPhysLink_CAN1
4110LL_DashBoardKWP2000CAN20—PR_KWP2000OnTP20BV_DashBoardKWP2000CAN20PhysLink_CAN1

В первой записи LabelExternalId содержит ссылку на строку SFT00017. Читаем 00017 после SFT как шестнадцатеричное число и получаем знакомый адрес блока 0x17. У второй записи это поле пустое, поэтому из него адрес не извлечь.

А где взять 0x714 и 0x77E, которые видим в трассе? Идём по связи LL_DashBoardUDS в базовый вариант BV_DashBoardUDS и смотрим параметры выбранного протокола. В этой редакции они находятся в CP_UniqueRespIdTable, в записи по смещению 158227 файла 0.0.0@BV_DashBoardUDS.bv.db. Вот фрагмент для PR_UDSOnCAN.

ПараметрЗначение в базеЧто увидим при обмене
CP_CanPhysReqFormatnormal segmented 11-bit transmit with FCЗапрос с 11-битным CAN ID, с управлением потоком при сегментации
CP_CanPhysReqId1812 (0x714)На этот CAN ID тестер отправляет запрос
CP_CanRespUSDTFormatnormal segmented 11-bit receive with FCОтвет с 11-битным CAN ID, с управлением потоком при сегментации
CP_CanRespUSDTId1918 (0x77E)С этого CAN ID приходит ответ блока

Скорость смотрим отдельно. У связанного интерфейса PhysLink_CAN1 в базе подпись CAN1 (500kBit). На стенде при 500 кбит/с панель 1Z0920843Q приняла запрос UDS на 0x714 и ответила на 0x77E. На стенде у 1Z0920843Q получилась именно эта пара CAN ID при скорости 500 кбит/с и обмене по UDS.

Кстати, к SK35X мы пришли через таблицу с суффиксом UDS. Тем интереснее открыть rt_index.xml и увидеть там сразу две группы файлов панели, BV_DashBoardUDS и BV_DashBoardKWP2000CAN20. В самой редакции встречаются PR_UDSOnCAN, PR_KWP2000OnTP20, PR_KWP2000OnKLine и PR_KWP1281OnKLine. По проекту видно, какие связи предусмотрены, а по трассе — какой путь использовался и какие блоки действительно ответили. Состав блоков также можно сверить по отдельной инвентаризации автомобиля.

Можно проверить протоколы файловым разборщиком. Из DatabaseVersionInfo.txt берём версии, а в двух индексах ищем исходные имена и имена контейнеров. Если ODIS установлен в другом месте, подставьте свой путь в $project. (ниже код для Powershell).

$project = 'C:/ProgramData/OS/MCD-Projects/VWMCD/SK35X'
Get-Content -LiteralPath (Join-Path $project 'DatabaseVersionInfo.txt') |
    Select-String '^VWMCD_.*VersionInfo=' | ForEach-Object { $_.Line }
Select-String -LiteralPath (Join-Path $project 'index.xml'), (Join-Path $project 'rt_index.xml') `
    -Pattern 'VI_SK35X|BV_DashBoard|KombiUDSVDDRM09' | ForEach-Object { $_.Line.Trim() }

В моём DatabaseVersionInfo.txt версия проекта — 2100.2.220, формат VW-MCD — 0018, версия ODX — 2.0.1, версия преобразователя — 21.0.0.0.

В index.xml едва ли не самое интересное — имена исходных документов. В выводе видны описание автомобиля VI_SK35X, базовые описания приборки для UDS и KWP2000 и два документа семейства RM09. Оставлю строки с именами файлов.

<FILE CREATION-DATE="2024-11-18" MIME-TYPE="text/xml">BV_DashBoardKWP2000CAN20_001001.odx</FILE>
<FILE CREATION-DATE="2024-11-18" MIME-TYPE="text/xml">BV_DashBoardUDS_006155.odx</FILE>
<FILE CREATION-DATE="2024-11-18" MIME-TYPE="text/xml">EV_KombiUDSVDDRM09_A04729.odx</FILE>
<FILE CREATION-DATE="2024-11-18" MIME-TYPE="text/xml">EV_KombiUDSVDDRM09_A05733.odx</FILE>
<FILE CREATION-DATE="2024-11-18" MIME-TYPE="text/xml">VI_SK35X_001001.odx</FILE>

А в rt_index.xml ищем файлы, которые можно открыть в установленной базе. У описания автомобиля и у каждой из двух групп приборки есть своя пара .db и .key.

<FILE>0.0.0@BV_DashBoardKWP2000CAN20.bv.db</FILE>
<FILE>0.0.0@BV_DashBoardKWP2000CAN20.bv.key</FILE>
<FILE>0.0.0@BV_DashBoardUDS.bv.db</FILE>
<FILE>0.0.0@BV_DashBoardUDS.bv.key</FILE>
<FILE>0.0.0@VI_SK35X.vi.db</FILE>
<FILE>0.0.0@VI_SK35X.vi.key</FILE>

Запись с SFT00017 мы нашли в VI_SK35X.vi.db. Она ведёт в BV_DashBoardUDS, поэтому условия, по которым различаются два варианта RM09, ищем в BV_DashBoardUDS.bv.db.

Как отличить A04 от A05?

Связь привела нас в BV_DashBoardUDS. Это BASE-VARIANT, то есть общая часть описания приборок семейства. Теперь смотрим, какой из ECU-VARIANT подходит к той, что ответила. В ODX для этого ищем ECU-VARIANT-PATTERNS и MATCHING-PARAMETER. В каждом условии есть три подсказки — какую службу вызвать, какое поле ответа взять и какое значение ожидать. В пределах одной альтернативы должны сойтись все условия. Если нужная служба в файле варианта не нашлась, проверяем родительский слой и функциональные группы. Когда совпало несколько вариантов, выписываем, на чём держится каждый, и сверяем порядок выбора для нужной редакции ODX.

Возвращаемся к результатам чтения 1Z0920843Q на стенде. Для этого поиска из отчёта пригодились четыре DID.

DIDЗначениеКак применить
F1871Z0920843QПодтвердить номер детали, сообщённый ЭБУ
F1890608Подтвердить версию ПО
F19EEV_Kombi_UDS_VDD_RM09Найти диагностическое семейство ASAM
F1A2A04114Сопоставить версию определения с условием варианта

По RM09 в индексе SK35X 2100.2.220 нашлись два похожих документа — EV_KombiUDSVDDRM09_A04729.odx и EV_KombiUDSVDDRM09_A05733.odx. Самое время посмотреть, чем они отличаются в самой базе. В 0.0.0@BV_DashBoardUDS.bv.db ищем записи с тегом 0x5C. У обоих вариантов проверяется Param_DataRecor, который возвращают службы DiagnServi_ReadDataByIdentASAMODXFileIdent и DiagnServi_ReadDataByIdentASAMODXFileVersi. Сведём то, что получилось, в таблицу.

Ключ и смещение записиВариантДопустимые пары имени и версии в этой редакции
628099463 / 157782EV_KombiUDSVDDRM09_A04EV_Kombi_UDS_VDD_RM09 / A04, EV_KombiUDSVDDRM09 / A04, EV_Kombi_UDS_VDD_RM09 / 004
628099464 / 157921EV_KombiUDSVDDRM09_A05EV_Kombi_UDS_VDD_RM09 / A05, EV_KombiUDSVDDRM09 / A05, EV_Kombi_UDS_VDD_RM09 / 005

Смотрим на F19E. Имя из отчёта подходит и к A04, и к A05. Разница становится видна в F1A2. Ответ A04114 начинается с A04, что согласуется с первым вариантом. Есть ещё одна зацепка — в .odx обновления этой панели нашлась ссылка на EV_KombiUDSVDDRM09_A04. Если нужно повторить именно штатный отбор, остаётся проверить по описанию службы, как из полного ответа выделяется сравниваемое поле. Поэтому я сохраняю и строку A04114 целиком, и её исходные байты.

Проверяем записи в файлах ODIS

Чтобы повторить проверку, достаточно Python 3 и файлов проекта. Копируем весь блок в PowerShell, включая строки с @' и '@'. Сначала читаем две сжатые записи логических связей по смещениям 2208 и 4110. Затем берём две записи условий по смещениям из таблицы. Имена служб и полей находим в таблице строк A, ожидаемые значения — в таблице U. Скрипт выводит каждую альтернативу отдельной строкой, знаком + соединены условия, которые должны совпасть вместе.

Смещения в скрипте относятся к SK35X 2100.2.220. При другой версии смещения надо определять заново по её индексам .key.

$project = 'C:/ProgramData/OS/MCD-Projects/VWMCD/SK35X'
@'
from gzip import decompress as gunzip
from io import BytesIO
from pathlib import Path
from struct import iter_unpack, unpack, unpack_from
import sys
import zlib

project = Path(sys.argv[1])

def strings(kind, width, encoding):
    index = gunzip((project / f"{kind}StringData.idx.gz").read_bytes())
    data = gunzip((project / f"{kind}StringData.data.gz").read_bytes())
    offsets = {key: offset for offset, key in iter_unpack("<II", index[4:])}

    def lookup(key):
        offset = offsets[key]
        (length,) = unpack_from("<I", data, offset)
        return data[offset + 4:offset + 4 + length * width].decode(encoding)

    return lookup

def record(filename, offset, size, tag):
    with (project / filename).open("rb") as stream:
        stream.seek(offset)
        body = zlib.decompress(stream.read(size))
    if unpack_from("<H", body)[0] != tag or body[-3:] not in (b"#>\0", b"#<\0"):
        raise ValueError(f"Unexpected record at {offset}")
    return body

def expect(stream, marker):
    if stream.read(len(marker)) != marker:
        raise ValueError("Unexpected variant record layout")

def number(stream):
    return unpack("<I", stream.read(4))[0]

a = strings("A", 1, "ascii")
u = strings("U", 2, "utf-16le")

for offset, size in ((2208, 60), (4110, 54)):
    link = record("0.0.0@VI_SK35X.vi.db", offset, size, 0x6A)
    fields = unpack_from("<8I", link, 2)
    (physical_link,) = unpack_from("<I", link, 44)
    label = a(fields[4]) if fields[4] else "-"
    print(f"{offset} / {a(fields[0])} / {label} / {a(fields[6])} / {a(fields[7])} / {a(physical_link)}")

for offset in (157782, 157921):
    stream = BytesIO(record("0.0.0@BV_DashBoardUDS.bv.db", offset, 139, 0x5C))
    stream.seek(10)
    expect(stream, b"\x01\x9b\x01")
    print(f"\n{offset}:")
    for _ in range(number(stream)):
        expect(stream, b"\x01\x9a\x01\x01\x96\x01")
        conditions = []
        for _ in range(number(stream)):
            expect(stream, b"\x01\x95\x01")
            service = number(stream)
            expect(stream, b"\0\0\0\0\0\0\xad\x0c\0\0")
            parameter, value = unpack("<II", stream.read(8))
            conditions.append(f"{a(service)} / {a(parameter)} = {u(value)}")
        print(" + ".join(conditions))
'@ | py -3 - $project

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

2208 / LL_DashBoardUDS / SFT00017 / PR_UDSOnCAN / BV_DashBoardUDS / PhysLink_CAN1
4110 / LL_DashBoardKWP2000CAN20 / - / PR_KWP2000OnTP20 / BV_DashBoardKWP2000CAN20 / PhysLink_CAN1

157782:
DiagnServi_ReadDataByIdentASAMODXFileIdent / Param_DataRecor = EV_Kombi_UDS_VDD_RM09 + DiagnServi_ReadDataByIdentASAMODXFileVersi / Param_DataRecor = A04

157921:
DiagnServi_ReadDataByIdentASAMODXFileIdent / Param_DataRecor = EV_Kombi_UDS_VDD_RM09 + DiagnServi_ReadDataByIdentASAMODXFileVersi / Param_DataRecor = A05

Хорошо видно, почему одного имени EV_Kombi_UDS_VDD_RM09 здесь мало. Обе строки содержат одно и то же имя, а сравниваемая версия различается. Для остальных записей и версий потребуется разбор соответствующего индекса и структуры объектов.

Возвращаемся к ответу в трассе

Осталось открыть описание нужной службы. Ищем запрос по SID и DID, смотрим положительный ответ и переходим по ссылке от поля данных к его DOP (DATA-OBJECT-PROP). Там проверяем положение и длину поля, кодирование, порядок байтов и преобразование в привычное значение с единицей измерения, если она задана. Если служба пришла из родительского слоя, смотрим, что осталось после переопределений и исключений. Для сложных ответов это особенно важно. Длина поля может зависеть от другого параметра, а состав ответа — от выбранной строки таблицы или ветки MUX.

Для нашего F189 всё проще. После сборки ISO-TP обмен получается таким.

CAN ID 0x714   запрос   22 F1 89
CAN ID 0x77E   ответ    62 F1 89 30 36 30 38

Первый байт 62 говорит, что запрос 22 выполнен, следующие два повторяют F1 89, а дальше идут четыре байта 30 36 30 38. Читаем их как ASCII и получаем ту самую строку 0608. Если захочется разобрать соседний DID, повторяем поиск его схемы. Если задача — собрать диагностическую симуляцию, эти четыре байта уже можно сохранить как исходное значение для чтения. Для переменных данных, ошибок и процедур придётся отдельно описать изменения состояния и ответы на запросы, которые модель не поддерживает. Про симуляцию и эмуляцию я еще напишу отдельно.

Заключение

Если хочется сразу перейти к разбору своей трассы, то рекомендую попробовать Protohaund. Программа уже умеет работать с диагностическими данными установленного ODIS. Подключаем базу, индексируем, чтобы немного ускорить доступ, открываем трассу в Tracer и смотрим, какие блоки и поля ответов удалось распознать по доступным описаниям.

Настройка подключения к существующей диагностической базе в Protohaund

Для работы с Protohaund через агента можно подключить MCP-клиент к локальному серверу через McpBridge. Например, попросить агента найти в открытой трассе обращения к F19E и F1A2 для приборки и выписать байты запросов и ответов. Он будет работать с той же трассой, которую мы видим в Tracer, и тем же диагностическим контекстом, который доступен в программе. Как устроен Tracer в Protohaund.

Если вы хотите создавать свои сценарии, то эту статью можно дать агенту. При наличии доступа к файлам установленного ODIS, по Claude Code, ChatGPT и любой другой ИИ по этим примерам сможет сам разобраться, как читать практически любые данные, описанные в базе. Например, выяснить, какие блоки предусмотрены для выбранной модели, расшифровать коды ошибок, найти каналы адаптации, измеряемые величины и описания кодирования и базовых установок. Тем же способом можно посмотреть параметры связи с блоком и схемы его запросов и ответов. В базе также есть описания процедур SFD и SFD2, включая порядок и правила их выполнения!

Диагностический контекст для операции SFD

А на этом пока все. Надеюсь, что материал вам понравился!

PS Вопросы, пожелания и обсуждение можно вести в группе Telegram.