Linux Certif

Toute la documentation sur la certification Linux LPI

Net::GPSD3.3pm

NAME

Net::GPSD3 - Interface to the gpsd server daemon protocol version 3 (JSON).

SYNOPSIS

   use Net::GPSD3;
   my $gpsd=Net::GPSD3->new(host=>"127.0.0.1", port=>2947); #defaults
   $gpsd->addHandler(\&myHandler);
   $gpsd->watch;  
 
   sub myHandler {
     my $object=shift;
     use Data::Dumper qw{Dumper};
     print Dumper($object);
   }
 
 

The Perl one liner

   perl -MNet::GPSD3 -e 'Net::GPSD3->new->watch'
 
 

DESCRIPTION

Net::GPSD3 provides an object client interface to the gpsd server daemon utilizing the version 3.1 protocol. gpsd is an open source GPS daemon from http://gpsd.berlios.de/. Support for Version 3 of the protocol (JSON) was adding to the daemon in version 2.90. If your daemon is before 2.90 then please use the Net::GPSD package.

CONSTRUCTOR

new

Returns a new Net::GPSD3 object.

   my $gpsd=Net::GPSD3->new;
   my $gpsd=Net::GPSD3->new(host=>"127.0.0.1", port=>2947); #defaults
 
 

METHODS

initialize

host

Sets or returns the current gpsd host.

  my $host=$obj->host;
 
 

port

Sets or returns the current gpsd TCP port.

  my $port=$obj->port;
 
 

watch

   $gpsd->watch;  #will not return unless something goes wrong.
 
 

intersperse

Time in seconds to intersperse DEVICES objects into the WATCHER stream. Disabled <= 0.

   my $intersperse=$self->intersperse; #$ seconds
 
 

addHandler

   $gpsd->addHandler(\&myHandler);
   $gpsd->addHandler(\&myHandler1, \&myHandler2);
 
 

handlers

   my @handler=$gpsd->handlers; #()
   my $handler=$gpsd->handlers; #[]
 
 

METHODS Internal

default_handler

socket

Returns the cached IO::Socket::INET6 object

   my $socket=$gpsd->socket;  #try to reconnect on failure
 
 

json

Returns the cached JSON::XS object

decode

Returns a perl data structure given a JSON formated string.

   my %data=$gpsd->decode($string); #()
   my $data=$gpsd->decode($string); #{}
 
 

encode

Returns a JSON string from a perl data structure

constructor

Constructs a class object by lazy loading the classes.

   my $obj=$gpsd->constructor(%$data);
   my $obj=$gpsd->constructor(class=>"DEVICE",
                              string=>'{...}',
                              ...);
 
 

Returns and object in the Net::GPSD3::Return::* namespace.

strftime

The format the DateTime objects

BUGS

Log on RT and Send to gpsd-dev email list

SUPPORT

Try gpsd-dev email list

AUTHOR

   Michael R. Davis
   CPAN ID: MRDVT
   STOP, LLC
   domain=>michaelrdavis,tld=>com,account=>perl
   http://www.stopllc.com/
 
 

COPYRIGHT

This program is free software licensed under the...

   The BSD License
 
 

The full text of the license can be found in the LICENSE file included with this module.

SEE ALSO

Net::GPSD, GPS::Point, JSON::XS, IO::Socket::INET6, Time::HiRes