What is it?

PHLocation is a software plug-in for both Windows and Linux versions of Homeseer HS3.

The plug-in works with several external services and applications to provide location based information to Homeseer.

Services and applications are broadly split into 2 types.


Important note regarding iCloud support

iCloud support requires TLS (Transport Layer Security Protocol) version 1.2.


For Windows Systems

Version 4.5 or later of the .net framework must be installed on the same machine that the plug-in is running on.


For Linux Systems

Version 4.8 or later of Mono must be installed on the same machine that the plug-in is running on.


Location based services / applications

Location based applications & services generally provide the device's current location in the form of latitude, longitude and position accuracy as a minimum. Depending on the service they can also provide other data including altitude, speed, course, battery level and charging state etc.


Geofence services / applications

Geofences are a predefined area on a map. Generally this consists of a circular area defined by a single point (latitude & longitude) and a radius value.

The user can configure a number of geofences within the application and it will then detect when the device enters or leaves any of the configured geofences.

Many geofence applications can also work with BlueTooth beacons to detect if the device is within range of a beacon.


Communication methods

The various supported applications and services communicate with the plug--in in different ways. Broadly speaking communications methods can be split into 2 types:

  • Polled: The mobile application will send it's data to a 3rd party server and the plug-in will poll this server at regular intervals for the most recent data.
  • Direct: The mobile application sends its data directly to the plug-in. This can be achieved either using the plug-in's built in http server or via the MyHomeSeer service. MyHS is the simplest and most secure option.

Services and applications that communicate directly with the plug-in generally provide faster updates than polled alternatives.

The table below shows the services currently supported and the communication method they use.


Application / Service

Mobile Platform

Type

Data Acquisition Method

Backitude

Android

Location

HTTP POST directly into the plug-in or MyHS

FollowMee

Android / iOS

Location

Polled from 3rd party server

Btraced

Android / iOS

Location (see notes below)

HTTP POST directly into the plug-in only

iCloud (FindMyiPhone)

iOS

Location

Polled from 3rd party server

EgiGeoZone

Android

Location and Geofence

HTTP POST directly into the plug-in or MyHS

Locative

Android / iOS

Geofence and Beacons

HTTP POST or GET directly into the plug-in or MyHS

Geofency

iOS

Geofence and Beacons

HTTP POST or GET directly into the plug-in or MyHS

*Custom Devices*

N/A

Location

Monitoring other HS3 devices for location data

Tasker

Android

Location

Special type with custom configuration


Btraced Notes:

1. The Btraced application is primarily designed for trip recording. The plug-in does not make use of the "trip" features and purely uses the service to obtain the devices last known location.

2. Btraced is not supported via the MyHS service and only works with direct communication using the plug-in's built in http server.



 

Created with the Personal Edition of HelpNDoc: What is a Help Authoring tool?