pxlBlck - Alle informatie voor testers van de nieuwste pre-release

Beste testers,
allereerst hartelijk dank voor je toestemming om de pxlBlck plugin te testen. 🙂

In het onderstaande probeer ik alles op te sommen wat je nodig hebt voor de installatie en werking van de plugin. Als er iets ontbreekt, vermeld dat dan in het commentaar onderaan de pagina. 🙂

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:
Om de pxlBlck plugin te installeren op je ....

Vereist gereedschap:
gg. Soldeerbout

Benodigd materiaal:

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

wemo's
LED-matrix
5V voeding

De plug-in installeren

Zoals eerder vermeld is de pxlBlck-plug-in een plug-in voor het ESPEasy Framework. Je zou dus eerst ESPEasy moeten flashen op je ESP8266 of ESP32. Uiteraard moet ook de PxlBlck-plug-in worden meegeleverd. Vanaf nu noem ik de combinatie van het EspEasy-framework inclusief plug-in simpelweg “firmware”.

Er zijn in principe twee manieren om de firmware op je microcontroller te krijgen. De ene is de manier die hier wordt beschreven: https://nerdiy.de/howto-espeasy-firmware-flashen/

De tweede manier is de enige mogelijke manier voor de testfase. Omdat ik de broncode nog niet wil publiceren, zal ik de firmware beschikbaar maken als een kant-en-klaar gecompileerde binary, die je dan alleen nog maar op de ESP hoeft te programmeren. Zoals ik al zei, wordt dit hier beschreven: https://nerdiy.de/howto-esp8266-mit-dem-esptool-bin-dateien-unter-windows-flashen/

Je vindt de huidige binaire waarde in het volgende gedeelte. 🙂

Binaire bestanden of voorgecompileerde firmwarebestanden

Hier zal ik een lijst maken van alle firmwareversies tijdens de testfase. Ik zal ook proberen te schrijven wat er veranderd is 🙂 .

Versie 0.0.2:

binair: Downloaden

Veranderlog:

• Modules “Generiek – MQTT Import” toegevoegd

Versie 0.0.1:

binair: Downloaden

Veranderlog:

• Eerste uitgave

WiFi-toegangsgegevens configureren

Nadat je de firmware naar je ESP hebt overgezet, is de volgende stap het configureren van de WLAN-toegangsgegevens. Dit wordt hier beschreven: https://www.nerdiy.de/howto-espeasy-firmware-flashen/ Ik vind de weg via de seriële interface het gemakkelijkst. Meer informatie vind je hier: https://nerdiy.de/howto-espeasy-firmware-flashen/#WLAN-Zugangsdaten_ueber_die_serielle_Schnittstelle_konfigurieren

Laat het me weten als er iets niet goed beschreven staat 🙂

Plugin opties / webmenu van de plugin

Een zeer comfortabele manier om de pxlBlck-plugin te configureren is het webmenu. Om dit te doen, voert u gewoon het IP-adres van uw EPS in de adresbalk van uw browser in. Klik vervolgens via het menu naar de instellingen van de pxlBlck.

• Naam: Hier kun je de naam van het apparaat configureren.
• Ingeschakeld: de plug-in is alleen geactiveerd als het vinkje hier is geplaatst
• GPIO/DigitalIn: Hier moet je de GPIO opgeven die is aangesloten op de LED-matrix.
• Help: Werkt nog niet of leidt nergens naartoe. Binnenkort wordt hier een pagina gemaakt waar gebruikers kunnen doorklikken naar helponderwerpen.
• Weergave ingeschakeld: Met dit vinkje kan het display worden uitgeschakeld of wordt de inhoud niet meer weergegeven. Deze optie kan bijvoorbeeld worden gebruikt om het scherm 's nachts uit te schakelen of als er niemand thuis is.
• Type matrix: Hier kun je de afmetingen van je LED-matrix configureren. In het bovenstaande voorbeeld is een matrix geconfigureerd van 32 LED's breed en 8 LED's hoog.
• Led type: Hier kun je het type van je LED instellen. De meeste Neopixel of WS2812 LEDs hebben de volgorde groen, rood, blauw. Dus GRB.
• Startposities: Hier kun je opgeven in welke hoek van je matrix de eerste LED zich bevindt. Informatie hierover vind je hier: https://learn.adafruit.com/adafruit-neopixel-uberguide/neomatrix-library
• LED-opstelling: hiermee kan de opstelling van uw LED-matrix worden geconfigureerd. Informatie hierover vind je ook hier: https://learn.adafruit.com/adafruit-neopixel-uberguide/neomatrix-library
• Tegelschikking & Matrixtegels in X-richting & Matrixtegels in Y-richting: Deze functies werken nog niet. :/ Laat het gewoon op “OneTileOnly” staan.
• Matrixrotatie: hiermee kan de matrix in stappen van 90° worden geroteerd.
• Wijzerplaatversie: Deze optie configureert de wijzerplaat of animatie die wordt weergegeven tijdens normaal gebruik. Meer hierover hieronder.
• Voorloopnullen ingeschakeld: Met deze functie kun je voorloopnullen activeren. De tijd 08:15 wordt bijvoorbeeld 8:15.
• Schermhelderheid: dit specificeert de schermhelderheid van de weergegeven inhoud in 15 stappen
• Minimale helderheid: Met deze optie kan een specifieke absolute waarde worden ingesteld voor de laagste helderheid. Het is een beetje moeilijk uit te leggen. Ik zal hier ook een aparte beschrijving toevoegen 🙂 .
• Uur & Minuut & Achtergrond: Hier kunt u de kleur voor elke groep instellen. Deze groepen veranderen ook afhankelijk van de wijzerplaat die is ingesteld onder “Kiesversie”.

Beschikbare opdrachten

Naast de mogelijkheid om de bovenstaande opties te configureren via het webmenu, kun je deze opties ook configureren door de commando's rechtstreeks in te voeren. Er zijn verschillende opties voor het invoeren van deze commando's, die hier allemaal worden beschreven: https://nerdiy.de/howto-espeasy-befehle-ausfuehren/

De volgende commando's zijn beschikbaar om de pxlBlck plugin per commando te configureren en om het uiterlijk/gedrag tijdens gebruik te veranderen.

De structuur van de commando's is meestal vergelijkbaar. Na de eigenlijke commandonaam worden de parameters doorgegeven - elk gescheiden door een komma. De vorm ziet er ongeveer zo uit:

Commandonaam,Parameter1,Parameter2,...,ParameterX,

Het is belangrijk dat de laatste parameter eindigt met een komma. Zonder komma wordt deze parameter genegeerd.

De volgende commando's zijn zo geschreven dat je een snel overzicht krijgt van de namen van het commando en de bijbehorende parameters. De parameters zijn weer van elkaar gescheiden en staan tussen vierkante haken. Bovendien wordt het toegestane waardebereik van de respectieve parameter ook aangegeven tussen vierkante haakjes.

Voorbeeld:
Commando Naam,[Parameter1 0-1],[Parameter2 0-15],[ParameterX 0-255],

In dit voorbeeld heeft parameter1 een toegestaan waardebereik van 0-1, parameter2 een toegestaan waardebereik van 0-15 en parameterX een toegestaan waardebereik van 0-255.

Het is ook belangrijk om op te merken dat waarden buiten dit toegestane waardebereik ervoor zorgen dat de volledige parameterinstelling voor deze parameter wordt genegeerd.

Als je parameterX in het bovenstaande voorbeeld wilt configureren, maar de rest ongewijzigd wilt laten, kun je het volgende commando sturen.

opdrachtnaam,2,16,133,

Deze specificatie zorgt ervoor dat de eerste twee ingevoerde waarden worden genegeerd omdat ze buiten het toegestane waardebereik liggen. Alleen de laatste waarde “133” wordt overgenomen, omdat deze binnen het toegestane waardebereik voor “ParameterX” ligt.

Commando: Algemene instellingen

Om algemene instellingen te maken, kunt u het commando “pb” gebruiken. U kunt dit gebruiken om het algemene gedrag en de weergave van uw pxlBlck te configureren.

Opdrachtoverzicht:
pb,[display_enabled 0-1],[brightness 0-15],[rc_mark_brightness 0-15],[matrix_rotation 0-3],[selected_dial 0-15],[wc_it_is_enabled 0-1],[wc_o_clock_enabled 0-1] ,[rc_dir_inversed 0-1],[wc_language_id 0-15],[minimal_brightness 0-255],

Parameterbeschrijving:

• display_enabled: Schakelt de display-uitgang in (1) of uit (0). Dit kan bijvoorbeeld worden gebruikt om stroom te besparen als er niemand aanwezig is. Zie ook pxlBlck - Het scherm uitschakelen wanneer afwezig
• helderheid: Helderheid van het display in 16 stappen van 0-15, waarbij het display bij een waarde van 0 niet volledig wordt gedeactiveerd. In dit geval wordt de (absolute) waarde gespecificeerd in minimal_brightness ingesteld als de helderheid.
• rc_mark_brightness: Helderheid van de uurmarkeringen in ringklokmodus in 16 stappen van 0-15.
• matrix_rotation: Weergavestand van de weergegeven matrix van 0-3. Het verhogen van deze waarde zorgt voor een rotatie van 90° met de klok mee.
• selected_dial: Geselecteerde wijzerplaat. Hier kun je selecteren welke wijzerplaat regelmatig wordt weergegeven op het display. Dit kan een eenvoudige animatie of een tijdweergave zijn.
• wc_it_is_enabled: Schakelt de weergave van de letters “Het is” in de woordklokmodus in (1) of uit (0).
• wc_o_clock_enabled: Schakelt de weergave van de letters “clock” in de word clock-modus in (1) of deactiveert (0).
• rc_dir_inversed: Inverted(1) of non-inverted(0) de looprichting van de wijzers in ringklokmodus. Met deze instelling wordt de ringvormige wijzerplaat in principe gespiegeld op de verticale as.
• wc_language_id: Selecteert de gewenste taal in de woordklokmodus. Hiermee kun je de tijd op de woordklok in verschillende talen weergeven.
• minimal_brightness: De waarde die wordt opgegeven met minimal_brightness is de waarde die wordt ingesteld als de helderheidswaarde wanneer de normale helderheid van het scherm op nul is ingesteld. Het verschil is dat minimal_brightness een groter instelbereik heeft. Hier kun je de helderheid niet alleen instellen in het bereik 0-15, maar in het bereik 0-255. Het grote voordeel hiervan is dat je veel donkerdere helderheden kunt instellen. Meer informatie hierover vind je in het artikel pxlBlck - Het scherm in de nachtmodus zetten als het donker is (die ik natuurlijk nog moet maken) 🙂

TODO: Voorbeelden

Commando's: kleuren

De toewijzing van de kleuren verandert afhankelijk van de geselecteerde wijzerplaat. Er zijn echter maximaal vier mogelijke kleuren die als volgt kunnen worden geconfigureerd.

Opdrachtoverzicht:
pbclr,[kleur1_rood 0-255],[kleur1_groen 0-255],[kleur1_blauw 0-255],[kleur2_rood 0-255],[kleur2_groen 0-255],[kleur2_blauw 0-255],[kleur3_rood 0-255] ,[kleur3_groen 0-255],[kleur3_blauw 0-255],[kleur4_rood 0-255],[kleur4_groen 0-255],[kleur4_blauw 0-255],

Parameterbeschrijving:

• color1_red: Rood kleurgedeelte van de eerste kleur
• kleur1_groen: Groene kleur deel van de eerste kleur
• color1_blue: Blauw kleurgedeelte van de eerste kleur
• color2_red: Rood kleurgedeelte van de tweede kleur
• kleur2_groen: Groene kleur deel van de tweede kleur
• color2_blue: Blauw kleurgedeelte van de tweede kleur
• color3_red: Rood kleurgedeelte van de derde kleur
• kleur3_groen: Groene kleur deel van de derde kleur
• color3_blue: Rood kleurgedeelte van de derde kleur
• color4_red: Rood kleurgedeelte van de vierde kleur
• kleur4_groen: Groene kleur deel van de vierde kleur
• color4_blue: Blauw kleurgedeelte van de vierde kleur

TODO: Voorbeelden

Commando: Booleaanse waarden:

Met deze optie kunnen waarheidswaarden absoluut worden ingesteld of omgeschakeld. Dit commando werkt een beetje anders. De structuur is als volgt.

Opdrachtoverzicht:
pbbo,[waarde_id 1-6], [waarde 0-2]

“Value_id” voert hier de waarde in die u wilt configureren. Hieronder vindt u een overzicht

“Waarde” kan de waarden nul tot drie hebben. Nul stelt de geselecteerde waarheidswaarde in op “false”, één stelt deze in op “true” en twee schakelt de betreffende waarde in. Schakelen hier betekent dat de waarde in het tegenovergestelde verandert. (Dus nul wordt één en omgekeerd).

Parameterbeschrijving:

• displayEnabled=1
• wordclockShowOClockEnabled=2
• wordclockShowItIsEnabled=3
• ringclockThick12markEnabled=4
• ringclockClockDirInversed=5
• diallLeadingZerosEnabled=6

TODO: Voorbeelden

Commando: helderheid

Met het hier beschreven commando kunnen de verschillende helderheidsniveaus worden geconfigureerd.

Opdrachtoverzicht:
pbbr,[helderheidId 0-2], [helderheid 1-15], [absoluut 1-15], [Onderrand 1-15], [bovengrens 1-15],

TODO: Uitleg en voorbeelden

Commando: Kleur instellen via kleurenwiel

Met dit commando kunnen de kleuren worden aangepast volgens de hoek van een kleurencirkel. Op deze manier kunnen bijvoorbeeld kleurwijzigingen worden gerealiseerd met één druk op de knop en kunnen alle kleuren worden geregeld.

Opdrachtoverzicht:
pbclrwhl,[kleurId 0-4], [graad 1-15], [absoluut 1-15], [Onderrand 1-15], [bovengrens 1-15],

TODO: Uitleg en voorbeelden

Commando: scrollende tekst

Opdrachtoverzicht:
pbrntxt,[txt_color_red 0-255],[txt_color_green 0-255],[txt_color_blue 0-255],[bg_color_red 0-255],[bg_color_green 0-255],[bg_color_blue 0-255],[delay_time 0-1000] ,[start_pos 0-MATRIX_WIDTH],

Parameterbeschrijving:

• txt_color_red: Rood deel van de tekstkleur
• txt_color_green: Groene kleur deel van de tekstkleur
• txt_color_blue: blauw kleurgedeelte van de tekstkleur
• bg_color_red: Rood deel van de achtergrondkleur
• bg_kleur_groen: Groen kleurgedeelte van de achtergrondkleur
• bg_color_blue: Blauw kleurgedeelte van de achtergrondkleur
• vertragingstijdDe tijd die de tekst nodig heeft om door het scherm te scrollen. Hiermee kun je bepalen hoe snel de tekst door het scherm loopt.
• start_pos: De horizontale startpositie op het scherm in pixels. De pixel linksonder is de 1e pixel.

TODO: Uitleg en voorbeelden

Commando: pictogramweergave

Je kunt de pictogramweergave gebruiken om zelfontworpen pictogrammen weer te geven op het scherm van je pxlBlck.

Er zijn verschillende fade-in en fade-out opties beschikbaar. Meer gedetailleerde informatie over hoe je zelf pictogrammen ontwerpt, ze overzet naar je pxlBlck en ze daar weergeeft staat in het volgende artikel pxlBlck - Ontwerp je eigen pictogrammen, zet ze over naar de pxlBlck en geef ze weer. (Artikel moet nog aangemaakt worden)

Opdrachtoverzicht:
pbicon,[txt_color_red 0-255],

Parameterbeschrijving:

Commando: FakeTV-simulatie

TODO: Uitleg en voorbeelden

Opdrachtoverzicht:
pbfaketv, [ingeschakeld 0-1],

Parameterbeschrijving:

• ingeschakeldDeze parameter kan worden gebruikt om de nepTV-functie te activeren of deactiveren.

Commando: Matrix/Kleurentest

Opdrachtoverzicht:
pbtest

Parameterbeschrijving:
-geen parameters beschikbaar

Commando: Animaties

Je kunt animaties gebruiken om een gebeurtenis te signaleren. Ze zijn bijvoorbeeld perfect om een gebeurtenis weer te geven op de slot/ring klok of op andere modellen die geen icoonweergave ondersteunen.

Opdrachtoverzicht:
pbani, [animatietype 0-5],

Parameterbeschrijving:

klökjlö

TODO: Uitleg en voorbeelden

Commando: demo-modus

TODO: Uitleg en voorbeelden

pbdemo

Commando: kiescodes configureren

TODO: Uitleg en voorbeelden

pbdia

TODO: Info ontbreekt nog overal

Kiesoverzicht:

Beschikbare wijzerplaten:
De instelbare wijzerplaten verschillen helaas van het type matrix dat wordt gebruikt. Dit komt helaas doordat verschillende matrixformaten verschillende weergaven wel of niet toestaan.

Om je een klein overzicht te geven van welke wijzerplaattypes mogelijk zijn met welke matrix, volgt hier een introductie van de instelbare wijzerplaten en een indicatie van de matrixtypes waaronder ze beschikbaar zijn.

Kaal:

Er wordt geen wijzerplaat weergegeven.

TODO: Er ontbreekt informatie

Lopende klok:

De tijd wordt weergegeven als scrollende tekst met instelbare intervallen.

Opties:

• Uur, minuut en achtergrondkleur instelbaar
• Scrollsnelheid van tekst instelbaar

Beschikbaar voor:

• pxlBlck8x8
• pxlBlck10x10
• pxlBlckCarrousel (16×8)
• pxlBlck16x16
• pxlBlck32x8
• pxlBlckCassette (gebruikt een 12×8 matrix)

TODO: Er ontbreekt informatie

“HrNum&MntPoints”: Uurnummer en minuutpunten

Uur wordt weergegeven als een getal. Minuten als proportioneel aantal geactiveerde achtergrondpixels. Kleuren voor uur, minuut en achtergrond kunnen worden ingesteld.

Opties:

• Uur, minuut en achtergrondkleur instelbaar
• Scrollsnelheid van tekst instelbaar

Beschikbaar voor:

• pxlBlck8x8
• pxlBlck10x10

BorderPxls: willekeurige pixels weergeven

WndrngPxl

TvSmltr

fiboKlik

horizNmbrs: Horizontale getallen als tijd:

Uren en minuten staan zoals gewoonlijk naast elkaar.

Opties:

• Uren, minuten en achtergrondkleur instelbaar.

Beschikbaar voor:

• pxlBlck10x10
• pxlBlckCarrousel (16×8)
• pxlBlck16x16
• pxlBlck32x8
• pxlBlckCassette (gebruikt een 12×8 matrix)

horizMiniNmbrs:

vertMiniNmbrs: Verticale klok:

De uur- en minuutcijfers staan boven elkaar.

Opties:

• Uur, minuut, uur achtergrond en minuut achtergrondkleur instelbaar.

Beschikbaar voor:

• pxlBlck10x10
• pxlBlckCarrousel (16×8)
• pxlBlck16x16
• pxlBlck32x8
• pxlBlckCassette (gebruikt een 12×8 matrix)

wordClock: woordklok

De tijd wordt weergegeven volgens het woordklokprincipe met verlichte of niet-verlichte letters.

Opties:

• Uur, minuut en achtergrondkleur instelbaar
• “Het is” en “Klok” kunnen worden geactiveerd/gedeactiveerd

Beschikbaar voor:

• pxlBlck Wordclock (gebruikt een aangepaste 11×11 matrix)

Ring: Ringhorloge

De tijd wordt weergegeven als een wijzerklok. De pointers zijn verlichte pixels van een ledstrip in verschillende kleuren.

Kleuren voor uur-, minuut- en secondemarkering instelbaar.

Opties:

• Uur, minuut en achtergrondkleur instelbaar
• De draairichting van de klok is omkeerbaar
• Offset instelbaar om het nulpunt op de LED-strip te kunnen verschuiven

Beschikbaar voor:

• pxlBlckRingClock
• pxlBlckSlotClock
• pxlBlckLinearClock?

cijferklok

diagMiniNmbrs

cmpVuur