Simulační systémy Řídicí systémy Zpracování a přenos dat
Displej DT20-6 Technická dokumentace
Autor:
Ing. Jan Tupý
. . . . . . . . . . . . . . . .
Spolupracovníci:
Ing. Ivo Henych
. . . . . . . . . . . . . . . .
Vedoucí odd. speciálních zařízení: Ing. Jan Tupý
TM 2011_07_18 OSC, a. s. Staňkova 557/18a 602 00 Brno
. . . . . . . . . . . . . . . .
18. 7. 2011 tel: +420 (5) 416 43 111 fax: +420 (5) 416 43 109 email:
[email protected]
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
ANOTACE: Materiál obsahuje technický popis displeje DT20-6 určeného k zobrazení časové informace přijaté síťovým rozhraním ethernet. Rovněž poskytuje informaci pro instalaci, obsluhu a nastavení displeje.
OBSAH: Úvod......................................................................................................................................................... 4 1.
Technické parametry ..................................................................................................................... 4
2.
Popis zařízení .................................................................................................................................. 5 2.1 Blokové řešení .......................................................................................................................... 7 2.2 Zobrazená informace ................................................................................................................ 8 2.2.1 Funkce tlačítek ..................................................................................................................... 9 2.2.2 Mód čas................................................................................................................................ 9 2.2.3 Mód datum........................................................................................................................... 9 2.2.4 Mód stopky ........................................................................................................................ 10 2.2.5 Mód text............................................................................................................................. 10 2.2.6 Lamp test ........................................................................................................................... 10 2.2.7 Zobrazení IP adresy ........................................................................................................... 11 2.3 Regulace jasu .......................................................................................................................... 11 2.3.1 Test funkce vyhodnocení intenzity okolního osvětlení ..................................................... 13 2.4 Ethernetové rozhraní ............................................................................................................... 13 2.4.1 MAC adresa ....................................................................................................................... 13 2.4.2 IP adresa, adresa brány a maska sítě .................................................................................. 13 2.5 NTP klient............................................................................................................................... 14 2.5.1 Nastavení parametrů NTP klienta ...................................................................................... 15 2.5.2 Časové pásmo .................................................................................................................... 16 2.5.3 Letní čas (DST) ................................................................................................................. 17 2.6 Obnovení výchozího nastavení, default parametry ................................................................. 18 2.7 Napájení, funkce PoE ............................................................................................................. 18
3.
Přímé řízení a komunikace protokolem HTTP ......................................................................... 20 3.1 Obecný popis .......................................................................................................................... 20 3.1.1 Požadavek .......................................................................................................................... 20 3.1.2 Odpověď ............................................................................................................................ 21 3.1.3 Jednotlivé příkazy .............................................................................................................. 24
4.
WWW stránky .............................................................................................................................. 44 4.1 Status – main........................................................................................................................... 44 4.2 Status – advanced ................................................................................................................... 46 4.3 Settings – main ....................................................................................................................... 47 4.4 Settings – advanced ................................................................................................................ 50 4.5 Settings – NTP servers............................................................................................................ 52
5.
JAVA API pro přímé řízení displeje........................................................................................... 54
TM_2011_07_18
2/63
Displej DT20-6 Technická dokumentace
6.
4000 - Oddělení speciálních zařízení
Instalace a obsluha displeje ......................................................................................................... 56 6.1 Instalace .................................................................................................................................. 56 6.1.1 Mechanické řešení ............................................................................................................. 56 6.1.2 Elektrické připojení ........................................................................................................... 57 6.2 Uvedení do provozu ................................................................................................................ 57 6.2.1 Připojení napájecího napětí................................................................................................ 58 6.2.2 Parametry síťového rozhraní ............................................................................................. 58 6.2.3 Prvotní synchronizace vnitřního časového zdroje ............................................................. 58 6.2.4 Časové pásmo a algoritmus přechodu na letní čas ............................................................ 58 6.2.5 Seznam NTP serverů ......................................................................................................... 59 6.2.6 Další nastavované parametry ............................................................................................. 59 6.3 Možné závady, jejich odstranění ............................................................................................ 61
POUŽITÉ ZKRATKY: DT20-6 ethernetový displej pro zobrazení časové informace, výrobek firmy OSC, a.s. NTP
Network Time Protocol – standardní protokol pro synchronizaci vnitřního času zařízení připojených k paketové síti s proměnným zpožděním přenosu dat
SNTP
Simple Network Time Protocol – zjednodušená forma NTP protokolu
Stratum hierarchický systém definující úroveň NTP serveru – jeho „vzdálenost“ od referenčního zdroje časové informace. Stratum nabývá hodnot 0 až 16 (teoreticky až 256). UTC
Coordinated Universal Time – koordinovaný světový čas založený na atomových hodinách nezávislý na rotaci země. Je základem systému občanského času.
GMT
Greenwich Mean Time - greenwichský střední čas platný v časovém pásmu základního poledníku, je založen na rotaci Země. GMT se vlivem malých změn v rotaci Země vůči UTC mírně odchyluje.
PoE
Power over Ethernet (IEEE802.3af) – standard napájení ethernetových zařízení prostřednictvím jejich datového síťového kabelu
PD
Powered Device – napájené zařízení standardu PoE
PSE
Power Sourcing Equipment – zařízení standardu PoE poskytující napájení
RTC
Real Time Clock – číslicové hodiny (obvod) udržující informaci o reálném čase
UTP
Unshielded Twisted Pair - nestíněný kabel tvořený kroucenými dvoulinkami pro připojení zařízení v počítačových sítích. Obsahuje čtyři páry vodičů.
TCP/IP Transmission Control Protocol/Internet Protocol - sada protokolů pro komunikaci v počítačové síti HTTP
Hypertext Transfer Protocol – internetový protokol určený především pro výměnu hypertextových dokumentů ve formátu HTML
FTP
File Transfer Protocol - protokol pro přenos souborů mezi zařízeními pomocí počítačové sítě. Využívá protokol TCP z rodiny TCP/IP protokolů.
Telnet
Telecommunication Network – protokol i aplikace umožňující uživateli připojení ke vzdálenému síťovému zařízení. Realizuje spojení typu klient-server.
XML
Extensible Markup Language – obecný značkovací jazyk pro výměnu dat mezi aplikacemi a pro publikování dokumentů. Není úzce svázán s konkrétní platformou.
TM_2011_07_18
3/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
Úvod LED displej DT20-6 je zařízení z výrobního programu firmy OSC, a.s. určené k zobrazení časové informace přijaté prostřednictvím rozhraní Ethernet z libovolného NTP/SNTP serveru. DT20-6 je určen k instalaci do pultů nebo panelů v interiérech - na velínech, ve větších místnostech a všude tam, kde je potřeba přehledně zobrazovat přesnou časovou informaci.
1. Technické parametry zobrazovací část •
zobrazený údaj: - čas HH:MM:SS (hodiny:minuty:sekundy) - datum DD.MM.RR (den.měsíc.rok) - stopky HH:MM:SS nebo MM:SS.ds (hodiny:minuty:sekundy nebo minuty:sekundy.desetiny sekund)
• •
typ zobrazovačů: sedmisegmentovky LED, výška číslic 20 mm barva zobrazovačů: DT20-6R –rudá DT20-6G –zelená
•
řízení proudu LED: statické řízené proudové zdroje
•
regulace jasu zobrazovačů: automatická podle intenzity okolního osvětlení nebo nastavitelná dálkově
vnitřní časový generátor •
zálohován vnitřním RTC obvodem s baterií
•
po výpadku spojení s NTP serverem pokračuje displej autonomně v čítání času
•
uživatelem volitelná funkce typu automatického přechodu letní/zimní čas
•
uživatelem volitelný posun časového údaje (časové pásmo)
•
časový cyklus: 24 hodin
•
odchylka časového údaje při absenci NTP synchronizace: ±10 sec/1 týden
•
indikace stavu synchronizace
rozhraní Ethernet •
typ: 10/100 Mbit
•
automatická detekce rychlosti
•
konektor RJ-45
•
zdroj časové informace: až 4 externí NTP/SNTP servery
•
Podporované síťové protokoly: - klient NTP/SNTP v4 - HTTP - FTP - Telnet
další údaje •
napájení: PoE (IEEE802.3af), Class 2, příkon cca 2 až 7 W
•
krytí: IP30
TM_2011_07_18
4/63
Displej DT20-6 Technická dokumentace •
mechanické rozměry: 213 x 132 x 46,8 mm (š x v x h)
•
způsob montáže: do panelu
•
hmotnost: 0,8 kg
•
rozsah provozních teplot: -10 °C až +50 °C
4000 - Oddělení speciálních zařízení
2. Popis zařízení Displej DT20-6 je určen k zobrazení časové informace na dispečincích, velínech, dozornách nebo jiných podobných místnostech. Obsahuje vnitřní zálohovaný časový zdroj, který je synchronizován standardním protokolem NTP (Network Time Protocol) prostřednictvím síťového rozhraní Ethernet s libovolnými NTP/SNTP servery. Lze použít např. miniaturní SNTP server GPSNTP z výrobního programu OSC, a.s. nebo kterýkoli veřejný NTP server na Internetu. 213.0 mm
fólie s tlačítky
čelní panel Al 2mm
DATE WATCH
MODE
3,5
46.8 mm 3,5 - 34 mm
čelní pohled
nosný panel M4x29
pohled zespodu
Obr. 1: Pohled na DT20-6R Displej přehledným způsobem zobrazuje časovou informaci na LED zobrazovačích umístěných pod průhledem v čelním panelu – viz. Obr. 1. Celý čelní panel včetně tohoto průhledu a dvou ovládacích tlačítek je pokryt odolnou antireflexní fólií. Displej je vybaven funkcí automatické regulace úrovně jasu podle intenzity okolního osvětlení, rovněž umožňuje dálkové ovládání úrovně jasu. TM_2011_07_18
5/63
70.0 mm
RJ-45
START /STOP TIME
132.0 mm
boční pohled
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
Vnitřní časový generátor displeje lze nastavit do libovolného časového pásma. Může pracovat trvale v „zimním“ čase nebo je možno vybrat některý z předdefinovaných algoritmů automatických posunů na letní/zimní čas. Displej je určen k montáži do panelu, kde je fixován pomocí dvou rozpěrných šroubů M4x29 nebo přes čtyři otvory ∅4mm skryté pod krycí fólií v rozích čelního panelu. Pohled na displej je zachycen na Obr. 1. Přesná rozměrová specifikace je na Obr. 2. Doporučené rozměry otvoru v čelním panelu jsou uvedeny na Obr. 12. 213.0 mm 46.8 mm
198.1 mm
DATE
D4
pin1
WATCH
m
MODE
boční pohled
22 mm
3,5 až 34 mm
22 mm
31.3 mm r= 2
m
čelní pohled
UTP kabel nosný panel M4x29
225.0 mm
pohled zespodu
Obr. 2: Rozměry DT20-6 Jediným připojovacím konektorem DT20-6 je ethernetový konektor RJ-45 (označen jako D4). Slouží k připojení do sítě Ethernet i k napájení displeje. DT20-6 splňuje standard PoE (Power over Ethernet) IEEE802.3af, vystupuje v roli napájeného zařízení PD (Powered Device). Standard PoE musí rovněž podporovat síťový switch, k němuž je displej připojen. Switch (PSE - Power Sourcing Equipment) - je pro displej zdrojem napájecího napětí. Po propojení displeje a switche přímým UTP kabelem se displej identifikuje jako zařízení napájecí třídy 2 (Class 2).
TM_2011_07_18
6/63
70.0 mm
TIME
RJ-45
pin8
UTP
132.0 mm
79.5 mm
START /STOP
100.5 mm
122.0 mm
72.5 mm
51.5 mm
otvor v nosném panelu 204 x 113 mm
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
Tabulka 1: Zapojení konektoru D4 (RJ-45)
Data TX Data TX Napájení + Napájení -
pin
název
1
TXD+
2
TXD-
3
RXD+
6
RXD-
4
EPWR+
5
EPWR+
7
EPWR-
8
EPWR-
popis Vysílací pár
Přijímací pár
Rezervní pár
Rezervní pár
Displej lze ovládat několika způsoby: 1) Místně K místnímu ovládání slouží dvě tlačítka umístěná vpravo od LED zobrazovačů. Pomocí nich lze pouze přepínat jednotlivé módy zobrazení a ovládat vnitřní stopky. 2) Dálkově přes www stránky Displej obsahuje www stránky, pomocí nichž je možno zobrazit a nastavit veškeré parametry displeje. Lze tak provádět dálkovou správu displeje ze standardního internetového prohlížeče spuštěného na libovolném počítači zapojeném do stejné sítě jako displej. Do příkazového řádku prohlížeče se zadá IP adresa displeje. Ta je uvedena na štítku na zadní straně displeje nebo ji lze zobrazit na displeji po jeho restartu – viz kap. 2.2.7. 3) Dálkově přes přímé řízení protokolem HTTP Ethernetové rozhraní displeje nabízí vedle www stránek i přímé řízení protokolem HTTP pro dálkový přístup ke všem funkcím displeje. Využívá komunikaci protokolem HTTP. Je určeno pro automatizované řízení displeje z libovolného počítače připojeného do téže počítačové sítě.
2.1 Blokové řešení Displej DT20-6 v sobě integruje dvě procesorové jednotky (Obr. 3): - řadič AT89C51RE2 firmy ATMEL - zástavný ethernetový modul, výrobce DIGI, typ ME9210 Řadič AT89C51RE2 provádí na nejnižší úrovni obsluhu všech HW periferií displeje s výjimkou ethernetového rozhraní. Realizuje tyto základní funkce: - přenos znaků do budičů LED zobrazovačů - měření intenzity okolního osvětlení, regulace jasu LED zobrazovačů - snímání stavu obou tlačítek - generování zvukového výstupu na interním piezo měniči - přenos časové informace z/do RTC obvodu TM_2011_07_18
7/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
- zálohování vnitřních parametrů do EEPROM a jejich zpětné načtení po obnově napájení - provedení lamp testu zobrazovačů (v zadaném rozsahu) po připojení napájení porty ME9210
Řadič (AT89C51RE2)
Ethernet
RJ 45
Ethernet
algoritmy NTP klient SPI master
WWW
SPI slave
SEC
Parametry
SD
budič LED
I/O
ADC
I/O
Tlačítka
I/O
PIEZO
DT
MIN
budič LED
HOD
budič LED
budič LED
R47
RTC PoE
XTAL
I/O
+ BAT
R5
3V
PoE řadič
EEPROM
I/O ISP
48 V
DC 3,3 V
TTL
DC
DT20-6
X1 update firmware řadiče
Obr. 3: Interní blokové schéma zapojení displeje DT20-6 Řadič funguje jako „HW driver“ jednotlivých periferií displeje pro ethernetový modul ME9210, jehož výkonnější procesor realizuje funkce displeje jako takového. ME9210 zahrnuje: - veškeré algoritmy displeje - vnitřní časový zdroj, funkci NTP klienta - obsluhu ethernetového rozhraní – IP protokol a aplikační uživatelské protokoly: Telnet, FTP a HTTP pro www stránky a přímé řízení displeje. - parametrizaci Data a řídící příkazy mezi řadičem a ethernetovým modulem jsou přenášena pomocí interní SPI sběrnice. Řadič vystupuje v roli „SPI slave“. Ethernetový modul v roli „SPI master“ řídí SPI komunikaci, přes řadič má přístup ke všem periferiím displeje. Na Obr. 3 je naznačeno i galvanické oddělení napájecích obvodů PoE od vnitřních obvodů displeje.
2.2 Zobrazená informace DT20-6 používá k zobrazení časové informace tři dvojité segmentovky s výškou znaku 20 mm – viz. Obr. 1. Ty jsou vzájemně odděleny dvojtečkami. Vedle pravé krajní dvojsegmentovky jsou pod sebou umístěny tři LED indikující právě zvolený mód zobrazení časové informace: - mód čas – svítí horní LED - TIME. - mód datum - svítí prostřední LED - DATE - mód stopky – svítí spodní LED - WATCH - mód text - nesvítí žádná z LED indikace módu TM_2011_07_18
8/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
K vyrovnání případného rozdílu jasů diskrétních LED dvojtečka a indikátorů vůči LED segmentovkám je určen trimr R47. Je umístěn na desce plošných spojů displeje. Trimr je přístupný po sejmutí zadního krytu displeje. U módů čas a datum lze zvolit potlačení zobrazení nadbytečných nul (parametry RedundandNULLs), a to nezávisle pro zobrazený údaj měsíce, dne, hodiny, minuty i sekundy.
2.2.1
Funkce tlačítek
V krycí fólii čelního panelu displeje jsou vpravo od průhledu na LED zobrazovače umístěna dvě membránová tlačítka: MODE a START/STOP. Tlačítko MODE postupně přepíná mezi módy čas – datum – stopky. Mód text lze aktivovat pouze dálkově z www stránek nebo pomocí přímého řízení protokolem HTTP. Tlačítko START/STOP je aktivní pouze v módu stopky. Slouží ke spouštění, zastavování a nulování stopek. Okamžik stisknutí tlačítek je doprovázen krátkou akustickou indikací. K tomu slouží interní piezo měnič. Intenzitu akustické indikace je možné nastavit parametrem Volume Key na jednu ze čtyř úrovní: - 0: bez akustické indikace - 1: délka akustické indikace 10 ms - 2: délka akustické indikace 30 ms - 3: délka akustické indikace 50 ms
2.2.2
Mód čas
V módu čas zobrazuje DT20-6 časový údaj ve formátu HH:MM:SS (hodiny : minuty : sekundy). Dvojtečka mezi minutami a sekundami bliká v rytmu 1 Hz, dvojtečka mezi hodinami a minutami svítí trvale. Je použit 24 hodinový formát zobrazení času. Svítí LED indikace módu označená jako TIME. Pokud tato LED bliká, není zobrazený údaj času synchronní s žádným z nadefinovaných NTP serverů. V tomto módu je tlačítko START/STOP neaktivní. Stiskem tlačítka MODE dojde k přepnutí displeje do módu zobrazení data. V módu čas je respektováno zvolené nastavené potlačení nadbytečných nul u zobrazeného údaje hodin, minut i sekund.
2.2.3
Mód datum
Datum zobrazuje DT20-6 ve formátu DD.MM.RR (den v měsíci. měsíc. rok). Svítí LED indikace módu označená jako DATE. Pokud tato LED bliká, není zobrazený údaj data synchronní s žádným z nadefinovaných NTP serverů. V tomto módu je tlačítko START/STOP neaktivní. Stiskem tlačítka MODE dojde k přepnutí displeje do módu stopek.
TM_2011_07_18
9/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
Datum je zobrazeno po dobu cca 5 sekund. Po uplynutí této doby přejde displej automaticky do módu zobrazení času. Výjimkou je ovládání displeje z www stránek nebo přímým řízením protokolem HTTP, kde lze aktivovat i trvalý přechod do módu zobrazení data. V módu datum je respektováno zvolené nastavené potlačení nadbytečných nul u zobrazeného údaje měsíce a dne.
2.2.4
Mód stopky
V módu stopek je zobrazen postupně narůstající časový údaj v jednom ze dvou formátů: - HH:MM:SS (hodiny : minuty : sekundy) - MM:SS.ds (minuty : sekundy . desetiny sekundy) Požadovaný formát zobrazení stopek lze zvolit pouze dálkově, a to jak z www stránek, tak pomocí přímého řízení protokolem HTTP. Pokud je při čítání času zvolen formát MM:SS.ds a dojde k prvnímu přetečení údaje minut přes 100 minut, je formát zobrazení automaticky přepnut do HH:MM:SS. Po přetečení údaje hodin přes 100 hodin je údaj stopek vynulován a stopky znovu pokračují v čítání času od nuly. Tlačítkem START/STOP jsou sopky spouštěny nebo zastavovány. Delším stiskem tlačítka START/STOP při zastavených stopkách dojde k vynulování stopek. Stiskem tlačítka MODE dojde k přepnutí do módu zobrazení času. Poznámka: Stopky měří čas průběžně nezávisle na zvoleném módu zobrazení. Pokud je tedy na stopkách odstartováno měření času, lze je kdykoli opustit a přejít do módu zobrazení času nebo data. Při následném návratu do módu stopek je zobrazen mezitím načítaný údaj času. V módu stopky není u zobrazeného času respektováno zvolené nastavené potlačení nadbytečných nul.
2.2.5
Mód text
Mód text lze aktivovat pouze z www stránek nebo pomocí přímého řízení protokolem HTTP. Na LED zobrazovače lze zapsat „libovolný“ text o délce až 8 znaků - s respektováním omezené možnosti zobrazení alfanumerických znaků na sedmisegmentových zobrazovačích a dvojtečkách mezi nimi. LED indikující zobrazený mód jsou zhasnuty, nelze je ovládat.
2.2.6
Lamp test
Po připojení napájecího napětí nebo po restartu displeje je řadičem AT89C51RE2 proveden lamp test LED zobrazovačů. Jeho rozsah lze přednastavit pomocí parametru Lamp Test na jednu ze čtyř možností:
TM_2011_07_18
10/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
- 0 – Lamp test se neprovádí. Je ihned nastaven mód displeje, který byl aktivní před výpadkem napájení nebo restartem displeje. Do nabootování ethernetového modulu ME9210 řídí zobrazení na LED segmentovkách řadič displeje. - 1 – Provede se postupné rozsvícení všech LED a segmentů zobrazovačů na maximální jas a zpět na minimální jas. Vzápětí je zobrazen poslední použitý mód displeje. Do nabootování ethernetového modulu ME9210 řídí zobrazení řadič displeje. - 2 – Lamp test se neprovádí, až do nabootování ethernetového modulu ME9210 jsou LED zobrazovače zhasnuty. - 3 – Provede se postupné rozsvícení všech LED a segmentů zobrazovačů na maximální jas a zpět na minimální jas. Vzápětí LED zobrazovače zhasnou a zůstanou zhasnuty až do nabootování ethernetového modulu ME9210.
2.2.7
Zobrazení IP adresy
K zaznamenání IP adresy slouží štítek na zadní straně krytu displeje, který je určen k zápisu nové IP adresy vždy po změně jejího nastavení. V případě potřeby (nečitelný štítek, špatně zaznamenaná adresa, …) lze odečíst aktuálně nastavenou IP adresu přímo na segmentovkách displeje. Postup je následující: 1) odpojit a znovu připojit napájení displeje – vysunout a znovu zasunout konektor UTP kabelu v konektoru D4 – typ RJ-45. 2) Vyčkat, až ethernetový modul nabootuje své programové vybavení (cca 15 až 20 sekund). To lze ověřit např. stiskem tlačítka MODE. Pokud již ethernetový modul pracuje správně, zareaguje displej na stisk tlačítka změnou módu zobrazení časové informace. 3) Od nabootování ethernetového modulu je možno po dobu 2 minut současným stiskem tlačítek START/STOP a MODE (START/STOP stisknout jako první) po dobu delší než 5 sekund zobrazit na pravé polovině segmentovek displeje první, nejvyšší segment IP adresy. Levá polovina segmentovek obsahuje znaky „IP:“. Nyní lze uvolnit obě tlačítka. 4) Opakovanými krátkými stisky tlačítka MODE jsou na pravé polovině segmentovek displeje postupně zobrazovány zbývající tři segmenty IP adresy. 5) Po vypršení dvouminutového intervalu nebo po dalším stisku tlačítka MODE přejde displej do normálního módu zobrazení časové informace.
2.3 Regulace jasu Displej DT20-6 je vybaven funkcí automatické regulace jasu podle intenzity okolního osvětlení. Optické čidlo (fotodioda) je umístěno vlevo od krajní levé dvojsegmentovky pod průhledem v čelním panelu. Z www stránek nebo přímým řízením protokolem HTTP je možno měnit parametry automatické regulace jasu nebo tuto funkci dálkově vypnout. V tomto případě je požadovaná úroveň jasu nastavena na hodnotu, kterou lze dálkově zadat. Parametry regulace jasu: - AutoBrightCntl - automatická regulace jasu: zapnuta - vypnuta
TM_2011_07_18
11/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
- OffsetABCntl - ofset automatické regulace jasu. Rozsah nastavení parametru je od -15 (posun regulace směrem k minimálnímu jasu o 30 kroků) až po +15 (posun regulace směrem k maximálnímu jasu o 30 kroků) - TimeDelayABCntl - zpoždění odezvy automatické regulace jasu na změnu intenzity okolního osvětlení: bez zpoždění (0 s) – rychlá (0,3 s) – střední (0,6 s) – pomalá (0,9 s) - RemoteABCntl - hodnota jasu LED zobrazovačů displeje při vypnuté automatické regulaci jasu: 0 (min) až 127 (max)
L
R5
min
R5=min
max
R5=max
Lmax
R5
ROZSAH REGULACE:
JAS
Lmin E
1 (R5=max)
E
E
1 (R5)
1 (R5=min)
E
2 (R5=max)
E
2 (R5)
E
2 (R5=min)
INTENZITA OKOLNÍHO OSVĚTLENÍ
E
a) vliv nastavení trimru R5
L
L
-15
min (OFSET=+15)
OFSET=-15
OFSET +15
L
max (OFSET=-15)
OFSET=+15
Lmax
OFSET=0
ROZSAH REGULACE:
JAS
Lmin E1
E
1 (OFSET=-15)
E
2 (OFSET=+15)
E2
INTENZITA OKOLNÍHO OSVĚTLENÍ
E
b) vliv nastavení ofsetu automatické regulace jasu
Obr. 4: Závislost jasu displeje na intenzitě okolního osvětlení Jas displeje při dané hladině okolního osvětlení lze modifikovat jedním ze dvou způsobů: - pomocí víceotáčkového trimru R5 na desce plošných spojů displeje. Trimr je přístupný po sejmutí zadního krytu displeje. Vliv jeho nastavení na jas displeje je zřejmý z Obr. 4a. - dálkově z www stránek či pomocí přímého řízení protokolem HTTP změnou ofsetu automatické regulace jasu (parametr OffsetABCntl). Ten lze nastavit v rozsahu -15 až +15. Modifikace automatické regulace jasu dálkovým způsobem je jednodušší než při změně nastaTM_2011_07_18
12/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
vení pomocí trimru R5, to je však vykoupeno zúžením rozsahu regulace jasu – viz. Obr. 4b.
2.3.1
Test funkce vyhodnocení intenzity okolního osvětlení
Podržením stisknutého tlačítka MODE při startu napájecího zdroje displeje je řadičem displeje vyvolán speciální diagnostický mód. Na pravé dvojsegmentovce je s maximálním jasem zobrazen vyhodnocený údaj intenzity okolního osvětlení. Všechny LED indikující mód displeje rychle synchronně blikají. Vyhodnocený údaj intenzity je zobrazen v hexa formátu v rozsahu 00 (minimum) až FF (maximum). Tento údaj je zobrazován až do okamžiku nabootování ethernetového modulu ME9210, následně je obnovena normální funkce displeje.
2.4 Ethernetové rozhraní Displej je vybaven jedním rozhraním ethernet. Je přístupné na konektoru D4 typu RJ-45 umístěném na boční straně krabičky– viz. Obr. 1 a Obr. 2. Rozhraní ethernet je součástí modulu ME9210 – viz. Obr. 3. Disponuje funkcí automatické detekce rychlosti 10/100 MBit. Na čele konektoru RJ-45 jsou v levém a pravém horním rohu umístěny dvě kontrolky pro optickou indikaci aktivity sítě. Tabulka 2: Kontrolky indikace aktivity sítě pozice LED
barva
funkce
vlevo nahoře
Žlutá
stav síťového připojení
vpravo nahoře
Zelená
síťová aktivita
Popis zhasnuta: rozhraní odpojeno rožnuta: rozhraní připojeno Nevyužita (trvale zhasnuta)
2.4.1 MAC adresa MAC adresa je „fyzická adresa“ ethernetového rozhraní displeje a je jedinečná pro každý displej. Je vytištěna na bílém štítku shora umístěném na modulu D4. Adresa je viditelná po sejmutí kovového krytu displeje. MAC adresa je rovněž zobrazena na www stránce displeje Status - main v sekci Ethernet nebo ji lze získat pomocí přímého řízení protokolem HTTP (viz. kap. 3.1.3.28). Poznámka: Příklad zápisu MAC adresy na štítku D4: 00409D:3C4C24 Uvedený zápis představuje tuto MAC adresu: 00:40:9D:3C:4C:24
2.4.2 IP adresa, adresa brány a maska sítě Displej má zadánu svoji IP adresu, která jej identifikuje v rámci připojené TCP/IP sítě. Aktuálně nastavenou hodnotu IP adresy je možné odečíst místně na štítku na zadní straně víka displeje nebo na LED zobrazovačích – viz. kap. 2.2.7. Měnit IP adresu je možné dálkově přes www stránky displeje nebo pomocí přímého řízení protokolem HTTP.
TM_2011_07_18
13/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
Poznámka: Ke změně IP adresy na předdefinovanou hodnotu dojde při obnovení výchozích hodnot parametrů displeje z www stránky Settings - main – viz. kap.4.3. Pozor na možnou ztrátu IP konektivity k displeji, pokud byla dříve IP adresa displeje změněna a tato změna se nepromítla do souborů popisujících výchozí nastavení ethernetového rozhraní – default parametrů. V displeji je uložena také adresa brány. Je to IP adresa brány (gateway) v připojeném segmentu TCP/IP sítě, přes kterou je zřízen přístup k dalším TCP/IP sítím. Adresu brány je možné zobrazit a měnit pouze dálkově přes www stránky displeje nebo pomocí přímého řízení protokolem HTTP. Nastavení IP adresy brány je však rovněž modifikováno po obnovení výchozích hodnot parametrů displeje. Masku sítě lze u displeje nastavit pouze dálkově přes www stránky displeje nebo pomocí přímého řízení protokolem HTTP. Vybrat lze jednu z těchto možností: - 255.255.255.0 - 255.255.0.0 - 255.0.0.0 Nastavení masky sítě je rovněž změněno po obnovení výchozích hodnot parametrů displeje. V síti TCP/IP jsou podporovány následující typy protokolů vyšších vrstev: - NTP v4 (klient) pro synchronizaci času displeje - HTTP pro přístup k interním www stránkám displeje pro nastavení a zobrazení stavu a pro přímé řízení jednotky - FTP pro práci se souborovým systémem - Telnet pro přímý přístup ke konzoli operačního systému embeded Linux
2.5 NTP klient NTP klient displeje je implementován v programovém vybavení ethernetového modulu ME9210. Přes síťové rozhraní se připojuje standardním protokolem NTPv4 na porty 123 dostupných NTP serverů, které jsou uvedeny v jeho seznamu. Řadič displeje i ethernetový modul sdílí jeden společný RTC obvod, v němž je po dobu výpadku napájení displeje zálohována aktuální časová informace. Po připojení napájecího napětí jako první nastartuje řadič displeje (Obr. 5). Jelikož ethernetový modul ME9210 zatím provádí své bootování, používá řadič pro zobrazení na LED segmentovkách čas průběžně načítaný z RTC obvodu, k němuž má přímý přístup – viz. Obr. 3. Skutečnost, že zobrazená časová informace není dosud synchronní s žádným NTP serverem, indikuje řadič blikáním LED módu čas nebo datum. Po nabootování získá ethernetový modul z RTC obvodu prostřednictvím řadiče časovou informaci a převezme od něj řízení zobrazovačů. Na nich zobrazuje stav svého vnitřního časového zdroje, zatím synchronizovaného pouze s časem přijatým z RTC obvodu. To i nadále indikuje blikáním LED módu čas nebo datum. Interní NTP klient ethernetového modulu zahájí proces komunikace s dostupnými NTP servery uvedenými v seznamu NTP serverů. Jakmile se po úvodní sérii NTP dotazů časový zdroj NTP TM_2011_07_18
14/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
klienta zasynchronizuje s alespoň jedním z nich, je aktualizován čas v RTC obvodu. LED módu čas nebo datum přestane blikat a rozsvítí se trvale, časový zdroj displeje je synchronní. Zápis aktuálního času do RTC obvodu se pak opakuje každých 30 minut, pokud probíhá NTP komunikace s alespoň jedním NTP serverem. obsah zobrazovačů určuje řadič
obsah zobrazovačů určuje ME9210 překlenutí výpadku spojení s NTP serverem
LED nesvítí LAMP tst zobrazovače
čas z RTC
LED indikace režimu (čas, datum) nesvítí
bliká nedef.
NO
Dostupnost NTP serveru
svítí
bliká
YES
NO
dostupný
Činnost PoE ini Bootování ME9210
úvodní série NTP dotazů
YES dostupný
Čas invalidní
OK
OK
Unsynchronized timeout
15-20s
Zasynchronizování časového zdroje
Ztráta spojení s NTP serverem
Zasynchronizování časového zdroje
Sart NTP klienta
čas První NTP dotaz
Start řadiče
2s
svítí
nedostupný
Časový zdroj nezasynchronizován
Time Sync
Připojení RJ-45
čas z NTP serveru
Obr. 5: Činnost displeje po připojení síťového kabelu Perioda generování NTP dotazů po zasynchronizování vnitřního časového zdroje displeje je určena algoritmem NTP klienta a závisí mimo jiné na zjištěné disperzi časové informace získané od serveru. Perioda NTP dotazů je odvozena od mocnin čísla 2 (např. 16, 32, 64, 128 sekund). Za běžných podmínek, kdy je displej i NTP server umístěn na stejném segmentu sítě a síť je dostatečně propustná, je perioda NTP dotazů 16, 32 nebo 64 sekund.
2.5.1
Nastavení parametrů NTP klienta
Funkce NTP klienta má na správnou činnost displeje DT20-6 zcela zásadní vliv. Při editaci parametrů NTP klienta je proto třeba věnovat pozornost jejich správnému nastavení. Nastavení se provádí přes www stránky nebo je možné nastavení provést pomocí přímého řízení protokolem HTTP.
2.5.1.1
Seznam NTP serverů
V seznamu NTP serverů je uveden jeden až čtyři externí NTP servery, se kterými NTP klient displeje komunikuje. V seznamu jsou pro každý server definovány tyto parametry: - Server URL – IP adresa serveru - Used – zda interní NTP klient má nebo nemá s NTP serverem komunikovat - Prefered – zda je nebo není server preferován před ostatními servery ze seznamu - Minpool – minimální perioda v úvodní sérii dotazů NTP klienta na NTP server - Maxpool – maximální perioda v úvodní sérii dotazů NTP klienta na NTP server TM_2011_07_18
15/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
Pokud je v seznamu NTP serverů uvedeno více serverů a jsou v dané chvíli alespoň dva z nich dostupné, vybírá si NTP klient pro synchronizaci svého systémového času jen jeden z nich takzvaný systémový server. NTP klient podle informací získávaných od všech dostupných serverů ze svého seznamu neustále vyhodnocuje, kterému z nich určí roli systémového serveru – role systémového serveru je tedy přiřazována dynamicky. Hlavním kritériem při výběru systémového serveru je hodnota jeho parametru Prefered. Servery takto označené jsou vyhodnoceny přednostně před ostatními. O pořadí serverů se stejnou hodnotou parametru Prefered pak rozhoduje řada dalších parametrů – stratum serveru, časové zpoždění jeho odpovědi na NTP dotaz , disperze jeho času a další.
2.5.1.2
Unsynchronise timeout
Tento parametr definuje časovou prodlevu od posledního úspěšného dotazu na alespoň jeden dostupný NTP server ze seznamu serverů, po jejímž vypršení je vnitřní časový zdroj displeje označen jako nesynchronní. Parametr lze nastavit v rozsahu 1 až 999 minut. Poznámka: Hodnotu tohoto parametru je potřeba nastavit dostatečně velkou, aby nedocházelo mezi dvěma po sobě jdoucími NTP dotazy na server předčasně k indikaci ztráty časové synchronizace. Pokud budeme např. považovat periodu úspěšných NTP dotazů 212 s = 4096 s jako hraniční ještě tolerovatelnou periodu, pak je vhodné zadat hodnotu tohoto parametru 69 minut (69 x 60 = 4 140 s).
2.5.2
Časové pásmo
Interní časový zdroj displeje může pracovat v libovolném časovém pásmu. To je určeno parametrem Time zone offset, definujícím časový posun vůči světovému času UTC – viz Tabulka 3. Tabulka 3: Seznam nastavitelných časových pásem Time zone offset
Město/stát
UTC-12:00
Baker Island, Howland Island
UTC-11:00
Samoa, American Samoa
UTC-10:00
Hawaii, Papeete
UTC-09:30
Marquesas Islands
UTC-09:00
Anchorage, Fairbanks, Juneau
UTC-08:00
Vancouver, Washington (state), Portland, Las Vegas, California, Baja California
UTC-07:00
UTC-03:30
Alberta, Colorado, Arizona, Chihuahua, Sonora Chicago, Costa Rica, Dallas, El Salvador, Guatemala, Honduras, Houston, Manitoba, Mexico City, Nicaragua, Saskatchewan Ottawa, Toronto, Montreal, Boston, New York, North Carolina, Washington D.C., Georgia, Miami, Cuba, Jamaica, Haiti, Panama, Colombia, Continental Ecuador, Peru Venezuela Nova Scotia, Dominican Republic, Puerto Rico, Trinidad and Tobago, Amazonas, Bolivia, Continental Chile, Paraguay, San Luis Province Newfoundland
UTC-03:00
Rio de Janeiro, São Paulo, Argentina (except San Luis Province), Uruguay, Nuuk
UTC-02:00
Fernando de Noronha, South Georgia and the South Sandwich Islands
UTC-01:00
Azores, Cape Verde Iceland, Faroe Islands, United Kingdom, Ireland, Continental Portugal, Madeira, Canary Islands, Morocco, Senegal, Ghana, Côte d'Ivoire
UTC-06:00 UTC-05:00 UTC-04:30 UTC-04:00
UTC
TM_2011_07_18
16/63
Displej DT20-6 Technická dokumentace
Time zone offset
Město/stát
UTC+04:30
Albania, Slovenia, Macedonia, Norway, Sweden, Denmark, Germany, the Netherlands, Belgium, Metropolitan France, Switzerland, Austria, Poland, Czech Republic, Slovakia, Hungary, Continental Spain, Italy, Croatia, Serbia, Kosovo, Bosnia and Herzegovina, Tunisia, Algeria, Nigeria, Cameroon, Angola, Kinshasa Finland, Lithuania, Latvia, Estonia, Belarus, Ukraine, Romania, Bulgaria, Greece, Turkey, Cyprus, Syria, Lebanon, Jordan, Palestine, Israel, Egypt, Libya, Mozambique, Malawi, Zambia, Zimbabwe, South Africa Samara, Iraq, Saudi Arabia, Yemen, Sudan, Ethiopia, Somalia, Kenya, Uganda, Tanzania, Madagascar Iran Georgia, Armenia, Azerbaijan, United Arab Emirates, Oman, Seychelles, Mauritius, Moscow, Saint Petersburg Afghanistan
UTC+05:00
Sverdlovsk, Uzbekistan, Pakistan, Maldives, Kazakhstan
UTC+05:30
India, Sri Lanka
UTC+05:45
Nepal
UTC+06:00
Novosibirsk, Almaty, Bangladesh
UTC+06:30
Myanmar, Cocos Islands
UTC+07:00
UTC+09:00
Krasnoyarsk, Thailand, Vietnam, Jakarta Irkutsk, Ulan Bator, China, Taiwan, Hong Kong, Philippines, Malaysia, Singapore, Western Australia Zabaykalsky, Japan, North Korea, South Korea, East Timor
UTC+09:30
Northern Territory, South Australia
UTC+10:00
Victoria, Tasmania, Queensland, New South Wales, Primorsky
UTC+10:30
Lord Howe Island
UTC+11:00
Kamchatka, Solomon Islands, New Caledonia
UTC+11:30
Norfolk Island
UTC+12:00
Fiji, New Zealand
UTC+12:45
Chatham Islands
UTC+13:00
Tonga
UTC+14:00
Line Islands
UTC+01:00
UTC+02:00 UTC+03:00 UTC+03:30 UTC+04:00
UTC+08:00
2.5.3
4000 - Oddělení speciálních zařízení
Letní čas (DST)
Interní časový zdroj displeje může respektovat různá předdefinovaná pravidla pro přechody letní/zimní čas (DST – Daylight Saving Time). K nastavení požadované funkce DST slouží tyto parametry: - Use DST: zda bude nebo nebude aplikováno pravidlo pro přechody letní/zimní čas - DST type: typ algoritmu pro určení přechodů letní/zimní čas. Tabulka 4 zachycuje v displeji implementovaná pravidla pro přechody letní/zimní čas. Tabulka 4: Přechody mezi letním a zimním časem implementované v displeji Začátek DST
Konec DST
DST Type den All EU countries Březen – poslední neděle
hodina
den
hodina
1:00 GMT
Říjen – poslední neděle
1:00 GMT
Armenia
Březen – poslední neděle
2:00 local wt
Říjen – poslední neděle
2:00 local wt
Australia
Říjen – první neděle
2:00 local wt
Duben – první neděle
2:00 local wt
TM_2011_07_18
17/63
Displej DT20-6 Technická dokumentace
Začátek DST
4000 - Oddělení speciálních zařízení
Konec DST
DST Type den
hodina
den
hodina
Azerbaijan
Březen – poslední neděle
4:00 local wt
Říjen – poslední neděle
4:00 local wt
Brasil
Říjen – třetí neděle
0:00 local wt
Únor – třetí neděle *)
0:00 local wt
Mexico
Duben – první neděle
2:00 local wt
Říjen – poslední neděle
2:00 local wt
Morocco
Duben –první neděle
0:00 local wt
Červenec – poslední neděle 0:00 local st
Nez Zealand
Září – poslední neděle
2:00 local wt
Duben – první neděle
3:00 local st
USA, Canada
Březen – druhá neděle
2:00 local wt
Listopad – první neděle
2:00 local wt
*) Kvůli karnevalu je konec DST posunut o týden v letech 2012, 2015, 2023, 2026, 2034 a 2037
Hraniční data s časy přechodů letní/zimní čas pro jednotlivé roky jsou pro všechny typy přechodů uloženy v souborovém systému ethernetového modulu ME9210 ve formě samostatných textových souborů. Konkrétně se jedná o adresář /etc/TZDST. Jednotlivé soubory obsahují informace o přechodech až do roku 2070 včetně. Při případné budoucí změně pravidel u některého typu přechodů letní/zimní čas stačí dotčený soubor příslušně zeditovat, např. protokolem FTP.
2.6 Obnovení výchozího nastavení, default parametry Pomocí www stránek (kap. 4.3) nebo pomocí přímého řízení protokolem HTTP (kap. 3.1.3.29) lze provést obnovení výchozího továrního nastavení všech parametrů displeje –factory default. Výchozí hodnoty parametrů jsou uloženy v textových souborech umístěných v adresářové struktuře ethernetového modulu. Jejich nastavení je možno změnit pomocí FTP rozhraní. Jméno uživatele je standardně nastaveno jako „root“, heslo je rovněž „root“.Jedná se o tyto soubory: a. /usr/default/ip1.info – IP adresa displeje b. /usr/default/gateway.info – IP adresa brány sítě c. /usr/default/netmask1.info – síťová maska displeje d. /usr/default/ntp.param – seznam NTP serverů a jejich nastavení e. /usr/default/TZDST.param – časová zóna, algoritmus změny letního času f.
/usr/default/WEBpwd.conf – heslo pro přístup k nastavovacím www stránkám
g. /usr/default/DISPdynamic.conf – ostatní parametry, binární soubor
2.7 Napájení, funkce PoE Napájecí napětí je do displeje DT20-6 přivedeno ethernetovým síťovým rozhraním přes konektor D4 (typ RJ-45). DT20-6 splňuje standard PoE IEEE802.3af, vystupuje v roli napájeného zařízení PD (Powered device). Tento standard musí rovněž podporovat síťový switch, k němuž je displej připojen a který displeji poskytuje napájecí napětí - switch představuje napájecí zdroj PSE (Power Sourcing Equipment).
TM_2011_07_18
18/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
Po propojení displeje a switche přímým UTP kabelem CAT5 se displej identifikuje jako zařízení napájecí třídy 2 (Class 2), čímž switchi dává na vědomí, že pro své potřeby bude požadovat výkon až 7 W. Celá iniciační procedura od zasunutí konektoru RJ-45 do rozsvícení časového údaje na displeji trvá asi 2 sekundy. Switch (PSE) může pro přivedení napájecího napětí do displeje (PD) použít jak rezervních párů vodičů v kabelu UTP (piny 4+5 a 7+8 konektoru D4), tak stejnosměrného podložení datových párů TXD a RXD (piny 1+2 a 3+6 konektoru D4) – viz Tabulka 1. Vstupní konektor RJ-45 je integrován v pouzdře ethernetového modulu ME9210 – viz Obr. 3. Napětí přivedené síťovým UTP kabelem ze switche do tohoto konektoru je přes interní diodové usměrňovače vyvedeno z modulu do řadiče PoE, který realizuje funkci HW interface rozhraní PoE. Získané napájecí napětí 48 VDC je galvanicky odděleno a převedeno DC/DC měničem na úroveň 3,3 VDC potřebnou pro napájení interních obvodů displeje. Zem vnitřního zdroje 3,3 VDC je vodivě spojena se všemi kovovými částmi krabičky displeje a je vyvedena na zemnící bod umístěný pod rohovým šroubem M3 zadního víka displeje.
TM_2011_07_18
19/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
3. Přímé řízení a komunikace protokolem HTTP 3.1 Obecný popis Veškerá datová komunikace s displejem DT20-6 probíhá protokolem HTTP. Pomocí této komunikace lze displej řídit nebo lze získávat veškerá data o jeho stavu. Mechanismus komunikace je následující: 1. Navázání spojení TCP na standardní port protokolu HTTP ... 80 2. Vyslání požadavku – pomocí metody POST nebo GET 3. Odpověď na požadavek 4. Uzavření spojení
3.1.1
Požadavek
Požadavky jsou vysílány metodou POST nebo GET, a to na následující adresy: http://
/cgi-bin/CGIget
pro získání stavů
nebo http:///cgi-bin/CGIput
pro změnu stavů
Jak je patrno, WEB server spustí úlohy CGIput nebo CGIget a předá jim jak HTTP záhlaví, tak i datovou oblast v případě metody POST. Součástí požadavku jsou data, která specifikují příkaz, jenž se má provést. Data mají formát: 1. Kód příkazu (Cmd1) a parametry příkazu (Par1_1), (Par2_1) nebo (SPar2_1), (Par3_1) 2. Kód příkazu (Cmd2) a parametry příkazu (Par1_2), (Par2_2) nebo (SPar2_2), (Par3_2) . . N. Kód příkazu (CmdN) a parametry příkazu (Par1_N), (Par2_N) nebo (SPar2_N), (Par3_N) kde N je číslo. Parametry nejsou povinné a záleží na příkazu zda je vyžaduje. Pokud příkaz CmdX vyžaduje parametry, pak to může být: a) jeden číselný parametr Par1_X b) dva číselné parametry Par1_X a Par2_X c) jeden číselný parametr a jeden textový parametr Par1_X a SPar2_X d) jeden textový parametr SPar2_X
TM_2011_07_18
20/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
e) tři číselné parametry Par1_X, Par2_X a Par3_X f) dva číselné parametry a jeden textový parametr Par1_X , SPar2_X a Par3_X kde X je číselná hodnota od 1 do N, přičemž N je počet příkazů v požadavku. Příklad dat požadavku: Cmd1=10&Par1_1=1&Cmd2=51&SPar2_2=10.1.1.100&Par3_2=2&Cmd3=52 Červeně
je 1. příkaz, který vyžaduje jeden číselný parametr.
Modře
je 2. příkaz, který vyžaduje dva číselné a jeden textový parametr.
Zeleně
je 3. příkaz, který nevyžaduje žádný parametr.
Poznámka: Pokud existují parametry příkazu, musí se objevit ihned za kódem příkazu. Následující příklad je špatně: Cmd1=10& Cmd2=51& Par1_1=1&Cmd3=52& SPar2_2=10.1.1.100&Par3_2=2 Následují příklady pro metodu GET a POST které jsou vyslány na IP 10.1.1.195 na port 80. V přikladu je obsah dat která jsou na danou adresu vyslána. V datech je jeden příkaz a to Cmd1=50&Par1_1=255. Podle metody jsou data uložena v adrese (metoda GET) nebo v datové oblasti požadavku (metoda POST). CGIget i CGIput si poradí jak s GET metodou, tak s POST metodou. HTTP záhlaví je zvýrazněno červeně, datová oblast modře. 1. Příklad GET: GET /cgi-bin/CGIget?Cmd1=50&Par1_1=255 HTTP/1.1 Host: 10.1.1.195 Connection: Keep-Alive
2. Příklad POST: POST /cgi-bin/CGIget HTTP/1.1 Content-Type: text/html Host: 10.1.1.195 Content-Length: 18 Expect: 100-continue Cmd1=50&Par1_1=255
3.1.2
Odpověď
Odpověď se skládá z HTTP záhlaví a dat. Data jsou vždy v XML formátu a jsou vygenerována na základě příkazů. Odpověď na oba dva požadavky z předchozích příkladů v kap. 3.1.1 je totožná (HTTP záhlaví červeně, datová oblast modře): HTTP/1.1 200 OK Date: Wed, 18 May 2011 20:39:17 GMT Server: Boa/0.94.14rc21
TM_2011_07_18
21/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
Accept-Ranges: bytes Connection: close Content-type: text/html <Stat Cmd="50" Name="GET_NTP_SERVER_PARAMS" P1="1" P2="0" P3="0"> - 1
- 10.1.1.190
- 1
- 6
- 1
Jak je možné si všimnout, záhlaví neobsahuje položku Content-Length, i když následují data. Konzistence dat se dá ověřit buď uzavřením soketu na straně serveru (displeje) nebo parserem XML dat.
3.1.2.1
Formát XML dat v odpovědi
Na následující ukázce je nejlépe patrná struktura XML dat: <Stat Cmd="kód 1.příkazu" Name="Jméno příkazu" P1="hodnota 1.parametru 1. přikazu" P2=" hodnota 2.parametru 1. příkazu" P3=" hodnota 3.parametru 1. přikazu"> - hodnota 1.položky
. . . - hodnota x.položky
. . . <Stat Cmd="kód m.příkazu" Name="Jméno příkazu" P1="hodnota 1.parametru m. přikazu" P2=" hodnota 2.parametru m. příkazu" P3=" hodnota 3.parametru m. přikazu"> - hodnota 1.položky
. . . - hodnota y.položky
TM_2011_07_18
22/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
Tabulka 5: Popis elementů Element
Popis
KIMstat
Root element – v atributech má základní údaje o generovaných datech pro jednotlivé příkazy z požadavku. Atribut
Popis atributu
err
Textová specifikace chyb, pokud je atribut begin == 0
begin
0 nebo 1 0 … generace se nezdařila (důvod popsán v err) 1 … generace se zdařila
Stat
Item
Element vracející stav provedeného příkazu, který je generován na základě jednoho příkazu – tento element je zastoupen tolikrát, kolik je příkazů v datech požadavku. Atribut
Popis atributu
Name
Textové pojmenování příkazu, který byl proveden na základě položky CmdX v datech příkazu
Cmd
Kód příkazu … kopie hodnoty z položky CmdX v datech příkazu
P1
Hodnota 1. parametru příkazu – kopie dat z položky Par1_X v datech příkazu. Pokud v datech tato položka chybí, je hodnota == 0
P2
Hodnota 2. parametru příkazu – kopie dat z položky Par2_X v datech příkazu. Pokud v datech tato položka chybí, je hodnota == 0
P3
Hodnota 3. parametru příkazu – kopie dat z položky Par3_X v datech příkazu. Pokud v datech tato položka chybí, je hodnota == 0
Položka stavu. Každý příkaz má stav s vlastní množinou položek. Text elementu nese hodnotu položky. Atribut
Popis atributu
Name
Textové pojmenování příkazu, který byl proveden na základě položky CmdX v datech příkazu
TimeVal
Tento atribut se vyskytuje pouze u položek s časem. Hodnota tohoto atributu je hodnotou typu time_t nebo struct timespec. Například: - 10:00:21 18.5.2011
nebo - 1:00:10.487911
Jako první příklad je zvolen příkaz: Cmd_1=50&Par1_1=255
Tento příkaz vrátí parametry všech 4 NTP serverů ke kterým může být displej připojen. Odpověď je následující: <Stat Cmd="50" Name="GET_NTP_SERVER_PARAMS" P1="255" P2="0" P3="0"> - 1
- 195.113.144.201
- 2
- 4
- 0
- 1
- 195.113.144.238
- 3
TM_2011_07_18
23/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
- 6
- 1
- 1
- 147.228.57.10
- 5
- 7
- 0
- 0
- 20.21.22.23
- 1
- 4
- 1
Jako druhý příklad jsou zvoleny dva příkazy v jednom požadavku: Cmd_1=50&Par1_1=255&Cmd_2=5
První příkaz je stejný - vrátí parametry všech 4 NTP serverů ke kterým může být displej připojen. Následuje příkaz vracející stav zobrazovací jednotky. Odpověď je následující: <Stat P3="0" P2="0" P1="255" Name="GET_NTP_SERVER_PARAMS" Cmd="50"> - 1
- 195.113.144.201
- 2
- 4
- 0
- 1
- 195.113.144.238
- 3
- 6
- 1
- 1
- 147.228.57.10
- 5
- 7
- 0
- 0
- 20.21.22.23
- 1
- 4
- 1
<Stat P3="0" P2="0" P1="0" Name="GET_LCD" Cmd="5"> - 8
- 0 32 0 50 0 58 0 48 0 54 64 58 0 49 0 56 0 1
- 2:06:18
- 1
- 0
- 10:10:11
3.1.3
Jednotlivé příkazy
Postupně jsou popsány všechny příkazy a odpovědi na ně.
TM_2011_07_18
24/63
Displej DT20-6 Technická dokumentace
3.1.3.1
4000 - Oddělení speciálních zařízení
Získání struktury položek zadávaných do řídící jednotky displeje Příkaz Kód příkazu
1
1.parametr
Nevyžadován
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIget
Odpověď Stat Name
"GET_DYNPARAMS"
Položky
Jméno
Význam
1.
"LampTest"
Hodnota 0 .. 3
2.
"IntensityRG"
Hodnota 0 .. 127
3.
"ColorModeTIM"
Hodnota 0 .. 3
4.
"ColorModeDAT"
Hodnota 0 .. 3
5.
"ColorModeWT"
Hodnota 0 .. 3
6.
"ActualMode"
Hodnota 0 .. 5 0 … mod čas 1 … mod datum 2 … mod stopky 3 … mod text
7.
"AutoBrightCntl"
Hodnota 0, 1
8.
"OffsetABCntl"
Hodnota -15 .. 15
9.
"TimeDelayABCntl"
Hodnota 0 .. 3
10.
"RemoteABCntl"
Hodnota 0 .. 127
11.
"VolumeKey"
Hodnota 0 .. 3
12.
"RdnNullsMonth"
Hodnota 0, 1
13.
"RdnNullsDay"
Hodnota 0, 1
14.
"RdnNullsHour"
Hodnota 0, 1
15.
"RdnNullsMin"
Hodnota 0, 1
16.
"RdnNullsSec"
Hodnota 0, 1
Tímto příkazem získáme XML data, která popisují strukturu položek, které používá řadič displeje pro nastavení potřebných vlastností. Viz. technický popis.
TM_2011_07_18
25/63
Displej DT20-6 Technická dokumentace
3.1.3.2
4000 - Oddělení speciálních zařízení
Nastavení položek struktury zadávané do řídící jednotky displeje a popřípadě zapsání struktury do řídící jednotky Příkaz Kód příkazu
2
1.parametr
Id. položky nebo Id. položky + 256 Id = 1 ... položka "LampTest" Id = 2 ... položka "IntensityRG" Id = 3 ... položka "ColorModeTIM" Id = 4 ... položka "ColorModeDAT" Id = 5 ... položka "ColorModeWS" Id = 6 ... položka "ActualMode" Id = 7 ... položka "AutoBrightCntl" Id = 8 ... položka "OffsetABCntl" Id = 9 ... položka "TimeDelayABCntl" Id = 10 ... položka "RemoteABCntl" Id = 11 ... položka "VolumeKey" Id = 12 ... položka "RdnNullsMonth" Id = 13 ... položka "RdnNullsDay" Id = 14 ... položka "RdnNullsHour" Id = 15 ... položka "RdnNullsMin" Id = 16 ... položka "RdnNullsSec"
2. parametr
Hodnota položky
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_DYNPARAM"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Tímto příkazem se zadávají hodnoty jednotlivých položek dat, které používá řadič displeje. Pokud je k hodnotě Id přičteno 256, je celá struktura všech parametrů přenesena z op. paměti displeje do interního řadiče. Jako příklad je uveden požadavek na zadání dvou položek "LampTest" a "ActualMode". Při zadání 2. položky je proveden zápis celé struktury do interního řadiče. Cmd=2&Par1_1=1&Par2_1=1&Cmd2=1&Par1_2=6&Par2_2=259
TM_2011_07_18
26/63
Displej DT20-6 Technická dokumentace
3.1.3.3
4000 - Oddělení speciálních zařízení
Získání položek struktury všech informací pro správu displeje Příkaz Kód příkazu
5
1.parametr
Nevyžadován
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIget
Odpověď Stat Name
"GET_LCD"
Položky
Jméno
Význam
1.
"BlinkTimes"
Hodnota s nastavením period blikání (1.byte data telegramu) naposledy předávaná řadiči displeje
2.
"HWLCDChars"
18 hodnot 1.atribut 1.znak . . 9.atribut 9. znak Tato data reprezentují dvojici atribut, znak pro všech 9 pozic LED zobrazovačů, které byly naposled poslány řadiči
3.
"HWLCDText"
Text který je v daném okamžiku zobrazen na LED zobrazovačích
4.
"HWLCDSign"
Hodnota posledního znaku … na LED zobrazovačích reprezentuje indikovaný mód – jde o hodnotu naposled poslanou řadiči Může nabývat těchto hodnot: 0 … text 1 … čas 2 … datum 4 … stopky
5.
"LOGLCDType"
Mód (mód) displeje Může nabývat těchto hodnot: 0 … čas 1 … datum 2 … stopky 3 … text 5 …. datum delay (automaticky se po 5 sekundách přepne do módu 0)
6.
TM_2011_07_18
"LOGLCDText"
Statický text, který se zobrazuje, pokud je displej v módu text
27/63
Displej DT20-6 Technická dokumentace
3.1.3.4
4000 - Oddělení speciálních zařízení
Nastavení položek struktury všech informací pro správu displeje Příkaz Kód příkazu
6
1.parametr
Id položky
2. parametr
Hodnota položky
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_LCD"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
3.1.3.5
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Nastavení textu, který se zobrazí v textovém módu Příkaz Kód příkazu
7
1.parametr
Nevyžadován
2. parametr
Text
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_LCD_TEXT"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
TM_2011_07_18
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
28/63
Displej DT20-6 Technická dokumentace
3.1.3.6
4000 - Oddělení speciálních zařízení
Nastavení módu displeje Příkaz Kód příkazu
8
1.parametr
Mód: 0 ... čas 1 ... datum 2 ... stopky 3 ... text 5 ... datum s automatickým přechodem na čas
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_LCD_MODE"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
3.1.3.7
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Získání stavu stopek Příkaz Kód příkazu
9
1.parametr
Nevyžadován
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIget
Odpověď Stat Name
"GET_STOPWATCH"
Položky
Jméno
Význam
1.
“Status“
Stav stopek – číslo je logickým součtem následujících elementů Stopky se používají
……. 8000H
Stopky běží
…….. 0001H
Stopky „mezičas“
…...... 0002H
Stopky zastaveny
…….. 0004H
Stopky v módu „HH:MM:SS“ ...... 4000H 2.
“Time“
Aktuální čas stopek
3.
“LapTime“
Čas stopek pro „mezičas“
TM_2011_07_18
29/63
Displej DT20-6 Technická dokumentace
3.1.3.8
4000 - Oddělení speciálních zařízení
Nastavení stopek Příkaz Kód příkazu
10
1.parametr
0 ... reset stopek 1 ... start stopek 2 ... sejmout mezičas 3 ... stop 256 ... mód MM:SS.ms 257 ... mód HH:MM:SS
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_LCD_MODE"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
3.1.3.9
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Nahrát lokální čas z RTC Příkaz Kód příkazu
11
1.parametr
Nevyžadován
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_RTC_LOAD"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Tento příkaz zajistí, že se provede aktualizace systémového času ze zálohovaného RTC obvodu.
TM_2011_07_18
30/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
3.1.3.10 Uložit lokální čas do RTC Příkaz Kód příkazu
12
1.parametr
Nevyžadován
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_RTC_SAVE"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Tento příkaz zajistí, že se provede aktualizace času v zálohovaném RTC obvodu časem systémovým převedeným na lokální čas.
3.1.3.11 Nastavit systémový čas Příkaz Kód příkazu
20
1.parametr
UTC čas jako počet sekund od 1.1.1970
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_TIME"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Tento příkaz zajistí, že se provede aktualizace systémového času časem z 1. parametru.
TM_2011_07_18
31/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
3.1.3.12 Získat konfigurační parametry pro NTP server Příkaz Kód příkazu
50
1.parametr
Index NTP serveru 0 … 1.server . 3 … 4.server 255 … všechny servery
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIget
Odpověď Stat Name
"GET_NTP_SERVER_PARAMS"
Položky
Jméno
Význam
1.
"Used_X"
Hodnota 0,1 0 .. X-tý server se nepoužívá (není v NTP konfiguraci) 1 .. X-tý server se používá (je v NTP konfiguraci) kde X =0 pro 1. server, … =3 pro 4. server
2.
"URL_X"
Adresa X-tého serveru (musí být IP, protože displej nepracuje s DNS) kde X =0 pro 1. server, … =3 pro 4. server
3.
"MinPoll_X"
Hodnota minpoll pro X-tý server (viz. NTP konfigurace) kde X =0 pro 1. server, … =3 pro 4. server
4.
"MaxPoll_X"
Hodnota maxpoll pro X-tý server (viz. NTP konfigurace) kde X =0 pro 1. server, … =3 pro 4. server
5.
"Prefer_X"
Hodnota prefer pro X-tý server (viz. NTP konfigurace) kde X =0 pro 1. server, … =3 pro 4. server
Pokud je 1.parametr příkazu roven 255, v odpovědi se objeví všechny 4 servery. Položek pak není 5, ale 20. Jako příklad je uveden příkaz, který vyžádá konfigurační parametry všech serverů: Cmd1=50&Par1_1=255
Tento příkaz vrátí konfigurační parametry všech serverů: <Stat Cmd="50" Name="GET_NTP_SERVER_PARAMS" P1="255" P2="0" P3="0"> - 1
- 195.113.144.201
- 2
- 4
TM_2011_07_18
32/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
- 0
- 1
- 195.113.144.238
- 3
- 6
- 1
- 1
- 147.228.57.10
- 5
- 7
- 0
- 0
- 20.21.22.23
- 1
- 4
- 1
3.1.3.13 Zadat konfigurační parametry pro NTP server Příkaz Kód příkazu
51
1.parametr
Index NTP serveru, pro který má být parametr nastaven 0 … 1.server . 3 … 4.server
2. parametr
Text popisující hodnotu parametru – určen 3. parametrem
3. parametr
Id parametru Id = 1 … Parametr “Used” Id = 2 … Parametr “URL” Id = 3 … Parametr “Minpoll” Id = 4 … Parametr “Maxpoll” Id = 5 … Parametr “Prefer”
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_NTP_SERVER_PARAM"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Příkaz pouze uloží parametry do interní paměti. Aby se projevily v běžící konfiguraci, musí být nastaven ještě následující příkaz Uložit konfigurační parametry pro NTP systém. Jako příklad je uveden příkaz, který zadá URL 1. serveru na 10.7.1.5: Cmd1=51&Par1_1=0&SPar2_1=10.7.1.5&Par3=2
TM_2011_07_18
33/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
3.1.3.14 Uložit konfigurační parametry pro NTP systém Příkaz Kód příkazu
52
1.parametr
Nevyžadován
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_NTP_SERVER_PARAMS_SAVE"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Příkaz uloží parametry z interní paměti do požadovaných konfiguračních souborů, které využívá NTP systém k parametrizaci své činnosti.
3.1.3.15 Restart systému NTP Příkaz Kód příkazu
201
1.parametr
Nevyžadován
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_RESTART_NTPD"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Příkaz restartuje NTP systém, ten se parametrizuje během restartu z konfiguračních souborů.
TM_2011_07_18
34/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
3.1.3.16 Získání stavu NTP systému Příkaz Kód příkazu
70
1.parametr
Nevyžadován
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIget
Odpověď Stat Name
"GET_NTP_STATUS"
Položky
Jméno
Význam
1.
"Sync"
NTP systém je synchronizován
2.
"last_time"
Lokální čas systému, ke kterému se všechny vzorky vztahují
3.
"last_offset"
Offset systémového času vůči referenčnímu času.
4.
"drift_comp"
Vypočtená odchylka systémového tiku v pps
5.
"clock_stability"
Stabilita systémového času
6.
"sys_leap"
LEAP systému NTP
7.
"sys_stratum"
STRATUM systému NTP
8.
"sys_rootdelay"
Delay systému ke kořenovému referenčnímu času (dle specifikace NTP)
9.
"sys_rootdispersion"
Rozptyl systémového času
TM_2011_07_18
35/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
3.1.3.17 Získání stavu o NTP serveru nebo všech NTP serverech Příkaz Kód příkazu
71
1.parametr
Index prvního NTP serveru, pro který chceme získat stav
2. parametr
Počet NTP serverů, nebo -1, což je počet až do konce, od kterých chceme získat stav
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIget
Odpověď Stat Name
"GET_NTP_SERVER_STATUS"
Položky
Jméno
Význam
1.
"NumAccess_X"
Počet přístupů na X-tý NTP server po restartu NTP systému kde X je 0 až 3
2.
"Stratum_X"
Stratum X-tého NTP serveru kde X je 0 až 3
3.
"last_time_X"
Čas posledního přístupu k X-tému NTP serveru kde X je 0 až 3
4.
"last_offset_X"
Offset systémového času k systémovému času X-tého NTP serveru po posledním přístupu kde X je 0 až 3
3.1.3.18 Získání informací o TIME ZONE a Daylight Saving Time Příkaz Kód příkazu
80
1.parametr
Nevyžadován
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIget
Odpověď Stat Name
"GET_TZ_DST_STATUS"
Položky
Jméno
Význam
1.
"TZOffset"
Offset TIMEZONE oproti UTC v sekundách
2.
"UseDST"
Je používán DST
3.
"IsDST"
Je DST právě nyní
4.
"DSTSpec"
Textová specifikace typu DST
5.
"DSTSpecId"
Vnitřní číselný identifikátor typu DST (zatím nemá pro uživatele význam)
TM_2011_07_18
36/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
3.1.3.19 Zadání parametrů pro TIME ZONE a Daylight Saving Time Příkaz Kód příkazu
81
1.parametr
Id parametru, který chceme zadat 1 ... TZOffset 2 ... UseDST 3 ... DSTSpecId 4 ... DSTSpec Pokud je k Id přičtena hodnota 256, je automaticky provedeno uložení všech parametrů do souboru. Jinak jsou parametry změněny pouze v paměti.
2. parametr
Specifikace hodnoty parametru Id = 1 ... počet sekund TZOffset Id = 2 ... 0 - nepoužívat DST, 1- používat DST Id = 3 ... číselná hodnota DSTSpecId Id = 4 ... text DSTSpec
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_TZ_DST_PARAM"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Jako příklad je uveden příkaz, který nastaví TZOffset pro střední Evropu a povolí používat DST, který se řídí metodikou EU. Po zadání posledního parametru provede uložení do souboru: Cmd1=81&Par1_1=1&SPar2_1=3600& Cmd2=81&Par1_2=1&SPar2_2=1& Cmd3=81&Par1_1=260&SPar2_1=All EU countries
TM_2011_07_18
37/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
3.1.3.20 Zadání nové TIME ZONE a Daylight SavingTime pro NTP systém Příkaz Kód příkazu
85
1.parametr
Nevyžadován
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_NTPD_NEW_TZ_DST"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Příkaz pouze informuje NTP systém, že byla nastavena TIMEZONE nebo DST. Pokud by nebyl zadán, NTP systém by s novým zadáním začal pracovat až po svém restartu nebo restartu systému. Vliv TIMEZOME a DST na NTP systém se projeví pouze na www stránkách.
3.1.3.21 Zadání nové TIME ZONE a Daylight Saving Time pro DISPLEJ systém Příkaz Kód příkazu
86
1.parametr
Nevyžadován
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_DISPLAY_NEW_TZ_DST"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Příkaz pouze informuje systém displeje, že byla nastavena TIMEZONE nebo DST. Pokud by nebyl zadán, systém displeje by s novým zadáním začal pracovat až restartu systému. Vliv TIMEZOME a DST na NTP systém se projeví na WEB stránkách a při přenosu do-z RTC zálohovaného obvodu.
TM_2011_07_18
38/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
Jako příklad je uveden příklad z kapitoly 3.1.3.19, ale je doplněn o zadání pro NTP systém a systém displeje. Cmd1=81&Par1_1=1&SPar2_1=3600& Cmd2=81&Par1_2=1&SPar2_2=1& Cmd3=81&Par1_1=260&SPar2_1=All EU countries&Cmd4=85&Cmd5=86
3.1.3.22 Získání IP adresy Příkaz Kód příkazu
101
1.parametr
Hodnota 0, 1 0 … aktuální IP adresa, pod kterou je displej dosažitelný 1 … změněná adresa - pokud po restartu již adresu někdo měnil, jinak je stejná jako aktuální
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIget
Odpověď Stat Name
"GET_IP_ADDR"
Položky
Jméno
Význam
1.
“ip1“
Text popisující IP adresu
3.1.3.23 Zadání IP adresy Příkaz Kód příkazu
111
1.parametr
Text popisující IP adresu
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
" SET_IP_ADDR"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Adresa IP je zadána, ale není aktuální, displej je stale dosažitelný pod IP adresou aktuální, která se nastaví při startu. Zadaná IP adresa se stane aktuální až po restartu.
TM_2011_07_18
39/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
3.1.3.24 Získání adresy brány Příkaz Kód příkazu
102
1.parametr
Hodnota 0, 1 0 … aktuální adresa brány, kterou displej používá 1 … změněná adresa brány - pokud po restartu již adresu někdo měnil, jinak je stejná jako aktuální
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIget
Odpověď Stat Name
"GET_GTW_ADDR"
Položky
Jméno
Význam
1.
“gateway“
Text popisující adresu brány
3.1.3.25 Zadání adresy brány Příkaz Kód příkazu
112
1.parametr
Text popisující adresu brány
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_GTW_ADDR"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Adresa brány je zadána, ale není aktuální. Displej stále používá adresu aktuální brány, která se nastaví při startu. Zadaná adresa brány se stane aktuální až po restartu.
TM_2011_07_18
40/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
3.1.3.26 Získání síťové masky Příkaz Kód příkazu
103
1.parametr
Hodnota 0, 1 0 … aktuální síťová maska, kterou displej používá 1 … změněná síťová maska - pokud po restartu již síťovou masku někdo měnil, jinak je stejná jako aktuální
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIget
Odpověď Stat Name
"GET_NET_MASK"
Položky
Jméno
Význam
1.
“ netmask1“
Text popisující síťovou masku
3.1.3.27 Zadání síťové masky Příkaz Kód příkazu
113
1.parametr
Text popisující síťovou masku
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_NET_MASK"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
Síťová maska je zadána, ale není aktuální. Displej stále používá síťovou masku aktuální, která se nastaví při startu. Zadaná síťová maska se stane aktuální až po restartu.
TM_2011_07_18
41/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
3.1.3.28 Získání MAC adresy Příkaz Kód příkazu
104
1.parametr
Nevyžadován
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIget
Odpověď Stat Name
"GET_MAC_ADDR"
Položky
Jméno
Význam
1.
“ethaddr1“
Text popisující MAC adresu ve formátu XX:XX:XX:XX:XX:XX
3.1.3.29 Nastavení default parametrů Příkaz Kód příkazu
120
1.parametr
Hodnota 0,1 0 … po nastavení default hodnot systému se neprovádí restart 1 … po nastavení default hodnot systému se provede restart
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_DEFAULT"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
TM_2011_07_18
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
42/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
3.1.3.30 Příkaz k rebootu řadiče displeje Příkaz Kód příkazu
200
1.parametr
Hodnota 1
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_CLIENT_REBOOT"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
3.1.3.31 Příkaz k rebootu systému Příkaz Kód příkazu
200
1.parametr
Hodnota 2
2. parametr
Nevyžadován
3. parametr
Nevyžadován
Adresa
/cgi-bin/CGIput
Odpověď Stat Name
"SET_MASTER_REBOOT"
Položky
Jméno
Význam
1.
"Result"
Hodnota 0,1 0 .. proběhlo OK 1 .. chyba
2.
TM_2011_07_18
"ErrorSpec"
Pokud proběhlo s chybou, tak zde je textový popis chyby
43/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
4. WWW stránky Interní www stránky displeje slouží pro diagnostiku stavu zařízení, změnu nastavených parametrů a pro dálkové řízení funkce displeje. Pro tyto účely obsahuje displej dílčí stránky: - Status s podstránkami: - main - advanced - Settings s podstránkami: - main - advanced - NTP servers Obě www stránky Status jsou v okně prohlížeče automaticky aktualizovány každé dvě sekundy. Stránky Settings jsou statické. Veškeré zde zobrazené časové údaje jsou odvozeny od vnitřního časového zdroje displeje.
4.1 Status – main Stránka Status - main (Obr. 6) obsahuje čtyři sekce: - NTP servers - Display - Time Zone, DST - Ethernet Sekce NTP servers obsahuje tyto položky: - Time sync: indikuje zda je nebo není interní časový zdroj považován za synchronní s alespoň jedním NTP serverem uvedeným v seznamu NTP serverů. Možné stavy indikátoru: - YES - interní časový zdroj je synchronizován - NO - interní časový zdroj není synchronizován - Server#n: pro každý z až čtyř definovaných NTP serverů jsou zde uvedeny následující parametry: - URL - IP adresa NTP serveru - Last time - datum a čas poslední platné odpovědi serveru na dotaz NTP klienta displeje. Uvedená informace je v čase aktuálně zvoleného časového pásma, s respektováním případné volby letního času (DST). - Num acc - počet platných odpovědí NTP serveru na dotazy NTP klienta displeje. Údaj se nuluje při každém restartu úlohy NTP klienta. - Unsynchronise timeout: nastavená hodnota parametru v minutách. Definuje časovou prodlevu od posledního úspěšného dotazu na alespoň jeden dostupný NTP server ze seznamu
TM_2011_07_18
44/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
serverů, po jejímž vypršení je vnitřní časový zdroj displeje označen jako nesynchronní. Parametr lze nastavit v rozsahu 1 až 999 minut. Bližší info viz kap. 2.5.1.2.
Obr. 6: Stránka Status - main Sekce Display obsahuje tyto položky: - Contetnt: aktuální údaj právě zobrazený na LED zobrazovačích displeje. Údaj je spolu s celým oknem prohlížeče automaticky aktualizován každé dvě sekundy. - Mode: aktuální mód zobrazení časové informace. Možné stavy indikátoru: - Time - Date in delay - Date TM_2011_07_18
45/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
- Stop Watch - Text - Text: Nastavený textový řetězec (0 až 8 znaků) pro zobrazení na displeji v módu text. - Stop Watch: stav stopek.Možné stavy: - Stop - stopky jsou zastaveny - Start - stopky čítají čas - Reset - stopky byly vynulovány - StopWatch mode: indikuje zvolený formát čítání času stopek (viz kap. 2.2.4): - HH:MM:SS - stopky měří čas s rozlišením 1 sekunda - MM:SS:m0 - stopky měří čas s rozlišením 0,1 sekundy Sekce Time Zone, DST obsahuje tyto položky: - Time zone offset: aktuální zvolené časové pásmo. Bližší info viz. kap. 2.5.2. - Use DST: zda používat (YES) nebo nepoužívat (NO) automatické přechody na letní čas (DST). - DST type: vybraný algoritmus přechodů na letní čas (DST). Bližší info viz. kap. 2.5.3. Sekce Ethernet obsahuje tyto volby: - IP address: aktuálně nastavená IP adresa displeje. Bližší info viz. kap. 2.4.2 - Gateway address: aktuálně nastavená IP adresa brány (gateway). Bližší info viz. kap. 2.4.2. - Net mask: aktuálně nastavená maska sítě. Bližší info viz. kap. 2.4.2 - MAC address: jedinečná MAC adresa displeje. Bližší info viz. kap. 2.4.1
4.2 Status – advanced Stránka Status - advanced (Obr. 7) obsahuje jedinou sekci: - Display Sekce Display obsahuje tyto položky: - Lamp Test: nastavený rozsah úvodního lamp testu LED zobrazovačů po připojení napájecího napětí displeje nebo po jeho restartu. Parametr je nastaven v rozsahu 0 až 3 – bližší viz. kap. 2.2.6. - Actual mode: aktuální mód zobrazení časové informace na LED zobrazovačích – viz. kap. 2.2. - AutoBrightCntl: automatická regulace jasu: zapnuta (1) nebo vypnuta (0). - OffsetABCntl: nastavená hodnota ofsetu automatické regulace jasu LED zobrazovačů displeje. Bližší viz. kap. 2.3. Rozsah nastavení parametru je -15 až +15. TM_2011_07_18
46/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
- TimeDelayABCntl: nastavená hodnota časového zpoždění reakce automatické regulace jasu na změnu intenzity okolního osvětlení. Bližší viz. kap. 2.3. Parametr je nastaven v rozsahu 0 až 3. - Remote ABCntl: nastavená hodnota jasu LED zobrazovačů displeje při vypnuté automatické regulaci jasu. Bližší viz. kap. 2.3. Rozsah nastavení parametru je 0 (min) až 127 (max). - Volume Key: nastavená hodnota intenzity akustické indikace stisku tlačítek displeje – viz. kap. 2.2.1. Parametr je nastaven v rozsahu 0 až 3. - RedundandNULLs: nastavení potlačení zobrazení nadbytečných nul u údaje měsíce, dne, hodiny, minuty či sekundy. Bez potlačení nadbytečných nul (0) nebo s potlačením nadbytečných nul (1).
Obr. 7: Stránka Status – advanced
4.3 Settings – main Stránka Settings - main (Obr. 8) obsahuje pět sekcí: - Display - Time Zone, DST - Ethernet - WEB - System
TM_2011_07_18
47/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
Obr. 8: Stránka Settings – main Sekce Display obsahuje tyto položky: - Mode: Rozkliknutím tohoto nastavovacího políčka je možno zvolit požadovaný mód zobrazení časové informace na LED displeji. Zvolený mód je ihned nastaven. Lze vybrat z těchto možností (viz kap. 2.2): - Time – mód čas - Date – mód datum, trvale zobrazen - Date in delay - mód datum, po 5 s přejde do módu čas. - Stop watch – mód stopky - Text – mód text - Text: Editací segmentu lze zapsat až osm znaků, které budou v módu text zobrazeny na LED zobrazovačích – viz. kap. 2.2.5. Zapsané znaky je nutno potvrdit tlačítkem Set. - StopWatch mode: Rozkliknutím tohoto nastavovacího políčka je možno zvolit jeden ze dvou možných formátů měření času pomocí stopek – viz. kap. 2.2.4:
TM_2011_07_18
48/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
- HH:MM:SS – s rozlišením 1 sec - MM:SS:m0 – s rozlišením 0,1 sec Zvolený formát je ihned nastaven, bez ohledu na to, zda stopky běží nebo jsou zastaveny. - Actual time: Stisknutím tlačítka Set je časový zdroj displeje jednorázově zasynchronizován s časem počítače, z něhož jsou www stránky prohlíženy. Poznámka: Toto nastavení může být užitečné v situaci, kdy byl displej dlouhodobě odstaven a jeho vnitřní RTC obvod již obsahuje neaktuální časovou informaci. Od zapnutí displeje do zasynchronizování jeho časového zdroje z NTP serveru by byl zobrazován neaktuální časový údaj, čemuž lze takto předejít. Sekce Time Zone, DST obsahuje tyto položky: - Time zone offset: rozkliknutím tohoto nastavovacího políčka je možno zvolit požadované časové pásmo – viz. kap. 2.5.2. Zvolené pásmo je ihned nastaveno. - Use DST: zaškrtávací políčko určující zda bude nebo nebude aplikováno pravidlo pro přechody letní/zimní čas – viz. kap. 2.5.3. Provedená volba je ihned akceptována. - DST type: rozkliknutím tohoto nastavovacího políčka je možno vybrat požadovaný typ algoritmu pro určení přechodů letní/zimní čas – viz. kap. 2.5.3 a Tabulka 4. Sekce Ethernet obsahuje tyto položky: - IP address: IP adresa displeje. Je možno ji měnit editací příslušného segmentu. - Gateway address: Slouží k nastavení IP adresy brány do jiných TPC/IP sítí. Je možno ji měnit editací příslušného segmentu. - Net mask: síťová maska. Po rozkliknutí nastavovacího políčka lze vybrat jednu ze tří nabízených masek: 255.255.255.0, 255.255.0.0. nebo 255.0.0.0. - Tlačítko Save: stisknutí tohoto tlačítka vyvolá zobrazení následujícího dialogového okna:
Po jeho potvrzení jsou všechny položky sekce Ethernet uloženy do vnitřní EPROM ethernetového modulu. Nejsou však zatím akceptovány, provedené změny se uplatní až po restartu displeje nebo po jeho vypnutí a zapnutí. - Tlačítko Save and restart: stisknutí tohoto tlačítka vyvolá zobrazení následujícího dialogového okna:
Po jeho potvrzení jsou všechny položky sekce Ethernet uloženy do vnitřní EPROM ethernetového modulu a následně je proveden restart ethernetového modulu i řadiče displeje. Provedení restartu trvá asi 1 minutu, během něj dojde k „zamrznutí“ zobrazeného údaje. TM_2011_07_18
49/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
Sekce WEB obsahuje tuto položku: - Password: stisknutím tohoto tlačítka je možno upravit heslo pro přístup do www stránek Settings. Zobrazí se dialogové okno pro změnu hesla (viz. Obr. 9). V něm je nutno potvrdit staré heslo a 2x zadat nové heslo. Stiskem tlačítka Accept je změna přijata, následně lze okno zavřít stiskem tlačítka Close.
Obr. 9: Dialogové okno pro změnu hesla Sekce System obsahuje tuto položku: - Tlačítko Factory default and restart: stisknutí tohoto tlačítka vyvolá zobrazení následujícího dialogového okna:
Po jeho potvrzení jsou v displeji obnovena veškerá výchozí tovární nastavení – viz. kap. 2.6.
4.4 Settings – advanced Stránka Settings - advanced (Obr. 10) obsahuje jednu sekci: - Display Změnu nastavení jednotlivých položek Sekce Display je nutno potvrdit buď stiskem tlačítka Set umístěného u editované položky nebo hromadně pro všechny položky stiskem tlačítka SetAll na konci celé sekce.
TM_2011_07_18
50/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
Obr. 10: Stránka Settings – advanced Sekce Display obsahuje tyto položky: - Lamp Test: zadáním jedné ze čtyř možností lze určit rozsah úvodního lamp testu LED zobrazovačů po připojení napájecího napětí displeje nebo po jeho restartu. Parametr je nastavitelný v rozsahu 0 až 3 – bližší viz kap. 2.2.6. - Actual Mode: rozkliknutím tohoto nastavovacího políčka lze vybrat mód zobrazení časové informace na LED zobrazovačích, který bude zobrazen po připojení napájecího napětí displeje nebo po jeho restartu. Pokud však po provedení tohoto nastavení dojde ke stisku tlačítka Mode a ke změně módu zobrazení, je jako výchozí mód použit posledně zobrazený mód. Lze vybrat z těchto možností: - Time – mód čas TM_2011_07_18
51/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
- Date – mód datum, trvale zobrazen - Stop watch – mód stopky - Text – mód text - AutoBrightCntl: zaškrtávací políčko určující zda bude nebo nebude aktivní funkce automatické regulace jasu LED zobrazovačů displeje – viz. kap. 2.3. - OffsetABCntl: editací segmentu lze nastavit požadovaný ofset automatické regulace jasu – viz. kap. 2.3. Zadat lze hodnotu v rozsahu -15 až +15. - TimeDelayABCntl: zadáním jedné ze čtyř možností lze nastavit hodnotu časového zpoždění reakce automatické regulace jasu na změnu intenzity okolního osvětlení. Bližší viz. kap. 2.3. Lze vybrat z těchto možností: - None - bez zpoždění - Fast - rychlá - Middle - střední - Slow - pomalá - RemoteABCntl: editací segmentu lze nastavit požadovanou hodnota jasu LED zobrazovačů displeje při vypnuté automatické regulaci jasu. Bližší viz. kap. 2.3. Rozsah nastavení parametru je 0 (min) až 127 (max). - Volume Key: zadáním jedné ze čtyř možností lze nastavit hodnotu intenzity akustické indikace stisku tlačítek displeje – viz. kap. 2.2.1. Lze vybrat z těchto možností: - 0 - bez akustické indikace - 1 - krátká akustická indikace - 2 - středně dlouhá akustická indikace - 3 - dlouhá akustická indikace - RedundandNULLs: zaškrtávací políčka určující, zda bude nebo nebude při zobrazení aplikováno potlačení zobrazení nadbytečných nul u údajů: - Month - měsíce - Day - dne - Hour - hodiny - Min - minuty - Sec - sekundy.
4.5 Settings – NTP servers Stránka Settings – NTP servers (Obr. 11) obsahuje seznam až čtyř NTP serverů, které NTP klient displeje používá k synchronizaci svého vnitřního časového zdroje.
TM_2011_07_18
52/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
Obr. 11: Stránka Settings – NTP servers Jednotlivé sloupce seznamu mají následující význam: - Server: obsahuje pořadové číslo NTP serveru. Pod tímto číslem je server identifikován. - Used: zaškrtávací políčko určující zda interní NTP klient má nebo nemá komunikovat s NTP serverem - Server URL: IP adresa NTP serveru - Prefered: zaškrtávací políčko určující zda je nebo není server preferován před ostatními - Minpool: rozkliknutím tohoto nastavovacího políčka lze vybrat minimální periodu v úvodní sérii dotazů NTP klienta na NTP server. Lze vybrat z těchto možností : 4, 8, 16, 32, 64, 128, 256, 512 s. - Maxpool: rozkliknutím tohoto nastavovacího políčka lze vybrat maximální periodu v úvodní sérii dotazů NTP klienta na NTP server. Lze vybrat z těchto možností : 4, 8, 16, 32, 64, 128, 256, 512 s. Dále stránka obsahuje tyto položky: - Unsynchronise timeout: editací segmentu lze nastavit požadovanou hodnotu tohoto parametru. Bližší info viz. kap. 2.5.1.2. Rozsah nastavení parametru je 1až 999. - Tlačítko Set and restart NTP connections: stisknutí tohoto tlačítka uloží nastavené parametry celé stránky a restartuje úlohu NTP klienta v ethernetovém modulu. Od tohoto okamžiku je indikována ztráta synchronizace, NTP klient zahájí úvodní sérii NTP dotazů.
TM_2011_07_18
53/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
5. JAVA API pro přímé řízení displeje Pro komunikaci s displejem DT20-6 je možné použít konzolovou JAVA aplikaci DISPLAYapp. Tato aplikace provede komunikaci s jednotkou protokolem HTTP a na standardní výstup vypíše XML data, která vrátí displej. Komunikace protokolem HTTP je podrobně popsána v kapitole 3. Veškeré informace o použití programu se vypíší pokud je zadán následující příkaz. java -jar DISPLAYapp.jar /h
nebo java -jar DISPLAYapp.jar /?
Jak je patrno z vypsaných informací, na příkazovém řádku je možné specifikovat jednotlivé příkazy, které se najednou odešlou do displeje, a to buď pro CGIput (přepínač /PP) nebo CGIget (přepínač /PG). Přepínačům /PP nebo /PG se lze vyhnout a za přepínač /S lze napsat specifikace IP adresy i stránky například: java -jar DISPLAYapp.jar /S "10.7.1.5" /PG /c 50 /p1 255
má stejnou funkci jako java -jar DISPLAYapp.jar /S "10.7.1.5/cgi-bin/CGIget" /c 50 /p1 255
Jako příklad je zvolen příkazový řádek, zadá 2 příkazy: 1. Příkaz 50 s parametrem Param1=255, který vrátí informace o konfiguraci všech NTP serverů 2. Příkaz 101 s parametrem Param1=0, který vrátí informace o aktuálně přednastavené IP adrese Zde je příkaz: java -jar DISPLAYapp.jar /S "10.7.1.5" /PG /c 50 /p1 255 /c 101 /p1 0
Zde je odpověď, která je vypsána na standardní výstup: <Stat Cmd="50" Name="GET_NTP_SERVER_PARAMS" P1="255" P2="0" P3="0"> - 3600
- 1
- 10.1.1.177
- 3
- 5
- 1
- 0
- 2
- 4
- 0
- 0
- 3
- 6
- 0
- 0
TM_2011_07_18
54/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
- 2
- 4
- 0
<Stat Cmd="101" Name="GET_IP_ADDR" P1="0" P2="0" P3="0"> - 10.1.1.190
Výstup je možné přesměrovat do souboru nebo rourou do XML parseru.
TM_2011_07_18
55/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
6. Instalace a obsluha displeje Displej DT20-6 není určen k provozu ve venkovním prostředí, jeho krytí je IP30.
6.1 Instalace Mechanické řešení
6.1.1
Displej DT20-6 je určen k montáži do panelu, kde je fixován pomocí dvou rozpěrných šroubů M4x29 nebo přes čtyři otvory ∅4mm skryté pod krycí fólií v rozích čelního panelu. Pohled na displej je zachycen na Obr. 1. Přesná rozměrová specifikace je na Obr. 2. Rozpěrné šrouby jsou v zadním krytu displeje fixovány v klecových maticích. Ty lze upevnit do jedné ze dvou připravených pozic v zadním krytu a tak přizpůsobit fixační rozsah rozpěrných šroubů různým tloušťkám nosného panelu. Ta může být v rozsahu 3,5 až 34 mm. 214,0 mm 204,0 mm
A
198,1 mm
2,8 mm otvor v nosném panelu
133,0 mm
DT20-6 UTP
113,0 mm
B 122,0 mm
B
DT20-6
M4
18,8 mm
nosný panel
řez A-A
3,5-34 mm
14,0 mm
pohled shora
A
r=
2, 5m m
otvory pro klecovou matici
14 mm
DT20-6 UTP kabel
M4x29
řez B-B
Obr. 12: Doporučený rozměr otvoru v nosném panelu pro montáž DT20-6 Celý čelní panel displeje včetně průhledu na LED zobrazovače a dvou ovládacích tlačítek je kryt odolnou antireflexní fólií. TM_2011_07_18
56/63
Displej DT20-6 Technická dokumentace
6.1.2
4000 - Oddělení speciálních zařízení
Elektrické připojení
Jediným připojovacím konektorem DT20-6 je ethernetový konektor RJ-45 (označen jako D4). Slouží k připojení displeje do sítě Ethernet i k jeho napájení. Použitý síťový switch musí splňovat standard PoE IEEE802.3af a musí mít na svém příslušném portu aktivován výstup PoE. Displej je se síťovým switchem propojen přímým UTP kabelem CAT5 a vyšším. UTP kabel je k displeji připojen přes konektor RJ-45 (D4) – viz Obr. 13.
Switch PoE
RJ-45 UTP kabel
RJ-45
OSC, a.s. Staňkova 18a 612 00 Brno
D4
IP addresa:
NÁZEV: DISPLEJ/HODINY U: 48 VDC (PoE) TYP: DT20-6 P: 7 W max (Class 2) VÝR. Č.: XXXXXX VYROBENO: XX/20XX KONTROLA: MADE IN CZECH REPUBLIC
pohled zezadu
Obr. 13: Připojení dospleje DT20-6 Zemnící bod displeje je umístěn pod rohovým šroubem M3 zadního krytu displeje, který je příslušně označen. Tento zemnící bod je spojen se zemí vnitřního zdroje displeje a se všemi kovovými částmi jeho skříňky.
6.2 Uvedení do provozu Následující text se odkazuje na soubory z adresářové struktury ethernetového modulu ME9210. Ty jsou dostupné pomocí FTP rozhraní. Jméno uživatele je standardně nastaveno jako „root“, heslo je rovněž „root“.
TM_2011_07_18
57/63
Displej DT20-6 Technická dokumentace
6.2.1
4000 - Oddělení speciálních zařízení
Připojení napájecího napětí
Do 2 sekund po připojení UTP kabelu mezi síťovým switchem a konektorem RJ-45 displeje DT20-6 naběhne vnitřní napájecí zdroj displeje. Na LED zobrazovačích displeje je po úvodním lamp testu zobrazena v posledně zvoleném formátu vnitřní časová informace.
6.2.2
Parametry síťového rozhraní
V prvním kroku je třeba nastavit parametry síťového rozhraní. Jsou to: IP adresa Adresa brány Maska sítě Aktuální IP adresa by měla být zapsána na štítku na zadní straně displeje, nebo ji lze dočasně zobrazit dlouhým stiskem obou tlačítek displeje po připojení napájení a naběhnutí displeje nebo po jeho restartu – viz kap. 2.2.7. Pro změnu IP adresy lze využít www stránky displeje (kap.4.3) nebo přímé řízení protokolem HTTP (kap. 5 a 3.1.3.23). Po provedené změně parametrů síťového rozhraní a jejich uložení je třeba displej dálkově restartovat nebo vypnout a zapnout jeho napájení. Poznámka: Změnu v parametrech síťového rozhraní je třeba promítnout i do souborů obsahujících výchozí tovární nastavení displeje – viz kap. 2.6. Jinak by při budoucím obnovení výchozích hodnot z www stránky Settings-main stiskem tlačítka Factory default and restart nebo pomocí přímého řízení protokolem HTTP došlo k obnovení již neplatného nastavení. To by mohlo vést ke ztrátě síťové konektivity k displeji. Jedná se o tyto soubory: /usr/default/ip1.info /usr/default/gateway.info /usr/default/netmask1.info
6.2.3 Prvotní synchronizace vnitřního časového zdroje Pokud došlo vlivem dlouhodobého odstavení displeje od napájení k nežádoucímu rozjetí časové informace zálohované ve vnitřním RTC obvodu, je možno synchronizovat vnitřní časový zdroj displeje se systémovým časem počítače ručně buď z www stránky Settings-main stiskem tlačítka Actual time: Set (viz. kap. 4.3) nebo pomocí přímého řízení protokolem HTTP (viz. kap. 3.1.3.11). Tímto časovým údajem se zasynchronizuje rovněž vnitřní RTC obvod displeje.
6.2.4 Časové pásmo a algoritmus přechodu na letní čas Z www stránky Settings-main nebo přímým řízením protokolem HTTP lze zvolit posun zobrazené časové informace vůči UTC a typ přechodu na letní čas – viz. kap. 2.5.2 a 2.5.3. Provedená změna je ihned akceptována bez nutnosti restartu displeje. Poznámka: Změnu nastavení časového pásma a algoritmu přechodu na letní čas je třeba promítnout i do souboru obsahujícího výchozí tovární nastavení těchto parametrů – viz kap. 2.6. Jinak by při budoucím obnovení výchozích hodnot z www stránky Settings-main stiskem tlačítka Factory default and restart nebo pomocí přímého ří-
TM_2011_07_18
58/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
zení protokolem HTTP došlo k obnovení již neplatného nastavení. Parametry jsou uloženy v tomto souboru: /usr/default/TZDST.param
6.2.5 Seznam NTP serverů Je třeba definovat NTP servery, ke kterým je displej jako NTP klient připojen. Z www stránky Settings – NTP servers nebo přímým řízením protokolem HTTP je třeba zadat alespoň jeden dostupný NTP server, jehož časem se bude displej řídit – viz. kap. 2.5.1. Zadávají se tyto parametry: - Server URL - Used - Prefered - Minpool - Maxpool - Unsynchronise timeout (společný parametr pro všechny servery) Při zadání více NTP serverů je možno definovat parametrem Prefered jeden nebo více serverů, které budou před ostatními servery upřednostněny. Paramert Minpool je vhodné nastavit např. na hodnotu 8 nebo 16s, parametr Maxpool na hodnotu 32 nebo 64 s. Čím kratší intervaly jsou vybrány, tím rychleji proběhne úvodní série NTP dotazů na server a tím dříve dojde k zasynchronizování vnitřního časového zdroje displeje. Hodnotu parametru Unsynchronise timeout je potřeba nastavit dostatečně velkou, aby nedocházelo mezi dvěma po sobě jdoucími NTP dotazy na server předčasně k indikaci ztráty časové synchronizace – viz. kap. 2.5.1.2. Po provedení změny nastavení NTP serverů je třeba úlohu NTP klienta restartovat z www stránky Settings-NTP servers stiskem tlačítka Set and restart NTP connections nebo pomocí přímého řízení protokolem HTTP. Případně lze provést restart celého displeje vypnutím a zapnutím jeho napájení. Poznámka: Změnu nastavení NTP serverů je třeba promítnout i do souboru obsahujícího výchozí tovární nastavení těchto parametrů – viz kap. 2.6. Jinak by při budoucím obnovení výchozích hodnot z www stránky Settings-main stiskem tlačítka Factory default and restart nebo pomocí přímého řízení protokolem HTTP došlo k obnovení již neplatného nastavení. Parametry jsou uloženy v tomto souboru: /usr/default/ntp.param
6.2.6 Další nastavované parametry Zde jsou popsány další parametry, které je vhodné při instalaci editovat. Lze to provést z www stránky Settings-advanced (kap. 4.4) příp. Settings-main (kap.4.3) nebo přímým řízením protokolem HTTP. Poznámka: Provedené změny je třeba promítnout i do souboru obsahujícího výchozí tovární nastavení těchto parametrů – viz kap. 2.6. Jinak by při budoucím obnovení výchozích hodnot z www stránky Settings-main stiskem tlačítka Factory default and re-
TM_2011_07_18
59/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
start nebo pomocí přímého řízení protokolem HTTP došlo k obnovení již neplatného nastavení. Parametry jsou uloženy v tomto binárním souboru: /usr/default/DISPdynamic.conf Tento soubor není textový, je obtížné jej editovat přímo. Je nutno jej po nastavení požadovaných parametrů nahradit jeho aktuální kopií z pracovního adresáře: /etc/DISPdynamic.conf
6.2.6.1 Nastavení regulace jasu displeje Pokud je potřeba, je možno upravit způsob regulace jasu displeje – viz. kap. 2.3. Jas je ovlivněn těmito parametry: - AutoBrightCntl - OffsetABCntl - TimeDelayABCntl - RemoteABCntl Nastavení lze provést z www stránky Settings-advanced (kap. 4.4) nebo pomocí přímého řízení protokolem HTTP (kap.3.1.3.2). Provedená změna uvedených parametrů je ihned akceptována bez nutnosti restartu displeje.
6.2.6.2 Nastavení zvuku tlačítek Intenzitu akustické indikace stisku tlačítek (viz. kap. 2.2.1) je možné nastavit parametrem Volume Key z www stránky Settings-advanced (kap. 4.4) nebo pomocí přímého řízení protokolem HTTP (kap.3.1.3.2). Provedená změna parametru je ihned akceptována bez nutnosti restartu displeje.
6.2.6.3 Potlačení nadbytečných nul U módů čas a datum lze zvolit potlačení zobrazení nadbytečných nul dílčími parametry RedundandNULLs nezávisle pro zobrazený údaj měsíce, dne, hodiny, minuty i sekundy – viz. kap. 2.2. Lze tak učinit ze stránky Settings-advanced (kap. 4.4) nebo pomocí přímého řízení protokolem HTTP (kap.3.1.3.2). Provedená změna těchto parametrů je ihned akceptována bez nutnosti restartu displeje.
6.2.6.4 Typ lamp testu LED zobrazovačů Po připojení napájecího napětí nebo po restartu displeje je řadičem AT89C51RE2 proveden lamp test LED zobrazovačů. Jeho rozsah je určen parametrem Lamp Test, jeho hodnotu lze zadat z www stránky Settings-advanced (kap. 4.4) nebo pomocí přímého řízení protokolem HTTP (kap. 3.1.3.2). Provedená změna parametru je ihned akceptována, projeví se při nejbližším restartu displeje.
6.2.6.5 Formát čítání času stopek Požadovaný formát zobrazení času stopek (kap. 2.2.4) lze zvolit jak z www stránky Settingsmain (kap. 4.3), tak pomocí přímého řízení protokolem HTTP (kap. 3.1.3.8). Provedená změna parametru je ihned akceptována bez nutnosti restartu displeje.
6.2.6.6 Nastavení módu zobrazení časové informace Aktuální mód zobrazení časové informace na LED zobrazovačích lze nastavit místně pomocí tlačítka MODE nebo dálkově přes www stránky Settings-main (kap. 4.3), resp. SettingsTM_2011_07_18
60/63
Displej DT20-6 Technická dokumentace
4000 - Oddělení speciálních zařízení
advanced (kap. 4.4) nebo pomocí přímého řízení protokolem HTTP (kap. 3.1.3.6). Provedená změna je ihned akceptována bez nutnosti restartu displeje.
6.2.6.7 Nastavení obsahu zobrazovačů v módu text Informaci pro zobrazení v módu text lze zadat z www stránky Settings-main (kap. 4.3) nebo pomocí přímého řízení protokolem HTTP (kap. 3.1.3.5). Provedená změna je ihned akceptována bez nutnosti restartu displeje.
6.2.6.8 Heslo pro přístup do www stránek Nastavení Ze stránky Settings-main (kap. 4.3) lze nastavit případně upravit heslo požadované pro přístup k www stránkám Settings. Mezi soubory obsahujícími výchozí tovární nastavení displeje je i soubor /usr/default/WEBpwd.conf, který obsahuje předlohu tohoto hesla použitou při obnovení výchozích hodnot parametrů displeje.
6.3 Možné závady, jejich odstranění závada Displej nezobrazuje žádnou informaci, je tmavý.
její příčina a odstranění • Není napájecí napětí – prověřit UTP kabel mezi switchem a displejem, jeho zasunutí v konektorech RJ-45. • Není napájecí napětí – prověřit nastavení funkce PoE v síťovém switchi: - je na příslušném portu aktivována funkce PoE? - není nastaveno příliš přísné výkonové omezení? - má switch ještě dostatečnou rezervu výkonu pro napájení displeje? • Displej je nastaven v módu text, zobrazuje textový řetězec tvořený osmi mezerami. Tlačítkem MODE přepnout do módu čas případně změnit textový řetězec z www stránky Settings-advanced (kap. 4.4) nebo pomocí přímého řízení protokolem HTTP (kap. 3.1.3.5). • Porucha zdrojové části displeje. Vyměnit displej.
Na displeji se cyklicky opakuje test zobrazovačů (rozsvěcují se všechny segmenty, jas pulzuje).
• Síťový switch má u portu k němuž je displej připojen nastaveno příliš přísné výkonové omezení. Upravit toto nastavení na automatickou detekci omezení nebo nastavit omezení výkonu pro class2 nebo class3 • Porucha zdrojové části displeje. Vyměnit displej.
TM_2011_07_18
61/63
Displej DT20-6 Technická dokumentace
závada Displej zobrazuje statický časový údaj, který se nemění
4000 - Oddělení speciálních zařízení
její příčina a odstranění • Displej je nastaven do módu text, zobrazuje statický text. Stiskem tlačítka MODE nebo dálkově lze změnit mód zobrazení časové informace na čas nebo datum. • Displej nereaguje na stisk tlačítka MODE, protože: a) právě probíhá dálkový restart displeje, během nějž dojde na asi 1 minutu k „zamrznutí“ zobrazeného údaje b) právě probíhá bootování ethernetového modulu displeje (cca 20 sekund od připojení napájecího napětí nebo restartu) Pokud ani pak nedojde ke změně módu, jde o poruchu displeje. Vypnout a zapnout napájení nebo vyměnit displej.
Displej zobrazuje měnící se časový údaj, nereaguje na tlačítka
• Jde o normální tav po restartu displeje: displej je řízen řadičem displeje, čeká se na nabootování ethernetového modulu. Vyčkat na obnovení činnosti ethernetového modulu displeje (do cca 20 sekund od připojení napájecího napětí nebo restartu displeje). • Pokud ani po cca 20 sekundách od připojení napájecího napětí nebo restartu nereaguje displej na stisk tlačítka MODE, jde o poruchu displeje. Vyměnit displej.
Na displeji je zobrazen nápis IP: následovaný třemi číslicemi
• Je aktivován režim postupného zobrazení IP adresy na LED zobrazovačích displeje – viz. kap. 2.2.7. Opakovaným stiskem tlačítka MODE projít zobrazením všech segmentů adresy a přepnout do normálního módu zobrazení nebo počkat 2 minuty na automatické přepnutí do normálního módu zobrazení • Displej je v módu text a zobrazuje požadovanou textovou informaci. Stiskem tlačítka MODE přepnout do normálního módu zobrazení.
Na displeji je maximálním jasem v pravé části zobrazen hexadecimální číselný údaj, všechny LED indikátory módu displeje rychle synchronně blikají
• Je aktivován test funkce vyhodnocení intenzity okolního osvětlení po restartu displeje – viz. kap. 2.3.1. Zobrazený údaj udává změřenou intenzitu: 00 indikuje minimální hodnotu, FF maximální hodnotu. Po nabootování ethernetového modulu (do cca 20 sekund) přejde displej do normálního módu zobrazení. • Pokud ani po cca 20 sekundách displej přejde do normálního módu zobrazení, jde o poruchu displeje. Vyměnit displej
Celý údaj času bliká
• Stav po restartu displeje, pokud byl jako poslední zobrazený mód zvolen mód stopky. Po nabootování ethernetového modulu přestane zobrazený údaj blikat. Pak je možno stopky začít používat nebo přepnout tlačítkem MODE do jiného módu zobrazení. • pomocí přímého řízení protokolem HTTP je dálkově ovládáno blikání zobrazeného údaje. Chybná, nebo možná požadovaná sekvence příkazů protokolu HTTP.
Nelze se připojit k www stránkám displeje, LED zobrazovače displeje svítí
• Nesprávné nastavení ethernetového rozhraní displeje. Ověřit a případně upravit aktuální IP adresu (viz kap. 2.2.7), adresu brány (je-li použita) a masku sítě – viz. kap. 2.4. • Ověřit, zda je počítač, z nějž jsou www stránky displeje prohlíženy, zapojen do téhož síťového segmentu jako displej.
TM_2011_07_18
62/63
Displej DT20-6 Technická dokumentace
závada Stav NTP synchronizace displeje je stále indikován jako nezasynchronizovaný
4000 - Oddělení speciálních zařízení
její příčina a odstranění • Není nakonfigurován ani jeden dostupný NTP server. Zadat požadované NTP servery – viz kap. 2.5.1.1. • Parametr Unsynchronise timeout je nastaven příliš krátký, mezi dvěma po sobě jdoucími NTP dotazy na server dochází předčasně k indikaci ztráty časové synchronizace – viz. kap. 2.5.1.2. Nastavit jeho hodnotu na např. 60 minut. • Parametry Minpool a Maxpool NTP serverů jsou nastaveny příliš velké. Úvodní série NTP dotazů displeje po jeho restartu proto trvá dlouhou dobu. Ověřit na www stránce Status-main, zda se displeji daří vůbec navázat spojení s NTP serverem. Pokud ano, zmenšit nastavené hodnoty parametrů Minpool a Maxpool. • NTP servery nejsou dostupné. Ověřit jejich dostupnost. Na displeji spustit Telnet (login: root, password: root) a zadat příkaz ping s adresou NTP serveru. Pokud je NTP server dostupný, je zobrazeno časové zpoždění přenosu paketů k serveru.
Čas displeje není ve správném časovém pásmu
• Prověřit správnost nastavení posunu času displeje a algoritmu přepínání na letní čas – viz kap. 2.5.2 a 2.5.3 • Pokud displej nereaguje na změnu těchto parametrů, ručně aktualizovat jeho čas z www stránky Settings-main stiskem tlačítka Actual time: Set (viz. kap. 4.3) nebo pomocí přímého řízení protokolem HTTP (viz. kap. 3.1.3.11).
Automatická regulace jasu nefunguje
• Je nastavena dálková regulace jasu – viz. kap. 2.3. Nastavit parametr AutoBrightCntl z www stránky Settings-advanced (kap. 4.4) nebo pomocí přímého řízení protokolem HTTP (kap. 3.1.3.2). • Je zakryto čidlo měřící intenzitu okolního osvětlení. Odstranit zastínění čidla. • Rozsah automatické regulace jasu je mimo rozsah místní intenzity okolního osvětlení. Upravit citlivost vyhodnocení intenzitu okolního osvětlení pomocí trimru R5. Ten je přístupný po demontáži zadního krytu displeje. Aktuálně měřenou hodnotu intenzity okolního osvětlení lze zobrazit pomocí postupu popsaného v kapitole 2.3.1.
Po obnovení výchozích hodnot z www stránky Settings-main stiskem tlačítka Factory default and restart nebo pomocí přímého řízení protokolem HTTP došlo ke ztrátě síťové konektivity displeje
TM_2011_07_18
• V souborech obsahujících výchozí nastavení parametrů displeje byla uložena jiná IP adresa, adresa brány či síťová maska. Zjistit aktuální adresu displeje (viz. kap. 2.2.7), přes FTP zeditovat příslušný soubor s chybným nastavením parametru (viz. kap. 6.2.2) a zrestartovat displej nebo vypnout a zase zapnout jeho napájení. Znovu provést obnovení výchozích hodnot parametrů, čímž dojde k načtení správné IP adresy, adresy brány i síťové masky.
63/63