Betriebsanleitung Lufft I-BOX Messgeräte-Gateway www.lufft.com G.
© G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany.
Inhaltsverzeichnis 1 Vor Inbetriebnahme zu beachten .....................................................................................5 1.1 Verwendete Symbole ...............................................................................................5 1.2 Sicherheitshinweise .................................................................................................5 1.3 Bestimmungsgemäße Verwendung .........................................................................5 1.
8 9 10 11 12 Systemerweiterung mit Apps ........................................................................................ 25 8.1 Apps ...................................................................................................................... 25 8.2 Der App-Lifecycle .................................................................................................. 26 Die App „OPUS20“ ...................................................................................................
1 Vor Inbetriebnahme zu beachten 1.1 Verwendete Symbole Wichtiger Hinweis auf mögliche Gefahren für den Anwender Wichtiger Hinweis für die korrekte Funktion des Gerätes 1.2 Sicherheitshinweise Die Montage und Inbetriebnahme dürfen nur durch ausreichend qualifiziertes Fachpersonal erfolgen. Niemals an spannungsführenden Teilen messen oder spannungsführende Teile berühren. Technische Daten, Lager- und Betriebsbedingungen beachten. 1.
1.6 Seriennummer Die Seriennummer ist an der Seite neben der Stromversorgung erkennbar (EN=xxxx:xxxx:xxxx). Die Seriennummer bildet sich ohne „EN=“. Die Seriennummer wird auch auf dem Login-Bildschirm angezeigt. 1.7 Verwendete Markennamen Alle verwendeten Markennamen unterliegen uneingeschränkt dem gültigen Markenrecht und dem Besitzrecht des jeweiligen Eigentümers. 6 G.
2 Lieferumfang Gerät Lufft I-BOX Abb. 1: Ansicht von oben und von vorne Anschlusskabel Ethernet 1m Abb. 2: Kabel Schnellstart-Anleitung Abb. 3: Schnellstart-Anleitung Das Handbuch ist als PDF-Datei nach Start der Lufft I-BOX in der Fußzeile verfügbar. G.
3 Bestellnummern, Zubehör und Support Gerätebezeichnung Bestellnummer Lufft I-BOX 8200.00 Lufft Webshop http://www.lufft.com/de/produkte/produktsuche/?q=8200.00 3.1 Zubehör Gerätebezeichnung Bestellnummer Hutschienennetzteil 24V/DC/500mA 8120.NT24 Lufft Webshop http://www.lufft.com/de/produkte/produktsuche/?q=8120.NT24 3.2 Support Bezeichnung Direktaufruf Support-Site Für technischen Support siehe Kapitel 15.1 http://lufft-i-box.com 8 G.
3.3 Lufft I-BOX App-Store Die Lufft I-BOX ist mit Apps erweiterbar. Die Apps können im Lufft I-BOX App-Store bezogen werden. Bezeichnung Direktaufruf Lufft I-BOX App-Store http://www.lufft-i-box.com/app/store G.
4 Gerätebeschreibung Bei der Lufft I-BOX handelt es sich um ein Messgeräte-Gateway, das Messwerte ermittelt, den aktuellen Messwert speichert und entweder aktiv versendet oder auf Anfrage im maschinenlesbaren Format ausgibt. Die Lufft I-BOX verfügt über Eingangs- und Ausgangs-Schnittstellen und eignet sich hervorragend, um Lufft-Messgeräte in Unternehmensnetzwerke zu integrieren. Über Apps kann das Gerät erweitert werden. 4.
Temperaturen / Luftfeuchte angereihte Montage: 0 ... 65°C nicht-angereihte Montage: 0 ... 70°C 0 ... 90% rel. Feuchte, nicht kondensierend Gehäuse / Gewicht Kunststoffkleingehäuse (105 x 75 x 22mm) integrierte Hutschienenaufnahme ca. 140g G.
5 Inbetriebnahme 5.1 Anschluss und Spannungsversorgung Die Spannungsversorgung kann per PoE oder mit einem externen Netzteil erfolgen. 5.1.1 Versorgung per PoE Die Lufft I-BOX ist für den Einsatz in PoE-Umgebungen entsprechend IEEE802.3af geeignet. Die Spannungsversorgung erfolgt hierbei durch die Netzwerkinfrastruktur über den RJ45-Anschluss. Die Lufft I-BOX unterstützt sowohl die Phantomspeisung über die Datenpaare 1/2 und 3/6, wie auch die Speisung über die ungenutzten Adernpaare 4/5 und 7/8.
Dank der Fähigkeit die Sende- und die Empfangsleitung angeschlossener Geräte automatisch zu erkennen, ist die Nutzung beliebiger (gekreuzter und ungekreuzter) Netzwerkkabel möglich. Der Netzwerkanschluss ist gegenüber der Versorgungsspannung mit mindestens 500V galvanisch getrennt. Die Betriebsart der Lufft I-BOX ist „Autonegotiation“.
5.3.2 Mehrfarbenanzeige Über die große Mehrfarbenanzeige in der Front der Lufft I-BOX wird der aktuelle Systemzustand dargestellt: 5.4 grün: Normalzustand der Lufft I-BOX. Alle Dienste sind gestartet und das System ist voll betriebsbereit. Ein unterlagertes, zyklisches Blinken zeigt die Systemauslastung an. Je hektischer dieser Herzschlag ist, desto höher ist die Prozessorauslastung. blau: Bootvorgang. Alle Dienste werden hochgefahren.
6 Erster Systemstart Nachdem die Lufft I-BOX erstmalig an die Spannungsversorgung angeschlossen wurde und der Bootvorgang abgeschlossen ist hat die Lufft I-BOX die IP-Adresse 190.107.233.110. Sie kann unter http://190.107.233.110 per Browser erreicht werden. Der Benutzername ist „admin“, das Password ist „admin“. Nun müssen wenige Parameter konfiguriert werden, bis die Lufft I-BOX funktionsbereit ist. Der Setup-Assistent hilft beim Einrichten der Lufft I-BOX. 6.
6.2 Netzwerk-Konfiguration Nach der Hardware-Installation der Lufft I-BOX muss die für den Betrieb in einem TCP/IPNetz notwendige IP-Adresse, sowie ggf. auch die Subnetzmaske und die Gateway-Adresse vergeben werden. Die korrekten Werte für diese Parameter erfragen Sie bitte bei Ihrem zuständigen Systemadministrator. Die Lufft I-BOX hat im Auslieferungszustand die statische IP-Adresse 190.107.233.110 Für die Vergabe müssen sich PC und Lufft I-BOX im gleichen physikalischen Netzwerk befinden (z.B.
6.3 Allgemeine Einstellungen Abb. 5: Bildschirm Allgemeine Einstellungen Systemname Systemname (lang) Hinweis zur Administration: Hier kann sich der Administrator eigene Anmerkungen festhalten (z.B. zum Kaufdatum, Hersteller-Ansprechpartner, Inventarnummer). An dieser Stelle könnten auch die AktivierungsKeys der aus dem App-Store bezogenen Apps erfasst werden. G.
6.4 Administrator-Einstellungen Der Administrator ist für den reibungsfreien Betrieb der Lufft I-BOX zuständig und erhält wichtige Email-Nachrichten von der Lufft I-BOX. Abb. 6: Bildschirm Administrator-Einstellungen Email-Adresse: An diese Email-Adresse werden kritische Log-Meldungen versendet. Kontaktdaten: Dieses Feld wird auf der Anmeldemaske angezeigt. Damit kann zum Beispiel hinterlegt werden, wie der zuständiger Administrator erreicht werden kann.
6.5 Email-Einstellungen Die Email-Einstellungen werden benötigt, damit von der Lufft I-BOX Emails gesendet werden können. Die Lufft I-BOX versendet Emails in folgenden Fällen: Es treten kritische Log-Meldungen auf Täglicher Statusbericht an den Administrator (kann abgeschaltet werden) In Apps wird der Email-Versand konfiguriert und genutzt Wenn kein Email-Server konfiguriert werden soll, muss das Host-Feld leer bleiben. Abb. 7: Bildschirm Email-Einstellungen 6.
7 Systembedienung 7.1 Dashboard / Home Das Dashboard sieht der Administrator nach erfolgreicher Anmeldung. Es kann jederzeit mit dem „Home“-Button wieder erreicht werden. Abb.
Der Systemstatus der Lufft I-BOX wird farblich hervorgehoben angezeigt: Abb. 9: Dashboard-Anzeige System Status Grün: Das System läuft ordnungsgemäß. Im System liegen weder Warnungen noch kritische Fehler vor Gelb: Es liegen Warnungen vor Rot: Es liegen kritische Fehler vor Die Meldungen können unter Einstellungen Log mit dem Button „gesamtes Log löschen“ zurückgesetzt werden. Dann ist der System Status wieder grün.
7.2 Login Die Anmeldemaske (Login) kann ohne Anmeldung angesehen werden. Es ist lediglich die Kenntnis der IP-Adresse der Lufft I-BOX erforderlich. Abb. 11: Bildschirm Login-Dashboard Zusätzlich zu Systemeigenschaften, die im Kapitel „Dashboard“ beschrieben sind, werden angezeigt: Admin Email Admin Kontakt Systembezeichnung Systemversion 7.3 Email-Adresse des zuständigen Administrators Name des zuständigen Administrators Diese Bezeichnung kann unter „Einstellungen Allgemein“ verändert werden.
7.4 Sicherung Die Sicherung der Lufft I-BOX kann unter Backup/Restore gestartet werden. Abb. 12: Bildschirm Backup/Restore Die im Sicherungsvorgang erstellte Datei (.backup) enthält alle Systemeinstellungen außer den Netzwerkeinstellungen, alle Kanalinformationen und alle Device-Konfigurationen. Eine Sicherung sollte nach größeren Konfigurationsanpassungen durchgeführt werden. Die zusätzlich installierten Apps werden nicht gesichert.
7.6 Passwort vergessen Die Lufft I-BOX kann nur nach Eingabe von Benutzername und einem Passwort konfiguriert werden. Wurde das Passwort vergessen, muss der „Password vergessen“ Link auf der Login-Seite aufgerufen werden. Die Wiederherstellung des Passworts kann auf zwei verschiedene Arten erfolgen: 24 Wenn ein Email-Server konfiguriert wurde, wird ein neues Passwort erzeugt und dieses an die beim Administrator angegebene Email-Adresse gesendet.
8 Systemerweiterung mit Apps Die Lufft I-BOX kann mit Apps im Funktionsumfang erweitert und an den jeweiligen Einsatzzweck angepasst werden. Apps können zu einem beliebigen Zeitpunkt nachinstalliert und wieder gelöscht werden. 8.1 Apps Apps sind Programme, die die Funktionsweise der Lufft I-BOX erweitern.
Im unteren Bereich werden die in der Lufft I-BOX installierten Apps angezeigt. In der Spalte „Devices verwalten“ können Devices hinzugefügt oder wieder gelöscht werden. 8.2 Der App-Lifecycle Unter dem App-Lifecycle wird der Umgang mit Apps in der Lufft I-BOX verstanden. Er umfasst folgende Schritte Finden Upload/Install Device erstellen Device konfigurieren App Update App deinstallieren 8.2.
8.2.3 Installation von Apps Unter Home Apps Management kann eine neue App hinzugefügt (installiert) werden. Die App erscheint nach erfolgreicher Installation in der App-Liste. Die App muss zuvor unter http://lufft-i-box.com/app/activation aktiviert worden sein. 8.2.4 Devices verwalten Eine App ist unmittelbar nach Installation in der Lufft I-BOX funktionslos. Aus jeder App können nun funktionsfähige „Devices“ erstellt werden.
Abb. 15: Bildschirm IN-Device einer OPUS20 App 8.2.6 App Update Eine App wird gelegentlich erweitert oder um Fehler bereinigt. Dann steht eine neue AppVersion zur Verfügung, die in die Lufft I-Box als Update installiert werden kann. Beim Update einer App wird geprüft, ob das Update im laufenden Betrieb durchgeführt werden kann oder ob eine Anpassung der Konfiguration der Devices erforderlich ist.
9 Die App „OPUS20“ Die App „OPUS20“ fragt die jeweils letzten Messwerte von OPUS20-Geräten ab und speichert diese in der Lufft I-BOX. Sie ist Teil des Lieferumfangs und zum Auslieferzeitpunkt bereits installiert. 9.1 Funktionsbeschreibung Die App ist eine IN-App und kann Messwerte von einem Lufft OPUS20-Device beziehen und in der Lufft I-BOX speichern.
9.3 Konfiguration Die Konfiguration der OPUS20-App erfolgt mit folgenden Parametern: Bezeichnung Bezeichnung (lang) Beschreibung Device aktiv Messintervall IP-Konfiguration Kanäle Die Bezeichnung wird in der Device-Übersicht angezeigt. Die Bezeichnung kann für längere Bezeichnungstexte verwendet werden. Notizen zur Konfiguration und zum OPUS20-Gerät (z.B.
In der Kanalliste kann die Kanalbeschreibung durch Klick auf die Werte in der Spalte Bezeichnung geändert werden. Die Zeilen können durch Klick auf die Spaltenüberschriften sortiert werden. 9.4 Meldungen / Fehlersituationen Während ein OPUS20 aktiv ist, können folgende Meldungen (Logs) auftreten: Typ Beschreibung Gegenmaßnahme Ethernet Fehler auf der TCP/IPVerbindungsebene. - Kabel prüfen - IP-Konfiguration prüfen Protokollfehler bei Kommunikation mit OPUS20.
Die App „OPUS Finder“ 10 Mit der App „OPUS Finder“ können OPUS20 Geräte im Netzwerk gefunden und mit einer neuen IP-Adresse versehen werden. Sie ist Teil des Lieferumfangs und zum Auslieferzeitpunkt bereits installiert und vorkonfiguriert. 10.1 Funktionsbeschreibung Die App ist eine SYS-App und kann zur Erst-Konfiguration eines OPUS20-Gerätes verwendet werden. Hierzu sendet die App Broadcast-Signale an alle Geräte im Netzwerk und bekommt Rückmeldungen von den angeschlossenen OPUS20-Geräten.
10.3 Konfiguration Damit die Suche nach OPUS20 Geräten gestartet werden kann, sind folgende Schritte notwendig: Erzeugung eines Device (z.B. unter Apps opusfinder Device verwalten).
Abb. 18: Bildschirm: IP-Einstellungen für ein OPUS20 Gerät Wenn die IP-Einstellungen per DHCP automatisch bezogen werden sollen, können die statischen Daten nicht eingegeben werden. Nach der Konfiguration der IP-Einstellungen kann die Messdaten-Übertragung vom OPUS20-Gerät zur Lufft I-BOX konfiguriert werden. Hierzu gehen Sie wie folgt vor: Apps opus20 ein neues OPUS20 Device hinzufügen. Bei diesem Device kann dann unter IN die IP-Adresse und der Messvorgang konfiguriert werden.
11 Die App „JSON“ Die App „JSON“ beantwortet REST-Anfragen und liefert Messwerte, Geräte-und Kanalinformationen im JSON-Format zurück. Sie ist Teil des Lieferumfangs und zum Auslieferzeitpunkt bereits installiert. Das JSON Datenformat ist ein einfaches maschinenlesbares Datenformat. In vielen Programmiersprachen und Programmsystemen wird das JSON-Format unterstützt. Damit ist eine sehr einfache Messwertabfrage und Messdatenübertragung realisierbar.
11.3 API-Verhalten 11.3.1 Anfrage Jede Anfrage erfolgt über den http-GET-Befehl http:/// websites/ab/index.php/json//api/ Netzwerkname oder IP-Adresse der Lufft I-BOX Device ID (vgl. OUT JSON API-Hilfe) siehe Kapitel „API-Befehle“ Nachfolgend wird der Beginn des Befehls http:///websites/ab/index.php/json//api/ als bezeichnet. 11.3.
app… Appname deviceid… Device-ID devicecaption… Vom Benutzer vergebene bezeichnung des Devices(string) channelno… Kanalnummer interval… Intervall im vielfachen von10sec (Integer) type… Kanaltyp (siehe unten) caption… Kanalbezeichnung (String, max. 255 Zeichen) measurementname… Name der Messgröße (String, max. 255 Zeichen) unitname… Einheit der Messgröße(String) valuemin… Wertebereich min. valuemax… Wertebereich max.
11.5 Konfiguration Die Konfiguration der JSON-App erfolgt mit folgenden Parametern: Bezeichnung Bezeichnung (lang) Beschreibung Device aktiv Die Bezeichnung wird in der Device-Übersicht angezeigt Die Bezeichnung kann für längere Bezeichnungstexte verwendet werden. Notizen zur Konfiguration und zur Nutzung des Devices (z.B. abfragende Programme, Ansprechpartner hierfür) Einschalten / Ausschalten der API-Funktion. Wenn das Device ausgeschaltet ist, wird „success = false“ zurückgeliefert. 11.
"channelmetaid":"479", "valueid":"110-40115", "app":"opus20", "deviceid":"110", "devicecaption":"Opus (.96)", "channelno":"40115", "interval":"1", "type":"16", "caption":"", "measurementname":"Taupunkt", "unitname":"\u00b0F", "valuemin":"-40", "valuemax":"80" } ], "errorno":0, "errormsg":"" } Nachfolgendes Resultat liefert der Befehl getvalues in einer Beispielkonfiguration zurück. http:///websites/ab/index.
Die App „Email Alert“ 12 Die App „Email Alert“ überwacht Messwerte und alarmiert, wenn Messbereiche verlassen werden. Sie ist Teil des Lieferumfangs und zum Auslieferzeitpunkt bereits installiert und vorkonfiguriert. 12.1 Funktionsbeschreibung Die App „Email Alert“ verfügt über folgende Funktionen: Prüfung von Kanälen auf Überschreitung von Grenzwerten. Prüfung von Kanälen auf Unterschreitung von Grenzwerten. Versand von Emails bei Über- bzw. Unterschreitung an die hinterlegten EmailAdressen 12.
Email-Adresse(n) Eine oder mehrere Email-Adressen können angegeben werden. Email-Adressen werden mit einem Komma getrennt. In dem Tab „Kanäle“ werden alle aktiven Kanäle der Lufft I-BOX angezeigt. Für jeden Kanal kann eine Werteobergrenze und eine –untergrenze eingestellt werden. Überwachungen werden nur für Felder durchgeführt, bei denen Eingaben erfolgt sind. 12.4 Meldungen / Fehlersituationen Bei Über- oder Unterschreiten von Grenzwerten wird ein Log-Eintrag als „Range“ erzeugt.
13 Konformitätserklärung Konformitätserklärung gemäß Richtlinie 2004/108/EG (EMC), 2006/95/EG (LVD) und 2011/65/EU (RoHS). Die G. Lufft Mess- und Regeltechnik GmbH, Fellbach, erklärt, dass das Produkt Lufft I-BOX Messgeräte-Gateway (Bestell-Nr.: 8200.00) auf das sich diese Erklärung bezieht, mit den folgenden Normen bzw. normativen Dokumenten übereinstimmen: 1. Stör-Emission gemäß EN 55022 Kl. B: 2010 EN 61000-3-2: 2006 + A1, A2 EN 61000-3-3: 2008 2.
14 Allgemeine Fehler Fehlerbeschreibung Das Gerät lässt sich nicht abfragen bzw. antwortet nicht Das Gerät lässt sich nicht abfragen bzw. antwortet nach Konfigurationsmaßnahmen nicht mehr Kennwort vergessen Ursache - Behebung Versorgungsspannung prüfen Ethernet-Kabelverbindung prüfen Es wurde möglicherweise eine falsche IP-Adresse konfiguriert. Eine Notfall-IP-Adresse ist im Gerät eingerichtet, falls eine falsche IP-Konfiguration vorgenommen wurde (vgl. Kapitel 6.
15 Reparatur / Instandsetzung Lassen Sie ein defektes Gerät ausschließlich vom Hersteller überprüfen und gegebenenfalls reparieren. Öffnen Sie das Gerät nicht und versuchen Sie auf keinen Fall eine eigenständige Reparatur. Für Fälle der Gewährleistung oder Reparatur wenden Sie sich bitte an: G. Lufft Mess- und Regeltechnik GmbH Gutenbergstraße 20 70736 Fellbach Postfach 4252 70719 Fellbach Deutschland Tel: +49 711 51822-0 Hotline: +49 711 51822-52 Fax: +49 711 51822-41 E-Mail: info@lufft.
16 Abbildungsverzeichnis Abb. 1: Ansicht von oben und von vorne .....................................................................................7 Abb. 2: Kabel ...............................................................................................................................7 Abb. 3: Schnellstart-Anleitung .....................................................................................................7 Abb. 4: Bildschirm Setup-Assistent ...............................................
17 Stichwortverzeichnis Konformitätserklärung .................................................. 42 A Administrator ................................................................ 18 L Allgemeine Einstellungen ............................................. 17 LED .............................................................................. 13 API Befehle................................................................... 36 Lieferumfang ...............................................................
G. Lufft Mess- und Regeltechnik GmbH Gutenbergstraße 20 70736 Fellbach Postfach 4252 70719 Fellbach Deutschland Tel: +49 711 51822-0 Hotline: +49 711 51822-52 Fax: +49 711 51822-41 E-Mail: info@lufft.de WWW: www.lufft.