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, MINSTRICT, MAXSTRICT z więcej niż 2 argumentami | 2020.2.19753 | 2020.2.17801 |
POWER, MOD, ABS, CEIL, FLOOR, RAND, RANDINT, SIGN, SQRT, LN, LOG z jednym argumentem | 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 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, AVGSTRICT, EQUALS, "base64" w ENCODE i DECODE | 2022.2.26510 | 2022.2.25229 |
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.28594 |
RECEIVEDMSG w skryptach listener, typy receivedmessage i blob (RECEIVEDBYTES działa na starszych kompilacjach) | 2024.1.30000 | 2024.1.29767 |
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 | — | Core 2026.1.40595, aplikacja 2026.1.40665 |
Funkcje bez wymagań
IF, SWITCH, RETURN, SLEEP, ROUND, LINEAR, MODBUSR, MODBUSW, MODBUSWNE i osiem funkcji sortowania działają na każdym obsługiwanym Core.
Zmiany w Core 2026.1
- Blokowe funkcje Modbus zostały wydane w Core 2026.1, kompilacji 39001; aplikacja wymaga kompilacji 39016 lub nowszej.
- Od Core 2026.1, kompilacji 40661, funkcje bitowe uwzględniają szerokość typu wartości. 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.
- Przed Core 2026.1, kompilacją 40661,
MODBUSWiMODBUSWNEignorowałyByteSwapdlaInt32iUInt32.
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, kompilacja N | Core i aplikacja wymagają co najmniej tej kompilacji. | 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.