Dane binarne

UNPACKVALUE i PACKVALUE przeliczają między wartościami z typem — liczbami całkowitymi, zmiennoprzecinkowymi, tekstem — a surowymi rejestrami lub bajtami kolekcji. Nie komunikują się z magistralą, więc działają w każdym skrypcie: na blokach rejestrów Modbus, na danych TCP i UDP w skrypcie listener modułu Packet parser lub w smart rule. Typ danych to jeden z typów danych Modbus. Obie funkcje wymagają Core 2026.1, kompilacji 39001 lub nowszej, oraz aplikacji w kompilacji 39016 lub nowszej.

UNPACKVALUE#

UNPACKVALUE odczytuje jedną wartość z typem z kolekcji rejestrów (collection<uint16>) lub kolekcji bajtów (collection<uint8>) od podanego przesunięcia.

1
2

UNPACKVALUE(collection, offset, dataType)
UNPACKVALUE(collection, offset, String, length)

Zwraca — liczbę; bool dla Bool; int64 lub uint64 dla 64-bitowych typów całkowitych; tekst dla String.

Uwagi — RECEIVEDMSG.PAYLOAD jest blobem i nie jest akceptowany. W skrypcie listener TCP lub UDP użyj RECEIVEDBYTES, który jest kolekcją bajtów, albo przekonwertuj tekst przez TOBYTES.

Przykład — wartości z jednego odczytu bloku Modbus

collection<uint16> data := MODBUSRBLOCK(H, 100, 4);
VAR power := UNPACKVALUE(data, 0, BigEndianFloat);
VAR state := UNPACKVALUE(data, 2, Uint16);
VAR name := UNPACKVALUE(data, 0, String, 2);

Przykład — liczba z odebranych bajtów

collection<uint8> frame := BYTECOLLECTION("01 02 00 FA");
UNPACKVALUE(frame, 2, Uint16);
# Result: 250

collection<uint8> frame := BYTECOLLECTION("FA 00 00 00");
UNPACKVALUE(frame, 0, LittleEndianUint32);
# Result: 250

Błędy — UNPACKVALUE: offset N + M element(s) exceeds collection length L; UNPACKVALUE: parameter 1 must be a Collection<UInt16> or Collection<UInt8>; UNPACKVALUE: String data type must have specified length - number of registers to read.

PACKVALUE#

PACKVALUE zapisuje jedną wartość z typem do kolekcji rejestrów lub bajtów od podanego przesunięcia i zwraca tę samą, zmienioną kolekcję.

1

PACKVALUE(collection, offset, dataType, value)

Uwagi

• Kolekcja jest zmieniana w miejscu; zwracana wartość to ta sama kolekcja.
• String nie jest obsługiwany.
• Typy całkowite zaokrąglają wartość do liczby całkowitej. Wartość spoza zakresu typu albo NaN zapisane do typu całkowitego zatrzymuje skrypt.

Przykład — zbudowanie bloku rejestrów i zapis w jednej transakcji

collection<uint16> block := UINT16COLLECTION(4);
PACKVALUE(block, 0, BigEndianFloat, 21.5);
PACKVALUE(block, 2, Uint16, 100);
MODBUSWBLOCK(H, 200, block);

Przykład — bajty dla polecenia TCP lub UDP

collection<uint8> frame := BYTECOLLECTION(4);
PACKVALUE(frame, 0, Uint16, 0x0102);
PACKVALUE(frame, 2, LittleEndianUint16, 0x0304);
SENDDATA(frame);
# frame is now 01 02 04 03

Błędy — PACKVALUE: String data type is not supported; PACKVALUE: Can’t write double.NaN to modbus register; Overflow when writing X as UInt16.

Kolejność bajtów w kolekcjach#

Te same nazwy typów danych opisują kolejność rejestrów w collection<uint16> i kolejność bajtów w collection<uint8>.

Uwagi — W kolekcji bajtów LittleEndian już odwraca wszystkie bajty, więc dodanie do niego ByteSwap niczego nie zmienia.

Zobacz też — Typy danych Modbus, MODBUSRBLOCK, RECEIVEDBYTES.