Support for Lowrance, Magellan and Garmin ReceiversTopUsing GPSMan in graphical modeUsing GPSMan in Command-line Mode

Using GPSMan in Command-line Mode

The command-line mode can only be used in operating systems supporting command line arguments, namely Unix/Linux systems. For the time being only Garmin receivers are supported in commands requiring a receiver.

In graphical mode GPSMan is launched by invoking gpsman or gpsman.tcl with either no arguments or a single argument standing for the serial or USB device, while in command-line mode there will always be 2 or more arguments. This is used to distinguish between the two situations, although the graphical mode can be entered from command-line mode.

The general form of invocation is (in the usual Unix notation)

gpsman [OPTIONS] COMMAND [COMMAND_ARGS]

Some commands accept parameters in the form NAME=VALUE. The term parameter when used here referring to arguments of a command has always this meaning. Care should be taken if the value part is a string with spaces (or other characters with special meaning for the shell or system command interpreter) in which case quotes or some other form of quoting should be used.

The possible options are:

-dev DEVICE
gives the serial device path
-log
creates a log file of the serial communication named logfile in the GPSMan user directory
-rec Garmin | Lowrance | Magellan
changes the brand of the receiver (NOTE: at present will only work with Garmin); this option can be useful to override the options in the preferences file; cannot be used with the readput command, nor with the -prefs option, and cannot occur after the -prot option;
-prefs PREFSFILE
gives the path for an alternative preferences file (read after the user preferences file); cannot be used with the -rec option
-prot PROTOCOL
selects the protocol to be used overriding the default protocol given in the preferences file; cannot occur before the -rec option; the show protocols command can be used to find out which protocols are available

Options not related with COMMAND will be silently ignored.

GPSMan exits with either a 0 if the command was successfully executed, or a 1 if not. Some commands will write information to the standard output channel. Error messages can possibly be written to the standard error channel, but most of the errors will not be explained. In case of doubt the graphical mode should be used to see if there are problems with files or the receiver.

Note that in command-line mode the saved state is not restored and the state is not saved unless the graphical mode is entered.

Available commands are:

is available
exits with 0
is connected
exits with 0 if a connection check with the receiver succeeds
show WHAT
writes help information to the standard output
haslib LIBRARY
checks availability of library
getwrite IN-TYPES FORMAT [OUT-PARAMS] [OUT-TYPES] PATH
transfers data from the receiver to a file
readput FORMAT [IN-PARAMS] [IN-TYPES] PATH [OUT-TYPES]
transfers data from a file to the receiver
getrtimelog PATH [INTERVAL]
gets the real-time log from the receiver and saves it to a file
getfix PATH [TIMEOUT]
gets the current fix data and saves it to a file
getalmanac PATH
gets the current almanac data and saves it to a file
read FORMAT [PARAMS] [TYPES] PATH
reads a data file and launches the graphical interface
start travel [INTERVAL]
launches the graphical mode and starts real-time logging, animation and travelling, unless the connection to the receiver could not be established
translate
IN-FORMAT [IN-PARAMS] [IN-TYPES] IN-PATH OUT-FORMAT [OUT-PARAMS]   [OUT-TYPES] OUT-PATH translates from a file format to another one
project LATD LONGD DATUM PROJECTION [PARAMS]
writes to the standard output the projection of a point
georef
IMGPATH TRANSF LATD LONGD LATD LONGD [LATD LONGD] DATUM X Y X Y [X Y]   PROJECTION [PARAMS] writes to the standard output a map information file
geopicts
IN-FORMAT [IN-PARAMS] IN-TYPE IN-PATH [PROC-PARAMS]   [OUT-FORMAT] [OUT-PARAMS] OUT-PATH PICT-PATHS geo-references files either based on their time-stamps and a given track, or by using the sequence of waypoints in a group
source PATH
executes a Tcl/Tk script
exec PATH
executes a GPSMan script

File format names should be given as they appear in the output of the show formats command, or using only lowercase letters.


GPSMan User Manual
©1998-2007 Miguel Filgueiras, mig_at_ncc.up.pt, LIACC & DCC Faculdade de Ciências, Universidade do Porto

Support for Lowrance, Magellan and Garmin ReceiversTopUsing GPSMan in graphical modeUsing GPSMan in Command-line Mode