I believe home automation, at least for me, is to a large extent driven by the joy of trying out new things and extending my system. I think this is why, despite my previous endeavors into FHEM, I kept on tinkering with Home Assistant. I am a big Python fanboy and do dislike PERL with a passion, so it seems in a way natural to do so.
There are a lot of things going on around Home Assistant at the moment and I think that is quite fantastic. In this post I’d like to take a moment to describe the basic steps needed to get up and running with Home Assistant on a Raspberry Pi, including setting up InfluxDB and Grafana for all your graphing needs.
But first things first. Let’s start with an inventory of services that I need to run on my Raspberry.
- Home Assistant: obviously
- HMLANd: because my Raspberry Pi doubles as HomeMatic LAN adapter for devices I installed in the basement
- InfluxDB: Database for all kinds of measurements
- Grafana: Graphical front end to InfluxDB for charting
- Mosquitto: An MQTT broker
- hm2mqtt: To translate HomeMatic to MQTT. This doesn’t run on the RPi in my setup, though, but on the CCU2 directly instead.
I firmly believe that eventually there will be one protocol to emerge in the whole Home Automation world that will finally allow connecting a myriad of devices and will be supported by virtually all vendors. While this is not the case today I am kind of betting MQTT (and so are others). Home Assistant has excellent support for it, too, so it is the foundation of my setup.
Installation is pretty straight forward:
sudo apt-key add mosquitto-repo.gpg.key
sudo wget http://repo.mosquitto.org/debian/mosquitto-jessie.list
sudo apt-get update
sudo apt-get install mosquitto
Done. I will describe securing your local MQTT server in a future post, but we don’t need any further setup for now. The MQTT broker is reachable on :1883.
hm2mqtt offers a bridge from HomeMatic to MQTT. It can run either directly on the CCU2 or on a separate system - I let it run on the CCU2 because I find that more convenient.
To install, your first need to build it. Simply clone the git repository of hm2mqtt from owagner and let gradle build your addon package afterwards.
git clone https://github.com/owagner/hm2mqtt hm2mqtt
This will generate hm2mqtt/build/distributions/hm2mqtt-addon.tar.gz which can be deployed to the CCU2.
To install the addon, point your browser to http://homematic-ccu2/ (or whatever hostname you chose for your CCU2) and navigate to the system settings, add ons dialog.
At the bottom of the dialog, point the choose file dialog to the hm2mqtt-addon.tar.gz we built previously and select install. After the CCU2 reboots, you should see a hm2mqtt button in the system settings. This will take you to the configuration page of the hm2mqtt addon where we can set the broker address correctly.
Enter the address of the system you installed Mosquitto on, leaving the port 1883 as is. Save settings and then stop and start the daemon.
That’s it. You can now fire up mqtt-spy, connect it to your broker and subscribe to hm/#.
You should start seeing MQTT messages from your CCU2 coming in.
As I wrote previously, my Home Assistant server doubles as a HMLANd range extender for my HomeMatic CCU2, allowing me to more reliably communicate with my sensors and actors that are currently placed in my basement.
Installing HMLANd is really straight forward. Simply grab the latest deb package from the HMLANd release repository. For a RaspberryPi you obviously want to pick the armhf package. In my case the latest available version was 0.102.
First we install some dependencies via apt and then install HMLANd via dpkg:
apt-get install libusb-1.0-0-dev build-essential git
dpkg -i hmcfgusb_0.102-1_armhf.deb
I also needed to configure some additional options to make it work.
For me I needed to emulate a LAN interface (the -I switch) and needed to make HMLANd listen on all interfaces (-l 0.0.0.0)
HMLAND_OPTS="-l 0.0.0.0 -I"
You should now be able to connect you CCU2 to the HMLANd via the system settings interface (LAN Gateway button).
After a reboot of the CCU2 the interface should be usable. The LAN Gateway page should show status as connected.
Influx DB and Grafana
Influx DB is the database backend I use to store data from sensors. It is specifically built to do this, so seems like a good choice, plus there is native support for it in Home Assistant (and that is in fact where I got the idea of using it, to be honest).
Grafana is a web front end that allows you to create various views on the data in Influx DB (and some other databases, actually).
Installing everything is again very straight forward. Unless you want to compile all packages yourself I suggest you download the pre-built debs from here. The packages provided here are a mirror of those built by padcom. You can also go to his page and get the original files.
Once you downloaded the deb simply install them using dpkg and fix missing dependencies afterwards.
sudo dpkg -i influxdb_0.9.6.1_armhf.deb
sudo dpkg -i telegraf_0.3.0-beta2_armhf.deb
sudo dpkg -i grafana_2.6.0_armhf.deb
sudo apt-get install -f
With that done, we can finalize the setup and start the Grafana server. Note that we need to create an empty /etc/default/telegraf file - otherwise you will see errors when starting Telegraf.
sudo touch /etc/default/telegraf
sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable grafana-server
sudo /bin/systemctl start grafana-server
As a final step, we setup a database for use in Home Assistant (see also the post in the home assistant blog for further details)
Visit https://enterprise.influxdata.com to register for updates, InfluxDB server management, and monitoring.
Connected to http://localhost:8086 version 0.9.5.1
InfluxDB shell 0.9.5.1
> CREATE DATABASE home_assistant
> CREATE DATABASE telegraf
> CREATE USER "home-assistant" WITH PASSWORD 'home-assistant!'
The one thing we want to do for Grafana now is setting up InfluxDB as a data source. The Grafana documentation describes how to do this in great detail, so I will not repeat it here. I think once you have this done it is a matter of evaluating that data that is logged and sorting it into meaningful views and plots. That is in fact something I also still have to do :)
Installing Home Assistant
Finally. The main piece of software we are doing all this for. We will cover two things here. First, we’ll install home assistant in a central location using a virtual environment. Secondly, we will make it start automatically at boot time.
I will talk about the procedure to install a development snapshot here, because that is what I typically use and play around with. Installing a release version is simply a matter of using pip install after you’ve setup the virtual environment, I think.
First, we install some prerequisites:
sudo apt-get install git
sudo apt-get install python3.4 virtualenv python-pip
sudo pip install build-essential
sudo apt-get install python3.4-dev
We then create the directories where we want our configuration and virtual environment to live, and install the virtual environment:
sudo mkdir /opt/home-assistant
sudo chown pi:pi /opt/home-assistant
virtualenv -p python3.4 /opt/home-assistant/virtualenv
Once we have that, we clone the official home assistant repo dev branch and
git clone https://github.com/balloob/home-assistant
With the clone done, we are now ready to install Home Assistant into our virtual environment (mind the source to activate the virtual environment first):
python setup.py install
pip install -r requirements_all.txt
Doing the final install of everything that is in the requirements_all.txt is actually not needed - HomeAssistant will install dependencies into /opt/home-assistant/config/lib - but I tend to do that anyway to more easily see when things go wrong. It will also come in handy when you want to install a custom version of some dependency.
Automatically starting Home Assistant
The Home Assistant documentation covers the procedure to start Home Assistant as a service quite well, so I will be brief. The hass-daemon startup script can be downloaded from the git repository and just needs some small modifications.
sudo cp hass-daemon /etc/init.d/hass-daemon
sudo chmod +x /etc/init.d/hass-daemon
Once this is done, we can make the necessary adjustments:
sudo nano /etc/init.d/hass-daemon
Simply update the following variables at the top of the file:
Finally, we create the run directory, add it to the default startup sequence and install the hass-daemon properly
sudo update-rc.d hass-daemon defaults
sudo service hass-daemon install
And then we start it up:
sudo service hass-daemon start
You should now be able to browse to
http://<your server>:8123/ and see you new Home Assistant installation.
I will cover the details of my current setup in detail in a future post. For now please refer to the excellent Home Assistant documentation to get started.