Skip to content

vu3scd/ECU-Audit-Log

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ECU Audit CLI + Web Viewer

Kali Tested Python Platform Docker Built with Love


A secure CLI + web-based audit logger for vehicle ECUs using ELM327 over CAN.
Built for traceability, regulation readiness (UN R155/R156), and usability.

v0.2.1 Updates

  • ✅ Auto-detects ELM327 or compatible USB/Bluetooth devices
  • ✅ CLI probes serial ports and prompts for user selection
  • ✅ Verified support for Kali Linux 2023.1+
  • ✅ USB access group instructions for Linux

Planned for v0.3.0

  • Support UDS requests (0x19, 0x22) for reading diagnostics
  • Export logs to CBOR and AUTOSAR XML format
  • Secure logging gateway prototype with multi-ECU support
  • Integration with ISO 21434 Clause 11/15 requirements
  • Optional local SQLite backend for persistence

Linux Support Matrix

Distro Version Status
Ubuntu 20.04+
Debian 11+
Kali Linux 2023.1+
Arch/Manjaro Rolling
Fedora/RHEL 34+ 🟡 (USB perms fix)

Python ≥ 3.7 required. Use sudo usermod -aG dialout $USER for USB access on Linux.


Quick Start

pip install -r requirements.txt
python ecu_audit/webapp.py

Then visit: http://localhost:5000

ecu-audit --auto

License

MIT © 2025 Sumit Chouhan

About

ECU Audit CLI + Web Viewer is a secure, plug-and-play audit logging tool for vehicle ECUs over CAN (ELM327), featuring auto-detection, tamper-evident logs, and a sleek web dashboard. Built for ISO 21434 and UN R155/R156 readiness.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors