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:
| Context | Ce face scriptul | Specific contextului |
|---|---|---|
| Smart rule Ecuație | O 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 Script | Citeș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ării | Compune textul notificării. | Trebuie să returneze text; constantele notificării |
| Scriptul de citire al modulului Modbus | Interoghează modulul, de regulă pentru a semnala erori ale dispozitivelor. | Funcțiile MODBUS* |
| Scripturile de citire și scriere ale dispozitivului Modbus | Convertesc registrele în valoarea dispozitivului și valoarea cerută înapoi în registre. | Rezultatul citirii devine valoarea dispozitivului |
| Scriptul de inițializare Modbus | Rulează o singură dată după conectarea modulului. | De regulă MODBUSWNE |
| Scripturile de citire și scriere Packet parser | Trimit 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 parser | Tratează 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: 3Rezultatul 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 dispozitivului | Rezultat permis |
|---|---|
| Starea întrerupătorului, contact reed | TRUE sau FALSE (se acceptă și numere), NaN, Null |
| Starea comutatorului cu mai multe valori | Număr (un număr întreg selectează starea; o valoare zecimală nu este respinsă), NaN, Null |
| Orice altă valoare | Numă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.