NAME

GPS::Magellan - Module for communicating with Magellan receivers

SYNOPSIS

 GPS::Magellan::OpenPort('/dev/ttyS0');

 $gps = GPS::Magellan->new(
     port => '/dev/ttyS0'
 );

 # Download waypoints
 @waypoints = $gps->getPoints('WAYPOINT');

 foreach $coord (@waypoints){
    printf("longitude: %s, latitude: %s\n", $coord->longitude, $coord->latitude);
 }

 # Download trackpoints
 @trackpoints = $gps->getPoints('TRACKLOG');

 foreach $coord (@trackpoints){
    printf("longitude: %s, latitude: %s\n", $coord->longitude, $coord->latitude);
 }

 $file = GPS::Magellan::File::Way_Txt->new(
    coords => \@waypoints
 );
 
 print $file->as_string();

DESCRIPTION

Soming soon, until then see README, examples/magellan.pl and the test suite for example.

METHODS

new ( port => SERIAL_DEVICE )

Instantiates a new GPS::Magellan object. SERIAL_DEVICE specifies which port if the receiver connected to.

getPoints( 'WAYPOINT' | 'TRACKLOG' )

Downloads coordinates of the specified type from the receiver.

Returns: an array of GPS::Magellan::Coord objects.

command( COMMAND )

Send arbitrary command to the receiver.

Returns: the receiver's response as an array of GPS::Magellan::Message objects.

AUTHOR

Peter Banik <peter@login-fo.net>

SEE ALSO

GPS::Magellan::Coord GPS::Magellan::Message GPS::Magellan::File

VERSION

$Id: Magellan.pm,v 1.2 2004/02/29 21:48:38 peter Exp $

BUGS

 Missing coordinate upload feature.
 Needs more documentation.
 Instead of GPS::Magellan::Coord, it should make use of a generic coordinate class.

Please report bugs to the author.

COPYRIGHT

Copyright (c) 2003