OBDscanner

Офлайн-съём диагностики OBD-II через Wi‑Fi адаптер ELM327 (проверено на V-LINK) с Mac/Linux. Результат — JSON/TXT/LOG в obd-dumps/ для анализа человеком или агентом.

Репозиторий: https://github.com/apodobe/OBDscanner

Возможности

• Полный скан: поддерживаемые PID Mode 01/09, DTC (03/07/0A), VIN, Mode 02/06 (сырые ответы)
• Multi-ECU: двигатель (7E8), КПП (7E9)
• LIVE: непрерывный опрос в поездке → .live.jsonl
• Сравнение сессий: obd-sessions.py list | compare | backfill
• Preflight: предупреждение при активном VPN (маршрут до адаптера ломается)

Зависимости: Python 3.10+, только stdlib.

Быстрый старт

git clone https://github.com/apodobe/OBDscanner.git
cd OBDscanner

# Зажигание ON, VPN выкл, Wi‑Fi адаптера (часто SSID V-LINK)
./scripts/obd-scan.sh

Ручной запуск:

python3 scripts/obd_scan.py --host 192.168.0.10 --port 35000

# Honda Civic 2013 (дампы в obd-dumps/honda-civic-2013/)
python3 scripts/obd_scan.py --vehicle honda_civic_2013

Профили: exeed_vx (по умолчанию, пути как раньше), honda_civic_2013. Протокол у обоих — auto (ATSP6→7→0).

Дампы по умолчанию: ./obd-dumps/ (не коммитятся). EXEED — в корне obd-dumps/, Honda Civic — в obd-dumps/honda-civic-2013/.

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

Файл	Содержание
docs/obd2-vlink-connection.md	Подключение Wi‑Fi ELM327, диагностика
docs/obd-sessions.md	Сценарии съёма, сравнение сессий
docs/obd-backlog.md	Планируемые доработки

Структура

scripts/
  obd_scan.py      # ELM327 + съём
  obd_vehicles.py  # профили авто (EXEED VX, Honda Civic 2013…)
  obd_decode.py    # декодирование ответов
  obd_pids.py      # таблица PID и формулы
  obd-sessions.py  # index / compare
  obd-scan.sh      # интерактивная обёртка
obd-dumps/         # локальные дампы (gitignore)
docs/

Конфиденциальность

В дампы попадают VIN, DTC и телеметрия вашего авто. Каталог obd-dumps/ в .gitignore — не публикуйте JSON в открытый доступ без необходимости.

Лицензия

MIT — см. LICENSE.