User manual

26/48 myEthernet Technische Beschreibung / technical description
www.myAVR.de © Laser & Co. Solutions GmbH – 06/2009 www.myAVR.com
5 Ersetzungen und Kommandos des
Webservers
Mit dem embedded Webserver des myEthernets sind
vielfältige Auswertungen möglich. Dabei wird eine eigene
Kommando- und Ersetzungssyntax verwendet. Mit
Anwendung dieser Befehle können Sie Abfragen von
aktuellen Werten an einem, mehreren oder allen Pins
vornehmen. Des Weiteren werden aktuelle Pin-
Konfigurationen und alle Möglichkeiten zur Pin-Einstellung
ausgegeben.
Ersetzungen werden nur in htm-Dateien durchgeführt und
können dort in jeglicher Kombination von JavaScript oder
HTML-Elementen verwendet und platziert werden.
5 Replacements and commands of the
web server
Many analysis are possible with the embedded web
server of the myEthernet. Thereby an own command
and replacement syntax will be used. By using these
commands you can take queries on one, several or all
pins. Actually pin configurations and all possibilities for
pin settings will be output.
Replacements are performed only in htm files and can
be used and placed in every combination of java script
or html elements.
5.1 Einstiegshilfe mit Anwendungsbeispiel
Anhand des Beispiels „Status LEDs“ soll die
Funktionsweise der Ersetzungen und Kommandos erklärt
werden. Die beiden LEDs dienen im Betrieb zur Anzeige
von Fehlern bei der Initialisierung des myEthernets. Durch
den Anwender können diese aber ebenfalls gesteuert
werden. Auf den Pins 20 und 21 wird das Signal an die
grüne bzw. rote LED ausgegeben.
5.1 Introduction by help of an example of use
The functionalitiy of the replacements and commands
will be based on the example “Status LEDs” to be ex-
plained. Both LEDs are used in the operation to displays
errors by initialization of the myEthernet. They can be
also controlled through the user. The signal is issued to
the green or red LED on the pins 20 and 21.
5.1.1 Schalten von Pins
Der Webserver reagiert auf Parameter einer Adresse, wenn
spezielle Befehle verwendet werden. Für dieses Beispiel ist
die Verwendung von dem Kommando „myChangeCmd“
notwendig.
Ausschalten der grünen LED:
http://192.168.20.98/?
myChangeCmd=°o20~0°
Einschalten der grünen LED:
http://192.168.20.98/?
myChangeCmd=°o20~1°
Diese beiden Adressen werden in der Adresszeile eines
Webbrowser benutzt. Wenn aber eine Webseite selbst als
Link diesen Befehl benutzt, dann muss beachtet werden,
dass ein ° (Gradzeichen) und ~ (Tildezeichen) mit e inem
Zeichencode genutzt wird, da der myEthernet Webserver
sonst sämtliche Texteinschlüsse innerhalb der Gradzeichen
als Ersetzung interpretiert.
Für das Gradzeichen ist dieses
%B0 und %7E für das
Tildezeichen. Die obigen Adressen würden dann innerhalb
einer htm-Datei wie folgt aussehen:
Ausschalten der grünen LED:
<a href=“http://192.168.20.98/?
myChangeCmd=%B0o20%7E0%B0“>
Grüne LED aus
</a>
Einschalten der grünen LED:
<a href=“http://192.168.20.98/?
myChangeCmd=%B0o20%7E1%B0“>
Grüne LED an
</a>
Beachten Sie: wird ein Kommando innerhalb einer htm-
Datei genutzt, dann muss der Zeichencode für Grad- und
Tildezeichen verwendet werden.
5.1.1 Switching of pins
The web server responds to an address parameter if you
use special commands. For this example the using of
the command „myChangeCmd“ is necessary.
Switch off the green LED:
http://192.168.20.98/?myChangeCmd=°o20~0°
Switch on the green LED:
http://192.168.20.98/?myChangeCmd=°o20~1°
These two addresses are used in the address line of a
web browser. If a website use this command as a link
then you have to pay attention that the ° (degree c harak-
ter) and ~ (tilde character) are used as character code
because the myEthernet web server interprets all text
which is between the ° (degree character) as a repl ace-
ment.
You have to use
%B0 for the degree character and %7E
for the tilde character.
Switch off the green LED:
<a href=“http://192.168.20.98/?
myChangeCmd=%B0o20%7E0%B0“>
green LED off
</a>
Switch on the green LED:
<a href=“http://192.168.20.98/?
myChangeCmd=%B0o20%7E1%B0“>
green LED on
</a>
Please note: if you use a command in a htm file then you
have to use the character code for degree and tilde char-
acters.