Skip to content

Latest commit

 

History

History
87 lines (48 loc) · 3.8 KB

README.md

File metadata and controls

87 lines (48 loc) · 3.8 KB

Google WiFi Home Assistant Integration

Buy me a coffee hacs_badge

This integration provides control and monitoring of the Google WiFi system within Home Assistant.

Platforms:

Binary Sensor:

The binary_sensor platform will show the access points that are configured in your system and their connection status to the Internet (on = connected).

Additionally there is a custom service to allow you to reset either a single access point or the whole wifi system:

Service: googlewifi.reset
Parameter Description Example
entity_id Access point or system to restart. binary_sensor.this_access_point

Device Tracker:

The device_tracker platform will report the connected (home/away) status of all of the devices which are registered in your Google Wifi network. Note: Google Wifi retains device data for a long time so you should expect to see many duplicated devices which are not connected as part of this integration. There is no way to parse out what is current and what is old.

Switch:

The switch platform will allow you to turn on and off the internet to any connected device in your Google Wifi system. On = Internet On, Off = Internet Off / Paused. Additionally there are two custom services to allow you to set and clear device prioritization.

Service: googlewifi.prioritize
Parameter Description Example
entity_id The entity_id of the device you want to prioritize. switch.my_iphone
duration The duration in hours that you want to prioritize for. 4
Service: googlewifi.prioritize_reset
Parameter Description Example
entity_id The entity_id of a device on the system you want to clear. switch.my_iphone

Note: Only one device can be prioritized at a time. If you set a second prioritization it will clear the first one first.

Light:

The light platform allows you to turn on and off and set the brightness of the lights on each of your Google Wifi hubs. (Just for fun).

Sensor:

The sensor platform adds upload and download speed monitoring to your Google Wifi system. Automatic speed testing can be enabled and disabled from the integration options (default on), as can the interval for the tests (default 24 hours).

Service: googlewifi.speed_test
Parameter Description Example
entity_id A speed sensor entity_id of the google system. sensor.google_wifi_system_upload_speed

Note: You must select the main wifi system. Individual devices can not be tested.

Install through HACS:

Add a custom repository in HACS pointed to https://github.com/djtimca/hagooglewifi

The new integration for Google WiFi should appear under your integrations tab.

Click Install and restart Home Assistant.

Install manually:

Copy the contents found in https://github.com/djtimca/hagooglewifi/custom_components/googlewifi to your custom_components folder in Home Assistant.

Restart Home Assistant.

Configure the integration:

To install this integration you will need a Google Refresh Token which you can get by following the instructions at: https://www.angelod.com/onhubauthtool

Note that using the Chrome Plugin is much easier.

Once installed, restart Home Assistant and go to Configuration -> Integrations and click the + to add a new integration.

Search for Google WiFi and you will see the integration available.

Enter the refresh token in the integration configuration screen and hit submit.

Enjoy!