FIND - jfederico/openhab GitHub Wiki

FIND

THE FRAMEWORK FOR INTERNAL NAVIGATION AND DISCOVERY

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.

Some notes on using a Pi as a 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

openhab.config file

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

###Running your own FIND server 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`.

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/#'

Reflect the server in openhab.cfg:

mqtt:find.url=tcp://localhost:1883
mqtt:find.clientId=OpenHAB
mqtt:find.user=YOUR-OPENHAB-MOSQUITTO-USER
mqtt:find.pwd=YOUR-OPENHAB-MOSQUITTO-PASSWORD

###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_david				"David FIND [%s]"	(All)	{mqtt="<[find:YOURGROUP/location/USERNAME:state:JSONPATH($.location)]"}