Net::GPSD3 (3pm)

Watch Interface

  use Net::GPSD3;
  my $gpsd=Net::GPSD3->new;
  $gpsd->watch;

One Liner

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

Poll Interface

use Net::GPSD3; use Data::Dumper qw{Dumper}; my $gpsd=Net::GPSD3->new; my $poll=$gpsd->poll; print Dumper($poll);

One Liner

perl -MNet::GPSD3 -e 'printf "Protocol: %s\n", Net::GPSD3->new->poll->parent->cache->VERSION->protocol;'

Protocol: 3.4

\s-1POE\s0 Interface

See Net::GPSD3::POE

Net::GPSD3 provides an object client interface to the gpsd server daemon utilizing the version 3 protocol. gpsd is an open source \s-1GPS\s0 daemon from http://www.catb.org/gpsd/ Support for Version 3 of the protocol (\s-1JSON\s0) was added to the daemon in version 2.90. If your daemon is before 2.90 (protocol 2.X), please use the Net::GPSD package.

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

host

Sets or returns the current gpsd host.

my $host=$obj->host;

port

Sets or returns the current gpsd \s-1TCP\s0 port.

my $port=$obj->port;

poll

Sends a Poll request to the gpsd server and returns a Net::GPSD3::Return::POLL object. The method also populates the cache object with the Net::GPSD3::Return::VERISON and Net::GPSD3::Return::DEVICES objects.

my $poll=$gpsd->poll; #isa Net::GPSD3::Return::POLL object

Note: In order to use the poll method consistently you should run the \s-1GPSD\s0 daemon as a service. You may also need to run the daemon with the \*(L"-n\*(R" option.

watch

Calls all handlers that are registered in the handler method.

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

addHandler

Adds handlers to the handler list.

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

A handler is a sub reference where the first argument is a Net::GPSD3::Return::* object.

handlers

List of handlers that are called in order to process objects from the gpsd wathcer stream.

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

cache

Returns the Net::GPSD3::Cache caching object.

default_handler

socket

Returns the cached IO::Socket::INET6 object

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

json

Returns the cached \s-1JSON::XS\s0 object

decode

Returns a perl data structure given a \s-1JSON\s0 formated string.

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

encode

Returns a \s-1JSON\s0 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.

Log on \s-1RT\s0 and Send to gpsd-dev email list

There are no two \s-1GPS\s0 devices that are alike. Each \s-1GPS\s0 device has a different \s-1GPSD\s0 signature as well. If your \s-1GPS\s0 device does not work out of the box with this package, please send me a log of your devices \s-1JSON\s0 sentences.

echo '?POLL;' | nc 127.0.0.1 2947

echo '?WATCH={"enable":true,"json":true};' | socat -t10 stdin stdout | nc 127.0.0.1 2947

DavisNetworks.com supports all Perl applications including this package.

Try gpsd-dev email list

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

This program is free software licensed under the...

The BSD License

The full text of the license can be found in the \s-1LICENSE\s0 file included with this module.

Net::GPSD, Net::GPSD3::POE, GPS::Point, \s-1JSON::XS\s0, IO::Socket::INET6, DateTime