I've ruthlessly hacked on the guts of hunnifie
, ripped asunder the Hue bridge and 0MQ/ZMQ logic
and replaced it with some hot MQTT publishing action. It fit in there OK once I had a running start.
The general idea here is to use this platform to implement Home Assistant
device_tracker
entities using the MQTT Device Tracker
platform, one of many types of Presence Detection
integrations. It queries the UniFi manager application of a list of devices, and will publish updates via MQTT
with a JSON payload for only those devices that you specify.
This is intended as a workaround for the recently updated
UniFi integration which has lost the ability
to selectively allow only specific devices to have their presence known by creating device_tracker
entities.
You can select which devices selected by specifing the MAC address or the hostname. Please note that the matches are simple, case senstive textual matches. So the mac address you specify ought to be in lower case to match the JSON payload from UniFi. If you want to use the Hostname, ensure that the case matches.
You could also match on the IP address, though honestly, I'm not sure how UniFi figures that out -- on my system, the DHCP server isn't on a UniFi managed device, so it must wiretap the traffic, maybe look at ARP responses or something?
This software, when a desired device is detected, will publish an MQTT payloads like this (assuming that the MQTT prefix is "unifi-clients"):
First, somewhat detailed information will be published to a topic like
unifi-clients/70:ef:00:06:be:ef
-- a periodic message while the UniFi controller has
information about the device (while it's registered and for a few minutes afterwards):
{"mac": "70:ef:00:06:be:ef", "hostname": "iPhone",
"ap_mac": "f0:9f:c2:26:1e:ca", "bssid": "f2:9f:c2:28:1e:ca", "ip": "10.0.1.42",
"latitude": 44.4200, "longitude": -78.1234, "gps_accuracy": 20}
this message can be used for debugging, or perhaps for some advanced application where knowing
some of the other metadata, like the access point MAC address could be useful. Unfortunately,
I don't think that you can use solely this message with the mqtt_json
device tracker
component because when the device is no longer associated on the network.. what do you do? There's
no explicit "not home" data you can transmit; the mqtt_json component relies on the latitude and
longitude to determine if the device is home or not. So you're left with transmitting a bogus
position outside the home as an option. Except if you're also using some other device tracker
component (like OwnTracks) and you've defined other zones that you might be interested in. Both
devices trackers are being updated and this is a confusing situation. So...
Second, a much simpler message with a payload of either home
or not_home
that is intended to be used with the Home Assistant mqtt
device tracker component is also
availabe. It is posted to a topic like unifi-clients/70:ef:00:06:be:ef/home
where
of course the second component is the MAC address of the device.
The latitude and logitude are also specified as options (or in from the configuration file), and probably should match the latitude and logitude of your Home Assistant installation so that devices are considered "home". Note that presently, the "gps accuracy" is fixed at 20 meters.
There's nothing fancy here to select by Wi-Fi network name or site or anything like that. I'm not even sure how the API is supposed work... remember, this is just a drive-by shooting and kidnapping of some existing code. I didn't look too hard at the parts that seemed to work Just Fine to figure out why they worked like they did. Just a hack, both quick and dirty.
The Home Assistant configuration would look something like this:
device_tracker:
- platform: mqtt
devices:
iphone: unifi-clients/70:ef:00:06:be:ef/home
As part of the process, I've renamed it so that the original's reputation won't suffer from the poor reputation of this effort. As a tribute, I've left the original README.md file below. While the options have changed around a bit, the general approach of managing configuration data, options and the like are preserved, though some of the defaults are changed here and there.
Please, for the love of DOG and all that is holy, do not bother the original author of huunifie
with questions that might come from using these changes that I slammed into his code. I apologize.
A Hue bridge and Unifi controller client. Enables/disables specified Hue schedules in the presence/absence of specified wifi devices on the Unifi controller.
huunifie can be installed with the following command:
python3 -m pip install huunifie
This code was only tested with python 3.5 and above under GNU/Linux with a Unify controller 5.9.29 and a hue bridge API version 1.28.0.
you@computer:~$ python3 -m huunifie --help
usage: huunifie.py [-h] [-uh UNIFI_HOST] [-up UNIFI_PORT] [-uu UNIFI_USERNAME]
[-uw UNIFI_PASSWORD] [-hh HUE_HOST] [-hp HUE_PORT]
[-hk HUE_KEY] [-wc WIFI_CLIENTS [WIFI_CLIENTS ...]]
[-sn SCHEDULES_NAMES [SCHEDULES_NAMES ...]] [-i INTERVAL]
[-c CONFIG_FILE] [-s] [-v] [-d] [-l LOG_FILE]
[-sh SYSLOG_HOST] [-sp SYSLOG_PORT]
A Hue bridge and Unifi controller client. Enables/disables specified Hue
schedules in the presence/absence of specified wifi devices on the Unifi
controller.
optional arguments:
-h, --help show this help message and exit
-uh UNIFI_HOST, --unifi_host UNIFI_HOST
Unifi controller hostname (default: None)
-up UNIFI_PORT, --unifi_port UNIFI_PORT
Unifi controller port (default: None)
-uu UNIFI_USERNAME, --unifi_username UNIFI_USERNAME
Unifi controller username (default: None)
-uw UNIFI_PASSWORD, --unifi_password UNIFI_PASSWORD
Unifi controller password (default: None)
-hh HUE_HOST, --hue_host HUE_HOST
Hue hub hostname (default: None)
-hp HUE_PORT, --hue_port HUE_PORT
Hue hub port (default: None)
-hk HUE_KEY, --hue_key HUE_KEY
Hue hub API key (default: None)
--no_pub Disables zmq publication
--pub Enables zmq publication
--pub_host PUB_HOST Host for zmq publication (default: *)
--pub_port PUB_PORT Port for zmq publication (default: 12168)
-wc WIFI_CLIENTS [WIFI_CLIENTS ...], --wifi_clients WIFI_CLIENTS [WIFI_CLIENTS ...]
Wifi clients (hostname or mac) to monitor. Clients
names are separated by spaces. (default: None)
-sn SCHEDULES_NAMES [SCHEDULES_NAMES ...], --schedules_names SCHEDULES_NAMES [SCHEDULES_NAMES ...]
Schedules to respectively enable/disable based on the
wifi clients presence/absence. Schedule names with
space(s) to be double-quoted. Schedule names are
separated by spaces. (default: None)
-i INTERVAL, --interval INTERVAL
Polling interval (default: None)
-c CONFIG_FILE, --config_file CONFIG_FILE
Path to configuration file. A template can be created
by using the -s option below. (default:
~/.config/huunifie.conf)
-s, --save_config Safe configuration given on the command line to the
configuration file. (default: False)
-v, --verbose Prints events information on the console. (default:
False)
-d, --debug Verbose mode. (default: False)
-l LOG_FILE, --log_file LOG_FILE
Path to log file. (default: None)
-sh SYSLOG_HOST, --syslog_host SYSLOG_HOST
Syslog hostname. If present, the logfile is not
written locally (default: None)
-sp SYSLOG_PORT, --syslog_port SYSLOG_PORT
Syslog port. (default: 514)
A Hue bridge and Unifi controller client. Enables/disables specified Hue
schedules in the presence/absence of specified wifi devices on the Unifi
controller.
You can create a template configuration file by running huunifie with only the -s flag.
You can also test values on one or more different arguments then, adding -s to update your configuration. Only values specified on the command line will be update in the config file.
- Create a config file:
you@computer:~$ python3 -m huunifie -s -v -c /tmp/test_huunifie.conf
2018-12-10 21:55:38 [WARNING] : Configuration file /tmp/test_huunifie.conf not found.
2018-12-10 21:55:38 [ INFO] : Configuration saved to /tmp/test_huunifie.conf
2018-12-10 21:55:38 [ ERROR] : Unable to connect to the Unifi controller using https://localhost:8443
^C
you@computer:~$ cat /tmp/test_huunifie.conf
[general]
interval = 3
wifi_clients = 01:23:45:67:89:ab,your_device_hostname
schedules_name = A schedule name with spaces,another_without
[unifi]
host = localhost
port = 8443
username = hue
password = hue_password!!
[hue]
host = hue
port = 80
key = Your_40_alphanumeric_hue_api_key_please.
- Update an existing config file
you@computer:~$ python3 -m huunifie -hh hue -uh unifi -v -s -c /tmp/test_huunifie.conf
2018-12-10 21:59:06 [ INFO] : Configuration loaded from /tmp/test_huunifie.conf
2018-12-10 21:59:06 [ INFO] : Configuration saved to /tmp/test_huunifie.conf
2018-12-10 21:59:06 [ ERROR] : Unable to connect to the Unifi controller using https://unifi:8443
^C
you@computer:~$ cat /tmp/test_huunifie.conf
[general]
interval = 3
wifi_clients = 01:23:45:67:89:ab,your_device_hostname
schedules_name = A schedule name with spaces,another_without
[unifi]
host = unifi
port = 8443
username = hue
password = hue_password!!
[hue]
host = hue
port = 80
key = Your_40_alphanumeric_hue_api_key_please.