Kifejezések / Szkriptnyelv

A TapHome egyetlen szkriptnyelvet használ a smart rule-okhoz, az értesítésekhez és az eszközintegrációkhoz. A szintaxis és a függvények mindenhol azonosak; csak az elérhető változók, konstansok és függvények függnek attól, hol fut a szkript. Az alkalmazás a szkriptszerkesztőben kiemeli a szintaxist.

Hol használhatók a szkriptek

Ugyanaz a szkriptnyelv fut a smart rule-okban, az értesítésekben, valamint a Modbus és a Packet parser integrációban:

Környezet	Mit csinál a szkript	Mi jellemző a környezetre
Egyenlet smart rule	Egyetlen kifejezés az eszközök értékei felett. `TRUE` esetén az igaz műveletek, `FALSE` esetén a hamis műveletek futnak le.	`LastState`, `TriggerName`
Képlet smart rule	Kiszámít egy értéket, amely minden kimeneti eszközbe beíródik.	`LastState`, `TriggerName`
Szkript smart rule	Beolvassa az eszközök értékeit és újakat rendel hozzájuk; minden értékadásból az eszköz egy művelete lesz.	Olvasható/írható változók, `TriggerName`
Képlet korlátozó feltétel	Eldönti, hogy a smart rule lefuthat-e.	`TRUE` engedi lefutni a szabályt
Értesítés címe és üzenete	Összeállítja az értesítés szövegét.	Szöveget kell visszaadnia; az értesítés konstansai
Modbus modul olvasó szkriptje	Lekérdezi a modult, jellemzően azért, hogy eszközhibákat jelezzen.	`MODBUS*` függvények
Modbus eszköz olvasó és író szkriptje	A regiszterekből az eszköz értékét állítja elő, a kért értéket pedig visszaalakítja regiszterekké.	Az olvasás eredményéből lesz az eszköz értéke
Modbus inicializáló szkript	Egyszer fut le, miután a modul csatlakozott.	Jellemzően `MODBUSWNE`
Packet parser olvasó és író szkriptek	Kérést vagy parancsot küld HTTP, FTP, TCP, UDP vagy MQTT protokollon; HTTP és FTP esetén a választ is feldolgozza.	`SENDHTTPREQUEST`, `SENDDATA`, `MQTTPUBLISH`
Packet parser listener szkript	Feldolgoz minden beérkező TCP- vagy UDP-csomagot és MQTT-üzenetet.	`RECEIVEDMSG`
Szolgáltatási attribútumok és szolgáltatási műveletek (Modbus, Packet parser)	Diagnosztikai sorok és paraméterezhető gombok az alkalmazásban.	A művelet paraméterei a rövidítésük alapján

A SLEEP függvényt a smart rule-ok és az értesítések elutasítják (kivétel a Képlet korlátozó feltétel). Az ADDERROR, ADDWARNING és ADDINFO csak az eszközök szkriptjeiben működik. Hogy az egyes smart rule-ok mit adnak át a szkriptjüknek, azt a Szkriptek a smart rule-okban és az értesítésekben oldal írja le; az integrációknak saját oldaluk van: Modbus függvények és Packet parser függvények.

A szkript eredménye

A szkript utasítások listája. Az utoljára kiértékelt utasítás értéke a szkript eredménye. A RETURN a megadott értékkel idő előtt befejezi a szkriptet.

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

Az eszköz olvasó szkriptjének eredménye illeszkedjen az eszköz értékéhez, különben a szkript a Return value 'X' does not match required return type constraint hibával leáll:

Az eszköz értéke	Megengedett eredmény
Kapcsoló állapota, reed érintkező	`TRUE` vagy `FALSE` (számokat is elfogad), `NaN`, `Null`
Többállású kapcsoló állapota	Szám (az egész szám választja ki az állapotot; a tizedes értéket nem utasítja el), `NaN`, `Null`
Bármely más érték	Szám, `NaN`, `Null`

A NaN jelentése „az érték ismeretlen”, a Null jelentése „nincs érték”. Hogy a kettő hogyan viselkedik a kifejezésekben, azt a Null és NaN szakasz írja le.

A szakasz oldalai

A szkriptnyelv referenciája négy oldalcsoportból áll: útmutató a nyelvhez, a függvények területenként, az integrációs függvények és a referencialisták.

Útmutató

Szintaxis és vezérlési szerkezetek — utasítások, megjegyzések, literálok, IF, SWITCH, WHILE és DO ciklusok, RETURN.
Adattípusok — számok, szöveg, strukturált és felsorolt típusok, gyűjtemények, .Type, típuskiterjesztés, Null és NaN.
Változók és konstansok — eszközváltozók, Value info, modulváltozók, VAR és típusos deklarációk, tulajdonságok, a környezet konstansai.
Operátorok — az operátorok listája, precedencia, rövidzáras kiértékelés, Excel megfelelők.
Szkriptek a smart rule-okban és az értesítésekben — Egyenlet, Képlet, Szkript, a Képlet korlátozó feltétel és az értesítések.

Függvények

Logika és diagnosztika — ISNULL, ISNAN, EQUALS, SLEEP, ADDERROR, ADDWARNING, ADDINFO, DEBOUNCE.
Matematikai függvények — MIN, MAX, AVG (kihagyják az ismeretlen értékeket, a …STRICT változatok nem), ABS, SIGN, SQRT, POWER, MOD, LOG, LN, DEWPOINT.
Kerekítés és véletlenszámok — ROUND, CEIL, FLOOR, RAND, RANDINT.
Interpoláció és küszöbértékek — a LINEAR egy értéket az egyik tartományból a másikba képez le (például egy fényerő-szabályozási görbe), HYSTERESIS.
Bitműveletek — GETBIT, GETBITS, SETBIT, SETBITS, GETBYTE, SETBYTE, TOBCD, FROMBCD.
Szöveg és gyűjtemények — LENGTH, GETAT, SETAT, APPEND, INSERT, REMOVEAT, COPY, INDEXOF, REPLACE, SPLIT, COMPARE, BYTECOLLECTION, UINT16COLLECTION, BOOLCOLLECTION.
Rendezés — ORDER, ORDERINDEX és ezek csökkenő és szigorú változatai.
Dátum és idő — NOW, DATETIME, DATETIMEADD, TIMESPAN, LOCALTIMEZONE.
Adattípusok konverziója — TOSTRING, TODOUBLE, TOBYTES, ENCODE, DECODE.
Színek — HSVTORGB, RGBTOHSV.
Elemző függvények — PARSETEXT, PARSEJSON (értéket olvas ki a JSON-ból az útvonala alapján), PARSEXML.
Bináris adatok — PACKVALUE, UNPACKVALUE.

Integrációk

Modbus függvények — regisztertípusok, MODBUSR, MODBUSW, MODBUSWNE, MODBUSRBLOCK, MODBUSWBLOCK, MODBUSWBLOCKNE.
Modbus adattípusok — a Modbus függvények adattípusai, bájtsorrend-változatok, 64 bites típusok, szöveg.
Modbus szkriptek és prefetch — milyen szkriptjei vannak egy Modbus modulnak és eszköznek, mikor futnak, prefetch és gyorsítótárazás.
Packet parser függvények — HTTPREQUEST, SENDHTTPREQUEST, SENDDATA, MQTTPUBLISH, FTPDOWNLOAD, FTPUPLOAD, COMPLETESERVICEATTRIBUTE, COMPLETESERVICEACTION.
Listener szkriptek — a Packet parser modul listener szkriptje, RECEIVEDMSG és RECEIVEDBYTES.

Referencia

Szkriptpéldák — teljes szkriptek valódi eszközsablonokból.
Szkripthibák és hibaelhárítás — elemzési és futásidejű hibaüzenetek és a javításuk.
A szkriptek verziókövetelményei — melyik Core buildre van szüksége az egyes függvényeknek.
Szkriptfüggvények A–Z — minden függvény egy mondattal és hivatkozással.

Szintaxis és vezérlési szerkezetek

A TapHome szkriptnyelv szintaxisa: utasítások és pontosvesszők, megjegyzések, literálok, az IF függvény- és blokkformája, SWITCH, WHILE és DO ciklusok, BREAK, CONTINUE és RETURN.

Adattípusok

A TapHome szkriptnyelv adattípusai: számok, szöveg, strukturált és felsorolt típusok, gyűjtemények, a .Type tulajdonság, típuskiterjesztés az aritmetikában, valamint a Null és a NaN viselkedése.

Változók és konstansok

Változók a TapHome szkriptekben: az eszközök értékei rövidítés alapján, Value info, csoportértékek, modul- és eszközváltozók, VAR és típusos deklarációk, értékadás, tulajdonságok és a környezet konstansai.

Operátorok

A TapHome szkriptnyelv operátorai: aritmetikai, összehasonlító, bitenkénti és logikai operátorok, a 10 precedenciaszint, az a & 1 > 0 csapda, a rövidzáras kiértékelés és az Excel megfelelők.

Szkriptek a smart rule-okban és az értesítésekben

Mit ad át a szkriptnek az Egyenlet, a Képlet és a Szkript smart rule, a Képlet korlátozó feltétel és az értesítések szkriptje, és mit kezdenek az eredményével: LastState, TriggerName, kimenetek, hibák és SLEEP.

Logika és diagnosztika

TapHome szkriptfüggvények az ismeretlen értékekhez és az eszközök diagnosztikájához: ISNULL, ISNAN, EQUALS, SLEEP, ADDERROR, ADDWARNING, ADDINFO és DEBOUNCE.

Matematikai függvények

A TapHome szkript matematikai függvényei — MIN, MAX, AVG és ezek STRICT változatai, ABS, SIGN, SQRT, POWER, MOD, LOG, LN és DEWPOINT.

Kerekítés és véletlenszámok

TapHome szkriptfüggvények a kerekítéshez és a véletlenszámokhoz — ROUND, CEIL és FLOOR adott pontossággal, RAND és RANDINT.

Interpoláció és küszöbértékek

A LINEAR lineáris interpoláció és a HYSTERESIS küszöbérték-kapcsolás értékek leképezésére, világítás fényerő-szabályozására és fűtés vezérlésére a TapHome szkriptekben.

Bitműveletek

Bitek és bájtok kezelése a TapHome szkriptben — GETBIT, GETBITS, SETBIT, SETBITS, GETBYTE, SETBYTE, TOBCD, FROMBCD, bitszélesség típus szerint és bitenkénti operátorok Excel megfelelőkkel.

Szöveg és gyűjtemények

TapHome szkriptfüggvények szövegekhez, gyűjteményekhez és bájttömbökhöz — LENGTH, GETAT, SETAT, APPEND, INSERT, REMOVEAT, COPY, INDEXOF, REPLACE, SPLIT, COMPARE, BYTECOLLECTION, UINT16COLLECTION, BOOLCOLLECTION.

Rendezés

A TapHome szkript rendezőfüggvényei — ORDER, ORDERINDEX és ezek STRICT és csökkenő változatai az értékek rendezésére vagy a rendezési sorrend indexeinek visszaadására.

Dátum és idő

A TapHome szkript dátum- és időfüggvényei — NOW, DATETIME, DATETIMEADD, TIMESPAN és LOCALTIMEZONE —, valamint a datetime és timespan értékek tulajdonságai.

Adattípus-konverziók

TapHome szkript konverziós függvények — TOSTRING szám- és dátumformátum-karakterláncokkal, TODOUBLE, TOBYTES, valamint ENCODE / DECODE XML-escapeléshez és Base64-hez.

Színek

TapHome szkript színfüggvények — HSVTORGB és RGBTOHSV —, valamint az rgbcolor és hsvcolor értéktípusok, amelyekkel RGB lámpákat vezérelhetsz Packet parser és Modbus szkriptekből.

Elemző függvények

TapHome szkript elemző függvények — PARSETEXT a minták közötti szöveghez, PARSEJSON JSONPath-szal és PARSEXML XPath-szal — értékek kiolvasásához az eszközök válaszaiból.

Bináris adatok

PACKVALUE és UNPACKVALUE TapHome szkriptfüggvények — típusos értékek olvasása és írása regiszter- és bájtgyűjteményekben, big-endian, little-endian és bájtcserés sorrendben.

Modbus függvények

TapHome szkript Modbus függvények — MODBUSR, MODBUSW, MODBUSWNE és a MODBUSRBLOCK, MODBUSWBLOCK, MODBUSWBLOCKNE blokkfüggvények —, valamint a C, D, H és A Modbus regisztertípusok.

Modbus szkriptek és prefetch

A TapHome Modbus modul és eszköz szkriptjei — inicializáló, olvasó, érték olvasó, érték író szkript, szolgáltatási attribútumok és szolgáltatási műveletek —, és hogyan hat rájuk a prefetch és a regiszter-gyorsítótár.

Modbus adattípusok

Modbus adattípusok a TapHome szkriptekben — Int16, Uint16, Int32, UInt32, Float, Bool, String és a 64 bites Int64, UInt64 és Double — big-endian, little-endian és bájtcserés változatokkal.

Packet parser függvények

TapHome szkript Packet parser függvények — HTTPREQUEST, SENDHTTPREQUEST, SENDDATA, MQTTPUBLISH, FTPDOWNLOAD, FTPUPLOAD, COMPLETESERVICEATTRIBUTE és COMPLETESERVICEACTION — HTTP, TCP, UDP, MQTT és FTP kommunikációhoz.

Listener szkriptek

TapHome Packet parser listener szkriptek — a bejövő TCP, UDP és MQTT üzenetek feldolgozása a RECEIVEDMSG (topic, payload, protokoll) és a régebbi RECEIVEDBYTES bájtgyűjtemény segítségével.

Szkriptpéldák

Teljes TapHome szkriptek: biztonságos osztás, 0 ismeretlen érték helyett, fényerő-szabályozás LINEAR-ral, Modbus riasztások és szolgáltatási attribútumok, HTTP és JSON, MQTT listener és Wake on LAN.

Szkripthibák és hibaelhárítás

A TapHome szkript hibaüzenetei szó szerint idézve — Division by zero, elemzési hibák, futásidejű hibák, valamint környezeti és verzióhibák — mindegyik okával és javításával.

Szkript verziókövetelmények

Melyik TapHome Core buildet igényli az egyes szkriptfüggvények és funkciók az Official és a Next csatornán, és mit jelentenek a függvényleírások Elérhetőség megjegyzései.

Szkriptfüggvények A–Z

A TapHome szkript összes függvénye ábécérendben, egysoros összefoglalóval és a teljes leírásra mutató hivatkozással.