Ovladač slouží pro komunikaci mezi jednou nebo více stanicemi a systémem Control Web přes standardní sériové rozhraní RS-232 (nebo RS-485, RS-422). Použitý protokol je DirectNET. Ovladač vystupuje jako MASTER.

Seznam sekcí:

Činnost ovladače

Kanály ovladače

Parametry ovladače

Mapovací soubor ovladače a datové typy

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

Chybové kódy

Činnost ovladače

Pomocí ovladače je možno číst nebo zapisovat data z paměťových registrů (VMemory) binárních výstupů (Outputs) a binárních vstupů (Inputs). Jednotlivé registry, vstupy nebo výstupy se přiřadí kanálům ovladače prostřednictvím definice v jeho souboru parametrů. Ovladač má určitou množinu kanálů vyhraženou pro speciální informace, proto doporučujeme, aby uživatelsky definované kanály začínaly nejméně od čísla 100. Paměťové registry stanice (VMemory) je možno interpretovat různým způsobem v závislosti na typu stanice nebo na aplikačním programu, běžícím ve stanici.

• Jeden registr (16-bitů) může obsahovat jednu hodnotu se znaménkem nebo bez znaménka, která odpovídá jednomu kanálu.

• Jeden registr (16-bitů) může být rozdělen na dvě hodnoty (byte) se znaménkem nebo bez znaménka, které odpovídají dvěma kanálům.

• Jeden registr (16-bitů) může být rozdělen na 16 logických hodnot, které odpovídají 16 kanálům typu boolean.

• Dva registry (po 16-bitech) mohou být spojeny do jednoho kanálu jako 32-bitová hodnota následujících typů:

  reálné číslo s jednoduchou přesností (float - single precision)

  celé číslo se znaménkem (signed integer)

  celé číslo bez znaménka (unsigned integer)

• Čtyři registry (po 16-bitech) mohou být spojeny do jednoho kanálu jako 64-bitová hodnota následujících typů:

  reálné číslo s dvojnásobnou přesností (float - double precision)

  celé číslo se znaménkem (signed integer)

Platí konvence, že všechny numerické kanály ovladače jsou vždy typu real. Všechny konverze do jiných datových typů použitého zařízení se provádějí v ovladači.

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], jak je popsáno níže.

Vyhrazené kanály ovladače

Ovladač předává informace o stavu komunikace prostřednictvím zvláštních kanálů, které jsou mapovány do intervalu 1 až 99. Dojde-li k chybě komunikace, je vygenerována výjimka ovladače a z jednotlivých kanálů je možno zjistit různé údaje, které blíže specifikují chybu nebo nějakou událost. Kanál č.1 rozlišuje, jedná-li se o chybu při čtení nebo při zápisu. Skupina kanálů č.10 až 18 doplňuje údaje o chybě při čtení resp. 20 až 28 při zápisu.

Kódy oblastí PLC (kanál 16 a 26)

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.

Sekce [Plc]

Tato sekce obsahuje parametry, které slouží ke konfiguraci ovladače z hlediska používání protokolu DirectNET.

[Plc]
    ComDriver = <LinkDll>, <ComId>
    MasterAdr = <N>
    FinalizeAfterEachBlock = true | false
    Mode = ASCII | HEX
    Timeout = <N>
    EnableMonitor = true | false
    SwapBytes = true | false
    SwapRegisters = true | false
    NumRepeat = <N>

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

Sekce [Channels]

V této sekci se používá jediný parametr Block, který definuje bloky kanálů ovladače. Jednotlivým datovým oblastem ve stanici je možno přiřadit určitou skupinu kanálů. Blok je definován adresou stanice, intervalem kanálů, datovou oblastí ve stanici, počáteční adresou v dané oblasti a pro oblast registrů ještě datovým typem. 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 na stejný kanál - pak jsou v ovladači vytvořeny dva zvláštní bloky, jeden pro čtení, druhý pro zápis. 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 tuto hodnotu dále upravuje. 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. Způsob zápisu parametrů a jejich možné hodnoty (v hranatých závorkách jsou uvedeny nepovinné nebo doplňující parametry):

[Channels]
    Block = <Station>, <ChannelFrom>, <ChannelTo>, <Media>, <Offset>, [<Subtype>], [Bidirect] [<Comment>]
    Block = ...
    ...

Příklad definice bloku

[Channels]
  Block = 01, 100, 199, M, 0301, int16, bidirect

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 definice parametrů sériové komunikace přímo v souboru parametrů ovladače Plc Direct:

[comm]
baudrate = 9600
parity = odd
databits = 8
stopbits = 1
rx_buffer = 1152
tx_buffer = 1152
rx_frame_buffer = 1152
tx_frame_buffer = 1152
cts_flow = false
dsr_flow = false
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

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 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 možno zjistit stav výjimky přečtením kanálu č.1. Stav je určen jednotlivými bity podle následující tabulky:

Ovladač generuje následující chybové kódy. Tyto kódy jsou k dispozici na kanálech č.11 resp. č.21. Při vzniku chyby se současně vypíše hlášení do okna zpráv.

• bit 0 - je-li bit nastaven, nastala chyba při čtení.

• bit 1 - je-li bit nastaven, nastala chyba při zápisu.

Chybové kódy

Ovladač generuje následující chybové kódy. Tyto kódy jsou k dispozici na kanálech č.11 resp. č.21. Při vzniku chyby se současně vypíše hlášení do okna zpráv.

Chybové kódy ovladače