TapHome Icon

TapHome are un singur limbaj de scripting pentru smart rules, notificări și integrările dispozitivelor. Sintaxa și funcțiile sunt aceleași peste tot; doar variabilele, constantele și funcțiile disponibile depind de locul în care rulează scriptul. Aplicația pentru Android, Windows și macOS evidențiază sintaxa în editorul de scripturi; aplicația pentru iOS afișează scriptul fără evidențiere.

Unde se folosesc scripturile

Același limbaj de scripting rulează în smart rules, în notificări și în integrările Modbus și Packet parser:

ContextCe face scriptulSpecific contextului
Smart rule EcuațieO singură expresie peste valorile dispozitivelor. TRUE execută acțiunile pentru adevărat, FALSE acțiunile pentru fals.LastState, TriggerName
Smart rule FormulăCalculează o valoare care se scrie în fiecare dispozitiv de ieșire.LastState, TriggerName
Smart rule ScriptCitește valorile dispozitivelor și atribuie valori noi; fiecare atribuire devine o acțiune a dispozitivului.Variabile de citire/scriere, TriggerName
Condiția de limitare FormulăDecide dacă smart rule poate rula.TRUE permite rularea regulii
Titlul și mesajul notificăriiCompune textul notificării.Trebuie să returneze text; constantele notificării
Scriptul de citire al modulului ModbusInteroghează modulul, de regulă pentru a semnala erori ale dispozitivelor.Funcțiile MODBUS*
Scripturile de citire și scriere ale dispozitivului ModbusConvertesc registrele în valoarea dispozitivului și valoarea cerută înapoi în registre.Rezultatul citirii devine valoarea dispozitivului
Scriptul de inițializare ModbusRulează o singură dată după conectarea modulului.De regulă MODBUSWNE
Scripturile de citire și scriere Packet parserTrimit o cerere sau o comandă prin HTTP, FTP, TCP, UDP sau MQTT; la HTTP și FTP prelucrează și răspunsul.SENDHTTPREQUEST, SENDDATA, MQTTPUBLISH
Scriptul listener Packet parserTratează fiecare pachet TCP sau UDP primit și fiecare mesaj MQTT.RECEIVEDMSG
Atribute și acțiuni de service (Modbus, Packet parser)Rânduri de diagnostic și butoane cu parametri în aplicație.Parametrii acțiunii după abrevierea lor

SLEEP este respins în smart rules și în notificări (excepția este condiția de limitare Formulă). ADDERROR, ADDWARNING și ADDINFO funcționează doar în scripturile dispozitivelor. Ce transmite fiecare smart rule scriptului său se găsește pe pagina Scripturi în smart rules și notificări; integrările au paginile lor proprii, Funcții Modbus și Funcții Packet parser.

Rezultatul scriptului

Un script este o listă de instrucțiuni. Valoarea ultimei instrucțiuni evaluate este rezultatul scriptului. RETURN încheie scriptul mai devreme cu valoarea dată.

VAR a := 1;
VAR b := 2;
a + b;
# Result: 3

Rezultatul scriptului de citire al unui dispozitiv trebuie să corespundă valorii dispozitivului, altfel scriptul eșuează cu Return value 'X' does not match required return type constraint:

Valoarea dispozitivuluiRezultat permis
Starea întrerupătorului, contact reedTRUE sau FALSE (se acceptă și numere), NaN, Null
Starea comutatorului cu mai multe valoriNumăr (un număr întreg selectează starea; o valoare zecimală nu este respinsă), NaN, Null
Orice altă valoareNumăr, NaN, Null

NaN înseamnă „valoarea este necunoscută", Null înseamnă „nu există nicio valoare". Cum se comportă cele două în expresii este descris în Null și NaN.