Skip to content
This repository has been archived by the owner on May 17, 2021. It is now read-only.
Markus Storm edited this page Nov 1, 2017 · 32 revisions

FIND

THE FRAMEWORK FOR INTERNAL NAVIGATION AND DISCOVERY

Github : FIND

Main Page : FIND

MQTT Documentation : FIND


FIND client is available for Android only. Retrieve FIND client through Play Store (search for "find hypercube")

Retrieve FIND server from Github. For a Raspberry Pi, select the arm binaries. If your Pi has WiFi and you want to use it as a client for learning, too, then also retrieve and install the fingerprint client from this page.

A note on using a Pi as a learning client:
In order to 'train' the FIND server (i.e. to 'learn your house') it usually does not make much sense to use a Pi because usually you actually don't move a Pi that's connected to mains power, meaning you can just learn a single 'location' (one room). To use a phone is easier. If you still want to use a Pi for this, always remember to use sudo.
If you encounter problems such as 14:27:35.615 scanWifi - INFO 008 Gathering fingerprint with '/sbin/iw dev wlan0 scan -u' 14:27:35.625 main - WARN 009 Scan failed, will continue after a rest then try sudo ./fingerprint -iwlist.


""NOTE"" this is a start to help with integration please feel free to edit and add more information.

MQTT binding

How to use MQTT Binding to get the data from FIND's mqtt server to OpenHAB

mqtt.cfg file

broker.url=tcp://ml.internalpositioning.com:1883
broker.clientId=OpenHAB
broker.user=YOURGROUP
broker.pwd=YOURPASSWORD

Running your own FIND server

See also You can run your own find server like this:
pi@tvpi:~/find $ ./find-2.1-linux-arm -mosquitto mosquittoPID -mqtt mymqttserver:1883/ -mqttadmin finduser -mqttadminpass findpasswd tvpi:8003

then it'll connect to a MQTT server on mymqttserver port 1883 with a 'mosquittoPID' being the process ID of the mosquitto server process, using credentials 'finduser' and password 'findpasswd'.

For usage in scripts, replace mosquittoPID above with `pgrep mosquitto`.

CAVEAT1: you need to start the findserver in the working directory where you have extracted the install zip package (or you need to move the data, too, to from where you want to start it) CAVEAT2: this working directory needs to be writable to the user you start it as and you also need another writable directory data inside.

If you're using mosquitto (probably everybody does, no?), you can add authentication using curl -X PUT "http://YOURGROUP/mqtt?group=YOURGROUP and then FIND will automatically manage the passwd file and restart mosquitto using a SIGHUP signal. Also, use mosquitto_passwd <passwordfile> finduser to add credentials. mosquitto_passwd ain't included in the Raspian mosquitto distribution, you need to g**gle where to find it. Find publishes to mqtt channel 'YOURGROUP/location/YOURUSER'. You can watch mqtt events like this: mosquitto_sub -v -h mymqttserver -p 1883 -t 'YOURGROUP/location/#'

openHAB items

You need to add the username of the person to track to get the information in. the JSONPATH will pull the current location.

location.items file

String	mqqtfind_markus				"Markus is @ [%s]"	(All)	{mqtt="<[find:YOURGROUP/location/USERNAME:state:JSONPATH($.location)]"}

Installation


User Interfaces


Community

(link to openHAB forum)

Development



Misc


Samples

A good source of inspiration and tips from users gathered over the years. Be aware that things may have changed since they were written and some examples might not work correctly.

Please update the wiki if you do come across any out of date information.

Use case examples

Collections of Rules on a single page

Single Rules

Scripts


Release Notes

Clone this wiki locally