Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

VISTA Hero Banner

VISTA β€” Your Intelligent Safety Guardian

CI Status Platform Coprocessor Tests BOM

VISTA doesn't just monitor your car β€” it protects you and keeps your loved ones informed. The system continuously learns from sensor data, camera vision, and driving patterns to predict problems before they become expensive repairs or safety hazards.


πŸŽ₯ VISTA Explainer & Live Demonstration

Watch VISTA Demonstration Video

⚑ Click the player above to watch the VISTA HD explainer video! ⚑
(Visualizing edge AI collision alerts, YAMNet acoustic processing, real-time CAN/OBD telemetry, and Gemini-powered damage analytics)

Play Video Download Video


πŸ“‘ Table of Contents


⚑ What You Get

  • 🚨 Instant crash alerts to you and emergency contacts with precise location data.
  • πŸ”’ Theft detection & real-time notifications the moment unusual activity occurs.
  • πŸ”§ Predictive maintenance warnings that catch issues before breakdowns happen.
  • πŸ“Š Driving pattern analysis that identifies risky behaviors and suggests improvements.
  • πŸ› οΈ Pre-tuned maintenance schedules shared directly with your trusted mechanic.

The longer VISTA runs, the smarter it becomes β€” learning your vehicle's unique behavior to separate normal wear from genuine concerns. It's not just protecting your car; it's protecting you.


🏒 Enterprise Value

πŸ›‘οΈ For Insurance Companies: The Truth Layer

Insurance fraud costs the industry billions annually. VISTA provides an intelligent black box that doesn't just record β€” it analyzes, contextualizes, and delivers forensic-grade incident data.

  • Undeniable incident reconstruction with multi-sensor data fusion (vision + telemetry)
  • Fraud detection patterns identified through AI analysis of crash signatures
  • Pre-crash behavior analysis showing driver actions in the critical seconds before impact
  • Automated claims validation reducing investigation time from weeks to minutes

Replace guesswork with ground truth. VISTA transforms claims processing from adversarial negotiation into objective data analysis.

🏭 For Automotive Manufacturers (NVH): Global Fleet Intelligence

Traditional R&D costs billions and relies on controlled test environments. VISTA delivers something far more valuable: real-world, structured intelligence from thousands of vehicles operating in actual conditions.

  • Component failure patterns identified across your entire fleet before recalls become necessary
  • Real-world performance metrics from diverse geographies, climates, and driving conditions
  • Early warning system for design flaws that only emerge in production environments
  • Competitive intelligence through aggregate performance benchmarking

VISTA turns every vehicle into a distributed R&D sensor, potentially saving hundreds of millions in traditional testing costs.

πŸ”— The Common Thread

Each stakeholder receives fundamentally different value from the same underlying platform. VISTA adapts its intelligence layer to serve the unique needs of drivers, insurers, and manufacturers β€” proving that in the modern era, the same data can unlock entirely different forms of value.


πŸ”Œ Hardware

Total BOM: β‚Ή5,770 (~$69 USD) Β· Recurring cloud cost: β‚Ή0/month

Component Purpose Cost
Raspberry Pi 4B (4GB) Main compute β‚Ή0 (owned)
ESP32-C3-DevKitM-1 Always-on 5ΞΌA sentinel β‚Ή400
ELM327 OBD-II (USB) Vehicle CAN data β‚Ή500
MPU6050 GY-521 Crash + motion detection β‚Ή150
Pi Camera v3 (IMX708) Scene capture for Gemini β‚Ή1,800
USB Microphone YAMNet audio classification β‚Ή200
HC-SR501 PIR Parked intrusion detection β‚Ή80
AO3401 P-MOSFET + 2N2222 Pi power control circuit β‚Ή60
Fuel pump relay module Ghost Key physical immobilizer β‚Ή60
DC-DC LM2596 (12V→5V) Car power regulation ₹300
Kingston A400 SSD (120GB) Event DB + images (not SD) β‚Ή900
Misc (wires, resistors, enclosure) Assembly β‚Ή320

The USB SSD is mandatory, not optional. SQLite in WAL mode and InfluxDB write-heavy workloads destroy SD card flash cells within weeks.

See β†’ raw/DESIGN/DESIGN_v4/docs/02_HARDWARE_DESIGN.md for complete pin diagrams, wiring schematics, and installation guide.

πŸ› οΈ Custom Hardware Stack & PCB Layouts

VISTA's electrical engineering incorporates a custom ESP32-C3 coprocessor architecture, transient-protected DC-DC regulators, and active power MOSFET controls. Below are the design assets:

VISTA Custom Hardware Stack

VISTA Schematic Design VISTA PCB Layout

VISTA Altium 3D Render VISTA Gerber Stackup


βš™οΈ Engineering & Architecture

VISTA is a vehicle-mounted intelligence system built on β‚Ή5,770 of hardware, fusing four physical sensing modalities β€” OBD-II vehicle bus data, inertial measurement, acoustic classification, and camera β€” to detect safety-critical events and respond autonomously.

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                    VEHICLE SENSING LAYER                          β”‚
β”‚  OBD-II ELM327    MPU6050 IMU     USB Microphone   Pi Camera v3 β”‚
β”‚  /dev/ttyUSB0     I2C 0x68        16kHz mono        CSI-2 3MP   β”‚
β”‚  2 Hz actual      100 Hz          YAMNet window      On-demand   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                              β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                HARDWARE ABSTRACTION LAYER (HAL)                    β”‚
β”‚  6 drivers with graceful demo-mode fallback                       β”‚
β”‚  System never crashes due to missing hardware                     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                              β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                   INTELLIGENCE PIPELINE                            β”‚
β”‚                                                                    β”‚
β”‚  VelocityEKF          2-state Kalman: OBD + IMU fusion            β”‚
β”‚  CrashDetector        4-tier: jerk β†’ audio β†’ OBD β†’ vision        β”‚
β”‚  AudioClassifier      YAMNet TFLite 4.1MB, 521 β†’ 6 classes       β”‚
β”‚  TheftDetector        Ghost Key TSA: 4-layer temporal analysis    β”‚
β”‚  PredictiveAnalytics  NVH FFT + Gemini mechanic report            β”‚
β”‚  SystemHealthMonitor  Sensor liveness + CPU/RAM/temp              β”‚
β”‚  DecisionEngine       Weighted confidence, explainable output     β”‚
β”‚  CloudVision          Gemini 1.5-flash REST, 3 retries            β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                              β”‚
              β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
              β–Ό                               β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”         β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚   COMMUNICATIONS    β”‚         β”‚   DATA STORAGE          β”‚
β”‚  Telegram (alerts)  β”‚         β”‚  SQLite (events, WAL)   β”‚
β”‚  MQTT (telemetry)   β”‚         β”‚  InfluxDB (time-series) β”‚
β”‚  BLE (proximity)    β”‚         β”‚  USB SSD primary        β”‚
β”‚  Buzzer (local)     β”‚         β”‚  (not SD card)          β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚              ESP32-C3 COPROCESSOR (ALWAYS-ON)                    β”‚
β”‚  Deep sleep: 5ΞΌA Β· PIR intrusion Β· BLE auth Β· MOSFET Pi power   β”‚
β”‚  Battery monitor Β· Heartbeat watchdog Β· 4-state machine          β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

#### πŸ—ΊοΈ Unified System Block Diagram

The complete hardware, signal processing, edge logic, and secure BLE/cellular cloud communications topology:

<p align="center">
  <img src="assets/vista_system_block_diagram.png" width="95%" alt="VISTA System Architecture Block Diagram" style="border-radius: 8px;">
</p>

πŸ”‘ Key Design Decisions

Tiered sensor architecture, not equal weighting. The IMU responds in <10ms. Audio responds in ~50ms. OBD responds in 300–500ms. These sensors cannot be treated as equals. VISTA assigns them roles: IMU is the primary trigger, Audio is the fast corroborator, OBD is the async post-event confirmation.

Hardware-layer theft response. A physical relay on the fuel pump power wire cannot be defeated by CAN-bus injection or any software attack. This is the architectural reason for choosing an analog relay over a CAN command.

Persist before transmit. Crash events are written to SQLite before any Telegram alert is attempted. If the network fails, the event survives. This reversal of the naive "alert first" pattern is critical for forensic completeness.

The cloud does what the edge cannot. Gemini 1.5-flash replaces 5 separate local vision models (object detection, scene classification, damage assessment, license plate reading, natural language reporting). One API call. Zero local compute overhead. Context-aware output in the owner's language.

Every hardware claim must survive physics. OBD-II achieves 2–3 Hz in practice, not 10 Hz. Pi 4 cannot suspend-to-RAM. MPU6050 saturates at Β±16g β€” deliberately configured at maximum range because real crashes produce 20–70g. These are not assumptions; they are measured facts baked into config.yaml.

⚑ Edge-Level Sensor Fusion

The asynchronous decision cascade prioritizing immediate IMU/jerk detection, fast YAMNet acoustic confirmation, post-event OBD-II telemetry verification, and cloud vision corroboration:

VISTA Sensor Fusion Logic

πŸ”’ Ghost Key Anti-Theft Verification

Hardware-layer fuel pump immobilizer relay state flow, requiring active Bluetooth Low Energy (BLE) secure token handshake to authenticate:

VISTA Ghost Key Immobilizer Workflow


πŸ§ͺ System Verification

(Last verified: May 16, 2026)

python -m pytest src/vista/tests/test_v3_quick.py
β†’ 20 passed, 0 failed

python scripts/demo_billion_dollar_architecture.py
β†’ theft_detected:    βœ… PASS
β†’ legitimate_passes: βœ… PASS
β†’ nvh_pipeline:      βœ… PASS
β†’ ALL SCENARIOS PASSED. Exit code: 0

Import check:
β†’ 19/19 modules importable (DEMO_MODE=true)

🚨 Crash/Theft Forensic Analysis & Unit Placement

VISTA uses physical placement optimized for cabin soundscapes and vehicle axis alignment, combined with real-world Telegram visual warning cards generated in under 3.5 seconds:

VISTA Vehicle Unit Placement Real-time Collision Alert View


πŸš€ Quick Start

git clone https://github.com/AdityaPagare619/VISTA.git
cd VISTA

# Configure API keys
cp src/vista/.env.example src/vista/.env
# Edit .env: add GEMINI_API_KEY, TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID

# Run in demo mode (no hardware needed)
cd src/vista
DEMO_MODE=true python run_dashboard.py
# Open http://localhost:5000

# Run on Raspberry Pi (production)
sudo ./scripts/deploy.sh
sudo systemctl start vista vista-dashboard

πŸ“š Documentation

Document For
DESIGN_v4/docs/README.md Start here β€” index + reading order by team
01 System Design Architecture, state machine, boot sequence, innovation claims
02 Hardware Design BOM, wiring diagrams, GPIO tables, relay circuit
03 Software Architecture Package structure, module APIs, data schemas
04 Operational Flows Crash timeline, Ghost Key sequence, NVH flow, EKF dropout
05 Technology Stack Dependencies, cloud config, deployment, CI/CD
06 Demo Methodology Dashboard walkthrough, exam scripts, verifiable claims

πŸ“‚ Project Structure

VISO-PROJECT/
β”œβ”€β”€ README.md
β”œβ”€β”€ pyproject.toml              ← pytest config
β”œβ”€β”€ scripts/
β”‚   β”œβ”€β”€ deploy.sh               ← One-command Pi deployment
β”‚   └── demo_billion_dollar_architecture.py  ← SITL demo
β”œβ”€β”€ .github/workflows/ci.yml    ← 4-job CI pipeline
└── src/vista/
    β”œβ”€β”€ main.py                 ← 5-phase initialization
    β”œβ”€β”€ config.yaml             ← All configuration
    β”œβ”€β”€ hal/                    ← 6 hardware drivers
    β”œβ”€β”€ intelligence/           ← 8 AI/ML modules
    β”œβ”€β”€ communication/          ← Telegram, MQTT, BLE
    β”œβ”€β”€ data/                   ← SQLite + InfluxDB
    β”œβ”€β”€ dashboard/              ← Flask-SocketIO web UI
    β”œβ”€β”€ esp32/main/main.c       ← 1,098 LOC C firmware
    β”œβ”€β”€ models/yamnet.tflite    ← 4.1MB real ML model
    └── tests/                  ← 20-test verified suite

πŸ‘₯ Team

Role Domain
Hardware Lead Wiring, sensors, ESP32 firmware, relay circuit, vehicle installation
AI/ML Engineer YAMNet training, Gemini integration, NVH baseline collection
Data & Integration Dashboard, alerts, database, system integration, CI/CD
Research & Docs IEEE paper, documentation, presentation, evaluation

πŸ“œ License & Contribution

This project is licensed under the MIT License β€” use, modify, and build upon freely. Credit appreciated.

Contributions are welcome! Please feel free to submit a Pull Request.

About

VISTA: Hybrid Edge-Cloud Multi-Modal Vehicle Intelligence Platform for Indian Road Safety. Raspberry Pi 4B + ESP32-C3.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages