WagoLibWakeOnLan.lib

Bibliotheksbeschreibung
WAGO-I/O-SYSTEM 750
CODESYS-2-Bibliothek
WagoLibWakeOnLan.lib
Wake on lan – Ferngesteuertes Aufwecken von
Netzwerk Geräten
Version 1.0.0 vom 18.11.2015
2
Impressum
© 2015 by WAGO Kontakttechnik GmbH & Co. KG
Alle Rechte vorbehalten.
WAGO Kontakttechnik GmbH & Co. KG
Hansastraße 27
D-32423 Minden
Tel.:
Fax:
+49 (0) 571/8 87 – 0
+49 (0) 571/8 87 – 1 69
E-Mail:
[email protected]
Web:
http://www.wago.com
Technischer Support
Tel.:
Fax:
+49 (0) 571/8 87 – 5 55
+49 (0) 571/8 87 – 85 55
E-Mail:
[email protected]
Es wurden alle erdenklichen Maßnahmen getroffen, um die Richtigkeit und
Vollständigkeit der vorliegenden Dokumentation zu gewährleisten. Da sich Fehler,
trotz aller Sorgfalt, nie vollständig vermeiden lassen, sind wir für Hinweise und
Anregungen jederzeit dankbar.
Wir weisen darauf hin, dass die im Handbuch verwendeten Soft- und HardwareBezeichnungen und Markennamen der jeweiligen Firmen im Allgemeinen einem
Warenzeichenschutz, Markenzeichenschutz oder patentrechtlichem Schutz
unterliegen.
Bibliotheksbeschreibung
Inhaltsverzeichnis
3
Inhaltsverzeichnis
Inhaltsverzeichnis
3
Hinweise zu dieser Dokumentation
4
Urheberschutz .............................................................................................. 4
Symbole ....................................................................................................... 4
Darstellung der Zahlensysteme .................................................................... 4
Schriftkonventionen ..................................................................................... 5
Wichtige Erläuterungen
6
Änderungsvorbehalt ..................................................................................... 6
Personalqualifikation ................................................................................... 6
Bestimmungsgemäßer Gebrauch ................................................................. 6
Technischer Zustand der Geräte .................................................................. 6
Funktionsbaustein
7
Senden eines Magic Packet (Wake on lan) (FbMagicPacket) ..................... 7
Bibliotheksbeschreibung
4
Hinweise zu dieser Dokumentation
Hinweise zu dieser Dokumentation
Hinweis
Dokumentation aufbewahren!
Diese Dokumentation ist Teil des Produkts. Bewahren Sie deshalb die
Dokumentation während der gesamten Nutzungsdauer des Produkts auf.
Geben Sie die Dokumentation an jeden nachfolgenden Benutzer des
Produkts weiter. Stellen Sie darüber hinaus sicher, dass gegebenenfalls jede
erhaltene Ergänzung in die Dokumentation mit aufgenommen wird.
Urheberschutz
Dieses Dokument, einschließlich aller darin befindlichen Abbildungen, ist
urheberrechtlich geschützt. Jede Weiterverwendung dieses Dokumentes, die von
den urheberrechtlichen Bestimmungen abweicht, ist nicht gestattet.
Die Reproduktion, Übersetzung in andere Sprachen, sowie die elektronische und
fototechnische Archivierung und Veränderung bedarf der schriftlichen
Genehmigung der WAGO Kontakttechnik GmbH & Co. KG, Minden.
Zuwiderhandlungen ziehen einen Schadenersatzanspruch nach sich.
Symbole
Beachten
Beachten!
Randbedingungen, die für einen fehlerfreien Betrieb unbedingt zu beachten
sind.
Hinweis
Wichtiger Hinweis!
Routinen oder Ratschläge für den effizienten Geräteeinsatz und die
Softwareoptimierung.
Information
Weitere Information
Weist auf weitere Informationen hin, die kein wesentlicher Bestandteil
dieser Dokumentation sind (z. B. Internet).
Darstellung der Zahlensysteme
Tabelle 1: Darstellung der Zahlensysteme
Zahlensystem
Dezimal
Hexadezimal
Binär
Beispiel
100
0x64
'100'
'0110.0100'
Bemerkung
Normale Schreibweise
C-Notation
In Hochkomma,
Nibble durch Punkt getrennt
Bibliotheksbeschreibung
Hinweise zu dieser Dokumentation
Schriftkonventionen
Tabelle 2: Schriftkonventionen
Schriftart
kursiv
Menü
>
Eingabe
„Wert“
[Button]
[Taste]
Bibliotheksbeschreibung
Bedeutung
Namen von Pfaden und Dateien werden kursiv dargestellt z. B.:
C:\Programme\WAGO Software
Menüpunkte werden fett dargestellt z. B.:
Speichern
Ein „Größer als“- Zeichen zwischen zwei Namen bedeutet die Auswahl eines
Menüpunktes aus einem Menü z. B.:
Datei > Neu
Bezeichnungen von Eingabe- oder Auswahlfeldern werden fett dargestellt z. B.:
Messbereichsanfang
Eingabe- oder Auswahlwerte werden in Anführungszeichen dargestellt z. B.:
Geben Sie unter Messbereichsanfang den Wert „4 mA“ ein.
Schaltflächenbeschriftungen in Dialogen werden fett dargestellt und in eckige
Klammern eingefasst z. B.:
[Eingabe]
Tastenbeschriftungen auf der Tastatur werden fett dargestellt und in eckige
Klammern eingefasst z. B.:
[F5]
5
6
Wichtige Erläuterungen
Wichtige Erläuterungen
Um dem Anwender eine schnelle Installation und Inbetriebnahme der
beschriebenen Geräte zu gewährleisten, ist es notwendig, die nachfolgenden
Hinweise und Erläuterungen sorgfältig zu lesen und zu beachten.
Änderungsvorbehalt
Die WAGO Kontakttechnik GmbH & Co. KG behält sich Änderungen, die dem
technischen Fortschritt dienen, vor. Alle Rechte für den Fall der Patenterteilung
oder des Gebrauchsmusterschutzes sind der WAGO Kontakttechnik GmbH & Co.
KG vorbehalten. Fremdprodukte werden stets ohne Vermerk auf Patentrechte
genannt. Die Existenz solcher Rechte ist daher nicht auszuschließen.
Personalqualifikation
Der in diesem Dokument beschriebene Produktgebrauch richtet sich
ausschließlich an Fachkräfte mit einer Ausbildung in der SPS-Programmierung,
Elektrofachkräfte oder von Elektrofachkräften unterwiesene Personen, die
außerdem mit den geltenden Normen vertraut sind. Für Fehlhandlungen und
Schäden, die an WAGO-Produkten und Fremdprodukten durch Missachtung der
Informationen dieses Dokumentes entstehen, übernimmt die WAGO
Kontakttechnik GmbH & Co. KG keine Haftung.
Bestimmungsgemäßer Gebrauch
Die Komponenten werden ab Werk für den jeweiligen Anwendungsfall mit einer
festen Hard- und Softwarekonfiguration ausgeliefert. Änderungen sind nur im
Rahmen der in dem Dokument aufgezeigten Möglichkeiten zulässig. Alle anderen
Veränderungen an der Hard- oder Software, sowie der nicht bestimmungsgemäße
Gebrauch der Komponenten, bewirken den Haftungsausschluss der WAGO
Kontakttechnik GmbH & Co. KG.
Wünsche an eine abgewandelte bzw. neue Hard- oder Software-Konfiguration
richten Sie bitte an WAGO Kontakttechnik GmbH & Co. KG.
Technischer Zustand der Geräte
Die Geräte werden ab Werk für den jeweiligen Anwendungsfall mit einer festen
Hard- und Software-Konfiguration ausgeliefert. Alle Veränderungen an der Hardoder Software sowie der nicht bestimmungsgemäße Gebrauch der Komponenten
bewirken den Haftungsausschluss der WAGO Kontakttechnik GmbH & Co. KG.
Wünsche an eine abgewandelte bzw. neue Hard- oder Software-Konfiguration
richten Sie bitte an die WAGO Kontakttechnik GmbH & Co. KG.
Bibliotheksbeschreibung
Funktionsbaustein
7
Funktionsbaustein
Senden eines Magic Packet (Wake on lan) (FbMagicPacket)
WAGO-I/O-PRO-Elemente der Bibliothek
Kategorie:
Name:
Typ:
Name der Bibliothek:
Anwendbar für:
Verwendete Bibliothek:
Automation
„FbMagicPacket“
Funktionsblock X
Funktion
WagoLibWakeOnLan.lib
Siehe Release-Note
WagoLibEthernet_01.lib
Eingangsparameter:
in_xStartJob
in_iPort
in_sIPaddress
Datentyp:
BOOL
INT
STRING
(16)
in_sMACaddress
STRING
(12)
Kommentar:
Startet die Abarbeitung
Port des Zielgerätes (z.B. 0, 7 oder 9)
Broadcastadresse des Zielsubnetzes
(z.B. 192.168.1.255)
MAC Adresse des Zielgerätes
(z.B 0030DE000000)
Ein-Ausgangsparameter:
Datentyp:
Kommentar:
Rückgabewert:
out_xBusy
out_xDone
out_diErrorCode
Datentyp:
BOOL
BOOL
DINT
Kommentar:
Funktion in der Abarbeitung
Funktion wurde ausgeführt
Error Codes der WagoLibEthernet_01
Grafische Darstellung:
Bibliotheksbeschreibung
Programm
8
Funktionsbaustein
Funktionsbeschreibung:
Der Funktionsbaustein ‚FbMagicPacket‘ kann genutzt werden um ein ‚Wake on lan‘Telegramm (MagicPacket) an ein beliebiges Netzwerkgerät zu versenden.
Bei einem Signal am Eingang in_xStartJob wird ein MagicPacket versendent. Der
Eingang muss solange anstehen, bis die Funktion beendet wurde.
Die IP Adresse am Eingang in_sIPaddress sollte auf die Broadcastadresse des
Zielsubnetztes eingestellt werden. Am Eingang in_iPort wird der Port des Zielgerätes
übergeben. Die meisten Geräte nutzen für WakeOnLan, Port 0, 7 oder 9.
Der Ausgang out_xBusy signalisiert, dass sich die Funktion in Abarbeitung befindet.
Der Ausgang out_xDone signalisiert, dass die Funktion erfolgreich beendet wurde.
Am Ausgang out_diErrorCode werden die Error Codes der WagoLibEthernet_01
ausgegeben.
Der Datentyp typFbMagicPacket_Arg beinhaltet alle Ein- und Ausgangsparameter
und besteht aus den Datentypen typFbMagicPacket_In und
typFbMagicPacket_Out.
Hinweis:
•
Das gewünschte Zielgerät muss die Funktionalität ‚Wake on lan‘ unterstützen.
Beispielsweise Zeitliches Verhalten:
Weitere notwendige Beschreibungsteile:
Bibliotheksbeschreibung
WAGO Kontakttechnik GmbH & Co. KG
Postfach 2880
• D-32385 Minden
Hansastraße 27 • D-32423 Minden
Telefon:
05 71/8 87 – 0
Telefax:
05 71/8 87 – 1 69
E-Mail:
[email protected]
Internet:
=== Ende der Liste für T extmar ke Ei nband_hinten ===
http://www.wago.com