A python package to interface with the Afero Hubspace service for smart home devices
HubSpace is a smart home platform by The Home Depot, powered by Afero.
- Object oriented API to support Hubspace devices
- Robust device identification
- Straightforward calls to common functionality
- Power a Home Assistant integration
- Support more device types (I need example data)
- Figure out how to handle multiple variant functions (color-temperature numeric vs color-temperature category)
- Create an RGB function type
- Create a debug script that returns full or sanitized data
- Improve call timer safety
- Lights
- Basic dimmable lights: Yes
- Tunable lights: Yes
- RGB lights: Yes
- Plugs: Yes
- Fans: Yes
- Locks: Yes (Limited functionality only - lock/unlock, get lock state, get battery level)
- Currently not supporting the following functions for security purposes: toggling lock sound mode, configuring PIN numbers, managing admin pin, controlling keypad lockout.
- Transformers: No
hubspace-ng includes a tools.py script to help debug common issues. This usess a creds.json file for your credentials.
$ python3 tools.py -h
usage: tools.py [-h] [-a] [-d DETAILED] {survey,connection_log,report} filename
Get debug data from your Hubspace account.
positional arguments:
{survey,connection_log,report}
the type of debugging to do
filename file to output to
options:
-h, --help show this help message and exit
-a, --anonymize Anonymize survey results; does not apply to other actions
-d DETAILED, --detailed DETAILED
When possible, create a more detailed product (state, etc.)
A detailed connection log is available via connection_log. This data is not anaonymized and should be inspected carefully before sharing!
$ python3 tools.py connection_log test.log
Report provides a human readable list of devices. Adding -d will provided detailed state information.
$ python3 tools.py report report.txt
In certain circumstances, it may be necessary to get a debug view of the device data hubspace-ng is seeing from the HubSpace servers. To accomodate this, a survey tool is included. If you want to share this data in a ticket, etc., we recommend using the -a anonymize option, then examining the files manually for anything else you may want to remove. If you are looking over this data yourself, there's no need to anonymize it, but in some cases it's slightly easier to read anonymized (IDs with mostly zeroes tend to be easier to visually process).
$ python3 tools.py survey test.zip
Special thanks to:
- https://github.com/jdeath/Hubspace-Homeassistant - initially wrote the Hubspace comms code
- https://github.com/jan-leila/hubspace-py - Fork of the original Hubspace-HA code that started to add an object structure
- https://github.com/arraylabs/pymyq - Library for MyQ used by the official HA integration - borrowed design patterns heavily