The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Ekahau-0.001
River stage zero No dependents
++
/ Ekahau

NAME

Ekahau - Synchronous interface to Ekahau location sensing system

SYNOPSIS

The Ekahau class provides a straightforward synchronous interface to the Ekahau location sensing system's YAX protocol. The YAX protocol itself is asynchronous, so this module tries its best to hide that from you.

This class inherits from Ekahau::Base, and you can use methods from that class. An alternative, event-driven interface is provided by Ekahau::Events.

DESCRIPTION

This class implements methods for querying the Ekahau Positioning Engine, and processing the responses. Each Ekahau object represents a connection to the Ekahau server. Some methods send queries to the server, others receive responses, and still others do both. This class tries to hide the asynchronousness of the YAX protocol from you.

The basic mechanism allows you to send requests, and wait for responses. If other responses unrelated to the one you're waiting for come in, they will be queued and sent to you when you ask for them. Some methods will first send a request then wait for the response, handling all of the details internally.

Constructor

This classes uses Ekahau::Base::new as its constructor.

Methods

getresponse ( [ $tags ], [ $cmds ] )

Get the next Ekahau::Response matching the given tags and commands. If you specify neither tags nor commands, the next response will be returned. If you specify just one of the two, responses will only be matched against the one specified. If you specify both, responses must match one of the tags, and one of the commands.

Both $tags and $cmds should be list references.

Examples:

    $obj->getresponse();                   # Next response
    $obj->getresponse(['LOC','AREA']);     # Next response with LOC or AREA tag
    $obj->getresponse([],['DEVICE_LIST']); # Next DEVICE_LIST response

gettaggedresponse ( @tags )

Get the next Ekahau::Response matching any of the given tags. This is exactly equivalent to:

    $self->getresponse([@_]);

get_device_list ( )

Get a list of devices currently detected on the Ekahau system. The response is returned as a reference to a list of numeric IDs. On error, this method will return undef.

get_device_properties ( $device_id )

Get the properties for the device with the given ID. Returns an Ekahau::Response object.

get_location_context ( $area_id )

Get the properties of the area with the given ID. Returns an Ekahau::Response object.

get_map_image ( $area_id )

Get a map of the area with the given ID. Returns an Ekahau::Response::MapImage object.

get_all_areas ( )

Returns a list of all logical areas, as an Ekahau::Response::AreaList object.

start_location_track ( [ $properties ], $device)

Start a continuous query tracking the location of the given device. An optional hash reference containing properties for the query can be given; see Ekahau::Base::start_location_track for details.

You can get results with next_location or next_track.

stop_location_track ($device)

Stop a continuous query tracking the location of the given device.

next_location ( )

Return the next location for any of the continuous queries started by calls to start_location_track. The returned value will be an Ekahau::Response object, or undef on error.

start_area_track ( [ $properties ], $device_id )

Start a continuous query tracking the area where the given device is located. An optional hash reference containing properties for the query can be given; see Ekahau::Base::start_area_track for details.

You can get results with next_area or next_track.

stop_area_track ($device)

Stop a continuous query tracking the area of the given device.

next_area ( )

Return the next area for any of the continuous queries started by calls to start_area_track. The returned value will be an Ekahau::Response object, or undef on error.

start_track ( [ $properties ], $device_id )

Start tracking both the location and the area of the given device, by calling the start_location_track and start_area_track methods.

An optional hash reference containing properties for the query can be given. These properties will be passed on to both queries; if you need different properties for the two queries call the methods directly.

Results can be obtained by calling the next_track method.

stop_track ( $device_id )

Stop tracking both the location and the area of the given device, by calling the stop_location_track and stop_area_track methods.

next_track ( )

Return the next location or area for any of the continuous queries started by calls to start_track, start_location_track, or start_area_track. The returned value will be an Ekahau::Response object, or undef on error.

AUTHOR

Scott Gifford <gifford@umich.edu>, <sgifford@suspectclass.com>

Copyright (C) 2005 The Regents of the University of Michigan.

See the file LICENSE included with the distribution for license information.

SEE ALSO

Ekahau::Base, Ekahau::Events.