NAME

       obdgpslogger - Log OBD and GPS data to sqlite

SYNOPSIS

       obdgpslogger [ options ]

DESCRIPTION

       This is a tool to log OBDII and GPS data to an sqlite database

OPTIONS

       -s|--serial <serialport>
              Open this serial port device to connect to the elm327 device.

       -c|--count <count>
              Take this many samples at most. Leaving this option out defaults to incessant sampling.

       -u|--output-log <filename>
              Redirect stdout and stderr to this file

       -l|--serial-log <filename>
              Log all serial comms into this file.

       -a|--samplerate <samples-per-second>
              Sample  at  most  this many times a second. The software will sleep temporarily at the end of each
              loop if appropriate. Keep in mind there is an upper limit to samplerate, typically capped  by  I/O
              on  your  serial  port. Set this to zero to sample as fast as possible.  BE WARNED. Values greater
              than ten here are forbidden for cars predating April 2002. If you think your car  postdates  early
              2002, and you'd like to sample as fast as possible, the -o option may help

       -o|--enable-optimisations
              Enable  certain  elm327  optimisations. This will [usually] make sampling faster [not a noticeable
              amount if you're only sampling once a second], but makes it much easier  to  accidentally  disobey
              the standard if you're sampling as fast as possible.

       -p|--capabilities
              Dump the commands your OBD device claims to support to stdout, then exit.

       -m|--daemonise
              Convert the program to a background daemon after successfully initialising.

       -B|--modifybaud [rate]
              Attempt to upgrade baudrate to rate. If rate isn't specified, we'll just take a few guesses and go
              with what works.

       -b|--baud <rate>
              Attempt to set serial port baudrate to this after launching. Passing zero  tells  it  to  try  and
              guess, or -1 to not try changing at all.

       -d|--db <database>
              Open this database to log data to. The software will create the database if it does not exist, and
              create the tables it needs.

       -i|--log-columns <column names>
              Comma-separated list of column names. These are the short names listed when you use  "-p"  to  get
              your car's capabilities

       -v|--version
              Print out version number and exit.

       -h|--help
              Print out help and exit.

NOT OPTIONS

       These  options  are not intended to be used by end users using the command line, they are support options
       for the GUI component. Use or rely on them at your own peril.

       -t|--spam-stdout
              Write all readings to stdout. The format is unlikely to change in practice, but if you  choose  to
              try to parse this yourself, I don't want to hear about it when it does change.

SEE ALSO

       obd2kml(1),   obd2csv(1),   obd2gpx(1),   obdsim(1),   obdgui(1),  obdlogrepair(1),  obdftdipty(1),  dot-
       obdgpslogger(5)

AUTHORS

       Gary "Chunky Ks" Briggs <chunky@icculus.org>

                                                                                                 obdgpslogger(1)