Requisiti di versione degli script
Quale build del Core TapHome richiede ciascuna funzione e caratteristica degli script, nei canali Official e Next, e che cosa significano le note Disponibile nelle voci delle funzioni.
Una funzione degli script funziona solo su un Core TapHome che la conosce, e deve conoscerla anche l’editor degli script nell’app. Su un Core più vecchio una funzione più recente è un errore di parsing: X function not supported. Please update your core unit to be able to use this feature.
Build e canali di rilascio
TapHome viene rilasciato in due canali, Official e Next; le nuove funzionalità arrivano prima in Next. Una versione si scrive come anno.release.build, quindi 2026.1.40599 è Core 2026.1, build 40599. Le tabelle indicano la prima build di ciascun canale nota per contenere una funzionalità, quindi sono limiti inferiori. Tutto ciò che è più vecchio di circa 2020.2 funziona su ogni Core supportato.
Requisiti per funzione
Sia il Core sia l’app richiedono almeno la build indicata. Un trattino significa che la funzionalità non è ancora in una release Official.
| Funzioni e funzionalità | Official da | Next da |
|---|---|---|
DEWPOINT, LENGTH | 2020.1.17170 | 2020.2.17347 |
MIN, MAX con più di 2 argomenti | 2020.1.17170 | 2020.2.17347 |
POWER, MOD, ABS, CEIL, FLOOR, RAND, RANDINT, SIGN, SQRT, LN, LOG con un argomento | 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 con DEFAULT che si comporta come BOUNDS (le build più vecchie estrapolano come 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 e DECODE | 2022.2.26510 | 2022.2.25293 |
APPEND, INSERT, REMOVEAT, GETAT, SETAT, SPLIT, COMPARE, NOW, DATETIME, DATETIMEADD, TIMESPAN, LOCALTIMEZONE, HTTPREQUEST, dichiarazioni di variabili tipizzate, collezioni | 2022.2.26510 | 2022.2.26151 |
HSVTORGB, RGBTOHSV, tipi rgbcolor e hsvcolor | 2023.1.28093 | 2022.3.27019 |
Tipo timespan in una dichiarazione tipizzata | 2023.2.29271 | 2023.2.28612 |
RECEIVEDMSG negli script listener, tipi receivedmessage e blob (RECEIVEDBYTES funziona sulle build più vecchie) | 2024.1.30000 | 2024.1.29767 |
MINSTRICT, MAXSTRICT, AVGSTRICT e le otto funzioni di ordinamento | 2024.2.30946 | 2024.2.30708 |
DEBOUNCE, tipi groupvalue, currentvalueinfo e historyvalues | — | 2026.1.36599 |
MODBUSRBLOCK, MODBUSWBLOCK, MODBUSWBLOCKNE, UNPACKVALUE, PACKVALUE, UINT16COLLECTION, BOOLCOLLECTION | — | 2026.1.39016 |
| Variabili del modulo di tipo collezione | — | 2026.1.39507 |
Tipi di dati Modbus Int64, UInt64 e Double | — | 2026.1.40665 |
AESENCRYPT, AESDECRYPT, HASH, HMAC, RANDBYTES, TOBASE64, FROMBASE64, TOHEX, FROMHEX, CRC16, CRC32 | — | 2026.1.40991 |
Funzioni senza requisiti
IF, SWITCH, RETURN, SLEEP, ROUND, LINEAR, MODBUSR, MODBUSW e MODBUSWNE funzionano su ogni Core supportato.
Modifiche in Core 2026.1
- Le funzioni Modbus a blocchi richiedono TapHome Next 2026.1.39016+.
- Le funzioni sui bit seguono la larghezza del tipo del valore; ciò richiede TapHome Next 2026.1.40665+. Le build più vecchie trattano ogni valore come a 32 bit: un valore a 64 bit perde la metà superiore, e un bit oltre un tipo a 8 o 16 bit viene letto come 0.
MODBUSWeMODBUSWNErispettanoByteSwapperInt32eUInt32; ciò richiede TapHome Next 2026.1.40665+, le build più vecchie lo ignorano.
Note di versione e di contesto
La voce di una funzione termina con una riga Disponibile quando la funzione richiede un Core più recente o funziona solo in alcuni script:
| Nota | Significato | Errore altrimenti |
|---|---|---|
| Core 2026.1 o più recente; TapHome Next 2026.1.N+ | Il Core e l’app richiedono almeno questa versione; una funzionalità che per ora ha solo TapHome Next indica la prima build di quel canale. | X function not supported. Please update your core unit to be able to use this feature. |
| Solo script Modbus | Script dei moduli e dei dispositivi Modbus: lettura, scrittura, inizializzazione, attributi di servizio e azioni di servizio. | ModbusFunction - unknown modbus device to work with |
| Solo script Packet parser | Script Packet parser di un modulo con il protocollo corrispondente (HTTP, TCP, UDP, MQTT o FTP). | PacketParserFunction - PacketParserContext is null; con un altro protocollo PacketParserFunction - unable to use 'X' with Y |
| Solo script dei dispositivi | Script dei dispositivi Modbus e Packet parser, mai smart rule; la voce indica gli script. | X function not supported here. |
L’elenco completo dei messaggi si trova in Errori.