HowTo: ESPEasy - MQTT-server configureren en abonneren op onderwerpen

Open eerst de configuratiewebsite van uw ESP8266 geprogrammeerd met ESPEasy door het IP-adres in uw webbrowser in te voeren. Informatie over hoe u het IP-adres kunt achterhalen, staat ook in het artikel Toon/ontdek het IP-adres van de apparaten in het netwerk samengevat.

Nadat u de configuratiewebsite heeft geopend, moet u overschakelen naar het tabblad “Controllers”. Om dit te doen, klikt u op de knop "Controllers".

Klik nu op de knop “Toevoegen” in een van de nog lege regels.

Hierdoor wordt u doorgestuurd naar een pagina met een vervolgkeuzemenu.

Open het vervolgkeuzemenu door erop te klikken en selecteer de vermelding "Home Assistant (openHAB) MQTT".

U wordt dan doorgestuurd naar de configuratiepagina van deze controller (=MQTT-server). Eerst kunt u hier kiezen of u het adres van de MQTT-server als hostnaam of IP-adres wilt opgeven.

In het hier getoonde voorbeeld gebruik ik een hostnaam. Maar je kunt ook een IP-adres gebruiken. Als u dit doet, moet u uw router zo configureren dat het IP-adres permanent wordt ingesteld.

U kunt de andere instellingen accepteren zoals weergegeven.

Het is belangrijk dat de poort is ingesteld op de geconfigureerde poort van uw MQTT-server (standaard 1883).

U moet ook de inloggegevens voor uw MQTT-server opgeven als authenticatie vereist is. Om dit te doen, voert u uw gebruikersnaam en wachtwoord in de daarvoor bestemde velden in en vinkt u het vakje “Gebruik uitgebreide referenties” aan.

U kunt de overige instellingen configureren zoals weergegeven. Voor de volledigheid volgt hieronder een korte beschrijving.

• “Controller Client ID”: Hier kunt u de naam/ID van uw controller voor de MQTT-server opgeven.
• “Unieke client-ID bij opnieuw verbinden”: Als dit selectievakje is aangevinkt, wordt er een willekeurige ID toegevoegd wanneer er wordt geprobeerd een nieuwe verbinding te maken. Dit voorkomt (zeer waarschijnlijk) dat twee clients met dezelfde ID worden verbonden.
• “Publish Retain Flag”: Als dit selectievakje is geactiveerd, worden gepubliceerde waarden inclusief de “Retain Flag” verzonden.
• “Controller Subscribe”: Op dit onderwerp is de controller geabonneerd. Via dit onderwerp kunnen dan bijvoorbeeld opdrachten naar ESPEasy worden verzonden. Informatie hierover vindt u ook in het artikel ESPEasy – voer opdrachten en acties uit via HTTP, MQTT, UDP en rechtstreeks.
• “Controller Publish”: Hier wordt het onderwerp gedefinieerd waaronder sensorwaarden (indien geactiveerd) worden gepubliceerd.
• “Controller LWT Topic”: De MQTT-server kan via de LWT (“Last Will/Testament”) rapporteren over de verbindingsstatus van de client.
• “LWT Connect / Disconnect Message”: Met deze optie kan worden aangegeven welk bericht via het LWT-topic wordt verzonden bij een verbinding of bij het wegvallen van de verbinding.
• “Send LWT to broker”: Schakelt de LWT-functionaliteit in/uit
• “Will Retain”: Stelt de “Retain Flag” in voor berichten verzonden via het LWT-onderwerp.
• “Schone sessie”: Schakelt een “schone sessie”-aanmelding in/uit
• “Ingeschakeld”: Schakelt deze controller in/uit

Zodra u alle instellingen naar wens heeft geconfigureerd, kunt u de instellingen toepassen door op “Verzenden” te klikken.

Uw controller zou dan in het controlleroverzicht moeten staan.

Als u meer dan één controller hebt geconfigureerd, moet u het aantal onderdelen onthouden waarin de MQTT-server is geconfigureerd. In dit voorbeeld is de MQTT-server de Eerst controleurs.

Om dit te doen, gaat u eerst naar het tabblad “Apparaten” door op de knop “Apparaten” te klikken.

Als u dit nog niet heeft gedaan, moet u eerst een sensor configureren.

In dit voorbeeld wordt de DHT11 gebruikt.

Om dit te doen, klikt u op de knop “Toevoegen” in de eerste lege regel van het tabblad “Apparaten”.

Configureer vervolgens de optie voor “GPIO Data” en “Sensormodel” volgens uw sensor.

Maar nu naar het MQTT-gedeelte:
Om ervoor te zorgen dat ESPEasy de sensorgegevens naar de MQTT-server verzendt, moet u het vinkje in de sectie "Verzenden naar controller" activeren. Omdat u de gegevens naar de Eerst Als u de controller wilt verzenden, staat het vinkje naast “1”.

Met de optie “Interval” kunt u opgeven hoe vaak de sensor wordt uitgelezen. De gegevens worden vervolgens met hetzelfde interval verzonden. In het getoonde voorbeeld wordt de sensorwaarde elke seconde uitgelezen en via MQTT verzonden.

Sla deze instellingen opnieuw op door op “Verzenden” te klikken.

Terug op het tabblad ‘Apparaten’ zie je nu ook de ingevoerde controller.

Vervolgens kan met een externe MQTT-client worden gecontroleerd of de gegevens worden verzonden.

Op de afbeelding ziet u een fragment uit de weergave van de “MQTT Explorer”. Deze tool is gratis en is zeer nuttig bij het omgaan met MQTT-berichten.

Om dit te doen, schakelt u terug naar het tabblad “Apparaten” door op de knop “Apparaten” te klikken.

Klik vervolgens op de knop “Toevoegen” in de eerste lege regel.

Vervolgens wordt u doorgestuurd naar een vervolgkeuzemenu. Selecteer hier de vermelding "Generiek – MQTT-import".

In het menu dat verschijnt kun je je op maximaal vier onderwerpen abonneren. Vul dit in onder “MQTT Topic 1 – 4”.

In het gedeelte “Waarden” kunt u vervolgens de namen van de variabelen opgeven. Deze variabelen bevatten later de via MQTT ontvangen waarden. Dit is bijvoorbeeld van belang als je met ‘Regels’ op deze waarden wilt reageren.

Nadat u alles naar wens heeft geconfigureerd, controleert u nogmaals of u “Ingeschakeld” heeft aangevinkt en bevestigt u de instellingen door op “Verzenden” te klikken.

Nu kunt u met behulp van regels reageren op de geabonneerde onderwerpen. Om dit te doen, moet u eerst naar het tabblad “Regels” gaan.

Als dit niet zichtbaar is, moet u dit eerst activeren.

Om dit te doen, klikt u op “Extra” om naar het tabblad “Extra” te gaan.

Klik op “Geavanceerd”…

...en vink de optie “Regels” aan.

Bevestig vervolgens deze instelling door op de knop “Verzenden” te klikken.

Het tabblad ‘Regels’ zou nu zichtbaar moeten zijn.

Als dit niet het geval is, moet dit uiterlijk na het “herladen” van de pagina zichtbaar worden.

Op MQTT#Value_of_TestTopic1 doen
als [MQTT#Value_of_TestTopic1]=1,00
pbani,5,150,0,0,0,0,0,
laatste
eindigt op

Op het tabblad ‘Regels’ kunt u vervolgens bijvoorbeeld de getoonde regels invoeren. Deze veroorzaken elke keer dat het onderwerp “Value_of_TestTopic1'Er wordt er één ontvangen, het commando'pbani,5,150,0,0,0,0,0," is uitgevoerd.

Deze opdracht maakt deel uit van de pxlBlck-plug-in. Ook hierover kunt u hier informatie vinden pxlBlck - Opdrachten voor het configureren van de pxlBlck