Skip to content

fwaggle/pyELM327

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pyELM327 - A Python interface to Generic OBD2 Devices

Frustrated with the quality of free OBD2 software, I decided to write my own. This involved learning how the ELM327 interface works, and in the meantime I figured I'd simply provide an API to access the ELM327 device programmatically, which I can then wrap a UI around.

Note: This is a work in progress, please don't expect it to be complete.

It's also very poorly tested, using only the platforms and vehicles I had available. At this stage, that consists of:

  • 1999 Holden Commodore VT Series II (LS1 Engine)
  • 2007 Holden Cruze

Requirements

  • ELM327 device - Generic devices vary vastly in quality, so compatibility is not guaranteed.
  • Python 2.7 or later (3.x support not guaranteed)
  • pySerial

Using

pyELM327 supports Python's Context Manager, so you can do stuff like this:

import elm327

with elm327.ELM327(2) as elm:
	print elm.fetchBatteryLevel()

The argument 2 is the port, per the pySerial specifications (COM3 in this case). On Linux replace 2 with '/dev/ttyUSB0'. You can also specify the baud rate and other serial port options.

Other examples can be found in examples/

Known Bugs and Issues

  • We don't cope with changing baudrates terribly well at all - need support for polling the baudrate so we can reset a device with a non-default baud rate. It works as long as nothing goes wrong.

  • Haven't tested DTC retrieval, because I haven't yet managed to throw a code on any of my cars. I might just unplug the MAF.

  • Need to implement proper exceptions.

  • Documentation is appalling.

Sources and Attributions

About

Python interface to ELM327 Devices

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages