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:
License
Ted is licensed under Mozilla Public License.