🚗 Vehicle Telemetry and Diagnostic System

🛠️ Real-Time Vehicle Telemetry & Diagnostics Simulator

A Python-based system that simulates core functionalities of an Electronic Control Unit (ECU) used in modern vehicles.
This project provides a real-time visual and interactive environment to observe how engine data behaves during acceleration and braking events.

• 🖥️ Tkinter GUI replicates a simple dashboard interface
• 📊 Matplotlib graphs display live RPM and speed updates
• ⚙️ Multithreaded engine ensures smooth sensor simulation
• 📁 Periodic logging of engine temperature, fuel level, and battery voltage to CSV

Ideal for educational use, early-stage automotive prototyping, and testing embedded logic before deployment.

---

⚙️ Tech Stack

Technology	Purpose
Python 3	Core programming language
Tkinter	Desktop GUI interface
Matplotlib	Real-time graph plotting
Threading	Concurrent data updates
CSV	Periodic sensor data logging

---

✨ Features

• Real-time RPM and speed simulation with graphical display
• Gas and brake control buttons with acceleration physics
• Threaded background data updates to keep GUI responsive
• Periodic logging of vehicle data: RPM, speed, temperature, fuel, voltage
• Dark mode UI with dual matplotlib plots for live visualization

---

📁 Project Structure

Vehicle_Telemetry_and_Diagnostic_System/
├── main.py                  # Main GUI simulator
├── telemetry/               # Vehicle data logic
│   ├── __init__.py
│   ├── simulator.py         # (planned)
│   ├── controller.py        # (planned)
│   └── sensors.py           # Randomized temp, fuel, battery voltage
├── telemetry_logger.py      # Logs sensor data to CSV
├── gui/                     # (optional UI modules)
├── tests/                   # (unit tests - planned)
├── logs/                    # Log output directory (auto-created)
└── README.md                # Project documentation

---

🚀 Getting Started

🔧 Installation

1. Clone the repository:

git clone https://github.com/lyushher/Vehicle_Telemetry_and_Diagnostic_System.git
cd Vehicle_Telemetry_and_Diagnostic_System

2. (Optional) Create a virtual environment:

python -m venv venv
source venv/bin/activate  # or .\venv\Scripts\activate on Windows

3. Install dependencies:

pip install matplotlib

▶️ Run the Simulator

python main.py

---

📊 Logs

Sensor data is logged every 2 seconds to logs/telemetry_log.csv. Each entry includes:

• Timestamp
• RPM
• Speed (km/h)
• Engine Temperature (°C)
• Fuel Level (%)
• Battery Voltage (V)

---

🧪 Testing (Planned)

• Unit tests using pytest
• Coverage reports via pytest-cov

---

🔧 CI/CD (Planned)

• GitHub Actions for automated testing
• Linting and code quality checks

---

☁️ Deployment (Planned)

• Docker containerization
• EC2 / Streamlit / FastAPI-based deployment

---

📬 API Endpoints (Planned)

This project will include a REST API using FastAPI to expose real-time telemetry data. Example endpoints:

GET /telemetry        # Latest sensor readings
GET /logs             # Access logged data

---

📄 License

This project is licensed under the MIT License.

---

Note: This project is under active development and will progressively include API endpoints, tests, and cloud deployment support.