This repo contains everything needed to setup an interface for uploading ODB2 data logged from your car in real-time using the Torque Pro app for Android.
The interface allows the user to:
- View a Google Map showing your trips logged via Torque
- Create time series plots of OBD2 data
- Easily export data to CSV or JSON
Demo
Requirements
These instructions assume you already have a LAMP-like server (on a Linux/UNIX based host) or have access to one. Specifically, you'll need the following:
- MySQL database
- Apache webserver
- PHP server-side scripting
If in doubt, I'd recommend using Ubuntu LTS.
You also need a Bluetooth ODBII adapter, I recommend this one which I've used since 2014:
BAFX Products 34t5 Bluetooth OBDII Scan Tool for Android Devices
I also use this to position the adapter in a better location:
Oem OBD-II OBD2 16Pin Male to Female Extension Cable Diagnostic Extender 100cm
Server Setup
First clone the repo:
bash
git clone https://github.com/surfrock66/torque
cd torque
Configure MySQL
To get started, create a database named torque and a user with permission to insert and read data from the database. In this tutorial, we'll create a user steve with password zissou that has access to all tables in the database torque from localhost:
sql
CREATE DATABASE torque;
CREATE USER 'steve'@'localhost' IDENTIFIED BY 'zissou';
GRANT USAGE, FILE TO 'steve'@'localhost';
GRANT ALL PRIVILEGES ON torque.* TO 'steve'@'localhost';
FLUSH PRIVILEGES;
Then create a table in the database to store the logged data using the create_torque_log_table.sql, the create_torque_sessions_table.sql, and the create_torque_keys_table.sql files provided in the scripts folder of this repo:
bash
mysql -u yoursqlusername -p < scripts/create_torque_log_table.sql
mysql -u yoursqlusername -p < scripts/create_torque_sessions_table.sql
mysql -u yoursqlusername -p < scripts/create_torque_keys_table.sql
OPTIONAL: Create Google Maps Javascript API Key
It's optional, but to be above board, you should create an API key for the google maps javascript API. If you go here Google Maps JavaScript API Click the "Get A Key" button, and follow the procedure to create a new project, then go to "Credentials" and make a new API Key, choosing "Server". You'll be using it below.
More guidance is available here.
You don't NEED to do this, but it's the proper way and will actually squash some javascript warnings if you like to keep your debug logs clean.
Configure Webserver
Move the contents of the web folder to your webserver and set the appropriate permissions. For example, using an Apache server located at /var/www:
bash
mv web /var/www/torque
cd /var/www/torque
find . -type d -exec chmod 755 {} +
find . -type f -exec chmod 644 {} +
Rename the creds-sample.php file to creds.php:
bash
mv creds-sample.php creds.php
Then edit/enter your MySQL username and password in the empty $db_user and $db_pass fields:
php
...
$db_host = 'localhost';
$db_user = '**steve**';
$db_pass = '**zissou**';
$db_name = 'torque';
$db_table = 'raw_logs';
$db_keys_table = 'torque_keys';
$db_sessions_table = 'sessions';
$gmapsApiKey = ''; // OPTIONAL Create a key at https://developers.google.com/maps/documentation/javascript/
...
If you created a google maps API key above, place that in the variable here.
Settings in Torque App
To use your database/server with Torque, open the app on your phone and navigate to:
Settings -> Data Logging & Upload
Below are the options which seem to work best for optimal logging, the suggested "File Logging" interval is 1s:
Additionally, I recommend changing the web logging interval to 1s, though this produces a LOT of data. Some users may want to set this to >=5s.
Enter the URL to your upload_data.php script under "Webserver URL" and press OK. Test that it works by clicking Test settings and you should see a success message like the image on the right:
At this point, you should be all setup. The next time you connect to Torque in your car, data will begin syncing into your MySQL database in real-time!
Gotchas
If you log a ton of PID's (as I do for debugging) you may encounter an apache bug; Torque uploads data through a huge $GET request. Apache, by default, allows $GET requests up to 8190 characters. My sample data upload was 13,619 characters long...this led to some data uploads returning 414 errors instead of 200 responses, which resulted in the app trying over-and-over to re-upload the datapoint, essentially DDoS'ing myself. For this; you can edit your apache configuration to allow any value you like; this is, in general, not recommended and should be set to limit a value as close as possible to what your longest query would be. On my configuration, I edited /etc/apache2/sites-available/000-default.conf and added the following line:
LimitRequestLine 15000
Roadmap
- Sanity Checks and Warnings for merges and deletes
- Allow for csv imports...captures un-uploaded but recorded data when emailed from torque
- Email-receiver for this? LONG SHOT, but have the server read an email address so you can email tracks from the app
- Ian Hawkins has a google map pin show up when hovering over his graphs on his reference viewer...different system, but it'd be cool to implement.
- Idea: speed heatmap for the map track. (Google Maps iOS API has gradient polylines, javascript API does not...may not be possible for now).
This repo contains everything needed to setup an interface for uploading ODB2 data logged from your car in real-time using the Torque Pro app for Android.
The interface allows the user to:
- View a Google Map showing your trips logged via Torque
- Create time series plots of OBD2 data
- Easily export data to CSV or JSON
Demo
Requirements
These instructions assume you already have a LAMP-like server (on a Linux/UNIX based host) or have access to one. Specifically, you'll need the following:
- MySQL database
- Apache webserver
- PHP server-side scripting
If in doubt, I'd recommend using Ubuntu 12.04 LTS.
Server Setup
First clone the repo:
bash
git clone https://github.com/econpy/torque
cd torque
Configure MySQL
To get started, create a database named torque and a user with permission to insert and read data from the database. In this tutorial, we'll create a user steve with password zissou that has access to all tables in the database torque from localhost:
sql
CREATE DATABASE torque;
CREATE USER 'steve'@'localhost' IDENTIFIED BY 'zissou';
GRANT USAGE, FILE TO 'steve'@'localhost';
GRANT ALL PRIVILEGES ON torque.* TO 'steve'@'localhost';
FLUSH PRIVILEGES;
Then create a table in the database to store the logged data using the create_torque_log_table.sql file provided in the scripts folder of this repo:
bash
mysql -u yoursqlusername -p < scripts/create_torque_log_table.sql
Configure Webserver
Move the contents of the web folder to your webserver and set the appropriate permissions. For example, using an Apache server located at /var/www:
bash
mv web /var/www/torque
cd /var/www/torque
find . -type d -exec chmod 755 {} +
find . -type f -exec chmod 644 {} +
Rename the creds-sample.php file to creds.php:
bash
mv creds-sample.php creds.php
Then edit/enter your MySQL username and password in the empty $db_user and $db_pass fields:
php
...
$db_host = "localhost";
$db_user = "steve";
$db_pass = "zissou";
$db_name = "torque";
$db_table = "raw_logs";
...
Settings in Torque App
To use your database/server with Torque, open the app on your phone and navigate to:
Settings -> Data Logging & Upload -> Webserver URL
Enter the URL to your upload_data.php script and press OK. Test that it works by clicking Test settings and you should see a success message like the image on the right:
The final thing you'll want to do before going for a drive is to check the appropriate boxes on the Data Logging & Upload page under the REALTIME WEB UPLOAD section. Personally, I have both Upload to webserver and Only when ODB connected checked.
At this point, you should be all setup. The next time you connect to Torque in your car, data will begin syncing into your MySQL database in real-time!