Protokol AMiT Websocket

Podporované typy a verzie zariadení 
Konfigurácia komunikačnej linky
Konfigurácia komunikačnej stanice
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 použitej verzii (DetStudio 3.4 build 43) 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ázovPopisJednotka / rozmerImplicitná 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.--

Encoding

Kódovanie použité pri komunikácii. Na výber sú tieto varianty:

  • MessagePack - binárne kódovanie (jedná sa v podstate o binárne kódovaný JSON).
  • JSON - štandardné JSON kódovanie.

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

Doba čakania 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:mss01: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ázovPopisJednotka / rozmerImplicitná 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-1000256

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 WORD/INT 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].
    Pozn: ak nie je zadaný žiaden z parametrov Row, Count, Row count, Col count, číta sa celé pole.
  • 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.
  • Passive - meraný bod nie je čítaný. Takýto meraný bod môže byť určený iba na zápis, alebo môže byť nakonfigurovaný ako prvok poľa, ktoré je čítané iným meraným bodom (ktorý nie je pasívny).

Pozn: Meraný bod typu TiA/ToA je chápaný ako počet sekúnd od 1.1.1970 (Unix time), keďže AMiT nemá objekty typu absolútny čas.

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 - Implementácia čítania a zápisu jednoduchých objektov a polí.


Súvisiace stránky:

Komunikačné protokoly

Napíšte komentár