An agent for collecting automotive metrics from OBD-II system on InfluxDB
Currently, this project is a WORK IN PROGRESS, so consider it useful for experimentation. Use at your own risk.
GO111MODULE=on go build
obdflux requires a running instance of InfluxDB to connect to. You can use your own installation or just use the provided docker-compose.yml by:
docker-compose up -d
Once your InfluxDB is up and running, create a new database by running:
docker-compose run influxdb-cli
then
CREATE DATABASE obdflux
Finally, create the .env file:
cp .env.example .env
and modify it if needed (or just leave it as is, if you're using the included docker-compose.yml).
To start, you need an ELM327 compatible device connected to your system and get the path to the device.
For futher information on how to get the device path, please refer to the Go library elmobd which is used by obdflux to handle the underlying OBD-II specs and device serial communication.
Once you know the your device path (e.g. /dev/ttyYOUR_USB_DEVICE), run obdflux:
./obdflux --serial=/dev/ttyYOUR_USB_DEVICE
In order to test obdflux without a real device you can use the --test=true option.
Finally, if you need a more verbose output, you can turn on debugging mode by setting --debug=true option.
Example:
./obdflux --test=true --debug=true
MIT