Wymagania wersji skryptów
Której kompilacji TapHome Core wymaga każda funkcja i właściwość skryptów, w kanałach Official i Next, oraz co oznaczają wiersze Dostępność przy opisach funkcji.
Funkcja skryptowa działa tylko na TapHome Core, który ją zna, i musi ją znać także edytor skryptu w aplikacji. Na starszym Core nowsza funkcja jest błędem parsowania: X function not supported. Please update your core unit to be able to use this feature.
Kompilacje i kanały wydań
TapHome jest wydawany w dwóch kanałach, Official i Next; nowe funkcje trafiają najpierw do Next. Wersja jest zapisywana jako rok.wydanie.kompilacja, więc 2026.1.40599 to Core 2026.1, kompilacja 40599. Tabele podają pierwszą znaną kompilację każdego kanału, która zawiera daną funkcję, więc są to dolne granice. Wszystko starsze niż mniej więcej 2020.2 działa na każdym obsługiwanym Core.
Wymagania według funkcji
Zarówno Core, jak i aplikacja potrzebują co najmniej podanej kompilacji. Myślnik oznacza, że funkcja nie jest jeszcze w wydaniu Official.
| Funkcje i właściwości | Official od | Next od |
|---|---|---|
DEWPOINT, LENGTH | 2020.1.17170 | 2020.2.17347 |
MIN, MAX z więcej niż 2 argumentami | 2020.1.17170 | 2020.2.17347 |
POWER, MOD, ABS, CEIL, FLOOR, RAND, RANDINT, SIGN, SQRT, LN, LOG z jednym argumentem | 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 z DEFAULT działającym jak BOUNDS (starsze kompilacje ekstrapolują jak 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" w ENCODE i DECODE | 2022.2.26510 | 2022.2.25293 |
APPEND, INSERT, REMOVEAT, GETAT, SETAT, SPLIT, COMPARE, NOW, DATETIME, DATETIMEADD, TIMESPAN, LOCALTIMEZONE, HTTPREQUEST, deklaracje zmiennych z typem, kolekcje | 2022.2.26510 | 2022.2.26151 |
HSVTORGB, RGBTOHSV, typy rgbcolor i hsvcolor | 2023.1.28093 | 2022.3.27019 |
Typ timespan w deklaracji z typem | 2023.2.29271 | 2023.2.28612 |
RECEIVEDMSG w skryptach listener, typy receivedmessage i blob (RECEIVEDBYTES działa na starszych kompilacjach) | 2024.1.30000 | 2024.1.29767 |
MINSTRICT, MAXSTRICT, AVGSTRICT i osiem funkcji sortowania | 2024.2.30946 | 2024.2.30708 |
DEBOUNCE, typy groupvalue, currentvalueinfo i historyvalues | — | 2026.1.36599 |
MODBUSRBLOCK, MODBUSWBLOCK, MODBUSWBLOCKNE, UNPACKVALUE, PACKVALUE, UINT16COLLECTION, BOOLCOLLECTION | — | 2026.1.39016 |
| Zmienne modułu z typem kolekcji | — | 2026.1.39507 |
Typy danych Modbus Int64, UInt64 i Double | — | 2026.1.40665 |
AESENCRYPT, AESDECRYPT, HASH, HMAC, RANDBYTES, TOBASE64, FROMBASE64, TOHEX, FROMHEX, CRC16, CRC32 | — | 2026.1.40991 |
Funkcje bez wymagań
IF, SWITCH, RETURN, SLEEP, ROUND, LINEAR, MODBUSR, MODBUSW i MODBUSWNE działają na każdym obsługiwanym Core.
Zmiany w Core 2026.1
- Blokowe funkcje Modbus — wymagana wersja: TapHome Next 2026.1.39016+.
- Funkcje bitowe uwzględniają szerokość typu wartości; wymagana wersja: TapHome Next 2026.1.40665+. Starsze kompilacje traktują każdą wartość jako 32-bitową: wartość 64-bitowa traci górną połowę, a bit powyżej typu 8- lub 16-bitowego odczytuje się jako 0.
MODBUSWiMODBUSWNEuwzględniająByteSwapdlaInt32iUInt32; wymagana wersja: TapHome Next 2026.1.40665+, starsze kompilacje go ignorują.
Uwagi o wersji i kontekście
Opis funkcji kończy się wierszem Dostępność, gdy funkcja wymaga nowszego Core lub działa tylko w niektórych skryptach:
| Uwaga | Znaczenie | Błąd w przeciwnym razie |
|---|---|---|
| Core 2026.1 lub nowszy; TapHome Next 2026.1.N+ | Core i aplikacja wymagają co najmniej tego wydania; funkcja, którą na razie ma tylko TapHome Next, podaje pierwszą kompilację tego kanału. | X function not supported. Please update your core unit to be able to use this feature. |
| Tylko skrypty Modbus | Skrypty modułów i urządzeń Modbus: odczyt, zapis, inicjalizacja, atrybuty serwisowe i akcje serwisowe. | ModbusFunction - unknown modbus device to work with |
| Tylko skrypty Packet parser | Skrypty Packet parser modułu z pasującym protokołem (HTTP, TCP, UDP, MQTT lub FTP). | PacketParserFunction - PacketParserContext is null; przy innym protokole PacketParserFunction - unable to use 'X' with Y |
| Tylko skrypty urządzeń | Skrypty urządzeń Modbus i Packet parser, nigdy smart rules; opis wymienia, o które skrypty chodzi. | X function not supported here. |
Pełna lista komunikatów jest na stronie Błędy.