Описание
Конвертер XDF → A2L WinOLSConverter — утилита для преобразования определений TunerPro XDF в файлы калибровок ASAP2 / A2L, предназначенные для использования с WinOLS.
Конвертер считывает структуру, заданную в XDF, вместе с выбранным исходным BIN и формирует промежуточную модель калибровки перед созданием итогового файла A2L.
Он разработан как универсальный конвертер, а не как база жёстко заданных определений ECU. Логика преобразования не зависит от марки ECU, семейства, имени файла, хэша файла или заранее определённого набора файлов разработки.
Для чего это нужно?
Файлы XDF описывают карты, скаляры, оси, флаги и другие элементы калибровки, используемые TunerPro. WinOLS, в свою очередь, может работать с описаниями ASAP2 / A2L.
Этот инструмент обеспечивает следующий путь преобразования:
XDF → Необработанная модель XDF → Каноническая модель калибровки → Проверка → A2L для WinOLS
Это может быть полезно, когда существующее определение XDF нужно перенести в рабочий процесс на базе WinOLS без ручного создания каждого элемента калибровки.
Основные функции
Поддержка переключателей
Конвертер включает специальную обработку поддерживаемых определений переключателей.
Обработка осей
Версия 3.1.2 исправляет генерацию FIX_AXIS_PAR_LIST.
Точки фиксированной оси теперь всегда записываются как корректный блок ASAP2:
Предыдущее встроенное представление удалено.
Перед записью A2L конвертер проверяет количество точек фиксированной оси по значению MaxAxisPoints.
Исходная разметка и шаг XDF не изменяются. Чередующиеся оси сохраняют свой фактический объём хранения и материализуются как FIX_AXIS только тогда, когда профиль WinOLS 4.70 не может точно представить их исходную структуру хранения.
Обработка GROUP
Категории XDF экспортируются как записи ASAP2 GROUP.
Идентификаторы групп очищаются и делаются уникальными. Старый искусственный префикс GRP_ больше не добавляется.
Универсальное ядро преобразования
Конвертер не содержит ветвей преобразования, основанных на:
Решения о преобразовании вместо этого принимаются на основе структуры XDF и информации, полученной из BIN-файлов, выбранных во время работы.
Встроенная самопроверка также использует синтетические тестовые данные, созданные в ходе тестирования, а не файлы из набора разработки.
Использование GUI
Использование командной строки
С целевым BIN:
Создание дополнительных отчётов:
Самопроверка
Требования
Конвертер написан на Python и не требует сторонних пакетов Python.
В пакет также входят файлы запуска BAT / PYW для более удобного запуска под Windows.
Важно
Автоматическое преобразование не может гарантировать, что для каждой нестандартной или специфичной для производителя конструкции XDF найдётся точный аналог в ASAP2 или WinOLS.
Перед использованием проекта для калибровочных работ всегда проверяйте созданный A2L и сверяйте важные адреса, оси, формулы преобразования и размеры карт с исходными XDF и BIN.
Конвертер считывает структуру, заданную в XDF, вместе с выбранным исходным BIN и формирует промежуточную модель калибровки перед созданием итогового файла A2L.
Он разработан как универсальный конвертер, а не как база жёстко заданных определений ECU. Логика преобразования не зависит от марки ECU, семейства, имени файла, хэша файла или заранее определённого набора файлов разработки.
Для чего это нужно?
Файлы XDF описывают карты, скаляры, оси, флаги и другие элементы калибровки, используемые TunerPro. WinOLS, в свою очередь, может работать с описаниями ASAP2 / A2L.
Этот инструмент обеспечивает следующий путь преобразования:
XDF → Необработанная модель XDF → Каноническая модель калибровки → Проверка → A2L для WinOLS
Это может быть полезно, когда существующее определение XDF нужно перенести в рабочий процесс на базе WinOLS без ручного создания каждого элемента калибровки.
Основные функции
- Преобразование определений калибровок XDF в формат ASAP2 / A2L.
- Использование выбранного исходного BIN при преобразовании.
- Дополнительная поддержка целевого BIN для операций PORT.
- Создание файлов A2L, предназначенных для WinOLS.
- Обработка карт, скаляров, осей и поддерживаемых определений переключателей.
- Сохранение информации, полученной из фактической структуры XDF, без опоры на жёстко заданные правила для конкретных ECU.
- Проверка перед записью итогового A2L.
- Дополнительные отчёты о преобразовании.
Поддержка переключателей
Конвертер включает специальную обработку поддерживаемых определений переключателей.
- Однобитный XDFFLAG экспортируется как CHARACTERISTIC VALUE с использованием BIT_MASK, TAB_VERB и DISCRETE.
- Определения XDFPATCH с одной записью, использующие скаляр размером 1, 2 или 4 байта, могут экспортироваться как дискретный CHARACTERISTIC VALUE.
- Значения ORIGINAL и PATCHED представляются с помощью точной COMPU_VTAB.
- Скалярные определения PATCH включают DEFAULT_VALUE "UNKNOWN".
- Определения PATCH с несколькими записями или неподдерживаемой шириной не принудительно преобразуются в модель скалярного переключателя.
- Многобитовые маски некорректно не представляются как простые переключатели ON/OFF.
Обработка осей
Версия 3.1.2 исправляет генерацию FIX_AXIS_PAR_LIST.
Точки фиксированной оси теперь всегда записываются как корректный блок ASAP2:
Код:
/begin FIX_AXIS_PAR_LIST
...
/end FIX_AXIS_PAR_LISTПредыдущее встроенное представление удалено.
Перед записью A2L конвертер проверяет количество точек фиксированной оси по значению MaxAxisPoints.
Исходная разметка и шаг XDF не изменяются. Чередующиеся оси сохраняют свой фактический объём хранения и материализуются как FIX_AXIS только тогда, когда профиль WinOLS 4.70 не может точно представить их исходную структуру хранения.
Обработка GROUP
Категории XDF экспортируются как записи ASAP2 GROUP.
Идентификаторы групп очищаются и делаются уникальными. Старый искусственный префикс GRP_ больше не добавляется.
Универсальное ядро преобразования
Конвертер не содержит ветвей преобразования, основанных на:
- имени файла XDF
- имени файла BIN
- производителе автомобиля
- семействе ECU
- хэше файла
- известных файлах разработки
Решения о преобразовании вместо этого принимаются на основе структуры XDF и информации, полученной из BIN-файлов, выбранных во время работы.
Встроенная самопроверка также использует синтетические тестовые данные, созданные в ходе тестирования, а не файлы из набора разработки.
Использование GUI
- Выберите файл XDF.
- Выберите исходный BIN.
- При необходимости выберите целевой BIN для PORT.
- Создайте файл A2L.
Использование командной строки
Код:
python xdf_to_a2l_winols_v3.1.2.py input.xdf source.bin output.a2lС целевым BIN:
Код:
python xdf_to_a2l_winols_v3.1.2.py input.xdf source.bin output.a2l --target-bin target.binСоздание дополнительных отчётов:
Код:
python xdf_to_a2l_winols_v3.1.2.py input.xdf source.bin output.a2l --reportsСамопроверка
Код:
python selftest_v3.1.2.pyТребования
Конвертер написан на Python и не требует сторонних пакетов Python.
В пакет также входят файлы запуска BAT / PYW для более удобного запуска под Windows.
Важно
Автоматическое преобразование не может гарантировать, что для каждой нестандартной или специфичной для производителя конструкции XDF найдётся точный аналог в ASAP2 или WinOLS.
Перед использованием проекта для калибровочных работ всегда проверяйте созданный A2L и сверяйте важные адреса, оси, формулы преобразования и размеры карт с исходными XDF и BIN.
