Oggi vediamo il comando StateText e perchè lo trovo utilissimo per aumentare la leggibilità dei log!
A cosa serve StateText
Il comando StateText del firmware Tasmota serve ad assegnare un testo personalizzato ai varii stati del relè.
Infatti si possono personalizzare i messaggi di OFF, ON, TOGGLE ed HOLD. Semplice e veloce, vediamo subito i parametri e poi spiego perchè lo trovo così comodo!
Questo comando si inserisce nel più ampio discorso di personalizzazione di Tasmota, iniziato con WebColor e proseguito con la tripletta WebServer, WebPassord e WebButton.
Usando anche StateText si ottiene la personalizzazione totale dell'interfaccia.
I parametri
I parametri sono ben pochi ed autoesplicativi, ma vediamoli insieme!
StateText1 xxx
Setta il testo per il comando OFF.
Viene cambiato sia il messaggio in console che nell'interfaccia Web.
Non viene cambiato il messaggio necessario a spegnere il carico, che resta sempre POWER OFF. Se il valore contiene uno spazio viene inserito, al posto, il segno "_"
StateText2 xxx
Setta il testo per il comando ON.
Viene cambiato sia il messaggio in console che nell'interfaccia Web.
Non viene cambiato il messaggio necessario ad accendere il carico, che resta sempre POWER ON
Se il valore contiene uno spazio viene inserito, al posto, il segno "_"
StateText3 xxx
Setta il testo per il comando TOGGLE.
Viene cambiato sia il messaggio solo console, l'interfaccia web riporta sempre "Toggle".
Se il valore contiene uno spazio viene inserito, al posto, il segno "_"
StateText4 xxx
Setta il testo per il comando HOLD.
Se il valore contiene uno spazio viene inserito, al posto, il segno "_"
Alcuni esempi
Siccome mi piace far vedere le cose nel modo più pratico e comprensibile, ecco qualche esempio del comando e dell'output della console.
11:34:04 CMD: StateText1 Spento
11:34:04 RSL: tasmota/wm_test_02/stat/RESULT = {"StateText1":"Spento"}
11:34:22 CMD: power off
11:34:22 RSL: tasmota/wm_test_02/stat/RESULT = {"POWER":"Spento"}
11:34:22 RSL: tasmota/wm_test_02/stat/POWER = Spento
11:43:49 CMD: StateText2 Acceso
11:43:49 RSL: tasmota/wm_test_02/stat/RESULT = {"StateText2":"Acceso"}
11:43:53 CMD: power on
11:43:53 RSL: tasmota/wm_test_02/stat/RESULT = {"POWER":"Acceso"}
11:43:53 RSL: tasmota/wm_test_02/stat/POWER = Acceso
11:45:24 CMD: StateText3 Cambia Stato
11:45:24 RSL: tasmota/wm_test_02/stat/RESULT = {"StateText3":"Cambia_Stato"}
11:45:32 CMD: power toggle
11:45:32 RSL: tasmota/wm_test_02/stat/RESULT = {"POWER":"Spento"}
11:45:32 RSL: tasmota/wm_test_02/stat/POWER = Spento
Ovviamente si può anche combinare tutto in un comodo comando di Backlog :
12:00:12 CMD: Backlog StateText1 Spento; StateText2 Acceso; StateText3 CambiaStato; StateText4 Contatto Prolungato
12:00:12 RSL: tasmota/wm_test_02/stat/RESULT = {"StateText1":"Spento"}
12:00:12 RSL: tasmota/wm_test_02/stat/RESULT = {"StateText2":"Acceso"}
12:00:13 RSL: tasmota/wm_test_02/stat/RESULT = {"StateText3":"CambiaStato"}
12:00:13 RSL: tasmota/wm_test_02/stat/RESULT = {"StateText4":"Contatto_Prolungato"}
Faccio notare che l'ultima voce nel comando è "Contatto Prolungato" mentre viene recepita da Tasmota come "Contatto_Prolungato".
Per tornare ai valori di default, altro treno di comandi con Backlog:
Backlog StateText1 OFF; StateText2 ON; StateText3 Toggle; StateText4 HOLD
12:02:43 CMD: Backlog StateText1 OFF; StateText2 ON; StateText3 Toggle; StateText4 HOLD
12:02:43 RSL: tasmota/wm_test_02/stat/RESULT = {"StateText1":"OFF"}
12:02:43 RSL: tasmota/wm_test_02/stat/RESULT = {"StateText2":"ON"}
12:02:43 RSL: tasmota/wm_test_02/stat/RESULT = {"StateText3":"Toggle"}
12:02:44 RSL: tasmota/wm_test_02/stat/RESULT = {"StateText4":"HOLD"}
Ora che abbiamo visto tutti gli esempi, possiamo dedicarti all'ultima parte del post!
Perchè è utile?
Per tanti motivi, ovvviamente :-)
Puoi aumentare la leggibilità dei log, se un'apparato specifico lo setti con StateText1 e StateText2 personalizzati, filtrare gli eventi diventa uno scherzo.
Altra utilità è quella di creare un dispositivo con Tasmota a bordo che sia chiaro all'utente finale, ma questo lo approfondiremo.
Come dicevo nel post Tasmota - Perchè ampliare il firmware, l'obbiettivo di avere un device con Tasmota che sia quanto più possibile indipendente da un hub domotico mi affascina non poco!
Vedremo dove si arriverà!
Questo comando non ha alcun effetto sulla classe dei Trigger ButtonX#State dei quali ho parlato nel post "Rule Tasmota - Sintassi dei trigger". Infatti si va ad agire a livello più "basso".
Giusto per andare un pochino indietro con il tempo, avrei anche potuto usare questo comando per la mia Cassetta delle lettere Smart ma mi sono limitato al cambio del Button Topic
Se vuoi approfondire il discorso personalizzazione, ecco il link agli articoli che ho citato prima :
Se invece vuoi vedere cosa ho scritto sui comandi da console del firmware Tasmota, qui trovi tutti gli articoli in merito
Nessun commento:
Posta un commento
Sei davvero sicuro di voler sprecare tempo prezioso per scrivere qualcosa? Non è che preferisci andare su Google?