owc Dokumentation Stand: 03/2016 Version

Transkript

1 owc Dokumentation Stand: 03/2016 Version

2 Inhalt 1. Rechtsgrundlagen Haftungsausschluss Eingetragene Markenzeichen Einleitung Ziele Globale Konstanten Datentypen der Bibliothek c_parameter DS1820_V1_ DS2423_V1_ DS2438_V1_ DS2450_V1_ one_wire_binaer_v1_ Baustein eservice_controller Anwendungshinweise Zielsystem für oscat.lib vorbereiten Bibliothek einfügen Daten eintragen Lizenz in Controller laden Artikelnummer zuweisen Ports des DS2408 steuern

3 1. Rechtsgrundlagen 1.1 Haftungsausschluss Haftungsausschluss Die in der owc Bibliothek enthalten Softwarebausteine werden als Entwicklungsvorlage angeboten. Es wird keinerlei Gewährleistung für die Richtigkeit und Fehlerfreiheit übernommen. Der dargestellte Programmcode ist nicht für Produktivzwecke vorgesehen und dient nur als Anwendungsbeispiel. Der Nutzer ist selbst verantwortlich dafür, eventuell in seiner Anwendung verwendete Module mit geeigneten Verfahren zu testen und die notwendige Fehlerfreiheit, Qualität und Funktionalität zu verifizieren. Eine Funktionsgarantie wird nicht übernommen und wird explizit ausgeschlossen. Da die in der Bibliothek enthaltenen Softwaremodule ohne jegliche Kosten bereitgestellt werden, besteht keinerlei Gewährleistung. 1.2 Eingetragene Markenzeichen Alle aufgeführten Bezeichnungen, Logos, Namen und Warenzeichen (auch solche, die nicht explizit gekennzeichnet sind) sind Warenzeichen, eingetragene Warenzeichen oder sonstige urheberrechtlich oder Marken- bzw. Titelrechtlich geschützte Bezeichnungen ihrer jeweiligen Eigentümer und werden von uns als solche ausdrücklich anerkannt. Die Nennung dieser Bezeichnungen, Logos, Namen und Warenzeichen geschieht lediglich zu Identifikationszwecken und stellt keinen irgendwie gearteten Anspruch von E-Service-Online, Andreas Geisler an bzw. auf diese Bezeichnungen, Logos, Namen und Warenzeichen dar. Zudem kann aus dem Erscheinen auf diesen WWW-Seiten nicht darauf geschlossen werden, dass Bezeichnungen, Logos oder Namen frei von gewerblichen Schutzrechten sind. 2. Einleitung 2.1 Ziele owc steht für one wire Controller. owc stellt eine Bibliothek zur Verfügung, mit welcher eine Kommunikation zwischen dem 1-Wire Controller von eservice und einem WAGO-Controller (getestet mit ) aufgebaut werden kann. Die Kommunikation erfolgt über TCPIP.. Folgende 1-Wire Bausteine werden unterstützt: Bezeichnung Funktion Sensor / Bausteingruppe Datentyp DS18B20 (DS18S20) Temperatursensor DS1820 DS1820_V1_1 DS2438 AD-Wandler DS2438 DS2438_V1_2 DS2450 AD-Wandler DS2450 DS2450_V1_2 DS Port PIO DS (2) Port PIO one_wire_binaer one_wire_binaer_v1_2 DS Port PIO DS Port PIO DS Kanal Zähler DS2423 DS2423_V1_1 ibutton i_button_key i_button_key_v1_

4 Globale Konstanten Um eine ordnungsgemäße Funktion zu gewährleisten werden folgende Bibliotheken benötigt: SysLibSockets.lib (wird von der Fa. Wago bereitgestellt) SysLibRtc.lib (wird von der Fa. Wago bereitgestellt) WagoLibEthernet_01.lib (wird von der Fa. Wago bereitgestellt) oscat_basic.lib Version 3.33 ( 2.2 Globale Konstanten Die owc Bibliothek benötigt einige globale Konstanten um die Bibliothek an die Anwendungen anzupassen. maximale Anzahl Bausteine Achtung: der Wert darf nie 0 sein, auch wenn der Typ nicht benutzt wird! owc_max_ds18b20: maximale Anzahl DS18B20 (Default=30) owc_max_ds2438: maximale Anzahl DS2438 (Default=20) owc_max_ds2450: maximale Anzahl DS2450 (Default=20) owc_max_ds2423 maximale Anzahl DS2423 (Default=10) owc_max_binaer: maximale Anzahl DS2405, DS2406, DS2408, DS2413(Default=30) owc_max_owd: max_owd owc_max_info: max_info definiert die maximale Anzahl one-wire Bausteine pro Controller [Default=30] definiert die Größe des Infospeichers [Default=20] welcher unter c_p.info zur Verfügung steht

5 3. c_parameter Datentypen der Bibliothek Die owc Bibliothek definiert neben den Standard Datentypen weitere Datentypen. Diese werden innerhalb der Bibliothek verwendet und können jederzeit von Anwender für eigene Deklarationen verwendet werden. 3.1 c_parameter Diese Parameter dienen zur Steuerung und Überwachung der Kommunikation mit dem one-wire Controller. Parameter Beschreibung status lizenz_status Nummer: ARRAY[1..owc_max_owd] steuern reset Controller neu starten net_open date_time_c_abgleich save_liste load_liste ids_neu_suchen intervall Hier wird die aktuelle Aktion als Text angezeigt. Information über Lizenzstatus Hier wird die laufende Nummer und der Typ des Bausteins, welche aus dem Controller gelesen wurden, abgelegt Verbindung öffnen [Default=TRUE] Datum und Zeit Controller neu setzen, wenn von SPS Zeit abweicht speichern der OWD Liste in das EEPROM des Controllers laden der gespeicherten OWD liste aus EEPROM alle Ids werden neu gesucht, Achtung Anordnung kann sich ändern Intervall der Datenübertragung [10-240]s [Default=20] hier die Lizenz eingeben lizenz baustein max_nummer Anzahl gefundener one-wire Bausteine anzahl_1820 anzahl_2401 info anzahl_bin anzahl_2423 anzahl_2438 anzahl_2450 Anzahl_iButton anzahl_infos infos_loeschen info DS2505, DS2406, DS2408, DS2413 TRUE-Signal löscht alle Informationen, Signal wird abgeschaltet Informationen mit Zeitstempel (Array [1.. owc_max_info]) Nummer: Wenn ein Baustein in einem E-Service Module eingebaut ist, wird hinter dem Bausteinnamen noch die Art. Nr. des E-Service Moduls eingetragen. Zuvor muss die Artikelnummer in den Controller eingegeben werden! siehe Artikelnummer zuweisen Beispiel: DS2438,

6 DS1820_V1_1 3.2 DS1820_V1_1 Der Datentyp DS1820_V1_1 definiert und speichert Vorgaben Werte und Status für den Temperatursensor DS18B20. Name: STRING Name des Sensors (optional) Nummer: INT Nummer des Bausteins im Controller ID: STRING(16) 8-stellige ID des Sensors Temperatur: REAL Messwert Stoerungen: INT Anzahl der Störungen letzte_aktualisierung: DT Zeitwert wann der Messwert zuletzt gelesen wurde aktiv : BOOL Sensor wird bearbeitet (TRUE-aktiv) 3.3 DS2423_V1_1 Der Datentyp DS2423_V1_1 definiert und speichert Vorgaben Werte und Status für den Zähler DS2423. Name:STRING Name des Sensors (optional) Nummer: INT Nummer des Bausteins im Controller ID: STRING(16) 8-stellige ID des Sensors zaehler1: DINT Zählerstand Kanal A zaehler2: DINT Zählerstand Kanal B Stoerungen Anzahl der Störungen, nur zur Bausteinbeurteilung letzte_aktualisierung: DT Zeitwert der letzten Aktualisierung aktiv:bool Baustein wird bearbeitet (TRUE-aktiv) 3.4 DS2438_V1_2 Der Datentyp DS2438_V1_2 speichert Vorgaben Werte und Status für den AD-Wandler DS2438. Name: STRING Name des Sensors (optional) Nummer: INT Nummer des Bausteins im Controller ID: STRING(16) 8-stellige ID des Sensors Liste: STRING hier steht, wo die Messwerte zu finden sind normal,typ1 oder typ2 Temperatur: REAL Spannung_VDD: REAL Busspannung [normal 5V] normal VAD: REAL Messspannung XSENS: REAL Spannungssignal 0-250mV vom Stromeingang typ1 Luftfeuchte: REAL Messwerte Temperatur Feuchtesensor Taupunkt: REAL Helligkeit: REAL typ2 Luftfeuchte: REAL Messwerte Temperatur-Feuchte-Luftgütesensor Taupunkt: REAL Luftguete: REAL Stoerungen Anzahl der Störungen, nur zur Bausteinbeurteilung letzte_aktualisierung: DT Zeitwert wann der Messwert zuletzt gelesen wurde aktiv:bool Sensor wird bearbeitet (TRUE-aktiv) Temperatur und Spannung_VDD wird immer abgelegt

7 DS2450_V1_2 Die übrigen Messergebnisse werden, abhängig vom Sensortyp, folgendermaßen abgelegt: Text in Liste normal : normal.vad, normal.xsens Text in Liste typ1 : typ1.luftfeuchte, typ1.taupunkt, typ1.helligkeit Text in Liste typ2 : typ2.luftfeuchte, typ2.taupunkt, typ2.luftguete 3.5 DS2450_V1_2 Der Datentyp DS2450_V1_2 definiert und speichert Vorgaben Werte und Status für den AD- Wandler DS2450. Name: STRING Name des Sensors (optional) Nummer: INT Nummer des Bausteins im Controller ID: STRING(16) 8-stellige ID des Sensors Liste: STRING hier steht, wo die Messwerte zu finden sind normal oder typ2 normal AI1: REAL Messwerte DS2450 normal oder AI2: REAL 1-Wire Analog Input AI3: REAL Art. Nr , AI4: REAL typ2 Strom_12V: REAL Messwerte Spannung_5V: REAL 1-Wire Hub und 1-Wire Hub II, Strom_5V: REAL Art. Nr , 11306, 11314, Spannung_12V: REAL Stoerungen: INT Anzahl der Störungen letzte_aktualisierung: DT Zeitwert wann der Messwert zuletzt gelesen wurde aktiv :BOOL Sensor wird bearbeitet (TRUE-aktiv) 3.6 one_wire_binaer_v1_2 Der Datentyp one_wire_binaer_v1_2 definiert und speichert Vorgaben Werte und Status für die Binärbausteine DS2405, DS2406, DS2408 und DS2413. *.Name: STRING Name des Sensors (optional) *.Nummer: INT Nummer des Bausteins im Controller *Typ: STRING Typ des Bausteins *.ID. STRING(16) 8-stellige ID des Sensors *.Status: ARRAY[0..7] Status [0] -Status 2 0 Status [1] - Status 2 1 *.Aenderung: ARRAY[0..7] Änderung [0] -Änderung an 2 0 Änderung [1] - Änderung an 2 1 *.DO_steuern_bool: ARRAY[0..7] Status des Bit welches als Ausgang verwendet werden soll *. DO_steuern_byte: do_byte_steuern_aktiv Ports mit Byte steuern aktiv [Default=False] do_byte_steuern:byte Wert [Byte] zum Steuern der Ports *.Stoerungen: INT Anzahl der Störungen *.letzte_aktualisierung: DT Zeitwert der letzten Aktualisierung *.aktiv:bool Sensor wird bearbeitet (TRUE-aktiv) 5 1.2

8 4. Baustein 4.1 eservice_controller Funktionsbaustein eservice_controller Input c_ip STRING(15) IP Controller 'aaa.bbb.ccc.ddd' c_port WORD Port Controller [Default 5000] DS1820_Daten POINTER TO ARRAY Zeiger auf das Array der DS1820 DS2438_Daten POINTER TO ARRAY Zeiger auf das Array der DS2438 DS2450_Daten POINTER TO ARRAY Zeiger auf das Array der DS2450 Binaerdaten POINTER TO ARRAY Zeiger auf das Array der Binärbausteine DS2423_Daten POINTER TO ARRAY Zeiger auf das Array der DS2423 ibutton_daten c_parameter POINTER TO ARRAY POINTER TO c_parameter Zeiger auf das Array der c_parameter Dem Funktionsbaustein eservice_controller werden die Adressen der Daten, welche als globalen Variablen definiert wurden, übergeben. Der Baustein wurde mit einer zyklischen Task 40ms getestet

9 Zielsystem für oscat.lib vorbereiten 5. Anwendungshinweise 5.1 Zielsystem für oscat.lib vorbereiten Speichergröße pro Segment von 16#7D000 in 16#7A000 ändern. Maximale Anzahl von Bausteinen von 1023 in 2046 ändern. 16#7A000 eintragen 2046 eintragen 5.2 Bibliothek einfügen Bibliotheksverwalter owc.lib einfügen: owc.lib einfügen 7 1.2

10 Daten eintragen 5.3 Daten eintragen Für eine ordnungsgemäße Funktion müssen unter Globale Variablen folgende Daten eingetragen werden: 1. Die Anzahl der verwendeten Sensoren / Bausteine 2. die c_parameter (Struktur c_parameter) 3. für jede verwendete Sensor- Bausteingruppe ein Array mit einer Größe wie unter Punkt 1 (Anzahl Sensoren / Bausteine) definiert wurde mit der Struktur der jeweiligen Sensor- Bausteingruppe. Beispiel: Achtung: wenn Anzahl der verwendeten Sensoren > max_typ ist, muss max_typ angepasst werden! max_typ <= max_owd Beispiel: DS2438_Anzahl:INT:=26; da max_ds2438 =20 ist, muss er angepasst werden:max_ds2438:int:=26; Einstellung in CoDeSys: Projekt Optionen Übersetzungsoptionen Konstanten ersetzen 8 1.2

11 Lizenz in Controller laden 5.4 Lizenz in Controller laden Ohne Lizenz werden nur 3 Bausteine gelesen! Um die Lizenz in den Controller zu laden muss der Lizenzcode in die Variable c_parameter.steuern.lizenz (Globale Variablenliste) eingegeben werden. Mit STRG+F7 wird der Wert in die Variable geschrieben und die Lizenz wird zum Controller übertragen. Lizenz eingeben Nach Eingabe der Lizenz muss das SPS-Programm neu gestartet werden um alle benötigten Daten zu laden. 5.5 Artikelnummer zuweisen Damit eine auf das 1-Wire Modul angepasste Datenformatierung, erweiterte Datenausgabe oder Datenumrechnung erfolgen kann, muss dem Baustein die E-Service Artikelnummer zugewiesen werden. Befehl: SET,OWD,ART,OWD-Nummer,OWD-Type, Beispiel: SET,OWD,ART,2,11316 Nach Zuweisen der Artikelnummer ist ein sichern der Bauteilliste mit Befehl SET,OWB,SAVE empfehlenswert

12 Ports des DS2408 steuern 5.6 Ports des DS2408 steuern Für das Schreiben der Ports existieren 2 Möglichkeiten: 1. DO_steuern_bool: DS2405, DS2406, DS2413 und DS2408 Steuerwert 2. DO_steuern_byte nur DS2408 do_byte_steuern_aktiv aktiviert das Steuern mit Byte Steuerwert