obd-server-python

Lightweight server written in Python for storing OBD-II readings, similar to the obd-server by pires. This is designed for use with the android-obd-reader app, also by pires.

Pre-requisites

The server requires the following to read and store OBD data:

• Python 2.7
• PostgreSQL server

In addition, the server requires the installation of Flask and Psycopg2 for the web service and database connection. These may be installed with pip install -r requirements.txt.

Usage

Run server.py. That's it! You may now send your POST or PUT requests to the server.

You may also view all of the logs for a given vehicle ID by going to /view/<vehicleid>.

Configuration

By default, the server will bind to port 5000, or to a port specified by a PORT environment variable. The server will connect to a database through a URL given in the DATABASE_URL environment variable.

Docker

You can build and run this project using Docker.

docker build -t obdserver .

docker run -it --rm \
    -p "5000:5000" \
    -e DATABASE_URL="postgres://user:pass@host:port/db" \
    obdserver

Or, if that's one command too many, set the database URL in docker-compose.yml and run docker-compose up!