Die pt-50 kann als Hardware-''Toolbox'' fr HTML-Programmierer angesehen werden. Sie ist ber URL-Parameter (''cgi''-Parameter, CGI steht fr Common Gateway Interface, URL steht fr Uniform Resource Locator) steuerbar und kann dynamisch HTML-Seiten und Clickable Images erzeugen.
Die Datenbertragung geschieht ber das HTTP-Protokoll das jeder Browser, wie z.B. Netscape Navigator oder Microsoft Internet Explorer untersttzt. Eine technische Beschreibung des HTTP-Protokolls befindet sich in RFC1945:Hypertext Transfer Protocol - HTTP/1.0.
Zur Erlernung der HTML-Sprache eignet sich das gut gemachte SELFHTML - HTML Online-Nachschlagewerk von Stefan Mnz.
Um einen Datenabruf aus der pt-50 zu starten, wird ein GET-Request (im Browser ein Seitenabruf) fr eine URL (die Adresszeile im Browser) gesendet, die dann von der pt-50 mit einer HTML-Seite bzw. den angeforderten Daten beantwortet wird.
Bei Absenden eines Formulares (durch Drcken des Speichern-Buttons in einer Konfigurationsseite) wird ein POST-Request an die pt-50 gesendet.
Die pt-50 macht Gebrauch von der šbertragung der Parametrierungsdaten per URL-Parameter. Die URL-Parameter folgen dem Verzeichnis- und Dateinamen und einem angeh„ngten Fragezeichen. Die URL-Parameter bestehen aus einer Folge von Attribut=Wert-Paaren. Die Paare werden durch das &-Zeichen voneinander getrennt.
Beispiel:
http://demo200/cgi-bin/rel?111.14.1=3&111.12=pt_iZoom
Die URL in diesem Beispiel besteht aus diesen Bestandteilen:
Leerzeichen | %20 |
% | %25 |
& | %26 |
= | %3D |
? | %3F |
Die L„nge der URLs ist von der pt-50 nicht limitiert, allerdings begrenzen einige Browser und Proxy-Server die L„nge auf 512 Zeichen.
Die Steuerung der I/O-Funktionen der pt-50 kann nicht nur ber die im Ger„t vordefinierten HTML-Seiten (/cgi-bin/control.htm) geschehen, sondern auch direkt ber URLs.
Die Steuer-URL beginnt immer mit
/cgi-bin/ctrl/rel?
Dann folgt eine (durch &-Zeichen getrennte ) Liste von Attribut=Wert-Paaren, die I/O-Steuer-Funktionen ausl”sen.
Das Attribut ist eine Objekt-ID (angelehnt an SNMP), der Wert ist abh„ngig vom Attribut numerisch oder alphanumerisch. Das Attribut=Wert-Paar wird allgemein notiert als <Table>.<Row>.<Element>=<Wert>. Fr die Tabelle 111 (I/O-Kan„le) gilt 111.<Channel>.<Index>=Wert. In einigen F„llen ist es m”glich .<Index> wegzulassen, in anderen F„llen kann nach .<Index> noch eine genauere Aufschlsselung m”glich sein.
0
Channel | Bedeutung | Index | R/W | Wert | ||||||||
0 | Printer | - | W | Text zur Ausgabe | ||||||||
1 | Serielle Schnittstelle | - | W | Text zur Ausgabe | ||||||||
8 | I/O-Port | PortNo | R/W | LOBYTE: Bit-Maske/Wert zur Verknpfung | ||||||||
HIBYTE: Mode | ||||||||||||
|
||||||||||||
11 | Serielle TX-Emulation auf Parallel-Port | 0...7 | W | Text zur Ausgabe | ||||||||
12 | Makro | - | R | Makro-Name | ||||||||
13 | Makro-Kommando | - | R | Kommando-String | ||||||||
14 | Relais | ...7 | R/W | Mode | ||||||||
|
||||||||||||
15 | (Alarm-)Eing„nge | 0...7 | R | TRUE/FALSE. |
Die Authentifizierung der Zugriffsberechtigung zur pt-50 wird, wie bei den HTML-Konfigurationsseiten, durch HTTP-Basic-Authentification im HTTP-Header durchgefhrt.
Beispiel: Aufruf einer Makrofunktion (ptpan) mit Parameter (4)
http://geraet.firma.de/cgi-bin/ctrl/rel?111.13=JP'ptpan',4
Um den Status von (Alarm-)Eing„ngen, Sensoren und Schaltausg„ngen anzuzeigen, kann durch die pt-50 eine Grafik erzeugt werden, die verschiedenfarbige Icons (kleine Bilder) und Display-Anzeigen enth„lt. Die generierte Grafik wird als eine GIF-Datei bertragen, besteht aber aus mehreren Teilbildern, die separat innerhalb eines umfassenden Rahmens positionierbar sind. Fr jedes Teilbild des generierten GIFs kann das Aussehen (Shape), die Farbe (Color) und die zugeh”rige Statusabfrage-Funktion definiert werden. Fr die gesamte Grafik ist die Gr”áe festzulegen.
Wie zuvor, wird auch diese Funktionalit„t durch eine Liste von Attribut=Wert-Paaren beeinflusst.
Soll nur eine Statusabfrage und Anzeige ber das generierte Bild durchgefhrt werden, so lautet die entsprechende URL
/cgi-bin/gen.gif?params
Soll auch eine Steuerfunktion durch die Attribut=Wert-Paare ausgel”st werden, so lautet die URL
/cgi-bin/ctrl/gen.gif?params.
params enth„lt zu Anfang ein Paar
size=xsize,ysize z.B. size=200,200 welches die GrӇe (in Pixel)
der gesamten generierten Grafik angibt. Fehlt diese Angabe, dann wird
size=32,32 angenommen.
Die Attribut=Wert-Paare zur Erzeugung der einzelnen Teilbilder haben die Syntax 111.<IO-Channel>.<Index>=<xpos>,<ypos>,<shape><color>,<value>.
<value> wird nur dann an das Objekt zugewiesen, wenn die URL /cgi-bin/ctrl/gen.gif zur Erzeugung des Bildes verwendet wurde.
Der vom Objekt 111.<IO-Channel>.<Index> gelieferte Wert wird auf das an der relativ zur linken oberen Bildecke positionierte Teilbild angewandt. Je nach <shape> wird ein Zahlwert angezeigt oder ein eingef„rbtes Icon. Die <IO-Channels> und der <Index> entsprechen denen unter 9.2
Das Attribut ''on'' liefert immer den Wert TRUE, ''off'' immer den Wert FALSE. So kann z.B. mit /cgi-bin/gen.gif?on=0,0,ledr das Symbol einer rot leuchtenden LED dargestellt werden, mit /cgi-bin/gen.gif?off?0,0,ledr wird das Symbol als dunkelrote LED (nicht leuchtend) dargestellt.
Mit <shape> k”nnen folgende Symbole erzeugt werden:
Name | GrӇe | Symbol |
cam | 24x19 | (Web-)Kamera |
ir | 16x23 | Infrarot-Bewegungsmelder |
lamp | 14x21 | Glhbirne |
led | 11x11 | Leuchtdiode |
ls | 11x19 | Lautsprecher-Schaltzeichen |
mic | 16x16 | Mikrofon-Schaltzeichen |
radi | 30x32 | Radiator/Heizk”rper |
rel | 15x15 | Relais-Schaltzeichen |
seg | n*10x17 | Dezimale Siebensegment-Anzeige |
segh | n*10x17 | Hexadezimale Siebensegment-Anzeige |
sock | 15x15 | Steckdose |
text | n*8x16 | Beliebiger Text (wird bisher nicht von den Browsern untersttzt!) |
Wird durch folgende URL erzeugt:
/cgi-bin/gen.gif?size=130,100& on=0,0,camb&on=35,0,irr&on=70,0,lampy&on=105,0,ledg& on=0,35,ls&on=35,35,mic&on=70,35,radi-r&on=105,35,relr& 111.12.SERES,5678=0,70,segg&111.12.SERES,$AFFE=50,70,seghr&on=100,70,sockb
Die beiden Siebensegmentanzeigen stellen die einzige M”glichkeit dar, die Anzeige von numerischen Werten vorzunehmen. Alle anderen Symbole dienen der Visualisierung von einfachen bool'schen Zust„nden.
Mit <color> k”nnen folgende Farben festgelegt werden.
r | Rot |
g | Grn |
b | Blau |
y | Gelb |
c | Trkis |
Grau |
Falls das abgefragte Objekt einen BOOL-Wert TRUE liefert, wird das <shape> in der ausgew„hlten Farbe (hell) dargestellt. Bei FALSE in der entsprechenden Farbe (dunkel). Soll die Farbgebung negiert werden (d.h. TRUE/FALSE vertauscht werden), so ist der Farbe ein Minuszeichen voranzustellen: 111.14.1=0,0,rel-y zeigt das Relaisymbol gelb an, wenn das Relais 1 ''aus'' ist.
Beispiel:
Das folgende Clickable-Image wurde aus einem schwarz/weiáen Hintergrund Grundriá-Bild, das auf einem allgemein zug„nglichen Fileserver liegt, einem generierten (teil-transparenten) GIF-Bild, welches als Overlay darber gelegt wurde und einer dazugeh”rigen Image-Map, die abh„ngig von der Position des Mausclicks verschiedene Aktionen ausfhrt, erzeugt.
Der Zugeh”rige HTML-Quelltext:
<HTML> <HEAD> <TITLE>Test</TITLE></HEAD> <BODY> <MAP NAME="map1"> <AREA SHAPE=RECT COORDS="100,160,115,175" HREF="http://demo200/cgi-bin/ctrl/rel?111.14.0=3" ALT="Licht Kinderzimmer"> <AREA SHAPE=RECT COORDS="200,120,215,135" HREF="http://demo200/cgi-bin/ctrl/rel?111.15.1=3" ALT="IR Melder Arbeitszimmer"> <AREA SHAPE=RECT COORDS="340,70,355,85" HREF="http://demo200/cgi-bin/ctrl/rel?111.14.1=3" ALT="Licht Bad"> <AREA SHAPE=RECT COORDS="436,279,447,298" HREF="http://demo200/cgi-bin/ctrl/rel?111.13=FN$58,'58'" ALT="Türsprechstelle"> <AREA SHAPE=RECT COORDS="300,240,315,255" HREF="http://demo200/cgi-bin/ctrl/rel?111.14.1=3" ALT="Licht Diele"> <AREA SHAPE=RECT COORDS="140,360,155,375" HREF="http://demo200/cgi-bin/ctrl/rel?111.14.2=3" ALT="Licht Schlafzimmer"> <AREA SHAPE=RECT COORDS="168,47,187,65" HREF="http://demo200/cgi-bin/ctrl/rel?111.14.2=3" ALT="Steckdose Arbeitszimmer"> <AREA SHAPE=RECT COORDS="43,250,72,281" HREF="http://demo200/cgi-bin/ctrl/rel?111.15.2=3" ALT="IR Melder Kinderzimmer"> <AREA SHAPE=RECT COORDS="218,270,233,285" HREF="http://demo200/cgi-bin/pushhalf.htm?camera=1" ALT="Kamera Diele" TARGET=BLANK> <AREA SHAPE=RECT COORDS="424,693,448,722" HREF="javascript:window.open('http://demo200/cgi-bin/pushhalf.htm?camera=1', 'w1','width=220,height=175,screenX=0,screenY=0,left=0,top=0')" TARGET=w1 ALT="Kamera Hof"> </MAP> <TABLE CELLPADDING=0 CELLSPACING=0 BORDER=0 FRAME=VOID WIDTH=563 HEIGHT=806 BACKGROUND="http://www2.pt-online.de/pub/images/grund.gif"> <TR><TD ALIGN=TOP VALIGN=LEFT> <IMG SRC="http://demo200/cgi-bin/gen.gif?size=563,806& 111.14.0=100,160,lampy&111.14.1=340,70,lampy&111.14.2=140,360,lampy& 111.14.2=168,47,sockg&111.14.1=300,240,relg&111.15.1=200,120,ir-r& 111.15.2=43,250,ir-r&on=436,279,lsb&on=424,693,camb" USEMAP="#map1" BORDER=0> </TD></TR></TABLE> </BODY> </HTML>
Eine st„ndige Erneuerung des Bildinhaltes im Browser kann durch das Refresh META-Tag erreicht werden:
<HTML> <HEAD> <META http-equiv="refresh" content="5; URL=http://URL_Dieser_Datei.htm"> </HEAD>
Alternativ kann eine Timergesteuerte Java-Script Routine verwendet werden. Die hat den Vorteil, daá nicht jedesmal der Gesamte Bildschirminhalt gel”scht wird, bevor das clickable Image neu generiert wird, sondern nur das Image selbst.
<script language="JavaScript"> <!-- var vin=1; function GifAnzeigen() { if(vin == 1){ document.images['gif'].src = 'http://demo200/cgi-bin/gen.gif?params'; } active = window.setTimeout('GifAnzeigen()',8000); } function Stoppen() { window.clearTimeout(active); } function LetsGo() { vin=1; document.images['gif'].src = 'http://demo200/cgi-bin/gen.gif?params'; } //--> </script>
Alternativ zur Erzeugung einer Grafik als Statusanzeige kann auch eine HTML-Tabelle zur Anzeige erzeugt werden.
Die ordentliche Darstellung der HTML-Seiten setzt einen Browser voraus, der CSS 1.0 (Cascading Style Sheets) untersttzt. Dies ist ab Navigator 4.0 und Internet Explorer 3.0 m”glich. Die Darstellung der Seiten ist auch ohne CSS m”glich, kann aber beim Seitenlayout zu schwerer lesbaren Tabellen fhren, da die Tabellen-Schriften und Schrift-Farben auf Standard-Werten eingestellt bleiben.
Wie zuvor, wird auch diese Funktionalit„t durch eine Liste von Attribut=Wert-Paaren beeinflusst.
Soll nur eine Statusabfrage und Anzeige ber das generierte Bild durchgefhrt werden, so lautet die entsprechende URL
/cgi-bin/gen.htm?params
Soll auch eine Steuerfunktion durch die Attribut=Wert-Paare ausgel”st werden, so lautet die URL
/cgi-bin/ctrl/gen.htm?params.
Die Attribut=Wert-Paare zur Erzeugung der einzelnen Teilbilder haben die Syntax 111.<IO-Channel>.<Index>=<type><color>,<name>,<value>.
<value> wird nur dann an das Objekt zugewiesen, wenn die URL /cgi-bin/ctrl/gen.htm zur Erzeugung des Bildes verwendet wurde.
Der vom Objekt 111.<IO-Channel>.<Index> gelieferte Wert wird auf das an der relativ zur linken oberen Bildecke positionierte Teilbild angewandt. Je nach <shape> wird ein Zahlwert angezeigt oder ein eingef„rbtes Icon. Die <IO-Channels> und der <Index> entsprechen denen unter 9.2
Das Attribut ''on'' liefert immer den Wert TRUE, ''off'' immer den Wert FALSE. So kann z.B. mit /cgi-bin/gen.gif?on=0,0,ledr das Symbol einer rot leuchtenden LED dargestellt werden, mit /cgi-bin/gen.gif?off=0,0,ledr wird das Symbol als dunkelrote LED (nicht leuchtend) dargestellt.
Mit <type> k”nnen die Objekt-Abfrage-Ergenisse folgendermassen interpretiert werden:
Type | Wertebereich | Ausgabe |
hex4 | 0...15 | Ein hexadezimales Digit (0-9,A-F) |
hex8 | 0...255 | Zwei hexadezimale Digits |
hex16 | 0...65535 | Vier hexadezimale Digits |
num | 0...65535 | Dezimale Anzeige (ohne fhrende Nullen) |
text | Text | ASCII-Zeichen |
bgtrue | TRUE/FALSE | Hintergrund farbig, falls TRUE geliefert |
bgfalse | TRUE/FALSE | Hintergrund farbig, falls FALSE geliefert |
Mit <color> kann die Schriftfarbe der Tabelleneintr„ge festgelegt werden.
r | Rot |
g | Grn |
b | Blau |
y | Gelb |
c | Trkis |
Grau |
So erzeugt folgende URL eine Tabelle mit der Temperatur und dem Status der Ein- und Ausg„nge:
/cgi-bin/gen.htm?111.13.SERES,TEMP=num,Temperatur& on=bgtruex,Relais&111.14.0=bgtruey,1&111.14.1=bgtruey,2&111.14.2=bgtruey,3& on=bgtruex,Alarme&111.15.0=bgtruer,1&111.15.1=bgtruer,2&111.15.2=bgtruer,3
Und das sieht so aus: