HowTo: ESP Easy - Installeer en configureer de NerdiysPanelMeter-plug-in

In het artikel Bouw je eigen retro SmartHome-display met analoge displays werd de assemblage van hun eigen retro SmartHome display uitgelegd.

Maar helaas is zelfs de beste hardware niets zonder de juiste software.

Om de analoge displays en de bijbehorende LED's comfortabel te kunnen bedienen, kun je de volgende ESP Easy plug-in gebruiken.

Hiermee kun je tot 16 analoge displays inclusief LED's aansturen en waarden weergeven die zijn aangepast aan de schalen.

Hoe je dit doet en waar je rekening mee moet houden, wordt beschreven in het volgende artikel.

Dit artikel bevat ook de huidige beschikbare en toekomstige geplande functies van de plugin en de lijst met wijzigingen.

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

Handige artikelen:
Voordat u met dit artikel begint, moet u het PanelMeter display in elkaar hebben gezet en geprogrammeerd met de ESPEasy firmware - inclusief de Nerdiys PanelMeter plug-in. Informatie hierover vindt u in de volgende artikelen.
Bouw je eigen retro SmartHome-display met analoge displays
ESPEasy - Firmware flashen en WLAN-toegangsgegevens configureren
ESPEasy - Opdrachten en acties uitvoeren

Vereist gereedschap:
-Nee-

Benodigd materiaal:

In de volgende lijst vind je alle tools die je nodig hebt om dit artikel te implementeren.

Download de plug-ingegevens van de Nerdiy Git

Zoals alle ESP-Easy plugins die hier op Nerdiy.de worden aangeboden, kun je deze plugin vinden in Git onder: https://github.com/Nerdiyde/Nerdiys_ESPEasy

Naast de eigenlijke plug-in bestanden bevat het ook de andere bestanden van het ESPEasy framework. Op deze manier kan het hele domein worden gedownload en rechtstreeks op de controller worden geprogrammeerd. Hiervoor zijn de plugins al correct geconfigureerd.

Hoe je bestanden van een Git repository kunt downloaden staat beschreven in het artikel GitHub - Hoe kopieer ik bestanden van een Git-repository naar mijn computer beschreven.

Schakel plug-incompilatie in

Als je ESPEasy programmeert op je ESP met behulp van de ArduinoIDE of de code vanaf nul compileert, is het belangrijk dat je vooraf de PanelMeter plugin activeert. Ga hiervoor naar de plugin tab en verwijder het commentaar (de twee "//") voor de "#define USES_P209". Dit zal de plugin en de code die het bevat opnemen in de volgende compilatie en het beschikbaar maken voor jou als een selectie in de plugin manager. Je kunt hier meer informatie over vinden in het artikel ESPEasy - Firmware compileren, flashen en WLAN-toegangsgegevens configureren in sectie Vereiste plugins activeren.

Weergave van de code met markering van de relevante plaats om de plug-incode te activeren.

Plugin configureren

Om de PanelMeter plugin dienovereenkomstig te configureren, moet u overschakelen naar het webconfiguratiemenu van de ESPEasy firmware die op de PanelMeter is geïnstalleerd. Voer gewoon het IP-adres in van de PanelMeter die verbonden is met uw WLAN.

Hoe u uw PanelMeter - geprogrammeerd met de ESPEasy firmware - verbindt met uw WLAN wordt beschreven in het artikel ESPEasy - Firmware flashen en WLAN-toegangsgegevens configureren wordt beschreven. Hoe je vervolgens het bijbehorende IP-adres achterhaalt, wordt beschreven in het artikel Toon/ontdek het IP-adres van de apparaten in het netwerk beschreven.

De LED's van de achtergrondverlichting van de PanelMeter moeten dan allemaal wit oplichten. Als dit niet het geval is, controleer dan nogmaals of u de juiste GPIO en het juiste aantal analoge displays heeft opgegeven.

De analoge displays moeten na de overdracht allemaal precies in het midden staan. Als dat niet zo is, controleer dan nogmaals of je het juiste I2C-adres en het juiste aantal PanelMeters hebt ingevoerd.

Beschikbare opdrachten

De plug-in "PanelMeter" biedt twee commando's waarmee je de displays kunt configureren. Deze kun je op de gebruikelijke manier voor ESP-Easy uitvoeren. Hoe u dit doet, wordt in detail beschreven in het artikel ESPEasy - Opdrachten en acties uitvoeren beschreven.

Met het eerste commando stel je de analoge displays in en configureer je optioneel de betreffende LED-kleur. Met het tweede commando kun je de LED-kleur onafhankelijk van de instelling van de analoge displays configureren.

Commando: pmset
Aanpassing van analoge displays en LED-kleuren.

Het commando "pmset" heeft zeven parameters nodig, waarvan de laatste drie optioneel zijn.
1e parameter: "geselecteerde paneelmeter":
Met behulp van deze parameter kies je welk analoog display je wilt instellen. De telling begint bij één. Als je een nul invoert, worden alle analoge displays ingesteld met de geselecteerde instellingen. Waardenbereik: 0 tot 16.
2e parameter: "ondergrens
Voor deze parameter moet je de ondergrens van de schaal op het analoge display invoeren. Deze waarde is nodig om de weer te geven waarde overeenkomstig te schalen. Waardebereik: -10000 tot 10000.
3e parameter: "bovengrens":
Voor deze parameter moet je de bovengrens van de schaal op het analoge display opgeven. Deze waarde is nodig om de weer te geven waarde overeenkomstig te schalen. Waardebereik: -10000 tot 10000.
4e parameter: "huidige waarde":
Dit is de waarde die moet worden weergegeven. Het wordt geschaald volgens de specificatie van de "ondergrens" en "bovengrens". Waardebereik: -10000 tot 10000.
5e parameter: "LED kleur rood":
Rode kleurwaarde van de LED in te stellen. Waardebereik: 0 tot 255.
Parameter 6: "LED kleur groen":
Groene kleurwaarde van de LED die moet worden ingesteld. Waardenbereik: 0 tot 255.
Parameter 7: "LED kleur blauw":
Blauwe kleurwaarde van de LED in te stellen. Waardebereik: 0 tot 255.

pmset,
{geselecteerde paneelmeter 0-16(nul=alle)},
{bereikMin -10000-10000},
{bereikMax -10000-10000},
{werkelijke waarde -10000-10000},
{led kleur rood 0-255},
{led kleur groen 0-255},
{led kleur blauw 0-255},

Voorbeelden:
- Je wilt bijvoorbeeld een analoge (temperatuur)weergave instellen op 20°C met een waardebereik van -10°C tot +40°C: pmset,1,-10,40,20
- moet de LED van hetzelfde display ook op blauw worden ingesteld: pmset,1,-10,40,20,0,0,255

Commando: pmled
Instellen van de LED-kleuren.

Het commando "pmled" heeft vier parameters nodig.
1e parameter: "geselecteerde LED":
Met behulp van deze parameter selecteer je welke LED moet worden ingesteld. De telling begint bij één. Als je een nul invoert, worden alle beschikbare LED's ingesteld met de geselecteerde instellingen. Waardenbereik: 0 tot 16.
2e parameter: "LED kleur rood":
Rode kleurwaarde van de LED in te stellen. Waardebereik: 0 tot 255.
3e parameter: "LED kleur groen":
Groene kleurwaarde van de LED die moet worden ingesteld. Waardenbereik: 0 tot 255.
Parameter 4: "LED kleur blauw":
Blauwe kleurwaarde van de LED in te stellen. Waardebereik: 0 tot 255.

gepmd,
{ {led kleur rood 0-255},
{led kleur groen 0-255},
{led kleur blauw 0-255},

Voorbeeld:
- Het volgende commando is voldoende om de vierde LED met de kleur groen in te schakelen: pmled,4,0,255,0

Voorbeeld NodeCode om de PanelMeter van data te voorzien

Natuurlijk heb je nog steeds een "backend" nodig om je PanelMeter van gegevens te voorzien. Verschillende SmartHome systemen zijn hier zeer geschikt voor. Dit kan bijvoorbeeld heel eenvoudig worden geïmplementeerd met NodeRed. Tips hierover vind je in het artikel NodeRed - Nerdiys PanelMeter voorzien van weergegevens.

Beschikbare functies

• Automatische schaalverdeling en weergave van waarden op individuele en alle analoge displays.
• De LED-kleuren van individuele en alle LED's instellen.

Geplande functies

• Koppeling naar openWeatherMap-account om klimaatgegevens direct weer te geven.
• Mogelijkheid om de analoge displays te gebruiken als minuten- en uuraanduidingen.

changelog

v0.1:

• project aangemaakt

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. 🙂