Script version requirements
Which TapHome Core build each script function and feature needs, in the Official and Next channels, and what the Available notes on function entries mean.
A script function works only on a TapHome Core that knows it, and the script editor in the app must know it too. On an older Core a newer function is a parse error: X function not supported. Please update your core unit to be able to use this feature.
Builds and release channels
TapHome is released in two channels, Official and Next; new features reach Next first. A version is written as year.release.build, so 2026.1.40599 is Core 2026.1, build 40599. The tables give the first build of each channel known to contain a feature, so they are lower bounds. Anything older than about 2020.2 works on every supported Core.
Requirements by function
Both the Core and the app need at least the listed build. A dash means that the feature is not in an Official release yet.
| Functions and features | Official from | Next from |
|---|---|---|
DEWPOINT, LENGTH | 2020.1.17170 | 2020.2.17347 |
MIN, MAX, MINSTRICT, MAXSTRICT with more than 2 arguments | 2020.2.19753 | 2020.2.17801 |
POWER, MOD, ABS, CEIL, FLOOR, RAND, RANDINT, SIGN, SQRT, LN, LOG with one argument | 2020.1.17609 | 2020.2.18753 |
ISNAN, ADDERROR, ADDWARNING, ADDINFO, TOBCD, FROMBCD, GETBIT, GETBITS, SETBIT, SETBITS, GETBYTE, SETBYTE, TOSTRING, REPLACE, ENCODE, DECODE | 2022.1.24169 | 2021.4.22941 |
HYSTERESIS | 2022.1.24169 | 2021.4.23800 |
LINEAR with DEFAULT behaving as BOUNDS (older builds extrapolate like INFINITE) | 2022.2.26510 | 2022.2.25053 |
PARSETEXT, PARSEJSON, PARSEXML, TODOUBLE, TOBYTES, ISNULL, BYTECOLLECTION, INDEXOF, COPY, SENDHTTPREQUEST, SENDDATA, MQTTPUBLISH, FTPDOWNLOAD, FTPUPLOAD, COMPLETESERVICEATTRIBUTE, COMPLETESERVICEACTION | 2022.2.26510 | 2022.2.25053 |
AVG, AVGSTRICT, EQUALS, "base64" in ENCODE and DECODE | 2022.2.26510 | 2022.2.25229 |
APPEND, INSERT, REMOVEAT, GETAT, SETAT, SPLIT, COMPARE, NOW, DATETIME, DATETIMEADD, TIMESPAN, LOCALTIMEZONE, HTTPREQUEST, typed variable declarations, collections | 2022.2.26510 | 2022.2.26151 |
HSVTORGB, RGBTOHSV, types rgbcolor and hsvcolor | 2023.1.28093 | 2022.3.27019 |
Type timespan in a typed declaration | 2023.2.29271 | 2023.2.28594 |
RECEIVEDMSG in listener scripts, types receivedmessage and blob (RECEIVEDBYTES works on older builds) | 2024.1.30000 | 2024.1.29767 |
DEBOUNCE, types groupvalue, currentvalueinfo and historyvalues | — | 2026.1.36599 |
MODBUSRBLOCK, MODBUSWBLOCK, MODBUSWBLOCKNE, UNPACKVALUE, PACKVALUE, UINT16COLLECTION, BOOLCOLLECTION | — | 2026.1.39016 |
| Collection-typed module variables | — | 2026.1.39507 |
Modbus data types Int64, UInt64 and Double | — | Core 2026.1.40595, app 2026.1.40665 |
Functions without a requirement
IF, SWITCH, RETURN, SLEEP, ROUND, LINEAR, MODBUSR, MODBUSW, MODBUSWNE and the eight sorting functions work on every supported Core.
Changes in Core 2026.1
- The block Modbus functions were released in Core 2026.1, build 39001; the app needs build 39016 or newer.
- From Core 2026.1, build 40661, the bit functions follow the width of the value’s type. Older builds treat every value as 32 bits: a 64-bit value loses its upper half, and a bit above an 8- or 16-bit type reads as 0.
- Before Core 2026.1, build 40661,
MODBUSWandMODBUSWNEignoredByteSwapforInt32andUInt32.
Version and context notes
A function entry ends with an Available line when the function needs a newer Core or works only in some scripts:
| Note | Meaning | Error otherwise |
|---|---|---|
| Core 2026.1, build N | The Core and the app need at least this build. | X function not supported. Please update your core unit to be able to use this feature. |
| Modbus scripts only | Modbus module and device scripts: read, write, initialize, service attributes and service actions. | ModbusFunction - unknown modbus device to work with |
| Packet parser scripts only | Packet parser scripts of a module with a matching protocol (HTTP, TCP, UDP, MQTT or FTP). | PacketParserFunction - PacketParserContext is null; with another protocol PacketParserFunction - unable to use 'X' with Y |
| Device scripts only | Scripts of Modbus and Packet parser devices, never smart rules; the entry names the scripts. | X function not supported here. |
The full list of messages is in Errors.