---
title: "Binárne dáta"
description: "Binárne dáta v skripte TapHome: rozbalenie desatinných a celých čísel a textu z blokov Modbus registrov alebo z bajtov TCP a UDP cez UNPACKVALUE, zabalenie cez PACKVALUE."
url: "https://taphome.com/sk/docs/script/binary-data/"
language: sk
lastmod: 2026-10-13
generator: hugo
ai:
  topics: ["binary-data","byte-order","modbus","packet-parser","scripting-language"]
  questions: ["Ako prečítam desatinné číslo (float) z bloku Modbus registrov?","Ako prečítam číslo z bajtov TCP alebo UDP správy?","Ako zostavím blok registrov na zápis jednou Modbus transakciou?","Čo znamená LittleEndian pri bajtovej kolekcii?","Môžem použiť UNPACKVALUE na RECEIVEDMSG.PAYLOAD?"]
---

# Binárne dáta

Funkcie skriptu TapHome PACKVALUE a UNPACKVALUE — čítanie a zápis typovaných hodnôt v kolekciách registrov a bajtov, s poradím big-endian, little-endian a byte swap.

Posledná aktualizácia: 2026-10-13

`UNPACKVALUE` a `PACKVALUE` prevádzajú medzi typovanými hodnotami — celými číslami, desatinnými číslami (float), textom — a surovými registrami alebo bajtmi kolekcie. Nekomunikujú so zbernicou, takže fungujú v každom skripte: nad blokmi Modbus registrov, nad TCP a UDP dátami v listener skripte Packet parsera aj v smart rule. Dátový typ je jeden z [dátových typov Modbus](https://taphome.com/sk/docs/script/modbus-data-types/). Obe funkcie potrebujú TapHome Next 2026.1.39016+.

## UNPACKVALUE

`UNPACKVALUE` prečíta jednu typovanú hodnotu z kolekcie registrov (`collection<uint16>`) alebo z bajtovej kolekcie (`collection<uint8>`) na zadanej pozícii.

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

| Názov | Typ | Popis |
|---|---|---|
| `collection` | `collection<uint16>` alebo `collection<uint8>` | Zdrojové dáta. Blob sa neprijíma. |
| `offset` | číslo | Pozícia hodnoty od 0 — v registroch pre `collection<uint16>`, v bajtoch pre `collection<uint8>`. |
| `dataType` | dátový typ Modbus | Napríklad `Uint16`, `BigEndianFloat`, `LittleEndianUint32`. |
| `length` | číslo | Povinné pre `String`: počet registrov (po 2 znaky) alebo bajtov (po 1 znaku). Text končí na prvom nulovom bajte. |

**Návratová hodnota** — číslo; `bool` pre `Bool`; `int64` alebo `uint64` pre 64-bitové celočíselné typy; reťazec pre `String`.

**Poznámky** — `RECEIVEDMSG.PAYLOAD` je blob a neprijíma sa. V TCP alebo UDP listener skripte použite `RECEIVEDBYTES`, ktorý je bajtovou kolekciou, alebo text preveďte funkciou [TOBYTES](https://taphome.com/sk/docs/script/data-type-conversions/#tobytes).

**Príklad — hodnoty z jedného blokového čítania Modbus**

```taphome
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);
```

**Príklad — číslo z prijatých bajtov**

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

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

**Chyby** — *UNPACKVALUE: offset N + M element(s) exceeds collection length L*; *UNPACKVALUE: parameter 1 must be a Collection&lt;UInt16&gt; or Collection&lt;UInt8&gt;*; *UNPACKVALUE: String data type must have specified length - number of registers to read*.

## PACKVALUE

`PACKVALUE` zapíše jednu typovanú hodnotu do kolekcie registrov alebo bajtov na zadanú pozíciu a vráti tú istú, zmenenú kolekciu.

```text
PACKVALUE(collection, offset, dataType, value)
```

**Poznámky**

- Kolekcia sa mení priamo; návratová hodnota je tá istá kolekcia.
- `String` nie je podporovaný.
- Celočíselné typy zaokrúhlia hodnotu na celé číslo. Hodnota mimo rozsahu typu aj zápis `NaN` do celočíselného typu zastaví skript.

**Príklad — zostavenie bloku registrov a zápis jednou transakciou**

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

**Príklad — bajty pre TCP alebo UDP príkaz**

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

**Chyby** — *PACKVALUE: String data type is not supported*; *PACKVALUE: Can't write double.NaN to modbus register*; *Overflow when writing X as UInt16.*

## Poradie bajtov v kolekciách

Tie isté názvy dátových typov opisujú poradie registrov v `collection<uint16>` aj poradie bajtov v `collection<uint8>`.

| Príznak | `collection<uint16>` (registre) | `collection<uint8>` (bajty) |
|---|---|---|
| `BigEndian` (predvolené) | Najvýznamnejší register je prvý. | Najvýznamnejší bajt je prvý. |
| `LittleEndian` | Obrátené poradie registrov (word swap); pri 16-bitovom type sa vymenia dva bajty registra. | Skutočné little-endian poradie: najmenej významný bajt je prvý. |
| `ByteSwap` | Dva bajty v každom registri sa vymenia. | Dva bajty v každej dvojici sa vymenia. |

| Dátový typ | Registre | Bajty |
|---|---|---|
| `Bool` | 1 | 1 |
| `Int16`, `Uint16` | 1 | 2 |
| `Int32`, `UInt32`, `Float` | 2 | 4 |
| `Int64`, `UInt64`, `Double` | 4 | 8 |

**Poznámky** — V bajtovej kolekcii už `LittleEndian` obráti všetky bajty, takže pridanie `ByteSwap` nič nezmení.

**Pozrite aj** — [Dátové typy Modbus](https://taphome.com/sk/docs/script/modbus-data-types/), [MODBUSRBLOCK](https://taphome.com/sk/docs/script/modbus/#modbusrblock), [RECEIVEDBYTES](https://taphome.com/sk/docs/script/listener-scripts/#receivedbytes).
