[ Modules | Screenshots | Log Output | Supported OSs | Download | Contact ]
It does exactly what it says on the tin. It logs OBDII and GPS data on Linux, OSX and others.
It can then take that logged data, and write useful output formats
If you find obdgpslogger useful, please don't hesitate to drop me an email at chunky@icculus.org and let me know of any success, failures, or questions you might have!
OBD GPS Logger comes as a bunch of small tools, each intended to complete a single task. I list these modules on a page of their own.
Of specific mention is an OBD II Simulator, which has been given its own page to explore some of its features.
Each module intended for end users has a manpage in the distribution. A simple text version of the manpages can be found here: manpages
This is what the output looks like when loaded in Google Earth
Click each screenshot below to take you to a page with higher resolution images, the logs, and the final output files.
| Cross-country road trip | |
Bit of Coast | |
|---|---|---|---|
| There and Back Again | |
Testing Trips | |
| Vegas trip for CES 2010 | |
obdgpslogger is actually a small group of command-line applications, and a UI that can be used to launch them. The UI is entirely optional, and the full capabilities of obdgpslogger are available without any graphical systems even running.
Here are some screenshots of it.
| When you first start the UI... |  |
While Driving... |  |
|---|---|---|---|
| Click "Convert log to..." |  |
While converting the log... |  |
Your car has lots of interesting things it can tell you from its on-board computer while it's running. Things like how fast you're going, how fast the engine's going, the air flow into the engine, the throttle position... everything. If you want to know more, google obdII, and enjoy the rabbit hole.
As with so many open-source projects, this is scratching an itch: There's a severe lack of applications that run on OSX or Linux that can log OBDII data.
My gem-of-an-idea from the outset was to be able to log this stuff as I was driving, along with GPS position, and later on plot an overlay on a map of where you drove, and how efficiently the car was running at each instant
The core interest in this application is OBDII. To log from OBDII, you'll need an elm327-compatible device [ie, "all of them"] plugged into your laptop and presenting itself as a serial port device. Just about anything you can find on the internet that says "elm327" and has a plug that fits a hole on your laptop should work.
For the bulk of the time I've been developing this, I've been using one of these: Bluetooth OBDKey. On OSX and Linux, it ends up presented as a serial port that connects as soon as a program opens the device.
After some time in development, I received an OBDPros USB device. It's significantly faster at sampling than the OBDKey, I'll probably use it for the bulk of my development in future. I can very highly recommend it. On OSX the drivers are available for download at this site: FTDIChip [who manufacture the USB-serial chip]
I now also have an OBDLink device. This device defaults to 38400 baud, but the /dev device set up by the FTDI driver defaults to 9600. Use the "-b" or "--baudrate" option to fix this issue.
If you want to use the GPS logging part, you'll need a GPS receiver compatible with gpsd, and gpsd. For bluetooth, I'm using one of these: Globalsat BT-359 and am very happy with it. In general, though, I prefer the BU-353 since you don't have to deal with batteries or turning on and enabling gpsd. [yay hotplug]
No.
OBDII is purely a way to get diagnostic information from the car. The only thing that could be classed as "writing" to the car's computer through the OBDII port is clearing diagnostic codes - which the engine dutifully sets again if whatever-was-wrong is still wrong.
Included in the distribution is a program called obd2kml. This reads the database generated by obdlogger and exports to a Google Earth .kml file
Included in the distribution is a program called obd2csv. This reads the database generated by obdogger and exports it to a CSV file with a couple extra useful columns pre-calculated.
Then open obdlogger.csv in your favorite spreadsheet to use as you please.
GPX is a standard format for GPS data. You can upload it to openstreetmap among others, and many tools recognise it.
Short Version: OSX, Linux, cygwin on Windows
Long Version: I'm doing most development and testing on OSX, but it's fully POSIX-compliant. Which means it works on OSX, Linux, Solaris. If you use windows, it works with cygwin [see below]
Longer, opaque version: I have run it on ARM Linux, x86 Linux, x86_64 Linux, PPC Linux, PPC OSX 10.4, Intel OSX 10.4 and 10.5, various flavors of Cygwin. Most modules work under MSYS, except the logger itself.
Some links to typical documents [direct links to svn versions]:
The current version is downloadable as source here: obdgpslogger-0.15.tar.gz
There's a macintel bundle, with included gpsd, here: OBDGPSLogger-0.11-Darwin.dmg
This is probably more recent than the numbered tarball above, but may have issues
svn co svn://svn.icculus.org/obdgpslogger/trunk obdgpslogger
You can browse the svn repo here: http://svn.icculus.org/obdgpslogger/
I strongly suggest installing gpsd first.
Build it using cmake:
mkdir build cd build cmake .. # or ccmake to edit options make make install # optional
Binaries are placed in the "bin" dir of your top level source directory. If you want to install to a different prefix, change CMAKE_INSTALL_PREFIX when you run ccmake
obdgpslogger is in jucr
Install thus:
pfexec pkg set-publisher -O http://jucr.opensolaris.org/pending jucr.opensolaris.org pfexec pkg refresh pfexec pkg install obdgpslogger
On Windows, the software works with cygwin. [obdsim also works with msys/mingw]
You need the following packages [install them through cygwin's setup.exe, selecting some of them may select others automatically, you should leave those ones on]:
Open Cygwin from the desktop or start menu entry, and then run the same commands as "building" above
OBD GPS Logger has a mailing list. Subscribe to it by visiting the icculus.org mailman page for it: http://icculus.org/mailman/listinfo/obdgpslogger
mp3car have provided me some forum space for this project here: http://www.mp3car.com/vbulletin/obdii-gps-logger/