Renault Grand Scenic III, турботрактор › Бортжурнал › #107 Новые возможности PyRen: документация под рукой
Обновление: в новых версиях (09h в частности, обновлен механизм формирования документов, исправлена проблема с определением поколения автомобиля. Подменять код платформы теперь не требуется) Все версии обновляются в шапке записи #55 Диагностика своими руками.
Эта запись будет посвящена тем автовладельцам, кто хочет найти техническую документацию по диагностике неисправностей на свой автомобиль, но базы Dialogys ему не хватает. До недавнего времени получить эти данные из CLIP можно было только при использовании одноименного ПО. Однако, в крайней версии PyRen 0.9.e, разработчики добавили функцию экспорта документации из базы CLIP для своего автомобиля.
Постепенно, новые функции PyRen, появляющиеся с каждым обновлением, поднимают функционал бесплатного диагностического приложения для Рено на очень высокий профессиональный уровень, за что разработчикам и участникам PyRen огромное Спасибо!
Начнем, пожалуй, еще раз с процесса обновления. В крайней версии 0.9.e PyRen также обновились экстракторы базы данных CLIP — инструмент, позволяющий скопировать базу данных без установки ПО CLIP. Кроме диагностической базы, теперь можно извлекать и базу диагностической информации VIN и MTC. Процесс обновления PyRen теперь также стал проще из-за возможности работы с универсальным лаунчером, который позволяет не только запускать PyRen под Windows и Android, но и держать различные версии PyRen рядом и запускать нужную из них.
Инструкция обновления применима и для Windows и для Android, различаться могут только пути установки.
1. В той директории, где находится текущий PyRen удалите лаунчеры прежних версий (и любые другие файлы), оставив только четыре папки:
EcuRenault
Location
pyren09c 
Про универсальный лаунчер я подробно рассказывал на видео в предыдущей записи.
Теперь, когда обновление у нас успешно проведено, вернемся к нашей теме, а именно новым функциям и получению документации из базы CLIP.
Новые функции требуют новых файлов из архива с базой и для этого разработчики обновили в том числе и экстрактор данных из установочного архива CLIP, а именно те самые два файлика, которые не требовалось копировать при обновлении PyRen — extract.py и i12comp.exe. Они нужны для того, что бы собрать собственную базу данных CLIP из установочного архива. Для их работы нужен образ диска с ПО CLIP, а именно два файлика из него — data1.hdr и data2.cab
1. Загрузите любую нужную Вам версию с установочным диском CLIP.
2. Распакуйте архив с актуальной версией PyRen (например 0.9.e и выше), туда, где будете пользоваться программой, например D:\PyRen\. Для работы экстрактора нужно не менее 5Гб свободного места на жестком диске.
3. Откройте архиватором или смонтируйте образ диска с CLIP и скопируйте из него в директорию с нашими скриптами — D:\PyRen\ — файлы data1.hdr и data2.cab. Например Total Commander под Windows самостоятельно поддерживает iso-файлы как архивы и может копировать данные из образа напрямую без предварительной распаковки всего диска.
Получится вот такая структура:
D:\PyRen\pyren9h\
D:\PyRen\_pyren_launcher.py
D:\PyRen\data2.cab
D:\PyRen\data1.hdr
D:\PyRen\cmdr_4a_launcher.py
D:\PyRen\extrdata.bat
D:\PyRen\i12comp.exe
D:\PyRen\make_torque_pids.py
4. Запустите скрипт extract.py (в старых версиях был extrdata.bat) и ждите завершения процесса. По завершению, будут созданы такие директории:
MTCSAVE
BVMEXTRACTION
Vehicles
Params
NML
Location
EcuRsm
EcuRenault
EcuDacia
Также, я советую сразу создать здесь директорию DocDB_RU/ и скопировать в нее из диска с CLIP файл DocDB_RU.7ze из языковой директории, которую вы будете использовать (в данном случае RU/).
5. В завершении процесса, можно заменить существующую базу CLIP в скриптах PyRen новой версией, переместив или скопировав все новые директории вместо старых трех — Vehicles, Location и EcuRenault.
Таким образом, мы получили базу данных для PyRen для использования новых функций. Кто не хочет проводить все этапы подготовки самостоятельно, может использовать готовый вариант на базе версии CLIP_170 доступен по ссылке с яндекс-диска.
Теперь, мы можем попробовать собрать документацию по своему автомобилю. Сделаем это последовательно.
1. В директории pyren09e есть скрипт — doc_maker.py. Я подготовил маленький BAT-файл, для того, что бы не приходилось открывать командную строку. Скачайте и поместите файл doc_maker.bat в директорию pyren09e, рядом с doc_maker.py.
2. Запустите doc_maker.bat и в открывшемся окне введите VIN. Не пугайтесь ошибок в процессе его работы, к ним мы как раз подойдем в следующем этапе.
(для примера, я использовал случайный VIN, взятый в интернете)
3. Как видно из картинки, скрипт отработал с ошибкой — не удалось определить поколение автомобиля. К сожалению, пока не знаю, это недоработка скрипта или я устанавливаю скрипты с ошибкой, но разработчики уже предложили вариант решения: в папке MTCSAVE/ появилась папка с нашим VIN номером и в ней несколько файлов. Один из них — platform.txt, должен как раз содержать версию платформы нашего автомобиля, например x95 для Renault Scenic 3. В новых версиях скрипт определяет код платформы самостоятельно и этот шаг можно пропустить.
Список платформ для других автомобилей можно подсмотреть в файлике projects.py в директории со скриптами pyren09e/.
Открываем файл platform.txt и вписываем в него код платформы нужного автомобиля вместо «двух точек», и запускаем doc_maker.bat еще раз.
Не расстраивайтесь, что и в этот раз у нас вернулась ошибка. Идем дальше!
4. Как видно из ошибки выше, нужен еще один файл, а именно данные по этому VIN. Достать его можно из архива DocDB_RU.7ze. Что бы не извлекать все данные — распакуем только папку, которая нужна для нашего автомобиля, в данном случае — DocDb132. И после распаковки — запускаем doc_maker.bat еще раз!
5. Создание занимает минут 5 и в результате должно завершиться на 100%
В результате в директории pyren09e создается файл htm с именем VIN вашего автомобиля. Файл довольно большой по объему и содержит всю информацию по диагностике неисправностей, который доступны в справке CLIP-а.
Например, у меня есть ошибка, связанная с резким стартом в то время, когда ручник еще был затянут.
Для поиска информации по диагностики этой ошибки, откроем наш htm файл и воспользуемся поиском по нему, но искать будем не по коду ошибки — DF025 — а по внутреннему кодом базы, он приведен в скобках следом — 516879.
Таким образом мы еще на шаг приблизились к пониманию нашего автомобиля и теперь диагностика той или иной неисправности будет проходить легче и, надеюсь, качественнее.
Однако помните, что Диагностика — это в первую очередь огромный опыт, а лишь потом профессиональный инструмент. PyRen — это отличный инструмент для самостоятельной диагностики, но без знаний и опыта — он не раскроет всего своего потенциала. Поэтому, не стесняйтесь обращаться к профессионалам за квалифицированной помощью, а там, где это невозможно — на тематические форумы.
Добавлю важную и полезную информацию, представленную на форуме, как расшифровать комплектацию из MTC.xml
Пример для Scenic3 идем в папку X95, тут сразу в текстовом виде лежат все возможные комплектации блоков REF.dat и все возможные комбинации опций MTC.dat
Далее берем свой VIN и первые 3 буквы VF1. Заходим в нужную директорию. Далее берем следующие 6 знаков VIN и смотрим, в какой диапазон они попадают, например между KZ0RD2 и VZR7T5З, значит нам нужен KZ0RD2.dat. переименовываем его в KZ0RD2.zip и разархивируем, либо через Total Commander нажимаем CTRL+Down. Выбираем файлик с нашими следующими 6 цифрами. Внутри ищем строку начинающуюся с последних цифр нашего VIN, второе число в этой строке это ссылка в файл MTC.dat и третье число (без лидирующих нолей) ссылка на REF.dat. В примере ниже это 05142515 и 91369 соответственно
Выбираем из большого файла нужную нам конфигурацию по значению 05142515
И ищем поиском описание параметров MTC по этому файлу:
Сделал excel форму для быстрой сверки комплектации. Комплектацию MTC удобно брать при генерации документов по VIN через doc_maker.py. В папке PyRen\MTCSAVE\ создается папка по имени VIN и в ней будет сохраняться файл mtcdata.txt.
drive.google.com/drive/fo…GKzumW4gvXNAMY7pSfkFExHqy
файл mtc.xlsx
Первая вкладка — справочник, вторая и третья — примеры со Сценик3.
Дополнение 2:
На поколениях машин посл 2009, код ошибки правильно должен начинаться с кода DTC — именно этот код и присутствует в скобках. Т.е. при поиске решения в интернете по своей ошибке, следует искать по коду в скобках, с приставкой DTC.
И вот пример, как выглядит справочная информация в клипе по ней:
А вот так выглядит раздел в документе, созданном PyRen:
Установка pyren для windows
Краткое описание:
Диагностика RENAULT с помощью ELM327
Требуется Android: 4.2 и выше. На смартфонах часто возникает проблема доступа к адаптеру. На планшетах под управлением Андроид 4.2 проблем с доступом к адаптеру нет.
Русский интерфейс: Да
Имя пакета: org.pyrenteam.pyclip
Все файлы для установки под Android в одном архиве: 
pyren_android.zip ( 7,98 МБ )
Сам скрипт PyRen: pyren-master.zip ( 389,68 КБ )
Всегда последняя версия PyRen доступна по этой ссылке
База ddt2000 12_2019 для PyRen PC
Виде установки PyRen
ДЛЯ УСТАНОВКИ НА WINDOWS НЕОБХОДИМ УСТАНОВЛЕННЫЙ PYTHON 2.7 , либо установить pyren по этой ссылке , либо скачать Вот Отсюда архив с версией скрипта на 13.02.2020 PYREN
1. Скачайте следующие файлы (находятся в одном архиве pyren_android.zip ( 7,98 МБ )
):
— sl4a-r6.1.1-arm-debug.apk
— PythonForAndroid-debug-r26.apk
— com.googlecode.pythonforandroid.zip
— savedEcus.p (файл с блоками авто, в архиве файл для примера, попробовать в демо режиме программу, после сканирования создается ваш собственный фал)
— актуальную сборку pyren-master.zip
2. Разрешите возможность установки неизвестных приложений «Unknown Sources» на вашем устройстве.
3. Установите первое приложение: SL4A Application
4. Установите второе приложение: PythonForAndroid
5. Распакуйте архив com.googlecode.pythonforandroid.zip в корень домашней директории пользователя (на том же уровне, что и папки DCIM, Downloads) и внутри папки com.googlecode.pythonforandroid будут три файла для установки питон: python_scripts_r26.zip, python_extras_r29.zip и python_r29.zip
6. Откройте PythonForAndroid
7. Нажмите Local Install и затем Run Local Install, для установки необходимых библиотек Python локально. Проверьте, что версия установлена нужная — Version Installed: Bin: 29 Extra: 29 Scripts: 26
8. Распакуйте архив с актуальной версией PyRen, скачанный ранее pyren-master.zip, в папку на устройстве /sl4a/scripts/. Существующие «тестовые» скрипты из этой папки следует предварительно удалить.
8.1. если вы хотите использовать для нескольких авто то просто переименовать папку pyren в нужную к примеру pyren_test, pyren_moi.
9. Поместите базу CLIP (архив с именем pyrendata_XXX.zip) в папку /sl4a/scripts/, а если вы используете еще и PyClip 2.1 или модифицированую то только в папку /pyren/.
10. Скопируйте пример файла savedEcus.p в папку pyren: /sl4a/scripts/pyren/. Этот файл необходим для запуска скрипта в демо-режиме.
11. Запустите приложение SL4A на устройстве.
12. Запустите универсальный лаунчер _pyren_launcher.py и выберите кнопку «DEMO».
13. После проверки работы скрипта, удалите пример savedEcus.p из папки со скриптом, что бы, подключаясь к своему автомобилю, опросить все блоки заново. После этого будет создан новый файл savedEcus.p с блоками именно Вашего автомобиля. А также рекомендуется очистить папку кеша скрипта, удалив папку pyren\cache.
14. Для запуска скрипта в обычном режиме, запустите универсальный лаунчер _pyren_launcher.py и выберите кнопку «Start».
15. При подключении выберите необходимый адаптер BT или выберите Wi-Fi, если используется такой адаптер, указав его адрес и порт для подключения.
16. Наслаждайтесь возможностью диагностики в любом месте.
17. Для обновления версии скрипта, удалите только скрипты лаунчеров, оставив базу PyRen с сохраненным вашим savedEcus.p файлом.
И распакуйте архив новой версии PyRen.
Теперь, при запуске универсального лаунчера достаточно выбрать папку с новой версией скрипта.
Изменять размер текста на экране устройства можно клавишами громкости или через контекстное меню приложения sl4a. В том случае, если необходимо увеличить сохраняемое на экране число строк, в настройках SL4A укажите параметр Scrollback size больше. По умолчанию там 140 строк, 450-500 строк хватит.
В том случае, если нужен режим demo или включение логирования, выберите соответствующий чекбокс. Кнопка SCAN позволяет подключаться скрипту к автомобилю, игнорируя сохраненный ранее savedEcus.p, т.е. по аналогии с версией для РС — каждый раз проводя опрос всех блоков автомобиля. При включении режима логирования, в папке logs/ появится два файла, необходимых для проверки работы скрипта и адаптера.
PyClip-3.5
версия: с базой 182 PyClip-2.1.apk ( 60,86 МБ )
версия: для DaciaPyClipDacia-1.4.apk ( 28,46 МБ )