Veškerá konfigurace přenosového programu Tarwin je uložena v textových souborech, takže změny konfigurace lze provádět mj. i běžně dostupnými jednoduchými textovými editory, například v "Poznámkovém bloku".
Následující kapitoly podrobně popisují formát souborů a význam jednotlivých voleb. Protože běžná nastavení programu lze provést pomocí uživatelského rozhraní, je tento text určen pro případy speciálních požadavků na chování programu nebo pro případy, kdy není možné konfigurační nástroj použít, např. přístup přes FTP apod.
Formát konfiguračních souborů vychází z formátu souborů .INI používaného v prostředí operačního systému Windows. Soubor se skládá z jedné nebo více sekcí. Každá sekce začíná hlavičkou a následuje tělo sekce. Přebytečné mezery, tabulátory na začátku, na konci nebo uprostřed řádku, prázdné řádky a řádky obsahující pouze poznámku se ignorují. U názvů sekcí a klíčů se nerozlišují velká a malá písmena.
Hlavička sekce obsahuje název sekce v hranatých závorkách. Za ní může být poznámka (viz dále).
Tělo může mít dva tvary: a) obsahuje dvojice klíč=hodnota na samostatných řádcích nebo b) obsahuje seznam řetězců, jednotlivé řetězce jsou na samostatných řádcích. Řádek může také obsahovat poznámku.
Poznámky začínají vždy mřížkou (#) a končí dvojicí znaků pro konec řádku.
[SEKCE1] # Poznámka klíč1 = hodnota1 # Poznámka klíč2 = hodnota2 [SEZNAM1] # Poznámka položka1 položka2Logické hodnoty se zapisují následovně (nerozlišují se velká a malá písmena):
Při spuštění přenosového modulu se nejprve čte hlavní konfigurační soubor tarwin.ini, který musí být umístěn ve stejném adresáři, jako program Tarwin a má následující části:
Sekce DEVICES obsahuje seznam obsluhovaných zařízení. Každé zařízení má svůj řádek. Na začátku řádku je uveden adresář, ve kterém se nachází konfigurační soubor zařízení (device.ini, viz dále) a který se také používá jako pracovní adresář pro ukládání různých souborů. V poznámce může být uvedeno jméno zařízení, které není povinné, ale při obsluze několika zařízení je užitečné si je pro přehlednost vhodně pojmenovat.
V sekci HTTP se konfiguruje monitorovací a řídící rozhraní. Tarwin obsahuje jednoduchý webový server, pomocí kterého lze na dálku sledovat činnost modulu nebo zahájit přenos. Sekce obsahuje tyto volby:
[DEVICES] dev.a # Buffer 1 dev.b # Buffer 2 [HTTP] Server = ON TCPPort = 80 UserName = Passwd = CSS = Head = Foot =
Význam: Jsou definována dvě zařízení, první používá pracovní adresář dev.a a konfigurační soubor dev.a\device.ini, druhé má přidělen adresář dev.b. Protože jsou cesty uvedeny relativně, vztahují se vždy k adresáři, ve kterém je umístěn program Tarwin. První zařízení má jméno Buffer 1, druhé Buffer 2. Monitorovací a řídící rozhraní je zapnuto a je dostupné na síťovém portu 80, nebude vyžadována autorizace.
Jednotlivá zařízení mají své konfigurační soubory s nastavením a volbami. Tyto soubory jsou uloženy vždy v pracovním adresáři zařízení v souboru device.ini. Obsah souboru lze rozdělit na dvě části: část společnou pro všechny typy zařízení a část specifickou pro daný typ zařízení, se kterým se komunikuje. Společná část obsahuje jednu sekci s názvem CONFIGURATON. Volby specifické pro konkrétní typy zařízení a přenosové protokoly včetně příkladů jsou uvedeny v dalších kapitolách.
V následujícím přehledu je uveden popis jednotlivých voleb v části CONFIGURATION, příklady jsou u jednotlivých typů zařízení.
Tato kapitola popisuje konfiguraci zařízení, které získává data z bufferu Tarflex nebo Tarflex plus připojeného na sériový port počítače. Volba Protokol se nastaví na TARWIN a volba Device na RS232. Soubor dále obsahuje sekce:
Sekce RS232 nastavuje parametry sériového portu:
Sekce BUFFER obsahuje parametry komunikačního protokolu
Do sekce COMMAND se zapisují mimořádné požadované akce, jako například
Buffer Tarflex je zapojen na sériový port COM2. Jeho rozhraní pro komunikaci s PC je nastaveno na rychlost 9600 baudů a je připojen kabelem dodávaným výrobcem (třížilové vedení bez hardwarového řízení toku dat). Buffer je připojen k ústředně, která má tarifikační výstup nastaven na rychlost 1200 baudů a pro řízení toku dat používá signály DTR/DSR. Nová data se budou kontrolovat každou hodinu a ukládat do souboru pa20.td v adresáři ..\pbx.a.
[CONFIGURATION] Protocol=Tarwin # Komunikační protokol Device=RS232 # Používá se sériové rozhraní Interval=3600 # Kontrolovat data každých 3600 sekund = 1 hodina DataFile=..\pbx.a\pa20.td # Cílový soubor [RS232] # Zde se konfiguruje vyse uvedene seriove rozhrani Port=COM2 # Buffer připojen na COM 2 Baud=9600 # Rychlost Tarflex-PC je 9600 HShaking=None # Nepoužívá se hw řízení toku [BUFFER] # Zde jsou nalezitosti bufferu Tarflex BufNr=0 # Ovládá se buffer s libovolným výr. č. Serial=OFF # Vypnuto stohování FIFO=ON # Zapnuto přepisování dat při zaplnění Sound=ON # Zapnuté zvukové signály DataC=ON # Zapnutá komprimace dat Text=ON # Zapnutý textový režim PBXBaud=1200 # Rychlost PBX-Tarflex je 1200 MaxRet=5 # Maximalne 5 opakovani pokusu o spojeni MaxDel=1 # Maximalne 1 sekundu cekat na odezvu bufferu MaxLen=2048 # Nejdelsi datove pakety budou 2048 bytů [COMMAND] AllBuffer=OFF # Normální provoz
Tato kapitola popisuje konfiguraci zařízení, které získává data z bufferu Tarflex nebo Tarflex plus s rozhraním pro připojení do sítě Ethernet nebo z bufferu připojeného přes sériový port k jinému počítači zpřístupněný do sítě pomocí programu RSEth. Konfigurační soubor device.ini obsahuje společnou sekci, která je popsána na začátku této kapitoly. Volba Protokol se nastaví na TARWIN a volba Device na ETH. Soubor dále obsahuje sekce:
Sekce ETH nastavuje parametry síťového rozhraní bufferu:
Sekce BUFFER a COMMAND jsou popsány v předchozím odstavci.
Buffer Tarflex je připojen do sítě Ethernet a má IP adresu 192.168.1.110 a číslo portu 1110. Buffer je připojen k ústředně, která má tarifikační výstup nastaven na rychlost 1200 baudů a pro řízení toku dat používá signály DTR/DSR. Nová data se budou kontrolovat každou hodinu a ukládat do souboru pa20.td v adresáři ..\pbx.a.
[CONFIGURATION] Protocol=Tarwin # Komunikační protokol Device=ETH # Používá se síťové rozhraní Interval=3600 # Kontrolovat data každých 3600 sekund = 1 hodina DataFile=..\pbx.a\pa20.td # Cílový soubor [ETH] IPBuf=192.168.1.110 # IP adresa bufferu Tarflex v síti TCPPort=1110 # TCP port pro přenos dat [BUFFER] Serial=OFF # Vypnuto stohování FIFO=ON # Zapnuto přepisování dat při zaplnění Sound=ON # Zapnuté zvukové signály DataC=ON # Zapnutá komprimace dat Text=OFF # Vypnutý textový režim PBXBaud=9600 # Rychlost PBX-Tarflex je 9600 MaxRet=5 # Maximalne 5 opakovani pokusu o spojeni MaxDel=1 # Maximalne 1 sekundu cekat na odezvu bufferu MaxLen=2048 # Nejdelsi datove pakety 2048 bytů [COMMAND] AllBuffer=OFF # Normální provoz, nestahovat celý obsah paměti
Tato kapitola popisuje konfiguraci zařízení, které získává data z bufferu Tarflex-E. Konfigurační soubor device.ini obsahuje společnou sekci, která je popsána na začátku této kapitoly. Volba Protokol se nastaví na TARWIN a volba Device na ETH.
Sekce ETH, BUFFER a COMMAND jsou popsány v předchozím odstavci. Buffer používá standardně síťový port 110 (místo 1110) a v sekci BUFFER musí být navíc parametr Typ s hodnotou 2, která určje, že jde o Tarflex-E.
Buffer Tarflex je připojen do sítě Ethernet a má IP adresu 192.168.1.253. Buffer je připojen k ústředně, která má tarifikační výstup nastaven na rychlost 9600 baudů a pro řízení toku dat používá signály DTR/DSR. Nová data se budou kontrolovat každou hodinu a ukládat do souboru pa20.td v adresáři ..\pbx.a.
[CONFIGURATION] Protocol=Tarwin # Komunikační protokol Device=ETH # Používá se síťové rozhraní Interval=3600 # Kontrolovat data každých 3600 sekund = 1 hodina DataFile=..\pbx.a\pa20.td # Cílový soubor [ETH] IPBuf=192.168.1.110 # IP adresa bufferu Tarflex v síti TCPPort = 110 # TCP port pro data, vzdy 110 [BUFFER] Typ = 2 # 1=Tarflex, 2=Tarflex-E Serial=OFF # Vypnuto stohování FIFO=ON # Zapnuto přepisování dat při zaplnění Sound=ON # Zapnuté zvukové signály DataC=ON # Zapnutá komprimace dat Text=OFF # Vypnutý textový režim PBXBaud=9600 # Rychlost PBX-Tarflex je 9600 PBXProt=DTR/DSR # Používají se hw signály DTR a DSR MaxRet=5 # Maximalne 5 opakovani pokusu o spojeni MaxDel=1 # Maximalne 1 sekundu cekat na odezvu bufferu MaxLen=2048 # Nejdelsi datove pakety 2048 bytů [COMMAND] AllBuffer=OFF # Normální provoz, nestahovat celý obsah paměti
Tato kapitola popisuje konfiguraci zařízení, které získává data z bufferu Tarflex nebo Tarflex plus připojeného přes telefonnímu modem. Konfigurační soubor device.ini obsahuje společnou sekci, která je popsána na začátku této kapitoly. Volba Protokol se nastaví na TARWIN a volba Device na MODEM. Soubor dále obsahuje sekce:
Sekce MODEM nastavuje parametry telefonního modemu připojeného k tomuto počítači:
Sekce BUFFER a COMMAND jsou popsány výše.
Buffer Tarflex je připojen k telefonnímu modemu. Druhý telefonní modem je v PC. Spojení se naváže vytočením čísla 0 pro přístup do telefonní sítě a dále se volí číslo 45454545. Buffer je připojen k ústředně, která má tarifikační výstup nastaven na rychlost 1200 baudů a pro řízení toku dat používá signály DTR/DSR. Nová data se budou kontrolovat každou hodinu a ukládat do souboru pa20.td v adresáři ..\pbx.a.
[CONFIGURATION] Protocol=Tarwin # Komunikační protokol Device=MODEM # Používá se modem Interval=3600 # Kontrolovat data každých 3600 sekund = 1 hodina DataFile=..\pbx.a\pa20.td # Cílový soubor [MODEM] Port=COM3 # Telefonní modem je na portu COM3 Baud=57600 # a komunikuje rychlostí 57600 Bd DialNum=0,45454545 # Vytáčené číslo DialType=TONE # Tónová volba čísla CDC=ON # Čekat na signál CD ATCMDS=ATX0 # AT příkaz modemu, aby nečekal na oznamovací tón. Timeout=40 # Pokud do 40s nezačne komunikace, zavěsit [BUFFER] BufNr=0 # Ovládá se buffer s libovolným výr.č. Serial=OFF # Vypnuto stohování FIFO=ON # Zapnuto přepisování dat při zaplnění Sound=ON # Zapnuté zvukové signály DataC=ON # Zapnutá komprimace dat Text=OFF # Vypnutý textový režim PBXBaud=1200 # Rychlost PBX-Tarflex je 1200 MaxRet=5 # Maximalne 5 opakovat pokus o spojeni MaxDel=1 # Maximalne 1 sekundu cekat na odezvu bufferu MaxLen=4096 # Nejdelsi datove pakety 4096 bytů [COMMAND] AllBuffer=OFF # Normální provoz, nestahovat celý obsah paměti
Tato kapitola popisuje konfiguraci zařízení, které získává data z přímo ústředny Alcatel 4400 po síti. Konfigurační soubor device.ini obsahuje společnou sekci, která je popsána na začátku této kapitoly. Volba Protokol se nastaví na ALC4400 a volba Device musí být nastavena na ETH. Soubor dále obsahuje sekci ALC4400 nastavuje parametry komunikace s ústřednou:
Ústředna Alcatel 4400 je připojena do sítě a má IP adresu 192.168.1.110. Nová data se budou kontrolovat každou hodinu a ukládat do souboru pa20.td v adresáři ..\pbx.a.
[CONFIGURATION] Protocol=ALC4400 # Komunikační protokol Device=Eth # Komunikace po síti Interval=3600 # Kontrolovat data každých 3600 sekund = 1 hodina DataFile=..\pbx.a\pa20.td # Cílový soubor [ALC4400] IPAlc=192.168.1.110 # IP adresa ústředny Cwd=/usr4/account # Adresář, kde jsou tarifní data Timeout=10 # Pokud do 10s nezačne komunikace, skončit MaxCnt=2048 # Maximalni počet souborů v ústředně
Tato kapitola popisuje konfiguraci zařízení, které získává data z přímo ústředny Alcatel OmniPCX po síti. Konfigurační soubor device.ini obsahuje společnou sekci, která je popsána na začátku této kapitoly. Volba Protokol se nastaví na ALCOXO a volba Device musí být nastavena na ETH. Soubor dále obsahuje sekci ALCOXO nastavuje parametry komunikace s ústřednou:
Ústředna Alcatel OmniPCX je připojena do sítě a má IP adresu 192.168.1.110. Nová data se budou kontrolovat každou hodinu a ukládat do souboru pa20.td v adresáři ..\pbx.a.
[CONFIGURATION] Protocol=ALCOXO # Komunikační protokol Device=Eth # Komunikace po síti Interval=3600 # Kontrolovat data každých 3600 sekund = 1 hodina DataFile=..\pbx.a\pa20.td # Cílový soubor [ALCOXO] IPAlc=192.168.1.110 # IP adresa ústředny MaxRet = 3 # Max. pocet pokusu o navazani spojeni Timeout = 10 # Jak dlouho cekat na spojeni (sekunkdy)
Tato kapitola popisuje konfiguraci zařízení, které získává data z přímo ústředny Alcatel 4400 přes vytáčené připojení protokolem SLIP. Konfigurační soubor device.ini obsahuje společnou sekci, která je popsána na začátku této kapitoly. Volba Protokol se nastaví na ALC4400 a volba Device musí být nastavena na SLIP. Soubor dále obsahuje sekci ALC4400 nastavuje název vytáčeného připojení a parametry komunikace s ústřednou:
Ústředna Alcatel 4400 je dostupná přes vytáčené připojení sítě, které je ve složce "Telefonická a síťová připojení" pojmenováno "Ústředna - Praha". Ústředna má IP adresu 192.168.1.110. Nová data se budou kontrolovat každých 6 hodin (=21600 sekund) a ukládat do souboru pa20.td v adresáři ..\pbx.a.
[CONFIGURATION] Protocol=ALC4400 # Komunikační protokol Device = SLIP # Protokol SLIP Interval=21600 # Kontrolovat data každých 6 hodin DataFile=..\pbx.a\pa20.td # Cílový soubor [ALC4400] Dial = Ústředna - Praha # Jméno připojení sítě IPAlc=192.168.1.110 # IP adresa ústředny Cwd=/usr4/account # Adresář, kde jsou tarifní data Timeout=10 # Pokud do 10s nezačne komunikace, ukončit přenos MaxCnt=2048 # Maximalni počet souborů v ústředně
Tato kapitola popisuje konfiguraci zařízení, které získává data z ústředny Siemens HiCom 100/300 po síti. Ústředna musí být nakonfigurována tak, že se chová jako TFTP server. Konfigurační soubor device.ini obsahuje společnou sekci, která je popsána na začátku této kapitoly. Volba Protokol se nastaví na SIEIP. Soubor dále obsahuje sekci SIEIP nastavující parametry komunikace s ústřednou:
Ústředna Siemens je připojena do sítě a má IP adresu 192.168.1.110. Nová data se budou kontrolovat každou hodinu a ukládat do souboru pa20.td v adresáři ..\pbx.a.
[CONFIGURATION] Protocol=SIEIP # Komunikační protokol Interval=3600 # Kontrolovat data každých 3600 sekund = 1 hodina DataFile=..\pbx.a\pa20.td # Cílový soubor [SIEIP] IPSie=192.168.1.110 # IP adresa ústředny FileName=gez.txt # Adresář, kde jsou tarifní data Timeout=10 # Pokud do 10s nezačne komunikace, skončit
Tato kapitola popisuje konfiguraci zařízení, které zachytává příchozí data ze sériového portu, ke kterému je přímo připojen tarifikační výstup pobočkové ústředny nebo jiný buffer. Konfigurační soubor device.ini obsahuje společnou sekci, která je popsána na začátku této kapitoly. Volba Protokol se nastaví na RAW a volba Device musí být nastavena na RS232. V tomto případě se ignoruje parametr Interval a data se přijímají nepřetžitě. Program Tarwin musí být v tomto případě spuštěný(!). Soubor dále obsahuje sekci RAW, kde se nastavují parametry sériového portu:
K počítači je přes sériový port COM1 připojena ústředna, jejíž sériové rozhraní je nastaveno na rychlost 9600 baudů a používá pro řízení toku dat harwarové signály DTR/DSR a RTS/CTS. Nová data se ukládají do souboru pa20.td v adresáři ..\pbx.a.
[CONFIGURATION] Protocol=Raw # Komunikační protokol Device=RS232 # Používá se sériové rozhraní DataFile=..\pbx.a\pa20.td # Cílový soubor [RAW] Port=COM1 # Ústředna je připojena na COM1 Baud=9600 # Rychlost je 9600 HShaking=Both # Řízení toku signály DTR/DSR a RTS/CTS Parity=NONE # Bez parity Len=8 # Osmibitová slova XonXoff=OFF # Nepoužívat sw řízení toku
Tato kapitola popisuje konfiguraci zařízení, které zachytává příchozí data ze síťového portu. Konfigurační soubor device.ini obsahuje společnou sekci, která je popsána na začátku této kapitoly. Volba Protokol se nastaví na RAW a volba Device musí být nastavena na Eth. V tomto případě se ignoruje parametr Interval a server je aktivní nepřetržitě. Program Tarwin musí být v tomto případě neustále spuštěný(!). Soubor dále obsahuje sekci RAW, kde se nastavuje jediný parametr:
Ústředna poskytuje data do počítačové sítě a je naprogramována tak, aby se chovala jako TCP klient, tzn. v určitém intervalu se spojí protokolem TCP/IP s protistranou a předá tam tarifní data. Server (v tomto případě program Tarwin) ukládá tato data do souboru pa20.td v adresáři ..\pbx.a.
[CONFIGURATION] Protocol=Raw # Komunikační protokol Device=Eth # Používá se síťové rozhraní DataFile=..\pbx.a\pa20.td # Cílový soubor [RAW] Port=514 # Síťový port je 514