Cerințe de versiune pentru scripturi
De ce build TapHome Core are nevoie fiecare funcție și facilitate de script, pe canalele Official și Next, și ce înseamnă notele Disponibilitate din descrierile funcțiilor.
O funcție de script funcționează doar pe un TapHome Core care o cunoaște, iar editorul de scripturi din aplicație trebuie să o cunoască și el. Pe un Core mai vechi o funcție mai nouă este o eroare de parsare: X function not supported. Please update your core unit to be able to use this feature.
Build-uri și canale de lansare
TapHome se lansează pe două canale, Official și Next; facilitățile noi ajung mai întâi pe Next. O versiune se scrie ca an.lansare.build, așa că 2026.1.40599 înseamnă Core 2026.1, build 40599. Tabelele dau primul build al fiecărui canal despre care se știe că conține o facilitate, deci sunt limite inferioare. Tot ce este mai vechi de aproximativ 2020.2 funcționează pe orice Core acceptat.
Cerințe după funcție
Atât Core, cât și aplicația au nevoie cel puțin de build-ul indicat. O liniuță înseamnă că facilitatea nu este încă într-o versiune Official.
| Funcții și facilități | Official de la | Next de la |
|---|---|---|
DEWPOINT, LENGTH | 2020.1.17170 | 2020.2.17347 |
MIN, MAX cu mai mult de 2 argumente | 2020.1.17170 | 2020.2.17347 |
POWER, MOD, ABS, CEIL, FLOOR, RAND, RANDINT, SIGN, SQRT, LN, LOG cu un singur 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 cu DEFAULT comportându-se ca BOUNDS (build-urile mai vechi extrapolează ca 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" în ENCODE și DECODE | 2022.2.26510 | 2022.2.25293 |
APPEND, INSERT, REMOVEAT, GETAT, SETAT, SPLIT, COMPARE, NOW, DATETIME, DATETIMEADD, TIMESPAN, LOCALTIMEZONE, HTTPREQUEST, declarații de variabile cu tip, colecții | 2022.2.26510 | 2022.2.26151 |
HSVTORGB, RGBTOHSV, tipurile rgbcolor și hsvcolor | 2023.1.28093 | 2022.3.27019 |
Tipul timespan într-o declarație cu tip | 2023.2.29271 | 2023.2.28612 |
RECEIVEDMSG în scripturile listener, tipurile receivedmessage și blob (RECEIVEDBYTES funcționează pe build-uri mai vechi) | 2024.1.30000 | 2024.1.29767 |
MINSTRICT, MAXSTRICT, AVGSTRICT și cele opt funcții de sortare | 2024.2.30946 | 2024.2.30708 |
DEBOUNCE, tipurile groupvalue, currentvalueinfo și historyvalues | — | 2026.1.36599 |
MODBUSRBLOCK, MODBUSWBLOCK, MODBUSWBLOCKNE, UNPACKVALUE, PACKVALUE, UINT16COLLECTION, BOOLCOLLECTION | — | 2026.1.39016 |
| Variabile ale modulului de tip colecție | — | 2026.1.39507 |
Tipurile de date Modbus Int64, UInt64 și Double | — | 2026.1.40665 |
AESENCRYPT, AESDECRYPT, HASH, HMAC, RANDBYTES, TOBASE64, FROMBASE64, TOHEX, FROMHEX, CRC16, CRC32 | — | 2026.1.40991 |
Funcții fără cerință
IF, SWITCH, RETURN, SLEEP, ROUND, LINEAR, MODBUSR, MODBUSW și MODBUSWNE funcționează pe orice Core acceptat.
Modificări în Core 2026.1
- Funcțiile Modbus de bloc necesită TapHome Next 2026.1.39016+.
- Funcțiile pe biți respectă lățimea tipului valorii; acest lucru necesită TapHome Next 2026.1.40665+. Build-urile mai vechi tratează orice valoare ca având 32 de biți: o valoare pe 64 de biți își pierde jumătatea superioară, iar un bit de peste un tip pe 8 sau 16 biți se citește ca 0.
MODBUSWșiMODBUSWNErespectăByteSwappentruInt32șiUInt32; acest lucru necesită TapHome Next 2026.1.40665+, build-urile mai vechi îl ignoră.
Note de versiune și de context
Descrierea unei funcții se încheie cu un rând Disponibilitate atunci când funcția are nevoie de un Core mai nou sau funcționează doar în anumite scripturi:
| Notă | Semnificație | Eroarea în caz contrar |
|---|---|---|
| Core 2026.1 sau mai nou; TapHome Next 2026.1.N+ | Core și aplicația au nevoie cel puțin de această versiune; o facilitate pe care deocamdată o are doar TapHome Next indică primul build al acelui canal. | X function not supported. Please update your core unit to be able to use this feature. |
| Doar scripturi Modbus | Scripturile modulelor și dispozitivelor Modbus: citire, scriere, inițializare, atribute de service și acțiuni de service. | ModbusFunction - unknown modbus device to work with |
| Doar scripturi Packet parser | Scripturile Packet parser ale unui modul cu protocolul potrivit (HTTP, TCP, UDP, MQTT sau FTP). | PacketParserFunction - PacketParserContext is null; cu alt protocol PacketParserFunction - unable to use 'X' with Y |
| Doar scripturile dispozitivelor | Scripturile dispozitivelor Modbus și Packet parser, niciodată smart rules; descrierea numește scripturile. | X function not supported here. |
Lista completă a mesajelor se află în Erori.