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 "Configuratie opslaan" doet in principe precies wat het zegt. Alle wijzigingen die je aanbrengt in je FHEM instantie worden opgeslagen in een groot configuratiebestand. Dit gebeurt echter pas nadat je op de knop "Save config" hebt geklikt. Niet-opgeslagen wijzigingen worden aangegeven met een rood vraagteken naast "Save config". Niet-opgeslagen wijzigingen gaan verloren wanneer de FHEM server opnieuw wordt opgestart.

MAX", "Ongesorteerd" en "Alles" zijn "kamers" die je kunt aanmaken om je geconfigureerde sensoren en actuatoren te groeperen. Je kunt bijvoorbeeld een kamer "Woonkamer" aanmaken en daarin alle apparaten groeperen die belangrijk zijn voor het regelen van de woonkamer. Alleen de kamers "ongesorteerd" en "Alles" worden automatisch aangemaakt en zijn altijd beschikbaar. In de kamer "Ongesorteerd" worden alle geconfigureerde modules weergegeven die nog niet aan een andere kamer zijn gekoppeld. In de kamer "Alles" worden alle geconfigureerde modules weergegeven, ongeacht of ze al aan een andere kamer zijn gekoppeld.

6. logfile toont de items in het logbestand

Commandref" toont je de lokale commandobibliotheek. Hier vind je alle beschikbare commando's en soms meer gedetailleerde informatie erover.

Remote doc" is vergelijkbaar met "Commandred" behalve dat het je doorverwijst naar de huidige versie van de beschikbare commando's op de FHEM website.

Met "Bestanden bewerken" kun je de verschillende stijl- en configuratiebestanden van FHEM bewerken. Hier heb je veel mogelijkheden, maar kan ook veel kapot. Werk hier daarom altijd voorzichtig en bij voorkeur met een eerdere back-up.

Je kunt het uiterlijk van je FHEM instantie wijzigen onder "Stijl selecteren".

Met de "Event Monitor" kun je actuele livegebeurtenissen weergeven. Gebeurtenissen zoals ontvangen schakelopdrachten worden bijvoorbeeld weergegeven.

Weergave van de "MAX"-kamer: Deze kamer bevat alle apparaten van de MAX-module voor de MAX! radiatorthermostaten. Sommige kamers (zoals deze) worden automatisch aangemaakt zodra een overeenkomstig apparaat van deze module wordt geconfigureerd.
Zicht op de kamer "Ongesorteerd": Deze kamer bevat alle geconfigureerde modules die nog niet zijn gesorteerd in een andere kamer.
Weergave van de ruimte "Alles": Alle geconfigureerde modules staan in deze ruimte. Dus als u op zoek bent naar een specifieke geconfigureerde module: Je zult het hier zeker vinden.
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.
Weergave van de "Commandref": Hier vindt u alle beschikbare commando's van de geïnstalleerde modules.
Weergave van "Bestanden bewerken": Hier vind je alle FHEM bestanden. Je kunt ze hier ook bekijken en bewerken. Je moet echter vooral voorzichtig zijn met de configuratiebestanden. Een verkeerde instelling hier kan ertoe leiden dat FHEM niet meer goed opstart.
Weergave van "Stijl selecteren": Hier kun je het uiterlijk van de FHEM interface bewerken. Geprefabriceerde stijlen worden ook aangeboden onder "Stijlen". Probeer ze gewoon uit. Je kunt hier (bijna) niets kapotmaken.
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
In het laatste geval kan je worden gevraagd onder welke gebruiker deze actie moet worden uitgevoerd. Hier selecteer je normaal gezien de gebruiker "pi", d.w.z. nr. 1, en bevestig je dit door het respectieve gebruikerswachtwoord in te voeren.

FHEM stoppen:

sudo /etc/init.d/fhem stop

of

systemctl stop fhem.service
In het laatste geval kan je worden gevraagd onder welke gebruiker deze actie moet worden uitgevoerd. Hier selecteer je normaal gezien de gebruiker "pi", d.w.z. nr. 1, en bevestig je dit door het respectieve gebruikerswachtwoord in te voeren.

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

Deze site gebruikt Akismet om spam te verminderen. Bekijk hoe je reactie-gegevens worden verwerkt.