Porovnávané verzie

Kľúč

  • Tento riadok sa pridal
  • Riadok je odstránený.
  • Formátovanie sa zmenilo.

...

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

Kotva
typy_verzie
typy_verzie
Podporované typy a verzie zariadení

...

Protokol podporuje zber dát komunikáciu so zariadeniami firmy AMiT pomocou komunikácie cez Websocketprostrední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.


Kotva
komunikacna_linka
komunikacna_linka
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 V použitej verzii (DetStudio 3.4 build 3843) 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ácia linky - záložka 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:

...

HW Init File
Plný názovPopisJednotka / rozmerImplicitná hodnota

Kotva

if

u

ifPlná cesta na súbor na disku, kde je uložená konfigurácia DB-Net.

Poznámka 1: Ak sa nepoužíva parameter protokolu linky "Init File" (prázdny string), potom všetky stanice musia mať správne nakonfigurované parametre protokolu stanice popísané nižšie. Parametre DB-Net IP alebo UPD komunikácie je možné konfigurovať iba s pomocou "Init File" súboru.

Poznámka 2: Ak nechcete, aby vo viacvláknovom režime táto linka inicializovala ovládač ATOUCH32, použite hodnotu "---" , t.j. 3x znak "mínus". Jedna z liniek v rámci KOM procesu však musí mať nakonfigurovanú platnú cestu na existujúci init súbor a tá potom vykoná inicializáciu aj pre všetky ostatné linky.

-

u
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.
--

Kotva
p
p
Password

Heslo použité pri komunikácii.--

Kotva
e
e
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

Kotva
wt
wt
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-

Kotva
komunikacna_stanica
komunikacna_stanica
Konfigurácia komunikačnej stanice

...

  • Komunikačný protokol: AMiT ATOUCH32 DB-NetWebsocket.
  • Adresa stanice je adresa zariadenia v sieti DB-Net (hodnota položky "Station" v inicializačnom stringu/súbore - 16-bitové číslo). V konfigurácii, ani v sieti nesmú byť dve stanice s rovnakou adresou, vrátane adresy "vlastnej stanice".sa nezadáva.


Parametre protokolu stanice

...

COM PortCOM SpeedMax. Transactions ErrorFull DebugEnable Matrix Read
Plný názovPopisJednotka / rozmerImplicitná hodnota

Kotva

myst

bs

myst

bs

My Station
Adresa "vlastnej stanice", to zn. stanice (PC), kde beží ovládač ATOUCH32.-31
Kotva
comcomPort COM, cez ktorý je realizovaná komunikácia.-1
Kotva
speedspeedPrenosová rýchlosť komunikácie.-19200
Kotva
metmetMaximálny počet neúspešných príkazov na čítanie za sebou, aby bola komunikácia so stanicou označená za zlyhanú a je nastavený stav stanice StCOMERR. Ak prekročí počet neúspešných čítaní meraných bodov dvojnásobok tejto hodnoty, je zastavené čítanie zvyšných meraných bodov za účelom urýchlenia komunikácie (stanica sa považuje za úplne nedostupnú).-10
Kotva
fdfdVysoká úroveň sledovania linky - trasovacie výpisy obsahujú aj podrobnosti o prijatých hodnotách meraných bodov.-False
Kotva
emremrOptimalizácia čítania maticových premenných pre pomalé siete (GPRS a podobne). Optimalizujú sa čítania premenných maticových typov (INT MATRIX, LONG MATRIX, FLOAT MATRIX a DBNETTIME MATRIX). Pokiaľ majú viaceré merané body ten istý WID a typ, generuje sa pre ne jediná požiadavka na čítanie, ktorá zahŕňa rozsah riadkov a stĺpcov všetkých týchto bodov.-False

...

Ovládač DB-Net vyžaduje pri štarte dodať konfiguračný súbor alebo string s konfiguráciou DB-Net siete v konkrétnej aplikácii. Ak používate komunikáciu iba cez štandardný COM port, je možné vytváranie konfiguračného súboru na disku obísť pomocou parametrov protokolu My Station, COM Port a COM Speed, ktoré musí mať nakonfigurované jedna zo staníc.

...

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

Kotva
merany_bod
merany_bod
Konfigurácia meraných bodov

...

Adresa meraného bodu pozostáva z:

  • Kotva
    widnamewid
    name
    WID Name - číselné meno premennej, je jednoznačné v rámci siete DB-Net. Povolený rozsah 0 až 65500, hodnota je prideľovaná parametrizačným nástrojom PSP3 alebo DetStudio. Číslo sa zadáva dekadicky, prípadne ako hexadecimálne číslo s mriežkou na začiatku (napr. #0A).textové meno premennej
  • Kotva
    typbittyp
    bit
    Typ - typ hodnoty premennej, môže byť INT, LONG, FLOAT a maticové typy INT MATRIX, LONG MATRIX alebo FLOAT MATRIX. Typy INT a INT MATRIX sú 16 bitové a ak sú nakonfigurované ako typy hodnôt Ai, Ao sú interpretované ako znamienkové a v prípade Ci,Co ako neznamienkové. Podobne typy LONG a LONG MATRIX (rozsah 32 bitov) sú v prípade Ai, Ao interpretované ako znamienkové a v prípade Ci,Co ako neznamienkové. Typy FLOAT a FLOAT MATRIX sú 32 bitové float hodnoty v rozsahu približne od ±10-36 do ±1038 . Pre typy hodnôt TiA a ToA je možný výber DBNETTIME a DBNETTIME MATRIX. DBNETTIME je v skutočnosti typ LONG interpretovaný ako absolútny čas v DBNet formáte (počet sekúnd od 1-1-1980 0:0:0). Pre typy hodnôt TxtI a TxtO je možné nastaviť INT MATRIX. Riadok z matice INT je interpretovaný ako text, každý INT element matice je jeden znak. Typy INT a LONG môžu byť interpretované ako relatívny čas - t.j. počet sekúnd.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 poliachRiadok, Stĺpec - Poloha hodnoty v maticových typoch, prvý riadok alebo stĺpec má hodnotu 0.
  • Počet riadkov, Počet stĺpcov - V prípade typov hodnôt TxtI a TxtO sa zadáva iba počet stĺpcov, čo je vlastne dĺžka textu. Pre iné typy hodnôt je 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: RiadokRow =1, StĺpecCol =2, Počet riadkovRow count=20, počet stĺpcovCol Count =30. Čítajú sa riadky 1 až 20, stĺpce 2 až 31, tj. časť matice matice [1,2 ..  2020,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 a INT MATRIX alebo 0 až 31 pre typy LONG a LONG MATRIX.

...

Vo fáze štartu alebo aj počas komunikácie sa môžu vyskytovať nasledovné chybové hlásenia. Pre ľahšiu identifikáciu problému zapnite úroveň sledovania komunikácie v konfigurácií príslušnej linky minimálne na úroveň "Monitor", najlepšie však dočasne na úroveň "Monitor & Disk". V prípade nastavenia "Monitor & Disk" bude v podadresári "\TRACE" adresára aplikácia vznikať súbor "meno_linky.LOG", kde sa nachádzajú všetky ladiace a chybové informácie. Ak sa Vám nepodarí chybu odstrániť a problémy pretrvávajú, kontaktujte technickú podporu firmy Ipesoft.

...

  • 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.

Kotva
literatura
literatura
Literatúra

...

  • AMiT Atouch32 v3.30 online manuál. Revize: 12.7.2011, Verze dokumentu: 1.34. MessagePack, JSON (Websocket) - messagepack_ws-json_dec_cz_102.pdf

Kotva
zmeny_upravy
zmeny_upravy
Zmeny a úpravy

...

...

  • 6. sept. 2006 - doplnený textový typ TxtI a TxtO, doplnený absolútny čas. Nové zadávanie parametrov protokolu stanice a linky.8. jan. 2008 - zmeny v konfigurácii matíc, DBNETTIME, cieľový stĺpec.
  • 22. máj 2009 - doplnené relatívne časy.
  • 25. október 2012 - podpora viacvláknového režimu ovládača ATOUCH32.
  • máj 2026 – vytvorenie dokumentu

Kotva
revizie
revizie
Revízie dokumentu

...

  • Ver. 1.0 - 26. marec 2002 - Vytvorenie dokumentu.
  • Ver. 1.1 – 23. jan. 2004 – Opravy dokumentu po zmenách v inicializácií.
  • Ver. 1.2 - 6. sept. 2006 - Aktualizácia.
  • Ver. 1.3 - 8. jan. 2008 - Aktualizácia.
  • Ver. 1.4 - 22. máj 2009 - Aktualizácia.
  • Ver. 1.5 - 1. okt. 2009 - Doplnenie funkčnosti parametra protokolu "Max. Transactions Error".
  • Ver. 1.6 - 25. okt. 2012 - Aktualizáciamáj 2026 - Implementácia čítania a zápisu jednoduchých objektov a polí.


Info
titleSúvisiace stránky:

Komunikačné protokoly

...