Ted is a script to read data from a cars OBD-II connecter using an ELM327 adapter.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
scripts
.gitignore
CHANGELOG.md
LICENSE
README.md
requirements.txt
setup.cfg
setup.py
tscreen.png

README.md

Ted

Ted is a set of scripts to read and display data from a cars OBD-II connecter using an ELM327 adapter. Ted automatically detects which PIDs are available and will only query those.

Installation

Ted is on PyPI and can be installed using pip.

$ pip install ted-tools

Another option is to install Ted from source:

$ python setup.py install

Usage

ted

ted uses the serial interface to a ELM327 adapter to read data from the OBD-II connector. It publishes this data on a ZeroMQ PUB socket. Other scripts can subscribe to this socket and can process the data.

The messages published by the ZeroMQ PUB socket follow this format:

<mode><pid> <value>

The following message contains the current speed of 38 km/h. 01 is the mode, 0d is de PID for the current speed and 38 is the actual value of this parameter.

010d 38
$ ted -h
usage: ted [-h] [-b BAUDRATE] [-d DEVICE] [-p PORT] [-v]

Read OBD-II data using a serial ELM327 interface and publish it on ZeroMQ PUB
socket.

optional arguments:
  -h, --help            show this help message and exit
  -b BAUDRATE, --baudrate BAUDRATE
                        Baudrate to use [default: 38400]
  -d DEVICE, --device DEVICE
                        Path to serial device [default: /dev/ttyUSB0]
  -p PORT, --port PORT  Port to publish data on [default: 1337]
  -v                    Incrase verbosity

tscreen

$ tscreen -h
usage: tscreen [-h] [-p PORT]

TUI showing currents speed and RPM.

optional arguments:
    -h, --help            show this help message and exit
    -p PORT, --port PORT  Port to read data from [default: 1337]

tscreen creates a TUI like this:

tscreenshot

License

Ted is licensed under Mozilla Public License.