README.txt

MotoLink // Telemetry

A real-time motorcycle telemetry system for the Royal Enfield Hunter 350, built using the ENSW architecture:  
ESP32 → Native Android Service → Supabase → WebView

The project is an embedded hardware and software system built around the ESP32-D0WD-V3 microcontroller, designed to collect, process, and optionally upload real-time data from a Royal Enfield Hunter 350 motorcycle. The system integrates both environmental and vehicle-specific sensors to monitor a variety of operational parameters, allowing for diagnostics, crash detection (partially), and condition tracking.

ENSW Architecture Overview
- ESP32: Collects raw sensor data on the bike
- Native Android Service: Receives, parses, and uploads data  
- Supabase: Stores all telemetry logs  
- WebView Frontend: Displays over mobile dashboard UI (hosted via Firebase)

Hardware Used

- ESP32-D0WD-V3
- DHT11 – Temperature & humidity
- ADXL345 – Vibration/acceleration
- MCP2515 CAN Bus Module – RPM, speed, fuel level
- 5V Relay Module – For speed pulse counting
- LM2596 Buck Converter – Power regulation
- Capacitors, resistors, jumper wires
- ESP32 connects to internet via phone’s hotspot

Android App Features

Foreground Service
- Runs in the background
- Receives HTTP POSTs from ESP32
- Native Service type: `dataSync`
- Custom logic for variable data rates and sensor control

Data Handling
- Parses ESP32 data and sends to Supabase
- Example table:  
  `dht11_telemetry (id, temperature, humidity, created_at)`

Web Dashboard (Firebase Hosted)
  - Speed
  - RPM
  - Fuel status
  - Trip time
  - Vibration
  - Temperature & humidity
- Pulls data directly from Supabase

Customization
- Adjustable sensor data rates
- Configurable vibration alert thresholds
- Modular backend architecture — new sensors can be added easily (In progress)