Bibliotheksbeschreibung. WAGO-I/O-SYSTEM 750 CODESYS-2-Bibliothek WagoLibWakeOnLan.lib Wake on lan Ferngesteuertes Aufwecken von Netzwerk Geräten

Transkript

1 WAGO-I/O-SYSTEM 750 CODESYS-2-Bibliothek WagoLibWakeOnLan.lib Wake on lan Ferngesteuertes Aufwecken von Netzwerk Geräten Version vom

2 2 Impressum 2015 by WAGO Kontakttechnik GmbH & Co. KG Alle Rechte vorbehalten. WAGO Kontakttechnik GmbH & Co. KG Hansastraße 27 D Minden Tel.: +49 (0) 571/ Fax: +49 (0) 571/ Web: info@wago.com Technischer Support Tel.: +49 (0) 571/ Fax: +49 (0) 571/ support@wago.com 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 Hardware- Bezeichnungen und Markennamen der jeweiligen Firmen im Allgemeinen einem Warenzeichenschutz, Markenzeichenschutz oder patentrechtlichem Schutz unterliegen.

3 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

4 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 Symbole 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. Beachten Hinweis Information Beachten! Randbedingungen, die für einen fehlerfreien Betrieb unbedingt zu beachten sind. Wichtiger Hinweis! Routinen oder Ratschläge für den effizienten Geräteeinsatz und die Softwareoptimierung. 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 Beispiel Bemerkung Dezimal 100 Normale Schreibweise Hexadezimal 0x64 C-Notation Binär '100' ' ' In Hochkomma, Nibble durch Punkt getrennt

5 Hinweise zu dieser Dokumentation 5 Schriftkonventionen Tabelle 2: Schriftkonventionen Schriftart Bedeutung kursiv Namen von Pfaden und Dateien werden kursiv dargestellt z. B.: C:\Programme\WAGO Software Menü 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 Eingabe Bezeichnungen von Eingabe- oder Auswahlfeldern werden fett dargestellt z. B.: Messbereichsanfang Wert Eingabe- oder Auswahlwerte werden in Anführungszeichen dargestellt z. B.: Geben Sie unter Messbereichsanfang den Wert 4 ma ein. [Button] Schaltflächenbeschriftungen in Dialogen werden fett dargestellt und in eckige Klammern eingefasst z. B.: [Eingabe] [Taste] Tastenbeschriftungen auf der Tastatur werden fett dargestellt und in eckige Klammern eingefasst z. B.: [F5]

6 6 Wichtige Erläuterungen Wichtige Erläuterungen Änderungsvorbehalt 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. 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.

7 Funktionsbaustein 7 Funktionsbaustein Senden eines Magic Packet (Wake on lan) (FbMagicPacket) WAGO-I/O-PRO-Elemente der Bibliothek Kategorie: Automation Name: FbMagicPacket Typ: Funktion Funktionsblock X Programm Name der Bibliothek: WagoLibWakeOnLan.lib Anwendbar für: Siehe Release-Note Verwendete Bibliothek: WagoLibEthernet_01.lib Eingangsparameter: Datentyp: Kommentar: in_xstartjob BOOL Startet die Abarbeitung in_iport INT Port des Zielgerätes (z.b. 0, 7 oder 9) in_sipaddress in_smacaddress STRING (16) STRING (12) Broadcastadresse des Zielsubnetzes (z.b ) MAC Adresse des Zielgerätes (z.b 0030DE000000) Ein-Ausgangsparameter: Datentyp: Kommentar: Rückgabewert: Datentyp: Kommentar: out_xbusy BOOL Funktion in der Abarbeitung out_xdone BOOL Funktion wurde ausgeführt out_dierrorcode DINT Error Codes der WagoLibEthernet_01 Grafische Darstellung:

8 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:

9 === Ende der Liste für T extmar ke Ei nband_hinten === WAGO Kontakttechnik GmbH & Co. KG Postfach 2880 D Minden Hansastraße 27 D Minden Telefon: 05 71/ Telefax: 05 71/ info@wago.com Internet: