Bibliotheken für das WAGO-I/O-SYSTEM 750. Bausteinbeschreibungen für die Anbindung von ebm-papst Ventilatoren mit dem ebmbus

Transkript

1 für das WAGO-I/O-SYSTEM 750 Bausteinbeschreibungen für die Anbindung von ebm-papst Ventilatoren mit dem ebmbus Letzte Änderung:

2 2 Allgemeines Copyright 2007 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/ info@wago.com Web: 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 Dokument verwendeten Soft- und Hardwarebezeichnungen und Markennamen der jeweiligen Firmen im Allgemeinen einem Warenzeichenschutz, Markenschutz oder patentrechtlichem Schutz unterliegen.

3 Inhalt 3 WAGO-I/O-PRO CAA Bibliothek für die Gebäudetechnik Inhalt Wichtige Erläuterungen 4 Urheberschutz... 4 Personalqualifikation... 4 Bestimmungsgemäßer Gebrauch... 4 Gültigkeitsbereich... 5 Bausteine 6 ebmmaster... 6 ebmjobmaster... 8 Enumerationen 10 EBM_COMMAND EBM_ERROR Datentypen 11 typebm_data typebm_service typebm_job typebm_joblist Visualisierungsbaustein 15 ebmvisu Visualisierungstemplates 16 VISU_EBM... 16

4 4 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. 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. 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 Gebrauchmusterschutzes 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 Softwarekonfiguration richten Sie bitte an WAGO Kontakttechnik GmbH & Co. KG.

5 Gültigkeitsbereich 5 Gültigkeitsbereich Dieser Anwendungshinweis basiert auf die genannte Hard- und Software der jeweiligen Hersteller sowie auf die zugehörige Dokumentation. Daher gilt dieser Anwendungshinweis nur für die beschriebene Installation. Neue Hard- und Softwareversionen erfordern eventuell eine geänderte Handhabung. Beachten Sie die ausführliche Beschreibung in den jeweiligen Handbüchern.

6 6 ebmmaster Bausteine ebmmaster WAGO-I/O-PRO CAA Elemente der Bibliothek Kommunikation ebmmaster Typ: Funktion Funktionsblock X Programm Verwendete Serial_Interface_01.lib; Sercomm.lib Anwendbar für: alle Controller der 750er Reihe die die Sercomm.lib unterstützen. (nicht X) Eingangsparameter: Datentyp: Kommentar: bcom_port_nr BYTE Portnummer der Schnittstelle 0x01 -> Serviceschnittstelle 0x02 -> 1. gesteckte serielle Klemme 0x03 -> 2. gesteckte serielle Klemme u.s.w. cfflow_control COM_FLOW_ CONTROL HALFDUPLEX, FLOW_CONTROL_TERMINAL_DEFAULT ttimeout TIME max. Wartezeit auf eine Antwort vom Lüfter nach einer Anfrage (default 50ms) Ein- / Ausgabeparameter: Datentyp: Kommentar: Request typebm_service Struktur mit den Anfragedaten Response typebm_service Struktur mit den Antwortdaten xstart BOOL Durch einmaliges setzen dieses Parameters wird ein Auftrag ausgelöst. Der Baustein löscht diesen Parameter nach der Beendigung dieses Auftrages. Ausgangsparameter: Datentyp: Kommentar: enerror EBM_ERROR EBM_NO_ERROR := 0, EBM_UNSUPPORTED_COMMAND:=16#0001, EBM_INVALID_FAN_ADDRESS :=16#0002, EBM_INVALID_GROUP_ADDRESS:=16#0003, EBM_INVALID_DATA_COUNT :=16#0004, EBM_ERROR_RESPONSE_CRC :=16#0011, EBM_ERROR_RESPONSE_DATA :=16#0012, EBM_ERROR_EBM_MAX_DATA_TO_SMALL := 16#0013, EBM_ERROR_TIME_OUT := 16#99

7 ebmmaster 7 Grafische Darstellung: WAGO-I/O-PRO CAA Elemente der Bibliothek Funktionsbeschreibung: Der Baustein ist ein ebmbus-master. Im Anwenderprogramm muss die Struktur Request ausgefüllt werden und anschl. die boolsche Variable am Eingang xstart einmalig gesetzt werden. Der Baustein sendet nun den Request und wartet max. für die ttimeout Zeit auf eine Response vom adressierten Lüfter, sofern der Request keine Broadcastadresse enthielt. Nach Beendigung des Auftrages wird die Variable am Eingang xstart autom. von dem Baustein gelöscht. Dieser Baustein muss ständig, zyklisch im Anwenderprogramm aufgerufen werden. Hinweis : In der Regel brauchen die Eingänge cfflow_control und ttimeout nicht beschaltet werden. Dieser Baustein kann nicht gleichzeitig mit dem Baustein ebmjobmaster auf demselben Com-Port betrieben werden.

8 8 ebmjobmaster ebmjobmaster WAGO-I/O-PRO CAA Elemente der Bibliothek Kommunikation ebmjobmaster Typ: Funktion Funktionsblock X Programm Verwendete Serial_Interface_01.lib; Sercomm.lib Anwendbar für: alle Controller der 750er Reihe die die Sercomm.lib unterstützen. (nicht X) Eingangsparameter: Datentyp: Kommentar: bcom_port_nr BYTE Portnummer der Schnittstelle 0x01 -> Serviceschnittstelle 0x02 -> 1. gesteckte serielle Klemme 0x03 -> 2. gesteckte serielle Klemme u.s.w. cfflow_control COM_FLOW_ CONTROL HALFDUPLEX, FLOW_CONTROL_TERMINAL_DEFAULT ttimeout TIME max. Wartezeit auf eine Antwort vom Lüfter nach einer Anfrage (default 50ms) Ein- / Datentyp: Kommentar: Ausgabeparameter: Job typebm_job Struktur die einen Auftrag repräsentiert. Diese Struktur enthält einen Request und eine Response Ausgangsparameter: Datentyp: Kommentar: enerror EBM_ERROR EBM_NO_ERROR := 0, EBM_UNSUPPORTED_COMMAND:=16#0001, EBM_INVALID_FAN_ADDRESS :=16#0002, EBM_INVALID_GROUP_ADDRESS:=16#0003, EBM_INVALID_DATA_COUNT :=16#0004, EBM_ERROR_RESPONSE_CRC :=16#0011, EBM_ERROR_RESPONSE_DATA :=16#0012, EBM_ERROR_EBM_MAX_DATA_TO_SMALL := 16#0013, EBM_ERROR_TIME_OUT := 16#99 Grafische Darstellung:

9 ebmjobmaster 9 WAGO-I/O-PRO CAA Elemente der Bibliothek Funktionsbeschreibung: Der Baustein kapselt den Baustein ebmmaster und stellt als Schnittstelle eine Struktur vom Typ typebm_job zur Verfügung. Dieser Baustein muss ständig, zyklisch im Anwenderprogramm aufgerufen werden. Hinweis : In der Regel brauchen die Eingänge cfflow_control und ttimeout nicht beschaltet werden. Dieser Baustein kann nicht gleichzeitig mit dem Baustein ebmmaster auf demselben Com-Port betrieben werden.

10 10 EBM_COMMAND Enumerationen EBM_COMMAND WAGO-I/O-PRO Elemente der Bibliothek EBM_COMMAND Typ: Datentyp Enumeration X Elemente: Wert: Kommentar: ebmget_status 0 ebmget_actual_speed 1 ebmset_target_speed 2 ebmsoftware_reset 3 ebmwrite_eeprom 6 ebmread_eeprom 7 EBM_ERROR WAGO-I/O-PRO Elemente der Bibliothek EBM_ERROR Typ: Datentyp Enumeration X Elemente: Wert: Kommentar: EBM_NO_ERROR 16#0000 EBM_UNSUPPORTED_COMMAND 16#0001 EBM_INVALID_FAN_ADDRESS 16#0002 EBM_INVALID_GROUP_ADDRESS 16#0003 EBM_INVALID_DATA_COUNT 16#0004 EBM_ERROR_RESPONSE_CRC 16#0011 EBM_ERROR_RESPONSE_DATA 16#0012 EBM_ERROR_EBM_MAX_DATA_ 16#0013 TO_SMALL EBM_ERROR_TIME_OUT 16#0099

11 typebm_data 11 Datentypen typebm_data WAGO-I/O-PRO Elemente der Bibliothek typebm_data Typ: Datentyp X Enumeration Array [1..EBM_MAX_DATA] of BYTE Deklaration: TYPE typebm_data : ARRAY[1..EBM_MAX_DATA] OF BYTE; END_TYPE Beschreibung: Parameterdaten eines ebmbus-kommandos.

12 12 typebm_service typebm_service WAGO-I/O-PRO Elemente der Bibliothek typebm_service Typ: Datentyp X Enumeration Struktur: Element: Datentyp: Beschreibung: Command EBM_COMMAND ebmbus-kommando FanAddress BYTE Lüfteradresse FanGroup BYTE Lüfter-Gruppe DataCount BYTE Anzahl der folgenden Parameter Data typebm_data Parameterdaten Deklaration: TYPE typebm_service : STRUCT Command : EBM_COMMAND; FanAddress : BYTE; FanGroup : BYTE; DataCount : BYTE; Data : typebm_data; END_STRUCT END_TYPE Beschreibung: Diese Struktur bildet ein ebmbus-telegramm ab.

13 typebm_job 13 typebm_job WAGO-I/O-PRO Elemente der Bibliothek typebm_job Typ: Datentyp X Enumeration Struktur: Element: Datentyp: Beschreibung: Request typebm_service Anfrage Response typebm_service Antwort des angefragten Lüfters Error EBM_ERROR Rückmeldung über den Verlauf des Jobs DoIt BOOL Wird vom Anwender einmalig gesetzt (startet den Job) und nach Ausführung des Jobs vom Masterbaustein automatisch gelöscht. Deklaration: TYPE typebm_job : STRUCT Request : typebm_service; Response : typebm_service; Error : EBM_ERROR; DoIt : BOOL; END_STRUCT END_TYPE Beschreibung: Diese Struktur bildet einen ebmbus-job ab. Die Anfragedaten werden vom Anwender in die Requeststruktur eingetragen und nach Ausführung des Jobs durch den Masterbaustein gibt das Element Error Auskunft über den Verlauf des Jobs. Bei fehlerfreien Verlauf ist die Antwort des angefragten Lüfters in der Responsestruktur eingetragen.

14 14 typebm_joblist typebm_joblist WAGO-I/O-PRO Elemente der Bibliothek typebm_joblist Typ: Datentyp X Enumeration Array [1..EBM_MAX_JOBS] of typebm_job Deklaration: TYPE typebm_joblist : ARRAY[1..EBM_MAX_JOBS] OF typebm_job; END_TYPE Beschreibung: Liste mit EBM_MAX_JOBS Jobs JobNr Request Response Error DoIt EBM_MAX_JOBS

15 ebmvisu 15 Visualisierungsbaustein ebmvisu WAGO-I/O-PRO CAA Elemente der Bibliothek Kommunikation ebmvisu Typ: Funktion Funktionsblock X Programm Verwendete Serial_Interface_01.lib; Sercomm.lib Anwendbar für: alle Controller der 750er Reihe die die Sercomm.lib unterstützen. (nicht X) Ein- / Ausgabeparameter: Datentyp: Kommentar: Job typebm_job Struktur die einen Auftrag repräsentiert. Diese Struktur enthält einen Request und eine Response Grafische Darstellung: Funktionsbeschreibung: Der Funktionsblock "ebmvisu", wird zur Unterstützung des Visualisierungstemplates benötigt. Dieser Baustein stellt intern die Informationen den Visualisierungstemplates zur Verfügung und behandelt die Logik der visualisierten Buttons und Funktionen.

16 16 VISU_EBM Visualisierungstemplates VISU_EBM WAGO-I/O-PRO CAA Elemente der Bibliothek Kommunikation VISU_EBM Typ: Template Verwendete Serial_Interface_01.lib; Sercomm.lib Anwendbar für: alle Controller der 750er Reihe die die Sercomm.lib unterstützen. (nicht X) Parameter: Datentyp: Kommentar: VISU_FB ebmvisu Instanz des Visualisierungsbausteines mit der zugehörigen Logik Grafische Darstellung : Funktionsbeschreibung: Das Template "VISU_EBM stellt eine Testoberfläche bereit

17 WAGO Kontakttechnik GmbH & Co. KG Postfach 2880 D Minden Hansastraße 27 D Minden Telefon: 05 71/ Telefax: 05 71/ info@wago.com Internet: