Multi-user geofencing for Hue
Not maintained
Multi-user geofencing for Phillips Hue. No need to install additional software, geofencing is based on detecting devices online in the local network.
Just add MAC-addresses of traced devices and the name of the light(s), which will turn on when the resident arrives home. After all devices have disconnected from the network, turn off all lights. In the future, turn on also additional lights/scene when arriving home after sunset.
Create .env file based on .env.example.
Set on .env ip-address of Hue bridge, names of lights that turn on when arriving home, and devices which to track. Multiple values can be inserted to DEVICES and ARRIVE_LIGHTS, separated by ,.
Additional configuration:
EXCLUDE_LIGHTS, lights to exclude when turning of all lightsBLUETOOTH_DEVICES, Bluetooth mac address for given devices in format wifi-mac;bt-mac separated by ,LOCATION_LAT and LOCATION_LON, required for getting sunset.LOG_LEVEL, Python logger level, default INFONETWORK_MASK, network mask to scan initially when starting serverSCAN_INTERVAL, how often to ping devices currently at homeDISABLE_START and DISABLE_END, range in hours when home arrive action should be disabledPING_SCHEDULE when True, will ping every hour all devices in subnet to generate traffic. May be useful if there is troubles to detect packages in network.
mkdir hue-geofencingtouch .phue_configdocker run -d \--env-file ".env" \--name "hue-geofencing" \--restart "unless-stopped" \--net=host \--mount "type=bind,source=/home/pi/hue-geofencing/.phue_config,target=/usr/src/app/.phue_config" \vaahtokarkki/hue-geofencing
Available tags on Docker are: amd64, armv6 (for RPi Zero and RPi 1), armv7. Adjust mount source argument to match your working directory.
Docker images can be found on Docker Hub
For best IoT-experience run Docker with Watchtower for automatic updates.
Server can be run also with python.
$ git clone https://github.com/vaahtokarkki/hue-geofencing$ cd hue-geofencing$ python -m venv env$ source env/bin/activate$ pip install -r requirements.txt$ cp .env.example .env
Add required values to .env, see instructions above.
Start server by
$ sudo python main.py
Note: sudo access is required for listening network.
Server keeps track of online devices and scans devices online periodically by pinging them.
Pinging a device is done with ARP-, ICMP- and TCP-ping. If device is not responding to any of those, ping with Bluetooth (l2ping), if Bluetooth MAC-address is provided.
If device is not responding after given times, assume it has left the house and remove it from list of devices online. After list is empty, turn off all lights as all residents have left the house.
Home arrive can be detected by listening packets on network (Wifi). If packet source is from tracked device and it is not on the list of online devices, assume that device has recently arrived home. Turn on given lights and add device to the list to prevent triggering home arrive multiple times for the same device.
After all residents are home, disable network listening and resume packet listening when someone leaves the house.
Note: For more reliability use official Hue app own location aware features to trigger home coming, as device may not connect immediately to wifi.
All network monitoring operations are made with scapy.
Server updates sunset and sunrise times once in a day. Home location is needed for getting correct sunset times. Data if fetched from open Sunset Sunrise API.
network.py, probably needs lots of mocking.