See LICENSE.md for license terms and conditions.
This is an HTML5 Cordova app that runs in iOS and Android (so far tested only in Android). The app connects via Bluetooth to an ELM327C OBD Connector plugged in the OBD port in any car. The app will collect live metrics from the car on-board diagnostic computer -RPM, speed, fuel consumption, etc.- and save & upload them to Google Sheets for further processing.
This app is more a proof-of-concept than a stable, feature rich application.
This software is heavily based on the npm module bluetooth-obd authored by Eric Smekens and licensed as Apache License 2.0
- Allow capturing live metrics reported by the car engine
- Allows storing locally and uploading them to a selected Google Spreadsheet via an API
- App detects connection to only enable data upload over wi-fi to prevent data plan consumption.
Refer to this wiki page on GitHub for additional information. Refer to this wiki for data upload configuration.
- HTML5 Cordova app authored in the Intel XDK IDE
- Bluetooth communication: cordova-plugin-bluetooth-serial
- Local data storage: cordova-plugin-file
- For detecting wifi-connectivity: cordova-plugin-network-information
- HTML5 Cordova app authored in the Intel XDK IDE
- PIDs supported 00-20
- Monitor status since DTCs cleared
- Fuel system 1 and 2 status
- Engine Coolant Temperature
- Short Term Fuel Trim - Bank 1,3
- Long Term Fuel Trim - Bank 1,3
- Short Term Fuel Trim - Bank 2,4
- Long Term Fuel Trim - Bank 2,4
- Fuel Pressure
- Intake Manifold Absolute Pressure
- Engine RPM
- Vehicle Speed Sensor
- Ignition Timing Advance for #1 Cylinder
- Intake Air Temperature
- Air Flow Rate from Mass Air Flow Sensor
- Absolute Throttle Position
- Commanded Secondary Air Status
- Location of Oxygen Sensors
- Bank 1 - Sensor 1/Bank 1 - Sensor 1 Oxygen Sensor Output Voltage / Short Term Fuel Trim
- Bank 1 - Sensor 2/Bank 1 - Sensor 2 Oxygen Sensor Output Voltage / Short Term Fuel Trim
- Bank 1 - Sensor 3/Bank 2 - Sensor 1 Oxygen Sensor Output Voltage / Short Term Fuel Trim
- Bank 1 - Sensor 4/Bank 2 - Sensor 2 Oxygen Sensor Output Voltage / Short Term Fuel Trim
- Bank 2 - Sensor 1/Bank 3 - Sensor 1 Oxygen Sensor Output Voltage / Short Term Fuel Trim
- Bank 2 - Sensor 2/Bank 3 - Sensor 2 Oxygen Sensor Output Voltage / Short Term Fuel Trim
- Bank 2 - Sensor 3/Bank 4 - Sensor 1 Oxygen Sensor Output Voltage / Short Term Fuel Trim
- Bank 2 - Sensor 4/Bank 4 - Sensor 2 Oxygen Sensor Output Voltage / Short Term Fuel Trim
- OBD requirements to which vehicle is designed
- Location of oxygen sensors
- Auxiliary Input Status
- Time Since Engine Start
- PIDs supported 21-40
- Distance Travelled While MIL is Activated
- Fuel Rail Pressure relative to manifold vacuum
- Fuel Rail Pressure (diesel)
- Bank 1 - Sensor 1/Bank 1 - Sensor 1 (wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Voltage
- Bank 1 - Sensor 2/Bank 1 - Sensor 2 (wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Voltage
- Bank 1 - Sensor 3 /Bank 2 - Sensor 1(wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Voltage
- Bank 1 - Sensor 4 /Bank 2 - Sensor 2(wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Voltage
- Bank 2 - Sensor 1 /Bank 3 - Sensor 1(wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Voltage
- Bank 2 - Sensor 2 /Bank 3 - Sensor 2(wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Voltage
- Bank 2 - Sensor 3 /Bank 4 - Sensor 1(wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Voltage
- Bank 2 - Sensor 4 /Bank 4 - Sensor 2(wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Voltage
- Commanded EGR
- EGR Error
- Commanded Evaporative Purge
- Fuel Level Input
- Number of warm-ups since diagnostic trouble codes cleared
- Distance since diagnostic trouble codes cleared
- Evap System Vapour Pressure
- Barometric Pressure
- Bank 1 - Sensor 1/Bank 1 - Sensor 1 (wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Current
- Bank 1 - Sensor 2/Bank 1 - Sensor 2 (wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Current
- Bank 1 - Sensor 3/Bank 2 - Sensor 1 (wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Current
- Bank 1 - Sensor 4/Bank 2 - Sensor 2 (wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Current
- Bank 2 - Sensor 1/Bank 3 - Sensor 1 (wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Current
- Bank 2 - Sensor 2/Bank 3 - Sensor 2 (wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Current
- Bank 2 - Sensor 3/Bank 4 - Sensor 1 (wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Current
- Bank 2 - Sensor 4/Bank 4 - Sensor 2 (wide range O2S) Oxygen Sensors Equivalence Ratio (lambda) / Current
- Catalyst Temperature Bank 1 / Sensor 1
- Catalyst Temperature Bank 2 / Sensor 1
- Catalyst Temperature Bank 1 / Sensor 2
- Catalyst Temperature Bank 2 / Sensor 2
- "PIDs supported 41-60
- Monitor status this driving cycle
- Control module voltage
- Absolute Load Value
- Fuel/air Commanded Equivalence Ratio
- Relative Throttle Position
- Ambient air temperature
- Absolute Throttle Position B
- Absolute Throttle Position C
- Accelerator Pedal Position D
- Accelerator Pedal Position E
- Accelerator Pedal Position F
- Commanded Throttle Actuator Control
- Time run by the engine while MIL activated
- Time since diagnostic trouble codes cleared
- External Test Equipment Configuration #1
- External Test Equipment Configuration #2
- Fuel Type
- Ethanol fuel %
- Absolute Evap system Vapor Pressure
- Evap system vapor pressure
- Short term secondary oxygen sensor trim bank 1 and bank 3
- Long term secondary oxygen sensor trim bank 1 and bank 3
- Short term secondary oxygen sensor trim bank 2 and bank 4
- Long term secondary oxygen sensor trim bank 2 and bank 4
- Fuel rail pressure (absolute)
- Relative accelerator pedal position
- Hybrid battery pack remaining life
- Engine oil temperature
- Fuel injection timing
- Engine fuel rate
- Emission requirements to which vehicle is designed
- Actual engine - percent torque
- Engine coolant temperature
- Exhaust gas recirculation temperature
- Fuel pressure control system
- Injection pressure control system
- Exhaust pressure
- Exhaust Gas temperature Bank 1