Repository files navigation

A python module for handling realtime sensor data from OBD-II vehicleports. Works with ELM327 OBD-II adapters, and is fit for the RaspberryPi.

$ pip install obd

importobdconnection=obd.OBD()# auto-connects to USB or RF portcmd=obd.commands.SPEED# select an OBD command (sensor)response=connection.query(cmd)# send the command, and parse the responseprint(response.value)# returns unit-bearing values thanks to Pintprint(response.value.to("mph"))# user-friendly unit conversions

Available atpython-obd.readthedocs.org

Here are a handful of the supported commands (sensors). For a full list, seethe docs

note: support for these commands will vary from car to car

• Calculated Engine Load
• Engine Coolant Temperature
• Fuel Pressure
• Intake Manifold Pressure
• Engine RPM
• Vehicle Speed
• Timing Advance
• Intake Air Temp
• Air Flow Rate (MAF)
• Throttle Position
• Engine Run Time
• Fuel Level Input
• Number of warm-ups since codes cleared
• Barometric Pressure
• Ambient air temperature
• Commanded throttle actuator
• Time run with MIL on
• Time since trouble codes cleared
• Hybrid battery pack remaining life
• Engine fuel rate
• Vehicle Identification Number (VIN)

There are sometimes connection issues when using a Bluetooth OBD-II adapter with some devices (the Raspberry Pi is a common problem). This can be fixed by setting the following arguments when setting up the connection:

fast=False,timeout=30

GNU GPL v2

This library is forked from:

• https://github.com/peterh/pyobd
• https://github.com/Pbartek/pyobd-pi

Enjoy and drive safe!