Configuring Home Assistant for the HASP requires making some basic changes to your configuration and downloading the packages to your installation. The procedure will be a little different if you're running Hass.io, so skip to that section or continue below for a standard Home Assistant installation (hassbian, venv, whatever).
For standard Home Assistant installations you can run an automatic deployment script which will attempt to make the required changes to your Home Assistant installation to support the HASP and a Home Assistant Packages bundle for each HASP device which you deploy. If you'd rather make all the changes yourself, jump to the Manual Home Assistant installation section.
You'll need to ssh to your Home Assistant installation as a user who has access to write to your home assistant installation. For most installations, this will be the user homeassistant.
sudo su -s /bin/bash homeassistant
cd ~/.homeassistant
bash <(wget -qO- -o /dev/null https://raw.githubusercontent.com/aderusha/HASwitchPlate/master/Home_Assistant/deployhasp.sh)You will be prompted for a device name and the script will do the rest. Once it completes, restart your Home Assistant service to apply changes and then continue to the First time setup section below to initialize your environment.
If you're running Hass.io, you'll need to install and configure the Mosquitto broker and SSH server add-ons from the default repository. Be sure to follow the configuration instructions provided for both add-ons. Once those are installed, configured, and started, you can ssh to your hass.io installation and execute the following commands:
cd /config
apk add tar wget
bash <(wget -qO- -o /dev/null https://raw.githubusercontent.com/aderusha/HASwitchPlate/master/Home_Assistant/deployhasp.sh)You will be prompted for a device name and the script will do the rest. Once it completes, restart your Home Assistant service to apply changes (Configuration > General > Server Management > RESTART) and then continue to the First time setup section below to initialize your environment.
To deploy your first HASP device into Home Assistant a couple simple changes will need to be made to your configuration.yaml. See the documentation here for the general process of editing that file.
Once these changes have been made for your first device, you can skip to the deployhasp.sh step when adding additional devices to your installation.
The configuration and automation files for the HASP are bundled as Home Assistant Packages. Enable packages under the homeassistant section at the top of your configuration.yaml by adding the following line:
homeassistant:
packages: !include_dir_named packagesThis project relies on MQTT for device communication. You will need to enable Home Assistant MQTT support by adding the following line to your configuration.yaml:
# Example configuration.yaml entry
mqtt:If you don't already have an MQTT broker configured, adding this one line will enable the built-in MQTT broker.
The Home Assistant Recorder component is required to allow Home Assistant to save configuration and state of some HASP controls across reboots. You will can enable Home Assistant Recorder by adding the following line to your configuration.yaml:
# Example configuration.yaml entry
recorder:Now you'll need to copy over the packages directory and modify it for your new device. The folder name, file names, and the contents of the .yaml files will all need to have plate01 replaced with your new device name.
Finally, you'll need to restart Home Assistant to apply your changes then continue to the First time setup section below to initialize your environment.
Upon startup the default HMI display file contains empty buttons with no text. Launch the Home Assistant web UI and look for a new tab with your chosen device name. Select that tab and look for the automation titled hasp_<your_device_name>_00_FirstTimeSetup. Select that automation and click "TRIGGER" to apply the basic configuration to your new device.
