Versionsanforderungen der Skripte
Welchen Build der TapHome Core jede Skriptfunktion und jedes Merkmal in den Kanälen Official und Next benötigt und was die Vermerke Verfügbar bei den Funktionen bedeuten.
Eine Skriptfunktion funktioniert nur auf einem TapHome Core, der sie kennt, und auch der Skripteditor in der App muss sie kennen. Auf einer älteren Core-Version ist eine neuere Funktion ein Parserfehler: X function not supported. Please update your core unit to be able to use this feature.
Builds und Release-Kanäle
TapHome erscheint in zwei Kanälen, Official und Next; neue Funktionen kommen zuerst in Next. Eine Version wird als year.release.build (Jahr, Release, Build) geschrieben, 2026.1.40599 ist also Core 2026.1, Build 40599. Die Tabellen nennen den ersten Build jedes Kanals, von dem bekannt ist, dass er ein Merkmal enthält; es sind also Untergrenzen. Alles, was älter als etwa 2020.2 ist, funktioniert auf jeder unterstützten Core-Version.
Anforderungen nach Funktion
Sowohl Core als auch App benötigen mindestens den angegebenen Build. Ein Strich bedeutet, dass das Merkmal noch in keinem Official-Release enthalten ist.
| Funktionen und Merkmale | Official ab | Next ab |
|---|---|---|
DEWPOINT, LENGTH | 2020.1.17170 | 2020.2.17347 |
MIN, MAX mit mehr als 2 Argumenten | 2020.1.17170 | 2020.2.17347 |
POWER, MOD, ABS, CEIL, FLOOR, RAND, RANDINT, SIGN, SQRT, LN, LOG mit einem Argument | 2020.1.17668 | 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.23839 |
LINEAR, bei dem sich DEFAULT wie BOUNDS verhält (ältere Builds extrapolieren wie 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, EQUALS, "base64" in ENCODE und DECODE | 2022.2.26510 | 2022.2.25293 |
APPEND, INSERT, REMOVEAT, GETAT, SETAT, SPLIT, COMPARE, NOW, DATETIME, DATETIMEADD, TIMESPAN, LOCALTIMEZONE, HTTPREQUEST, typisierte Variablendeklarationen, Sammlungen | 2022.2.26510 | 2022.2.26151 |
HSVTORGB, RGBTOHSV, Typen rgbcolor und hsvcolor | 2023.1.28093 | 2022.3.27019 |
Typ timespan in einer typisierten Deklaration | 2023.2.29271 | 2023.2.28612 |
RECEIVEDMSG in Listener-Skripten, Typen receivedmessage und blob (RECEIVEDBYTES funktioniert auf älteren Builds) | 2024.1.30000 | 2024.1.29767 |
MINSTRICT, MAXSTRICT, AVGSTRICT und die acht Sortierfunktionen | 2024.2.30946 | 2024.2.30708 |
DEBOUNCE, Typen groupvalue, currentvalueinfo und historyvalues | — | 2026.1.36599 |
MODBUSRBLOCK, MODBUSWBLOCK, MODBUSWBLOCKNE, UNPACKVALUE, PACKVALUE, UINT16COLLECTION, BOOLCOLLECTION | — | 2026.1.39016 |
| Modulvariablen eines Sammlungstyps | — | 2026.1.39507 |
Modbus-Datentypen Int64, UInt64 und Double | — | 2026.1.40665 |
AESENCRYPT, AESDECRYPT, HASH, HMAC, RANDBYTES, TOBASE64, FROMBASE64, TOHEX, FROMHEX, CRC16, CRC32 | — | 2026.1.40991 |
Funktionen ohne Anforderung
IF, SWITCH, RETURN, SLEEP, ROUND, LINEAR, MODBUSR, MODBUSW und MODBUSWNE funktionieren auf jeder unterstützten Core-Version.
Änderungen in Core 2026.1
- Die Modbus-Blockfunktionen erfordern TapHome Next 2026.1.39016+.
- Die Bitfunktionen richten sich nach der Breite des Typs des Wertes; das erfordert TapHome Next 2026.1.40665+. Ältere Builds behandeln jeden Wert als 32 Bit: Ein 64-Bit-Wert verliert seine obere Hälfte, und ein Bit oberhalb eines 8- oder 16-Bit-Typs wird als 0 gelesen.
MODBUSWundMODBUSWNEberücksichtigenByteSwapbeiInt32undUInt32; das erfordert TapHome Next 2026.1.40665+, ältere Builds ignorieren es.
Versions- und Kontextvermerke
Ein Funktionseintrag endet mit einer Zeile Verfügbar, wenn die Funktion eine neuere Core-Version benötigt oder nur in einigen Skripten funktioniert:
| Vermerk | Bedeutung | Fehler andernfalls |
|---|---|---|
| Core 2026.1 oder neuer; TapHome Next 2026.1.N+ | Core und App benötigen mindestens dieses Release; ein Merkmal, das bisher nur TapHome Next hat, nennt den ersten Build dieses Kanals. | X function not supported. Please update your core unit to be able to use this feature. |
| Nur Modbus-Skripte | Skripte von Modbus-Modulen und -Geräten: Lesen, Schreiben, Initialisierung, Service-Attribute und Service-Aktionen. | ModbusFunction - unknown modbus device to work with |
| Nur Packet-Parser-Skripte | Packet-Parser-Skripte eines Moduls mit passendem Protokoll (HTTP, TCP, UDP, MQTT oder FTP). | PacketParserFunction - PacketParserContext is null; bei einem anderen Protokoll PacketParserFunction - unable to use 'X' with Y |
| Nur Geräteskripte | Skripte von Modbus- und Packet-Parser-Geräten, nie smart rules; der Eintrag nennt die Skripte. | X function not supported here. |
Die vollständige Liste der Meldungen finden Sie unter Fehler.