Seznam sekcí:

Vlastnosti ovladače

Činnost ovladače

Parametry ovladače

Kanály ovladače

Procedury ovladače

Mapovací soubor ovladače a datové typy

Zpracování a stavy výjimek ovladače

Chybové kódy

Příklad použití ovladače

Vlastnosti ovladače

• Ovladač umožňuje připojení jednoho nebo více přístrojů A.P.O. - ELMOS k systému Control Web.

• Komunikace přes standardní sériové rozhraní počítače RS-232 resp. RS-485 s použitím vhodného převodníku.

• Ovladač řídí komunikaci — pracuje v režimu master.

• Čtení a zápis všech dostupných hodnot parametrů.

• Komunikace se všemi typy přístrojů MRS 01, MRS 04 a APOSYS, popřípadě dalšími se shodným protokolem.

• Při komunikaci s více regulátory je možno logicky odpojit regulátory, které jsou momentálně nedostupné.

Činnost ovladače

Ovladač slouží ke komunikaci systému Control Web s přístroji MRS 01, MRS 04 a APOSYS ve všech jejich modifikacích. Dále umožňuje komunikovat s novými přístroji, které mají shodný komunikační protokol s některým přístrojem z uvedených skupin. Pomocí ovladače je možno číst nebo zapisovat všechny dostupné hodnoty parametrů a aktuální data. Při komunikaci s přístroji A.P.O. - ELMOS ovladač používá následující komunikační služby:

• Čtení identifikace přístroje

• Čtení verze firmware

• Čtení hodnoty

• Zápis hodnoty

• Čtení stavu přístroje

• Čtení a zápis synchronizačních dat

• Zápis dat do EEPROM

Ovladač interpretuje parametry a aktuální hodnoty přístrojů jako svoje kanály. Vždy se jedná o kanály číselného typu. Číselný rozsah je dán typem hodnoty v přístroji. Z hlediska aplikace mohou být všechny kanály definovány jako hodnoty typu real. Pokud některé kanály obsahují pouze hodnoty 0 a 1, je možno je v aplikaci definovat jako typ boolean. Ovladač se automaticky stará o převod na požadovaný typ na základě definice kanálů v souboru parametrů. Výjimku tvoří pouze kanály, ve kterých se vrací jméno výrobce, název a verze přístroje. Tyto kanály musí být typu string.

Počet kanálů ovladače není pevně definován a záleží pouze na tom, které hodnoty je třeba v aplikaci číst nebo zapisovat. Jednotlivé datové kanály ovladače, popřípadě celé jejich skupiny se konfigurují v souboru parametrů podle požadavků uživatele.

Existuje-li možnost připojení více zařízení — stanic na jedno sériové rozhraní (např. prostřednictvím sběrnice RS-485), ovladač se dá nakonfigurovat tak, aby při výskytu chyby komunikace s některým zařízením došlo k jeho logickému odpojení. Ovladač v tomto případě nebude se zařízením komunikovat. To zabezpečí plynulý běh zbytku aplikace. Po uplynutí nastaveného intervalu, popřípadě povelem z aplikace se dá znovu zažádat o spojení s právě odpojeným zařízením.

Parametry ovladače

Pomocí souboru parametrů je možno nastavit parametry komunikace a definovat kanály ovladače, popřípadě nastavit další doplňující parametry. Celý soubor parametrů je rozdělen do několika sekcí. Název sekce je uveden v hranatých závorkách. V sekci jsou uvedeny za jménem a znakem = jednotlivé parametry. Na jednom řádku může být definován jeden parametr.

Parametry pro základní nastavení ovladače — sekce [Settings]

Tato sekce obsahuje parametry, které slouží ke konfiguraci ovladače z hlediska komunikace. Způsob zápisu parametrů a jejich možné hodnoty:

[Settings]
ComDriver = <LinkDll> <ComId> 
NumRepeat = <N> 
Timeout = <N> 
InputBufferSize = <N> 
OutputBufferSize = <N> 
MaxExceptions = <N> 
Trace = none | log | xtrace | windows 
InterMessageDelay = <N> 
Readback = true | false
SrcAdr = <N>
GoodComReport = true | false
MaxPacketLength = <N>
FinalizeAfterEachBlock = true | false
DoNotCheck = true | false  

Základní syntaktické kategorie použité v konfiguraci ovladače:

Následuje výčet a popis jednotlivých parametrů:

Možné hodnoty nastavení parametru Trace jsou:

Příklad parametrů v sekci [Settings]:

[Settings]
  ComDriver = CWCOMM.DLL COM1
  NumRepeat = 2
  Timeout = 250
  SrcAdr = 1
  MaxPacketLength = 260
  InputBufferSize = 522
  OutputBufferSize = 522
  DoNotCheck = true
  MaxExceptions = 1000
  Trace = none

Konfigurace kanálů ovladače — sekce [Channels]

Tato sekce definuje jednotlivé kanály nebo skupiny kanálů ovladače a jejich reprezentaci v paměti přístroje. Jednotlivé kanály resp. skupiny kanálů se definují jako bloky. Blok je definován intervalem kanálů, adresou přístroje, typem přístroje a jménem požadované funkce pro přenos dat. Funkce může vyžadovat doplňkové parametry pro bližší určení hodnoty. Tyto doplňkové parametry jsou pro přístroje MRS 04-1xxx a MRS 04-3xxx segment, index X, index Y a datový typ hodnoty. Pro ostatní přístroje jsou to čísla tabulek a jména datových struktur, které popisují typy dat v tabulkách a blocích se stavy přístrojů. Doplňkové parametry jsou závislé na dané funkci.

Dále je možné zadat v definici kanálů ovladače další rozšiřující parametry, které jsou nepovinné. V případě použití obousměrných kanálů je možno definovat parametr bidirect, který zamezí vzniku kolizí při současném čtení i zápisu stejného kanálu — pak jsou v ovladači vytvořeny dva zvláštní bloky, jeden pro čtení, druhý pro zápis. Další nepovinný parametr určuje prohození pořadí byte u typů zabírajících více než jeden byte v paměti přístroje. Každý blok může být dále opatřen vlastním identifikátorem. Jeho význam je popsán dále. Součástí definice bloku může být i komentář. Ten musí být uveden na samostatném řádku a musí začínat středníkem.

Z pohledu komunikace představuje jeden blok maximální celistvý úsek, který se dá přenést najednou v rámci jedné komunikace se stanicí. Použitý komunikační protokol resp. nižší komunikační vrstvy tuto hodnotu dále upravují. Bude-li definován delší blok než je možno přenést najednou a budou-li zadány požadavky na čtení nebo zápis všech kanálů bloku, rozpadne se komunikace na několik částí tak, aby byla všechna data přenesena.

Dále následuje popis zápisu parametrů a jejich možné hodnoty. Každé skupině (bloku) kanálů odpovídá v parametrickém souboru jeden řádek textu. V hranatých závorkách jsou uvedeny nepovinné nebo doplňující parametry:

[Channels]
  Block = <From>, <To>, <Con>, <Device>, <Function> [, Id:<ID>] [, Bidirect] [, Swapbytes]
  Block = ...
  ...

  Device = APOSYS02 | APOSYS10 | APOSYS20 | APOSYS30 | APOSYS40 |
           MRS01_1 | MRS04_1 | MRS04_3 | MRS04_4 | MRS04_5 | MRS04_D

  Function = IDENT | VERSION | STATUS <StructName> |
             VALUE, <Seg>, <Type> |
             MVALUE, <Seg>, <IX>, <IY>, <Type> |
             TC, <Table>, <StructName> |
             SYNC | SYNCREAD, <StructName> |
             EEPROM 

Význam jednotlivých parametrů:

Možné hodnoty parametru Function jsou:

Možné hodnoty parametru Device jsou:

Možné hodnoty parametru Type jsou:

Příklad parametrů v sekci [Channels]:

[Channels]
  Block  = 1100, 1102, 11, MRS04_1, IDENT
  Block  = 1200, 1203, 11, MRS04_1, VALUE,  3, float32
  Block  = 1204, 1207, 11, MRS04_1, VALUE,  4, float32
  Block  = 1208, 1211, 11, MRS04_1, VALUE,  1, float32
  Block  = 1300, 1303, 11, MRS04_1, VALUE,  0, float32
  Block  = 1400, 1419, 11, MRS04_1, STATUS, StatusMRS04_1
  Block  = 1500, 1503, 11, MRS04_1, VALUE,  3, float32
  Block  = 1504, 1507, 11, MRS04_1, VALUE,  4, float32
  Block  = 2100, 2100, 12, APOSYS30, IDENT
  Block  = 2101, 2101, 12, APOSYS30, VERSION
  Block  = 2400, 2401, 12, APOSYS30, STATUS, StatusAPOSYS30
  Block  = 2200, 2201, 12, APOSYS30, TC, 0, Table0
  Block  = 2202, 2206, 12, APOSYS30, TC, 1, Table1
  Block  = 2502, 2506, 12, APOSYS30, TC, 1, Table1
  Block  = 2207, 2208, 12, APOSYS30, TC, 2, Table2
  Block  = 2507, 2508, 12, APOSYS30, TC, 2, Table2
  Block  = 2209, 2209, 12, APOSYS30, TC, 5, Table5
  Block  = 2509, 2509, 12, APOSYS30, TC, 5, Table5

Definice struktur — sekce [Structures]

Tato sekce popisuje datové struktury, které jsou použity v sekci [Channels] v definici typů u bloků kanálů, které zpřístupňují stav přístrojů, data tabulek a synchronizovaná data (funkce STATUS, TC a SYNCREAD). Jinými slovy, jsou použity všude tam, kde se najednou přenášejí data různých typů. Každá struktura musí mít svůj jednoznačný identifikátor (jméno) a seznam jednotlivých jednoduchých typů všech položek tak, jak jsou přenášeny za sebou mezi přístrojem a počítačem resp. tak, jak jsou uloženy v paměti přístroje.

Následuje způsob zápisu struktur:

[Structures]
  <StructName> = <Type>, <Type>, ...
  <StructName> = ...
  ...

Význam paramterů pro definici struktur je následující:

Možné datové typy v položce Type jsou:

Příklad parametrů v sekci [Structures]:

[Structures]
  Status = float32,uint8
  Table0 = float32[2]
  Table1 = uint8[4], uint16
  Table2 = float32[2]
  Table3 = float32[3]
  Table4 = float32[2]
  Table5 = uint8
  Table6 = uint8
  Table7 = uint8

Parametry spojení s připojenými jednotkami — sekce [Unit_n]

Pokud ovladač komunikuje s více zařízeními, která jsou připojena na jedné sběrnici, může nastat případ, kdy je některé z nich nedostupné. To může být způsobeno buď poruchou zařízení, jeho vypnutím, či odpojením a pod. Jestliže tato situace nastane a aplikace požaduje po ovladači výměnu dat s tímto zařízením, může dojít ke zpomalení běhu celé aplikace vlivem čekání ovladače na odpověď od tohoto zařízení (po dobu definovanou parametrem Timeout). Aby se zabránilo těmto stavům, je ovladač vybaven možností nefungující zařízení logicky odpojit. To znamená, že se zařízení z pohledu ovladače uvede do vypnutého neboli odpojeného stavu. Nachází-li se zařízení v odpojeném stavu, požadavky aplikace na komunikaci s ním budou ovladačem ignorovány (budou ztraceny). Do odpojeného stavu může být zařízení uvedeno buď uživatelsky (povelem z aplikace) nebo automaticky po výskytu chyby komunikace (jestliže zařízení neodpovídá na požadavky od ovladače). Připojení zařízení, které je v odpojeném stavu se uskuteční automaticky po uplynutí předem definované doby (parametr ovladače) nebo opět uživatelsky — povelem z aplikace. Akce připojení nezpůsobí okamžitý požadavek na komunikaci, ale pouze nastaví pro zařízení stav, kdy s ním ovladač může opět komunikovat — zařízení přejde do stavu připojeno. Fyzicky se komunikace uskuteční až v důsledku následující žádosti aplikace na přenos dat. Je-li zařízení stále nedostupné, vznikne opět chyba komunikace a zařízení přejde znovu do stavu odpojeno.

Připojit nebo odpojit zařízení je možno prostřednictvím kanálů ovladače č. 28 a 29 nebo voláním procedur ovladače UnitConnect a UnitDisconnect.

Aby bylo možné využívat zmíněné vlastnosti ovladače, je třeba pro každé zařízení, ke kterému se má ovladač takto chovat, definovat zvláštní sekci v souboru parametrů. Název sekce je složen z klíčového slova Unit_ (se znakem podtržítko) a pořadového čísla sekce v souboru parametrů, např. Unit_1. Číslování sekcí musí začínat od jedničky a pokračovat v souvislé řadě. Číslo v názvu sekce nemá nic společného s adresou zařízení.

Způsob zápisu parametrů a jejich možné hodnoty:

[Unit_<N>]
  UnitAdr = <N>
  StatusChannel = <N>
  CheckTime = <N>

Následuje výčet a popis jednotlivých parametrů:

Příklad zápisu parametrů:

[Unit_1]
  UnitAdr = 15
  StatusChannel = 1000
  CheckTime = 60

Parametry linkové komunikační vrstvy — sekce [comm]

Linková komunikační vrstva představuje prostředek pro přístup na standardní sériové rozhraní počítače. Tato vrstva umožňuje mimo jiné sdílet jedno sériové rozhraní více ovladači. V systému Control Web je linková komunikační vrstva reprezentována dvěma DLL knihovnami ('CWXLINK.DLL' a 'CWCOMM.DLL'). Pro její konfiguraci slouží v souborech parametrů ovladače sekce [comm]. V této sekci je možno buď přímo definovat parametry sériové komunikace nebo uvést odkaz (přesměrovaní) na samostatný konfigurační soubor s parametry sériové komunikace. V případě přesměrování obsahuje sekce [comm] pouze jediný parametr — file:

[comm]
  file=c:\cw\par\comm.par

Struktura parametrů linkové vrstvy:

[comm]
  file = <file>
  device = <comdevice>

Pokud je definován parametr device a existuje sekce jména comdevice, budou konfigurační parametry přednostně získány z této sekce, jinak budou použity parametry přímo ze sekce [comm].

Povinné parametry:

[comm]
  rx_frame_buffer = <N>
  tx_frame_buffer = <N>
  baudrate = <N>
  databits = <N>
  stopbits = one | 1 | oneandhalf | 1.5 | two | 2
  parity = none | no | even | mark | odd | space
  cts_flow = true | false
  dsr_flow = true | false
  dtr_control = disable | low | enable | high | handshake | toggle | toggle_neg
  rts_control = disable | low | enable | high | handshake | toggle | toggle_neg
  dsr_sense = low | high
  rx_interchar_timeout = <N>
  rx_char_timeout = <N> | 0
  rx_timeout = <N> | 0
  tx_char_timeout = <N> | 0
  tx_timeout = <N> | 0

Nepovinné parametry:

  priority = idle | low | below_normal | normal | above_normal | high | realtime
  mode = fullduplex | halfduplex
  pre_key = <N>
  hold_key = <N>
  rx_buffer = <N>
  tx_buffer = <N>
  tx_continue_xon_xoff = true | false
  tx_xon_xoff = true | false
  rx_xon_xoff = true | false
  xon_tresh = <N>
  xoff_tresh = <N>
  error_xlat = true | false
  discard_null = true | false
  xon_char = <N>
  xoff_char = <N>
  err_char = <N>
  eof_char = <N>
  evt_char = <N>

Syntaktické kategorie:

Popis jednotlivých parametrů:

Hodnoty pro definici chování DTS a RTS (parametry rts_control a dtr_control):

Příklad parametrů v sekci [comm]:

[comm]
  baudrate = 9600
  databits = 8
  parity = even
  stopbits = 1
  rx_buffer = 512
  tx_buffer = 512
  rx_frame_buffer = 512
  tx_frame_buffer = 512
  cts_flow = disable
  dsr_flow = disable
  dtr_control = disable
  rts_control = disable
  dsr_sense = low
  rx_interchar_timeout = 0
  rx_char_timeout = 0
  rx_timeout = 0
  tx_char_timeout = 0
  tx_timeout = 0

Kanály ovladače

Ovladač může jednotlivé prvky různých datových oblastí připojených stanic interpretovat jako svoje kanály, což jsou číselné nebo logické hodnoty (bity). Definice kanálů se děje prostřednictvím souboru parametrů v sekci [Channels].

Vyhrazené kanály ovladače

Kromě uživatelsky definovaných kanálů, viz sekce [Channels], má ovladač skupinu kanálů, které jsou pevně definovány. Tyto kanály jsou vyhrazeny pro poskytování stavových informací o ovladači a pro řízení jeho činnosti. Jsou mapovány do intervalu 1 až 99. Proto kanály s těmito čísly nepoužívejte v definici bloků pro komunikaci:

č. 1 (real input)

stav výjimky od ovladače

č. 2 (boolean output)

povolení výjimky od ovladače

č. 3 (real input)

počet zpracovaných výjimek od ovladače

č. 4 (real input)

počet nezpracovaných výjimek, které má ovladač ve frontě

č. 5 (real input)

adresa stanice, která způsobila výjimku

č. 6 (real input)

chybový kód

č. 7 (string input)

popis chyby

č. 8 (real input)

číslo prvního kanálu bloku, při jehož přenosu vznikla chyba

č. 9 (real input)

číslo posledního kanálu bloku, při jehož přenosu vznikla chyba

č. 10 (real input), kód funkce, při jejímž přenosu vznikla chyba:

č. 11 (real input)

počet chyb čtení

č. 12 (boolean output)

vynulování počítadla chyb čtení

č. 13 (real input)

počet chyb zápisu

č. 14 (boolean output)

vynulování počítadla chyb zápisu

č. 15 (real input)

celkový počet opakování požadavků na komunikaci

č. 28 (string/real output)

logické připojení zařízení. Zápisem adresy resp. identifikátoru zařízení do tohoto kanálu dojde k jeho připojení.

č. 29 (string/real output)

logické odpojení zařízení. Zápisem adresy resp. identifikátoru zařízení do tohoto kanálu dojde k jeho odpojení.

Automatická konverze typů

Při definování kanálů ovladače je nutno kromě zápisu bloků v souboru parametrů vytvořit také soubor '*.DMF', který obsahuje seznam kanálů a jejich typů pro aplikaci. Ovladač nevyžaduje striktní dodržování stejných typů v definici bloků a souboru '*.DMF'. Pouze doporučujeme aby kanály typu boolean (logické) v souboru '*.DMF' měly své protějšky v blocích v souboru '*.PAR' jako některý z bitových typů. Ostatní číselné typy se mohou kombinovat. Např. v souboru '*.DMF' mohou být všechny číselné kanály typu real a v blocích ovladače mohou být uvedeny třeba jako int16.

Procedury ovladače

Aplikace může volat ovladači určité procedury, pomocí nichž je možno řídit chování ovladače nebo získat důležité informace. To se děje prostřednictvím systémové procedury:

core.DriverQueryProc( DriverName : string; Param1 : any; &Param2 : any )

Její parametry mají následující význam:

DriverName a Param1 se zadávají jako textové řetězce. Param2 je různého typu podle významu procedury. Některé procedury, sloužící k nastavení parametrů, mohou skončit chybou. Výsledek naposled vykonané procedury je možno získat voláním procedury GetResult.

Přehled a význam jednotlivých procedur ovladače (parametr Param1)

Mapovací soubor ovladače a datové typy

Tento soubor obsahuje typy kanálů ovladače. Protože ovladač má jak pevnou množinu kanálů, tak proměnnou množinu kanálů, měl by tento soubor obsahovat vždy shodnou definici pro vyhražené kanály a různou (podle požadavků aplikace) pro kanály definované uživatelsky v souboru parametrů v sekci [Channels].

Zpracování a stavy výjimek ovladače

Při výskytu chyby komunikace vznikne událost, kterou ovladač může přenést jako výjimku do aplikace. V aplikaci musí být definován objekt (virtuální přístroj), který má definován parametr driver_exception se symbolickým jménem tohoto ovladače. V tomto případě je takový přístroj výjimkou aktivován. V rámci jeho činnosti je třeba zapsat na kanál č. 2 hodnotu true nebo zavolat proceduru ovladače EnableException. Tím se povolí vyvolání další výjimky, jakmile nastane nebo pokud není fronta výjimek prázdná. Přečtením kanálu č. 1 je možno zjistit stav výjimky. Při použití kanálu č. 2 je třeba pamatovat na to, aby měl virtuální přístroj nastaven parametr send_same_data. Pokud aplikace výjimky nezpracovává, přidávají se do fronty, jejíž maximální velikost je určena parametrem MaxExceptions v sekci [Settings].

Kódy pro stavy výjimek ovladače

Chybové kódy

Ovladač generuje následující chybové kódy. Tyto kódy jsou k dispozici na kanále č. 6. Kód a popis chyby je také možno získat voláním procedur ovladače GetErrorCode a GetErrorString. Při vzniku chyby se současně vypíše hlášení do Okna zpráv systému Control Web.

Kódy definované systémem Control Web:

Obecné chybové kódy ovladače:

Příklad použití ovladače

Součástí instalace je několik příkladů použití ovladače. Tyto příklady naleznete v adresáři 'EXAMPLES\APOELMOS'. Součástí příkladů jsou také soubory '*.DMF' a '*.PAR'. Před spuštěním příkladů si nejprve tyto soubory upravte podle aktuální konfigurace.