Sebastian

Home Automation I – Aan de slag met de Home Assistant software

Gewoon een andere slimme thuisstandaard?

De laatste jaren is er veel gebeurd op het gebied van domotica. Iedereen heeft het over het ivd en veel fabrikanten bieden er oplossingen voor.

Na het aanvankelijke enthousiasme volgt echter meestal ontgoocheling: er zijn oneindig veel standaarden en oplossingen, veel wordt beheerd in een cloud en vaak worden producten nutteloos en onverenigbaar met elkaar als de fabrikant stopt met het verlenen van service. Daarnaast zijn er de vele verschillende programma’s en apps voor het aansturen van de afzonderlijke apparaten.

Home Assistant biedt hier een goede oplossing. U kunt uw eigen krachtige domoticasoftware op uw eigen server installeren – en in het eenvoudigste geval volstaat een Raspberry Pi – en deze niet alleen gebruiken voor apparaten die u zelf ontwikkelt, maar ook voor integraties van alle denkbare ivd-fabrikanten. En dit alles is Open Source.

Interesse? In deze How-to laat ik u zien hoe u de Home Assistant op een Raspberry Pi kunt installeren en geef ik u een overzicht van de functies en mogelijkheden.

Het project

Benodigde tijd: min. 3u (gevorderden)

Je hebt dit nodig:

  • Een server, in het eenvoudigste geval een Raspberry Pi
  • Programmeerkennis in Python is voordelig
  • Voor verdere experimenten solide Engelse vaardigheden

Overzicht van het project

Er zijn verschillende manieren om de Home Assistant te installeren.

Wij bevelen het zogenaamde HassOS (voor Home Assistant Operating System, te vinden op Github op https://github.com/home-assistant/operating-system) aan, dat een voorgeconfigureerde afbeelding is.

Voor mij persoonlijk werkte deze methode niet altijd goed en moest ik de server opnieuw installeren vanwege problemen. Als u nog steeds de voorkeur geeft aan deze methode, kunt u hier alle informatie vinden.

Ik raad de handmatige installatie aan. In het begin is het misschien wat ingewikkelder, maar in de praktijk heeft het zich voor mij bewezen vanwege de lagere complexiteit en de goede onderhoudbaarheid.

Als u thuis al een NAS of server heeft, is het een goed idee om er een Home Assistant op te installeren. Onder de gidsen van de community vindt u instructies voor bijvoorbeeld Synology apparaten. Daarnaast is er een community plugin voor FreeNAS die je kunt vinden op Github

De handmatige installatie

De installatie volgt deze instructies uit de documentatie. Mocht het proces in de toekomst veranderen, dan vindt u daar de meest actuele informatie.

Ik zal de nodige stappen nog eens kort voor u samenvatten.

Na het openen van de terminal op onze Raspberry Pi, installeren we eerst alle benodigde pakketten:

sudo apt-get update
sudo apt-get upgrade -y
sudo apt-get install python3 python3-dev python3-venv python3-pip libffi-dev libssl-dev

Maak vervolgens om veiligheidsredenen eerst een nieuwe gebruiker “homeassistent” aan waarmee het Home Assistant proces wordt uitgevoerd.

Deze gebruiker zal ook worden toegevoegd aan drie extra groepen die nodig zijn om verschillende diensten te draaien.

sudo useradd -rm homeassistant -G dialout,gpio,i2c

Stel een wachtwoord in voor de gebruiker op uw systeem.

Daarna maken we de installatiemap aan, ook wel “homeassistant” genoemd, en geven we de nodige lees- en schrijfrechten aan de gebruiker “homeassistant”.

cd /srv
sudo mkdir homeassistant
sudo chown homeassistant:homeassistant homeassistant

Daarna maken we de installatiemap aan, ook wel “homeassistant” genoemd, en geven we de nodige lees- en schrijfrechten aan de gebruiker “homeassistant”.

De volgende stap is nodig om Python-afhankelijkheden netjes en apart van andere projecten op uw Raspberry Pi te beheren.
U maakt een venv (virtual environment, documentatie is hier te vinden), die gebruik maakt van de bibliotheken en de juiste Python-versie.
Schakel hiervoor eerst over op de gebruiker “homeassistent” via:

sudo -u homeassistant -H -s

en het initialiseren en activeren van de venv:

cd /srv/homeassistant
python3 -m venv .
source bin/activate

Aan het einde installeert u een python-wiel en met pip3, de python-pakketmanager, installeert u de Home Assistant.

python3 -m pip install wheel
pip3 install homeassistant

Nu is alles voorbereid en kunt u de Home Assistant software starten.

hass

De eerste start duurt erg lang, omdat er meer inhoud wordt geïnstalleerd. Maar als dit eenmaal gebeurd is, gaat het allemaal snel.
Als dit ook gebeurt, is de webinterface van uw eigen domoticasoftware toegankelijk via HTTP op poort 8123.

Open hiervoor de browser en voer het adres in de adresbalk in:

localhost:8123

Natuurlijk kunt u de website ook benaderen vanaf elk ander apparaat in uw thuisnetwerk. Zoek eerst het IP-adres van je Raspberry Pis uit:

ip addr show

Als uw Raspberry Pi via WLAN met de router is verbonden, staat het IP onder het knooppunt “wlan0”. Als u het met een ethernetkabel hebt aangesloten, vindt u het IP in node “eth0”.

Op de foto ziet u hoe de Home Assistant u bij de eerste start begroet.

Configuratie en uitbreidingen

Nadat u namen hebt ingevoerd en de basisinstellingen hebt gemaakt, kunt u uw ivd-apparaten al integreren.

Scroll door de lijst en krijg een overzicht van de vele integraties, misschien heeft u al een apparaat dat u via de Home Assistant kunt bedienen. Er zijn natuurlijk nog veel meer modules en er komen dagelijks nieuwe bij.

Ik raad aan om het overzicht van de integraties te bekijken om meer ideeën op te doen.

Deze gids is bedoeld om de nodige basiskennis op het gebied van infrastructuur en kennis te verschaffen om de verdere artikelen van deze serie te begrijpen en zelf te kunnen implementeren. Daarom leert u de configuraties kennen.

De verdere mogelijkheden voor automatisering, configuratie en ook de presentatie van de website zijn te vinden in de uitgebreide documentatie.

Er zijn in principe twee manieren om de Home Assistant te configureren:

  • op de website onder het menu-item Instellingen
  • met een teksteditor en de configuratiebestanden (in dit voorbeeld te vinden onder /home/homeassistant/.homeassistent) direct op de Raspberry Pi

Tip: Veranderingen in de YAML-configuratiebestanden kunnen soms fouten veroorzaken die kunnen leiden tot problemen met herstarten.

U kunt de configuratie zowel op de website als op de Raspberry Pi bekijken.

Eerst voegen we via de website een display toe over het IP van onze Raspberry Pi.

Ga hiervoor naar Instellingen > Integraties > + en zoek naar “Lokaal IP-adres”. Vervolgens geeft u de sensor de naam “Raspi-IP”. In het overzicht vindt u dan de sensor in een cirkel aan de bovenkant. Klik erop om de gewenste informatie weer te geven.

De volgende sensor moet u de temperatuur van de CPU van de Raspberry geven.

Open hiervoor het volgende bestand op de Raspberry Pi

/home/homeassistant/.homeassistant/configuration.yaml

Let op: U moet dit doen met de gebruiker “homeassistent”.

Als u niet bent ingelogd met dit account, voert u gewoon het volgende in de console in:

sudo su homeassistant
nano configuration.yaml

Voeg vervolgens deze vermelding toe aan het einde van het bestand en sla het bestand op (CTRL+, Enter, CTRL+x).

Vergeet niet de Config te controleren. Om dit te doen, beëindig het gedoe in de eerder geopende terminal en voer de volgende regel uit:

hass --script check_config

Als alles past, start dan de Home Assistant opnieuw op en zie het resultaat in uw browser:

Verdere mogelijkheden

Zoals u ziet zijn de mogelijkheden bijna onbeperkt, hoewel u tot nu toe slechts een klein inzicht heeft gekregen.

Sensoren alleen zijn nog niet erg nuttig, maar nu kunt u ze gebruiken om automatiseringen te maken, de interface te ontwerpen en nog veel meer.

Sind Sie durch den Artikel Sensordatenbank auf dem Raspberry Pi auf den Geschmack gekommen und wollen die vom Home Assistant gesammelten Daten länger aufbewahren und verarbeiten?

De InfluxDB integratie biedt de mogelijkheid om geselecteerde gegevens op te slaan in een InfluxDB!

Im nächsten Artikel dieser Reihe werden Sie eigene Sensoren programmieren und in Home Assistant einbinden und somit noch tiefer in die Materie eintauchen.


Titelafbeelding bestaande uit:
Home Assistant Logo – Jeremy Geltman  / Wikimedia Commons / CC BY-SA 4.0
Raspberry Pi Foto – Michael Henzler / Wikimedia Commons / CC BY-SA 4.0

Geef een reactie

Je e-mailadres wordt niet gepubliceerd. Vereiste velden zijn gemarkeerd met *