eero_tracker

This adds Eero device tracking to Home Assistant (HA, HASSIO, HASS OS). This project is based on @343max's eero-client project: https://github.com/343max/eero-client -- many thanks to him or this project probably wouldn't exist. This code has no warranties, and please submit any pull requests you might have to improve upon it.

Setup the scripts!

There are three ways to get the files copied into your HA instance:

1. Download the zip file from the releases section, then uncompress them in your configuration directory (mine is ~/.homeassistant). Example:

   cd ~/.homeassistant/
   wget https://github.com/jrlucier/eero_tracker/releases/download/1.0/eero_tracker-1.0.zip
   unzip eero_tracker-1.0.zip
   

2. Manually copy the files from this project into your configuration directory of your Home Assistant install (eg: ~/.homeassistant). This directory is the same one which has the configuration.yaml file in it. Note: You need to maintain the exact same directory pathings as I use in this repository.

3. Use git. Go to your HA configuration directory (eg: cd ~/.homeassistant), and execute the following commands to have git pull it down.

   git init .
   git remote add -t \* -f origin https://github.com/jrlucier/eero_tracker.git 
   git checkout master
   

   Future updates can be done by going to your configuration directory again (eg: cd ~/.homeassistant), and running the following:

   git pull
   

   If you wish to never update again via git, then you can blow away the .git directories. You can run the following in the configuration directory (eg: cd ~/.homeassistant) to do that:

   ( find . -type d -name ".git" && find . -name ".gitignore" && find . -name ".gitmodules" ) | xargs -d '\n' rm -rf
   

Initial Configuration

To get a session reference to Eero, you need to go to your configuration directory (eg: cd ~/.homeassistant), and run the eero_tracker_instantiate.py file:

python eero_tracker_instantiate.py

This will prompt you for your phone number (no dashes), and then it will send you an SMS text with a code you will need to put in. Once done, it will create an eero.session file in your configuration directory. Subsequent calls to this python file will dump the list of connected wireless devices, their mac addresses, and hostnames for easier reference. You technically shouldn't need eero_tracker_instantiate.py after the creation of the eero.session file, but I keep it around for quick mac address referencing.

chown the files to the same permissions as your other HA configuration files (ls -al to check yours in your configuration directory). Mine are owned by homeassistant:nogroup:

sudo chown homeassistant:nogroup eero.session 
sudo chown homeassistant:nogroup eero_tracker_instantiate.py 
sudo chown -R homeassistant:nogroup custom_components/

Now that that's done, all you need to do is update your configuration.yaml with the device_tracker. Here's an example:

device_tracker:
  - platform: eero_tracker
    consider_home: 300
    interval_seconds: 60 # Recommended...do not set this lower than 25, we don't want to DDOS Eero
    only_macs: "11:22:33:44:55:66, 22:22:22:22:22:22"  # Optional

only_macs is optional, but allows you to reduce down the devices returned to a core set of mac addresses. The list is comma separated.