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, MINSTRICT, MAXSTRICT mit mehr als 2 Argumenten | 2020.2.19753 | 2020.2.17801 |
POWER, MOD, ABS, CEIL, FLOOR, RAND, RANDINT, SIGN, SQRT, LN, LOG mit einem 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, 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, AVGSTRICT, EQUALS, "base64" in ENCODE und DECODE | 2022.2.26510 | 2022.2.25229 |
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.28594 |
RECEIVEDMSG in Listener-Skripten, Typen receivedmessage und blob (RECEIVEDBYTES funktioniert auf älteren Builds) | 2024.1.30000 | 2024.1.29767 |
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 | — | Core 2026.1.40595, App 2026.1.40665 |
Funktionen ohne Anforderung
IF, SWITCH, RETURN, SLEEP, ROUND, LINEAR, MODBUSR, MODBUSW, MODBUSWNE und die acht Sortierfunktionen funktionieren auf jeder unterstützten Core-Version.
Änderungen in Core 2026.1
- Die Modbus-Blockfunktionen kamen mit Core 2026.1, Build 39001; die App benötigt Build 39016 oder neuer.
- Ab Core 2026.1, Build 40661, richten sich die Bitfunktionen nach der Breite des Typs des Wertes. Ä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.
- Vor Core 2026.1, Build 40661, haben
MODBUSWundMODBUSWNEbeiInt32undUInt32dasByteSwapignoriert.
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, Build N | Core und App benötigen mindestens diesen Build. | 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.