Expressions / Script Language

Multi-line scripting language with syntax highlighting, usable in smart rules Equation, Formula and Script, and also in Modbus and Packet parser interfaces.

Reference

The script language reference is organized into the following pages:

Basics — association, multi-line algorithms, returned value, temporary variables, IF/ELSEIF/ELSE, SWITCH, loops, NaN, ISNULL, SLEEP, comments, numeric literals (hexadecimal and binary), and mathematical/logical expressions and operators.
Interpolation and thresholds — LINEAR (linear interpolation) and HYSTERESIS (threshold-based signal filtering).
Mathematical functions — MIN, MAX, AVG (and their STRICT variants), ROUND, ABS, DEWPOINT, POWER, MOD, CEIL, FLOOR, RAND, RANDINT, SIGN, SQRT, LOG, LN.
Bit operations — GETBIT, GETBITS, GETBYTE, SETBYTE, SETBIT, SETBITS, bit shifts, and bitwise AND/OR.
Text, String and Byte array — LENGTH, BYTECOLLECTION, INDEXOF, COPY, REPLACE, SPLIT, COMPARE, APPEND, INSERT, REMOVEAT, GETAT, SETAT, ENCODE, DECODE, EQUALS.
Sorting — ORDER, ORDERINDEX and their STRICT and descending variants.
Date and time — DATETIME, NOW, TIMESPAN, LOCALTIMEZONE, DATETIMEADD.
Data type conversions — TODOUBLE, TOSTRING, TOBCD, FROMBCD, TOBYTEARRAY, RGBTOHSV, HSVTORGB.
Parsing functions — PARSETEXT, PARSEJSON, PARSEXML.
Packet parser — SENDHTTPREQUEST, SENDDATA, MQTTPUBLISH, FTPDOWNLOAD, FTPUPLOAD, COMPLETESERVICEATTRIBUTE, COMPLETESERVICEACTION, plus Modbus.

Basics

Core syntax of the TapHome scripting language — association, multi-line algorithms, return values, variables, IF/ELSE, SWITCH, loops, NaN, comments, numeric literals, and mathematical/logical expressions.

Interpolation and thresholds

LINEAR linear interpolation and HYSTERESIS threshold filtering functions for mapping and conditioning input values in TapHome scripts.

Mathematical functions

TapHome script mathematical functions — MIN, MAX, AVG (and STRICT variants), ROUND, ABS, DEWPOINT, POWER, MOD, CEIL, FLOOR, RAND, RANDINT, SIGN, SQRT, LOG, LN.

Bit operations

TapHome script bit and byte manipulation — GETBIT, GETBITS, GETBYTE, SETBYTE, SETBIT, SETBITS, bit shifts, and bitwise AND/OR operators.

Text, String and Byte array

TapHome script string and collection functions — LENGTH, BYTECOLLECTION, INDEXOF, COPY, REPLACE, SPLIT, COMPARE, APPEND, INSERT, REMOVEAT, GETAT, SETAT, ENCODE, DECODE, EQUALS.

Sorting

TapHome script sorting functions — ORDER, ORDERINDEX and their STRICT and descending variants for sorting values or returning sort-order indexes.

Date and time

TapHome script date and time functions — DATETIME, NOW, TIMESPAN, LOCALTIMEZONE, and DATETIMEADD for creating and manipulating date/time values.

Data type conversions

TapHome script data type conversion functions — TODOUBLE, TOSTRING, TOBCD, FROMBCD, TOBYTEARRAY, RGBTOHSV, and HSVTORGB.

Parsing functions

TapHome script parsing functions — PARSETEXT, PARSEJSON, and PARSEXML for extracting values from text, JSON, and XML data.

Packet parser

TapHome script Packet parser functions — SENDHTTPREQUEST, SENDDATA, MQTTPUBLISH, FTPDOWNLOAD, FTPUPLOAD, COMPLETESERVICEATTRIBUTE, COMPLETESERVICEACTION — plus Modbus configuration.