Skip to main content

Serial module for handling live sensor data from a vehicle's OBD-II port

Project description

A python module for handling realtime sensor data from OBD-II vehicle ports. Works with ELM327 OBD-II adapters, and is fit for the Raspberry Pi.

Installation

$ pip install obd

Basic Usage

import obd

connection = obd.OBD() # auto-connects to USB or RF port

cmd = obd.commands.RPM # select an OBD command (sensor)

response = connection.query(cmd) # send the command, and parse the response

print(response.value)
print(response.unit)

Documentation

Visit the GitHub Wiki!

Commands

Here are a few of the currently supported commands (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

  • etc… (for a full list, see commands.py)

License

GNU GPL v2

This library is forked from:

Enjoy and drive safe!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

obd-0.2.0.tar.gz (31.5 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page