HowTo: FHEM - structuur, modules en wetenswaardigheden

Nadat ik FHEM voor de eerste keer had geïnstalleerd en de configuratiepagina echt toegankelijk was, was de euforie groot. Na wat rondklikken werd deze euforie echter snel verdrongen door verbijstering. FHEM is een krachtige en goed onderhouden tool voor het aansluiten van verschillende domotica-apparaten. Helaas is er maar één ding dat het niet is: intuïtief.

Naar mijn mening is dit het enige nadeel van FHEM of open source projecten in het algemeen: je moet tijd investeren en je met het project bezighouden. Helaas is het vaak niet iets dat in een avondje op een plug-and-play manier in elkaar gezet of geklikt kan worden.

Daarom heb ik besloten om de belangrijkste basisprincipes van FHEM in dit artikel samen te vatten en uit te leggen.

In het ideale geval ben je in staat om een functionele en veilige FHEM configuratie op te zetten zonder dat je dagenlang forumberichten en wikipagina's hoeft door te spitten.

Ik zal eerst wat schrijven over de structuur en configuratie van FHEM en dan een paar nuttige (en soms belangrijke) configuratie fragmenten presenteren.


Veiligheidsinstructies

Ik weet dat de volgende opmerkingen altijd een beetje vervelend zijn en onnodig lijken. Helaas hebben veel mensen die "beter" wisten door onvoorzichtigheid ogen, vingers of andere dingen verloren of zichzelf verwond. Gegevensverlies is in vergelijking bijna te verwaarlozen, maar zelfs dit kan erg vervelend zijn. Neem daarom vijf minuten de tijd om de veiligheidsinstructies te lezen. Omdat zelfs het coolste project geen blessure of andere problemen waard is.
https://www.nerdiy.de/sicherheitshinweise/

Affiliate links / reclame links

De hier vermelde links naar online winkels zijn zogenaamde affiliate-links. Als u op zo'n affiliate-link klikt en via deze link een aankoop doet, ontvangt Nerdiy.de een commissie van de betreffende onlineshop of aanbieder. De prijs verandert voor jou niet. Als u via deze links uw aankopen doet, steunt u Nerdiy.de om in de toekomst andere nuttige projecten aan te kunnen bieden. 🙂 


Eisen

Voordat je aan dit artikel begint, moet je de RaspberryPi zo hebben voorbereid dat deze via het netwerk bereikbaar en via SSH te bedienen is.

In de volgende drie artikelen wordt beschreven wat er moet gebeuren om de RaspberryPi voor te bereiden:
RaspberryPi – setup voor nerds!
RaspberryPi – De eerste configuratie!
RaspberryPi – Bedien de RaspberryPi via SSH
FHEM - Installatie op de RaspberryPi

Gereedschap nodig:
-Nee-

Benodigde materialen:

In de volgende lijst vindt u alle onderdelen die u nodig heeft om dit artikel te implementeren.


Overzicht van de FHEM webinterface

De volgende afbeeldingen zijn bedoeld om je een kort overzicht te geven van de verschillende functies van de FHEM webinterface.

1. De opdrachtregel:
Hier kunt u commando's invoeren om bijvoorbeeld nieuwe modules te maken of om ze te configureren.

2. “Save config” macht im Prinzip genau das was es sagt. Alle Änderungen die Ihir an Eurer FHEM-Instanz vornehmt, werden in einer großen Konfigurationsdatei gespeichert. Dies passiert allerdings erst nachdem Ihr den “Save config”-Button angeklickt habt. Ungespeicherte Änderungen werden euch dabei durch ein rotes Fragezeichen neben “Save config” angezeigt. Ungespeicherte Änderungen gehen durch einen Neustart des FHEM-Servers verloren.

3. , 4. und 5. “MAX”, “unsorted” und “Everything” sind “Räume” die Ihr erstellen könnt um Eure konfigurierten Sensoren und Aktoren zu gruppieren. So könnt Ihr zum Beispiel auch einen Raum “Wohnzimmer” erstellen und darin alle Geräte zusammenfassen die zur Steuerung des Wohnzimmers wichtig sind. Nur die Räume “unsorted” und “Everything” werden automatisch erstellt und sind immer vorhanden. Im Raum “unsorted” werden alle konfigurierten Module aufgeführt die noch mit keinem anderen Raum verknüpft sind. Im Raum “Everything” werden alle konfigurierten Module aufgeführt, unabhängig davon ob sie schon mit einem anderen Raum verknüpft sind.

6. “Logfile” zeigt Euch die Eintragungen der Logdatei an

7.  “Commandref” zeigt euch die lokale Befehlsbibliothek an. Hier findet Ihr also alle verfügbaren Befehle und teilweise nähere Informationen dazu.

8.  “Remote doc” ist ähnlich wie “Commandred” nur, dass Ihr hierdurch auf die aktuelle Version der verfügbaren Befehle auf der FHEM-Webseite weitergeleitet werdet.

9. “Edit Files” ermöglicht es Euch die verschiedenen Style- und Konfigurationsdateien von FHEM zu bearbeiten. Hier hat man viele Möglichkeiten, kann aber auch viel kaputt machen. Deswegen hier immer vorsichtig und am besten mit einem vorherigen Backup arbeiten.

10. Unter “Select Style” könnt Ihr das Aussehen Eurer FHEM-Instanz verändern.

11. Der “Event Monitor ermöglicht es euch aktuelle Live-Events anzeigen zu lassen. Es werden also zum Beispiel Ereignisse wie empfangene Schaltbefehle angezeigt.

Ansicht des Raums “MAX”: Dieser Raum beinhaltet alle Geräte des MAX-Moduls für die MAX!-Heizkörperthermostate. Manche Räume (wie dieser) werden automatisch erstellt sobald ein ein entpsprechendes Gerät dieses Moduls konfiguriert wird.
Ansicht des Raums “Unsorted”: In diesem Raum sind alle konfigurierten Module enthalten die noch nicht in einem anderen Raum – also noch nicht einsortiert – sind.
Ansicht des Raums “Everything”: In diesem Raum sind alle konfigurierten Module aufgelistet. Solltet Ihr also mal ein bestimmtes konfiguriertes Modul suchen: Hier findet Ihr es auf jeden Fall.
Bekijk het logbestand: Hier kun je verschillende activiteiten uit het verleden bekijken. In dit voorbeeld kun je zien dat verschillende verbindingspogingen met een bepaalde server zijn mislukt. Elk stukje informatie wordt gelogd met een tijdstempel. Dit is erg handig bij het oplossen van problemen.
Ansicht der “Commandref”: Hier findet Ihr alle verfügbaren Befehle der installierten Module.
Ansicht von “Edit files”: Hier findet Ihr alle FHEM-Dateien. Außerdem könnt Ihr sie hier anzeigen und auch bearbeiten. Gerade bei den Konfigurationsdateien solltet Ihr aber vorsichtig sein. Eine falsche Einstellung kann hier dazu führen, dass FHEM nicht mehr ordentlich startet.
Ansicht von “Select Style”: Hier könnt Ihr das Aussehen der FHEM-Oberfläche bearbeiten. Unter “Styles” werden außerdem vorgefertigte Styles angeboten. Probiert sie einfach aus. Hier kann man (fast) nichts kaputt machen.
Weergave van de Event Monitor: Hier worden verschillende activiteiten live weergegeven. In dit voorbeeld zie je dat de verbinding met de geconfigureerde MQTT-server actief is. Deze en andere toestanden/gebeurtenissen worden regelmatig gecontroleerd en hier weergegeven.

modules

Het mooie van FHEM is dat de functies kunnen worden uitgebreid en verfijnd met allerlei modules. Juist deze eigenschap maakt het zo krachtig, omdat het ook mogelijk is om nieuwe sensoren en actuatoren in de FHEM te integreren.

Je kunt een geweldig overzicht van de structuur van FHEM vinden onder https://wiki.fhem.de/wiki/System%C3%BCbersicht


starten en stoppen

Om Putty via de console te starten en te stoppen, zijn de volgende commando's handig.

FHEM starten:

sudo /etc/init.d/fhem start

of

systemctl start fhem.service
Im letzteren Fall werdet Ihr ggf. gefragt unter welchem User diese Aktion ausgeführt werden soll. Hier wählt Ihr normalerweise den Benutzer “pi” also Nr. 1 aus und bestätigt dies durch die Eingabe des jeweiligen Benutzerpassworts.

FHEM stoppen:

sudo /etc/init.d/fhem stop

of

systemctl stop fhem.service
Im letzteren Fall werdet Ihr ggf. gefragt unter welchem User diese Aktion ausgeführt werden soll. Hier wählt Ihr normalerweise den Benutzer “pi” also Nr. 1 aus und bestätigt dies durch die Eingabe des jeweiligen Benutzerpassworts.

Geef de huidige status van FHEM weer

De volgende opdracht is voldoende om de huidige systeemberichten van uw FHEM-instantie weer te geven.

sudo /etc/init.d/fhemstatus

of

systemctl-status fhem.service
De laatste twee regels zijn hier interessant. Deze laten zien dat FHEM is gestart en nu draait. Als FHEM niet start, zie je hier waarschijnlijk een foutmelding die je kan helpen bij het oplossen van problemen.

Meer informatie

https://wiki.fhem.de/wiki/System%C3%BCbersicht


Veel plezier met het project

Ik hoop dat alles werkte zoals beschreven. Zo niet, of als je vragen of suggesties hebt, laat het me weten in de commentaren. Ik zal dit dan zo nodig aan het artikel toevoegen.
Ideeën voor nieuwe projecten zijn altijd welkom. 🙂

PS Veel van deze projecten - vooral de hardwareprojecten - kosten veel tijd en geld. Natuurlijk doe ik dit omdat ik het leuk vind, maar als je het cool vindt dat ik de informatie met je deel, dan zou ik blij zijn met een kleine donatie aan het koffiefonds. 🙂

Koop Me a Coffee op ko-fi.com       

Kommentar hinterlassen

Het e-mailadres wordt niet gepubliceerd. Erforderliche Felder sind mit * markiert


De verificatie periode van reCAPTCHA is verlopen. Laad de pagina opnieuw.