Izrazi / Skriptni jezik

TapHome ima jedan skriptni jezik za smart rules, obavijesti i integracije uređaja. Sintaksa i funkcije svugdje su iste; samo dostupne varijable, konstante i funkcije ovise o tome gdje se skripta izvršava. Aplikacija u uređivaču skripti ističe sintaksu.

Gdje se skripte koriste

Isti skriptni jezik izvršava se u smart rules, obavijestima i u integracijama Modbus i Packet parser:

Kontekst	Što skripta radi	Specifično za kontekst
Smart rule Jednadžba	Jedan izraz nad vrijednostima uređaja. `TRUE` pokreće radnje za istinu, `FALSE` radnje za laž.	`LastState`, `TriggerName`
Smart rule Formula	Izračunava vrijednost koja se upisuje u svaki izlazni uređaj.	`LastState`, `TriggerName`
Smart rule Skripta	Čita vrijednosti uređaja i dodjeljuje nove; svaka dodjela postaje radnja na uređaju.	Varijable za čitanje i pisanje, `TriggerName`
Ograničavajući uvjet Formula	Odlučuje smije li se smart rule izvršiti.	`TRUE` dopušta izvršavanje smart rule
Naslov i tekst obavijesti	Sastavlja tekst obavijesti.	Mora vratiti tekst; konstante obavijesti
Modbus skripta za čitanje modula	Ispituje modul, obično radi prijave pogrešaka uređaja.	Funkcije `MODBUS*`
Modbus skripte za čitanje i pisanje uređaja	Pretvara registre u vrijednost uređaja i traženu vrijednost natrag u registre.	Rezultat skripte za čitanje postaje vrijednost uređaja
Modbus inicijalizacijska skripta	Izvršava se jednom nakon spajanja modula.	Obično `MODBUSWNE`
Packet parser skripte za čitanje i pisanje	Šalje zahtjev ili naredbu preko HTTP, FTP, TCP, UDP ili MQTT; kod HTTP i FTP obrađuje i odgovor.	`SENDHTTPREQUEST`, `SENDDATA`, `MQTTPUBLISH`
Packet parser listener skripta	Obrađuje svaki dolazni TCP ili UDP paket i svaku MQTT poruku.	`RECEIVEDMSG`
Servisni atributi i radnje (Modbus, Packet parser)	Dijagnostički retci i gumbi s parametrima u aplikaciji.	Parametri radnje prema njihovoj kratici

SLEEP se u smart rules i obavijestima odbija (iznimka je ograničavajući uvjet Formula). ADDERROR, ADDWARNING i ADDINFO rade samo u skriptama uređaja. Što pojedini smart rules prosljeđuju svojoj skripti, opisuje stranica Skripte u smart rules i obavijestima; integracije imaju vlastite stranice, Funkcije Modbus i Funkcije Packet parsera.

Rezultat skripte

Skripta je popis naredbi. Vrijednost posljednje izračunate naredbe rezultat je skripte. RETURN prijevremeno završava skriptu zadanom vrijednošću.

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

Rezultat skripte za čitanje uređaja mora odgovarati vrijednosti uređaja, inače skripta završava pogreškom Return value 'X' does not match required return type constraint:

Vrijednost uređaja	Dopušteni rezultat
Stanje sklopke, magnetski kontakt	`TRUE` ili `FALSE` (prihvaćaju se i brojevi), `NaN`, `Null`
Stanje prekidača s više vrijednosti	Broj (cijeli broj odabire stanje; decimalna vrijednost se ne odbija), `NaN`, `Null`
Bilo koja druga vrijednost	Broj, `NaN`, `Null`

NaN znači „vrijednost je nepoznata”, Null znači „vrijednost ne postoji”. Kako se oba ponašaju u izrazima, opisano je u odjeljku Null i NaN.

Stranice u ovom odjeljku

Referencija skriptnog jezika ima četiri skupine stranica: vodič kroz jezik, funkcije po područjima, funkcije integracija i referentne popise.

Vodič

Sintaksa i tijek izvršavanja — naredbe, komentari, literali, IF, SWITCH, petlje WHILE i DO, RETURN.
Tipovi podataka — brojevi, tekst, strukturirani i enum tipovi, zbirke, .Type, proširenje tipa, Null i NaN.
Varijable i konstante — varijable uređaja, vrijednosti skupina, varijable modula, VAR i deklaracije s tipom, svojstva, konstante konteksta.
Statistika i Info vrijednosti — statistike uređaja, Info vrijednosti s vremenom posljednje promjene, prethodnom vrijednošću i vrijednostima završenih razdoblja.
Operatori — popis operatora, prioritet, skraćeno izračunavanje, ekvivalenti u Excelu.
Skripte u smart rules i obavijestima — Jednadžba, Formula, Skripta, ograničavajući uvjet Formula i obavijesti.

Funkcije

Logika i dijagnostika — ISNULL, ISNAN, EQUALS, SLEEP, ADDERROR, ADDWARNING, ADDINFO, DEBOUNCE.
Matematičke funkcije — MIN, MAX, AVG (preskaču nepoznate vrijednosti, varijante …STRICT ne), ABS, SIGN, SQRT, POWER, MOD, LOG, LN, DEWPOINT.
Zaokruživanje i slučajni brojevi — ROUND, CEIL, FLOOR, RAND, RANDINT.
Interpolacija i pragovi — LINEAR preslikava vrijednost iz jednog raspona u drugi (na primjer krivulju prigušivanja), HYSTERESIS.
Operacije s bitovima — GETBIT, GETBITS, SETBIT, SETBITS, GETBYTE, SETBYTE, TOBCD, FROMBCD.
Tekst i zbirke — LENGTH, GETAT, SETAT, APPEND, INSERT, REMOVEAT, COPY, INDEXOF, REPLACE, SPLIT, COMPARE, BYTECOLLECTION, UINT16COLLECTION, BOOLCOLLECTION.
Sortiranje — ORDER, ORDERINDEX i njihove silazne i stroge varijante.
Datum i vrijeme — NOW, DATETIME, DATETIMEADD, TIMESPAN, LOCALTIMEZONE.
Pretvorbe tipova podataka — TOSTRING, TODOUBLE, TOBYTES, ENCODE, DECODE.
Boje — HSVTORGB, RGBTOHSV.
Funkcije za raščlambu — PARSETEXT, PARSEJSON (čita vrijednost iz JSON-a prema njezinoj putanji), PARSEXML.
Binarni podaci — PACKVALUE, UNPACKVALUE.
Šifriranje i hashevi — AESENCRYPT, AESDECRYPT, HASH, HMAC, RANDBYTES.
Kodiranje bajtova i kontrolni zbrojevi — TOBASE64, FROMBASE64, TOHEX, FROMHEX, CRC16, CRC32.

Integracije

Funkcije Modbus — tipovi registara, MODBUSR, MODBUSW, MODBUSWNE, MODBUSRBLOCK, MODBUSWBLOCK, MODBUSWBLOCKNE.
Tipovi podataka Modbus — tipovi podataka funkcija Modbus, varijante redoslijeda bajtova, 64-bitni tipovi, tekst.
Skripte Modbus i prefetch — koje skripte imaju Modbus modul i uređaj, kada se izvršavaju, prefetch i predmemoriranje.
Funkcije Packet parsera — HTTPREQUEST, SENDHTTPREQUEST, SENDDATA, MQTTPUBLISH, FTPDOWNLOAD, FTPUPLOAD, COMPLETESERVICEATTRIBUTE, COMPLETESERVICEACTION.
Listener skripte — listener skripta modula Packet parser, RECEIVEDMSG i RECEIVEDBYTES.

Referencija

Primjeri skripti — cjelovite skripte iz stvarnih predložaka uređaja.
Pogreške skripti i rješavanje problema — poruke o pogreškama pri raščlambi i izvršavanju te kako ih ukloniti.
Zahtjevi skripti za verziju — verzija Core koju treba svaka funkcija.
Funkcije skripti od A do Ž — svaka funkcija s jednom rečenicom i poveznicom.

Sintaksa i tijek izvršavanja

Sintaksa skriptnog jezika TapHome: naredbe i točka sa zarezom, komentari, literali, IF u obliku funkcije i bloka, SWITCH, petlje WHILE i DO, BREAK, CONTINUE i RETURN.

Tipovi podataka

Tipovi podataka skriptnog jezika TapHome: brojevi, tekst, strukturirani i enum tipovi, zbirke, svojstvo .Type, proširenje tipa u aritmetici te ponašanje vrijednosti Null i NaN.

Varijable i konstante

Varijable u skriptama TapHome: vrijednosti uređaja prema kratici, vrijednosti skupina, varijable modula i uređaja, VAR i deklaracije s tipom, dodjela, svojstva i konstante konteksta.

Statistika i Info vrijednosti

Statistika i Info vrijednosti u skriptama TapHome: vrijednost statistike, vrijeme posljednje promjene, prethodna i posljednja poznata vrijednost te vrijednosti završenih razdoblja.

Operatori

Operatori skriptnog jezika TapHome: aritmetički operatori, operatori usporedbe, operatori nad bitovima i logički operatori, njihovih 10 razina prioriteta, zamka a & 1 > 0, skraćeno izračunavanje i ekvivalenti u Excelu.

Skripte u smart rules i obavijestima

Što smart rules Jednadžba, Formula i Skripta, ograničavajući uvjet Formula i skripte obavijesti prosljeđuju skripti i što rade s njezinim rezultatom: LastState, TriggerName, izlazi, pogreške i SLEEP.

Logika i dijagnostika

Funkcije skripte TapHome za nepoznate vrijednosti i dijagnostiku uređaja: ISNULL, ISNAN, EQUALS, SLEEP, ADDERROR, ADDWARNING, ADDINFO i DEBOUNCE.

Matematičke funkcije

Matematičke funkcije skripte TapHome — MIN, MAX, AVG i njihove varijante STRICT, ABS, SIGN, SQRT, POWER, MOD, LOG, LN i DEWPOINT.

Zaokruživanje i slučajni brojevi

Funkcije skripte TapHome za zaokruživanje i slučajne brojeve — ROUND, CEIL i FLOOR s višekratnikom, RAND i RANDINT.

Interpolacija i pragovi

Linearna interpolacija LINEAR i preklapanje na pragovima HYSTERESIS za preslikavanje vrijednosti, prigušivanje svjetla i upravljanje grijanjem u skriptama TapHome.

Operacije s bitovima

Rad s bitovima i bajtovima u skripti TapHome — GETBIT, GETBITS, SETBIT, SETBITS, GETBYTE, SETBYTE, TOBCD, FROMBCD, širina u bitovima prema tipu i operatori nad bitovima s ekvivalentima u Excelu.

Tekst i zbirke

Funkcije skripte TapHome za nizove znakova, zbirke i polja bajtova — LENGTH, GETAT, SETAT, APPEND, INSERT, REMOVEAT, COPY, INDEXOF, REPLACE, SPLIT, COMPARE, BYTECOLLECTION, UINT16COLLECTION, BOOLCOLLECTION.

Sortiranje

Funkcije skripte TapHome za sortiranje — ORDER, ORDERINDEX i njihove varijante STRICT i silazne varijante za sortiranje vrijednosti ili vraćanje indeksa redoslijeda.

Datum i vrijeme

Funkcije skripte TapHome za datum i vrijeme — NOW, DATETIME, DATETIMEADD, TIMESPAN i LOCALTIMEZONE — i svojstva vrijednosti datetime i timespan.

Pretvorbe tipova podataka

Funkcije pretvorbe u skripti TapHome — TOSTRING s nizovima formata za brojeve i datume, TODOUBLE, TOBYTES te ENCODE / DECODE za XML i Base64.

Boje

Funkcije za boje u skripti TapHome — HSVTORGB i RGBTOHSV — te tipovi vrijednosti rgbcolor i hsvcolor za upravljanje RGB svjetlima iz skripti Packet parsera i Modbusa.

Funkcije za raščlambu

Funkcije za raščlambu u skripti TapHome — PARSETEXT za tekst između uzoraka, PARSEJSON s JSONPath i PARSEXML s XPath — za čitanje vrijednosti iz odgovora uređaja.

Binarni podaci

Funkcije PACKVALUE i UNPACKVALUE u skripti TapHome — čitanje i zapis vrijednosti s tipom u zbirkama registara i bajtova, s redoslijedom big-endian, little-endian i zamjenom bajtova.

Šifriranje i hashevi

Funkcije skripte TapHome za šifrirane i potpisane protokole uređaja: AESENCRYPT i AESDECRYPT, HASH i HMAC s MD5 i SHA, RANDBYTES te primjer pristupnika Bosch KM200.

Kodiranje bajtova i kontrolni zbrojevi

Funkcije skripte TapHome TOBASE64 i FROMBASE64 (i base64url), TOHEX i FROMHEX, CRC16 i CRC32 — bajtovi kao tekst i natrag te kontrolni zbrojevi okvira.

Funkcije Modbus

Funkcije Modbus u skripti TapHome — MODBUSR, MODBUSW, MODBUSWNE i blokovske funkcije MODBUSRBLOCK, MODBUSWBLOCK, MODBUSWBLOCKNE — te tipovi registara Modbus C, D, H i A.

Skripte Modbus i prefetch

Skripte modula i uređaja Modbus u sustavu TapHome — inicijalizacijska skripta, skripta za čitanje, čitanje vrijednosti, pisanje vrijednosti, servisni atributi i servisne radnje — i kako na njih utječu prefetch i međuspremnik registara.

Tipovi podataka Modbus

Tipovi podataka Modbus u skriptama TapHome — Int16, Uint16, Int32, UInt32, Float, Bool, String i 64-bitni Int64, UInt64 i Double — s inačicama big-endian, little-endian i zamjenom bajtova.

Funkcije Packet parsera

Funkcije Packet parsera u skripti TapHome — HTTPREQUEST, SENDHTTPREQUEST, SENDDATA, MQTTPUBLISH, FTPDOWNLOAD, FTPUPLOAD, COMPLETESERVICEATTRIBUTE i COMPLETESERVICEACTION — za HTTP, TCP, UDP, MQTT i FTP.

Listener skripte

Listener skripte Packet parsera u sustavu TapHome — obrada dolaznih poruka TCP, UDP i MQTT pomoću RECEIVEDMSG (tema, sadržaj, protokol) i starije zbirke bajtova RECEIVEDBYTES.

Primjeri skripti

Cjelovite skripte TapHome: sigurno dijeljenje, 0 umjesto nepoznate vrijednosti, zatamnjivanje funkcijom LINEAR, alarmi i servisni atributi Modbus, HTTP i JSON, MQTT listener i Wake on LAN.

Pogreške skripti i rješavanje problema

Poruke o pogreškama skripti TapHome navedene doslovno — Division by zero, pogreške raščlambe, pogreške pri izvršavanju te pogreške konteksta i verzije — s uzrokom i rješenjem svake.

Zahtjevi skripti za verziju

Koji build jedinice TapHome Core treba pojedina funkcija i mogućnost skripte, u kanalima Official i Next, i što znače napomene Dostupno uz opise funkcija.

Funkcije skripti od A do Ž

Sve funkcije skripte TapHome abecednim redom, svaka sa sažetkom u jednom retku i poveznicom na potpuni opis.