Protokol AMiT Websocket

Podporované typy a verzie zariadení
Konfigurácia komunikačnej linky
Konfigurácia komunikačnej stanice
Inicializácia DB-Net
Konfigurácia meraných bodov
Literatúra
Zmeny a úpravy
Revízie dokumentu

Podporované typy a verzie zariadení

Protokol podporuje komunikáciu so zariadeniami firmy AMiT prostredníctvom Websocketov. Komunikácia nevyžaduje inštaláciu žiadnych dodatočných ovládačov. Komunikácia bola testovaná a odladená na zariadení ADiS4 (Gen2 E+) s centrálnou jednotkou AD4-CPS.

Konfigurácia komunikačnej linky

Kategória komunikačnej linky: TCP/IP-TCP
Host: URL adresa PLC (napr. ws://192.168.1.1 alebo wss://192.168.1.1 pre secure web sockets)
Poznámka: v aktuálnej verzii (DetStudio 3.4 build 38) nefungovala wss (TLS) komunikácia, keďže AMiT PLC používalo príliš slabé kryptovacie kľúče, ktoré už nevyhovovali SSL knižnici použitej v D2000. Tento problém sa dal vyriešiť nakonfigurovaním TLS cez pomocnú utilitu, napr. stunnel.
Port: číslo portu. Ak sa použije defaultný port (80 pre ws://, 443 pre wss://), je možné zadať aj hodnotu 0

Parametre protokolu linky

Dialóg konfigurácie linky – záložka Parametre protokolu.
Ovplyvňujú niektoré voliteľné parametre protokolu. Môžu byť zadané nasledovné parametre protokolu linky:

Tab. č. 1

Plný názov	Popis	Jednotka / rozmer	Implicitná hodnota
User Name	Užívateľské meno použité pri komunikácii. Ak nie je zadané, tak sa pri komunikácii meno/heslo nepoužije. Pozn.: Zariadenia AMiT nevyžadujú posielanie mena a hesla, pokiaľ nemajú nakonfigurovaných žiadnych užívateľov.	-	-
Password	Heslo použité pri komunikácii.	-	-
Protocol	Protokol použitý pri komunikácii. Na výber sú tieto varianty: MessagePack - binárny protokol (jedná sa v podstate o binárne kódovaný JSON). JSON - štandardný textový protokol. Zariadenia AMiT majú obmedzenú veľkosť prijímaných aj odosielaných Websocket správ na 16 kB a teda do tejto veľkosti sa musia zmestiť výzvy aj odpovede. Preto je odporúčaná varianta MessagePack, ktorá je zároveň aj menej náročná na CPU.	MessagePack JSON	MessagePack
Wait Timeout	Čakanie na odpoveď. V prípade väčších dotazov, prípadne kvôli vyšším latenciám (napr. na mobilnej sieti alebo pri komunikácii cez WAN/VPN) môže byť potrebné túto hodnotu zvýšiť.	ss:mss	01:000

Konfigurácia komunikačnej stanice

Komunikačný protokol: AMiT Websocket.
Adresa stanice sa nezadáva.

Parametre protokolu stanice

Dialóg konfigurácia stanice - záložka Parametre protokolu.
Ovplyvňujú niektoré voliteľné parametre protokolu. Môžu byť zadané nasledovné parametre protokolu stanice:

Tab. č. 2

Plný názov	Popis	Jednotka / rozmer	Implicitná hodnota
Batch Size	Veľkosť dávky pri čítaní, tj. počet meraných bodov, ktoré sú vyčítavané naraz. AMiT zariadenia majú obmedzenú veľkosť prijímaných aj odosielaných Websocket správ na 16 kB a teda do tejto veľkosti sa musia zmestiť výzvy aj odpovede. V prípade väčších objektov (polia, textové premenné) môže byť nutné prednastavenú hodnotu zmenšiť, prípadne vytvoriť na linke viacero staníc - jednu pre polia (malá hodnota Batch Size), druhú pre jednoduché premenné (väčšia Batch Size).	1-1000	256

Konfigurácia meraných bodov

Možné typy hodnôt bodov: Ai, Ao, Ci, Co, Di, Do, TxtI, TxtO, TiA, ToA, TiR, ToR.

Adresa meraného bodu pozostáva z:

Name - textové meno premennej
Bit - pre celočíselné typy premenných je možné špecifikovať konkrétny bit. Môže byť v rozsahu 0 až 15 pre typy INT a INT MATRIX alebo 0 až 31 pre typy LONG a LONG MATRIX.
Pozn: Do meraného bodu so zadaným bitom nie je momentálne možné zapisovať.
Row, Col - Poloha hodnoty v dvojrozmerných poliach, prvý riadok alebo stĺpec má hodnotu 0.
Row count, Col count - Pre dvojrozmerné polia počet čítaných riadkov a stĺpcov (implicitná hodnota počtu riadkov aj počtu stĺpcov je 1). Ak je nakonfigurovaný počet riadkov alebo stĺpcov vyšší ako 1, je použitý pre ukladanie hodnôt celej matice alebo výrezu z matice do cieľového stĺpca štruktúry. Číta sa časť matice [Riadok, Stĺpec .. Riadok + Počet riadkov -1, Stĺpec + Počet stĺpcov - 1].
Príklad: Row =1, Col =2, Row count=20, Col Count =30. Čítajú sa riadky 1 až 20, stĺpce 2 až 31, tj. časť matice [1,2 .. 20,31].
Bit - číslo bitu pri typoch hodnôt Di, Dout. Môže byť v rozsahu 0 až 15 pre typy WORD/INT alebo 0 až 31 pre typy DWORD/DINT.

Literatúra

AMiT MessagePack, JSON (Websocket) - messagepack_ws-json_dec_cz_102.pdf

Zmeny a úpravy

6. máj 2026 – vytvorenie dokumentu

Revízie dokumentu

Ver. 1.0 - 6. máj 2026 - Vytvorenie dokumentu.

Komunikačné protokoly