Документация CarPort

Программная документация

💡 Эта документация относится к CarPort версии 3.2. В более старых или более новых версиях набор функций может отличаться.

История диагностики & журналы отладки

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

История диагностики

История диагностики

Во время работы с автомобилем CarPort в фоновом режиме записывает, что на самом деле происходило: к каким блокам управления ты подключался, какие данные считывались и — самое главное — какие значения ты изменил. История диагностики делает эти записи наглядными.

Это особенно ценно, если после кодирования или адаптации что-то начинает работать не так, как ожидалось: для каждого изменения в журнале указаны старое значение (До) и новое значение (После), поэтому вмешательство можно отследить и точечно отменить даже спустя несколько дней.

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

Структура окна:

  • Слева — сессии: каждое подключение к автомобилю образует отдельную сессию. Она начинается с первой записанной операции и заканчивается, как только интерфейс отключается или CarPort закрывается. Сессии сгруппированы по периодам (Сегодня, Вчера, Последние 7 дней, В этом месяце, В этом году, более ранние — по годам). В каждой строке указаны время, идентификационный номер (или используемый интерфейс) и количество записей. Текущая сессия при открытии уже выбрана и пополняется в реальном времени.
  • Справа — журнал: выбранная сессия в хронологическом порядке. При каждой смене блока управления выводится выделенная цветом строка с адресом, названием и параметрами связи; под ней следуют отдельные операции со временем, названием, результатом и считанными или записанными значениями. Изменения выделены цветом, как и неудачные операции.

💡 Совет: Командой Переименовать сессию (контекстное меню списка сессий или клавиша F2) можно дать сессии имя, например «Golf 7 — закодирован поворотный свет». Это имя затем отображается в списке и в заголовке журнала, и нужную сессию проще найти.

Фильтрация и поиск:

Сессия легко может насчитывать несколько тысяч записей — один только AutoScan создает по нескольку записей для каждого блока управления. С помощью Фильтр можно ограничить отображение:

Вариант Действие
Все записи Все записанные операции (по умолчанию).
Только изменения Только операции, которые что-то изменили в автомобиле, например запись кодирования, запись значения адаптации, стирание памяти неисправностей, тест исполнительных механизмов, базовые настройки, разрешение на доступ или разблокировка SFD. Это самый важный вид, если нужно понять, что было изменено в автомобиле.
Только операции чтения Только операции чтения — информация о блоках управления, память неисправностей, кодирование, каналы адаптации, список установки и измеряемые величины.

Независимо от этого можно включить Только действия пользователя. Этот параметр скрывает все, что было вызвано автоматически выполняемыми функциями, — AutoScan, сервисным ассистентом и стиранием всех кодов неисправностей. Остается то, что ты сам делал с блоком управления; начало и конец этих функций сохраняются в виде отметок, чтобы не терялась временная взаимосвязь.

Поле поиска Поиск... у правого края панели инструментов выделяет желтым все совпадения в журнале, не скрывая записей, — это удобно, чтобы найти в длинной сессии определенный номер детали, канал адаптации или код неисправности.

Печать и экспорт:

  • Печать (Ctrl+P) открывает предварительный просмотр печати выбранной сессии.
  • Экспорт (Ctrl+S) сохраняет выбранную сессию в формате PDF, Markdown или в виде текстового файла. Формат определяется выбранным расширением файла. По умолчанию для сохранения предлагается папка для отчетов, заданная в настройках программы, а имя файла уже содержит дату.

Обе функции охватывают всю сессию — в том числе части, которые еще не подгружены в окне. Однако установленный фильтр продолжает действовать: то, что скрыто, не печатается и не экспортируется.

💡 Совет: Для собственной документации или в качестве подтверждения для автосервиса лучше всего подходит PDF. Если ты просишь помощи на форуме, лучше выбрать экспорт в Markdown или текст — его можно сразу вставить в сообщение. Отдельные фрагменты журнала можно также выделить и скопировать командой Копировать в буфер обмена (Ctrl+C).

Удаление истории:

Кнопка Удалить предлагает два варианта:

  • Удалить сессию удаляет выбранную сессию со всеми записями.
  • Удалить всю историю удаляет все записанные сессии.

Оба действия доступны и в контекстном меню списка сессий. CarPort каждый раз запрашивает подтверждение.

⚠️ Внимание: Удаленные записи восстановить невозможно. Если ты хочешь задокументировать изменения, заранее экспортируй сессию.

Запись и срок хранения:

Вести ли запись и как долго хранить сессии, задается в настройках программы в разделе История диагностики.

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

Журналы отладки

Если при диагностике возникают проблемы — например, ошибки связи, обрывы соединения или неожиданные сообщения об ошибках, — CarPort может записать весь обмен данными с автомобилем в журнал отладки. Такие журналы содержат подробную информацию обо всех отправленных и полученных сообщениях, о внутренних этапах обработки, а также о возможных ошибках или исключениях.

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

ℹ️ Примечание: Журналы отладки содержат только технические данные обмена между CarPort и автомобилем. Персональные данные не записываются.

Пошаговая инструкция:

  1. Включи запись журнала отладки через меню Опции → Записать журналы отладки.
  2. Откроется диалоговое окно с местом сохранения. По умолчанию используется папка для отладочных данных, заданная в настройках программы.
  3. Выполняй диагностику как обычно, пока не возникнет проблема (например, ошибка связи, неожиданное сообщение об ошибке).
  4. Закрой CarPort.
  5. Автоматически откроется окно Проводника Windows с папкой, в которой сохранены журналы отладки. Имена файлов журналов содержат отметку времени, поэтому нужный файл легко найти.
  6. Отправь файл журнала по электронной почте в нашу службу поддержки, чтобы наша команда разработчиков смогла проанализировать причину.