manualshive.com logo in svg

Lufft I-BOX, Operating Manual

Share
Download
Lufft I-BOX Operating Manual Download Page 29

 

 

G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany 

29

 

9 

The 

App „OPUS20“ 

The app “OPUS20” transmits values from Lufft OPUS20 measuring instruments to the Lufft I-
BOX. It is shipped with the Lufft I-BOX and can be used out of the box.  

9.1 

Operating mode 

The app “OPUS20” acquires values from Lufft OPUS20 instruments. The last acquired value 
per channel will be saved in the Lufft I-BOX. 

The app supports all devices of the Lufft OPUS20 family: 

 

Lufft OPUS20 THI 

 

Lufft OPUS20 THIP 

 

Lufft OPUS20 E 

These instruments are connected to the Lufft I-BOX via Ethernet and TCP/IP. All channels of 
OPUS20 devices are supported. External sensors connected to an OPUS20 instrument are 
supported as well. 

9.2 

Features 

feature 

 

description 

name  

OPUS20 

type  

IN 

description  

This app acquires live values from Lufft OPUS20 measuring 
instruments family (see microsite 

http://www.opus20.info

 or 

product website 

http://www.lufft.com/de/produkte/produktsuche/?q=opus20

). All 

channels are loaded on request. External sensors are 
supported. 

description URL  

http://lufft-i-box.com/app/view?name=opus20

 

licence name 

Ondics Lufft I-BOX App EULA 

lizence URL  

http://lufft-i-box.com/dev/ondics/eula.html

 

maximum devices  

30 

 

 

 

Summary of Contents for I-BOX

Page 1: ...G Lufft Mess und Regeltechnik GmbH Fellbach Germany Operating Manual English Lufft I BOX Measuring instruments gateway www lufft com ...

Page 2: ... G Lufft Mess und Regeltechnik GmbH Fellbach Germany We reserve the right to make technical changes at any time without notice ...

Page 3: ...tore 9 4 Equipment Description 10 4 1 Lufft I BOX Features 10 4 2 Technical data 10 5 Installation 12 5 1 Power Supply 12 5 2 Network connection 12 5 3 LEDs 13 5 4 Button Hardware Reset 14 6 First Startup 15 6 1 Setup Assistant 15 6 2 Network Configuration 15 6 3 Common Settings 17 6 4 Administrator Settings 18 6 5 Email Settings 19 6 6 Time and date 19 7 User Interface 20 7 1 Dashboard Home 20 7 ...

Page 4: ... 33 10 4 Logging errors 34 11 The App JSON 35 11 1 Operating mode 35 11 2 Features 35 11 3 API specification 36 11 4 API commands 36 11 5 Configuration 38 11 6 Logging errors 38 11 7 Beispiele von JSON Abfragen 38 12 The App Email Alert 40 12 1 Operating mode 40 12 2 Features 40 12 3 Configuration 40 12 4 Logging errors 41 13 Declaration of Conformity 42 14 General errors 43 15 Repair Corrective M...

Page 5: ...age and operating conditions 1 3 Designated Use The equipment must only be operated within the range of the specified technical data The equipment must only be used under the conditions and for the purposes for which it was designed The safety and operation of the equipment can no longer be guaranteed if it is modified or adapted 1 4 Incorrect Use If the equipment is installed incorrectly It may n...

Page 6: ...e designated use is violated 1 6 Serial number The serial number is shown besides the power supply connector EN xxxx xxxx xxxx EN is not part of the serial number The serial number ist displayed in the login screen too 1 7 Brand Names All brand names referred to are subject without limitation to the valid trademark and ownership rights of the respective owner ...

Page 7: ... Delivery Equipment Fig 1 Top and front view Ethernet cable 1 meter Fig 2 Ethernet cable Quickstart Sheet Fig 3 Quickstart manual The operating manual is available as PDF file inside the Lufft I BOX After booting the Lufft I BOX it can be downloaded from the footer ...

Page 8: ...s produktsuche q 8200 00 3 1 Accessories Part name Order number Website Power Supply Din Rail 24V DC 500mA 8120 NT24 http www lufft com en products produktsuche q 8120 NT24 3 2 Support Description Website Support Site For technical support see section 15 1 http lufft i box com The Website http lufft i box com is operated by Ondics GmbH in Germany http ondics de ...

Page 9: ...e The Lufft I BOX is expandable using Lufft I BOX Apps These Apps can be downloaded and purchased in the Lufft I BOX App Store Part name Website Lufft I BOX App Store http www lufft i box com app store The Lufft I BOX App Store is operated by Ondics GmbH in Germany http ondics de ...

Page 10: ...ng and Buffering the last value per channel Providing a REST API for value delivery in JSON format Range monitoring with email alerting features The Lufft I BOX can be enhanced using Lufft I BOX Apps These Apps can be downloaded and purchased in the Lufft I BOX App Store and installed through the User Interface 4 2 Technical data Network 10 100BaseT autosensing autocrossing Connectivity 1 x LAN Ne...

Page 11: ...G Lufft Mess und Regeltechnik GmbH Fellbach Germany 11 Housing Weight Plastic compact housing 105 x 75 x 22mm Integrated DIN rail mount approx 140g ...

Page 12: ... power plug is correspondingly labeled Reversing the polarity will not harm the hardware of the Lufft I BOX 5 1 3 Disconnect from power supply When disconnecting the Lufft I BOX from the power supply the operating system gets shut down controlled The energy for this process is taken from two capacitors Especially the file system is protected from failure which could lead to problems at the next st...

Page 13: ...by the Lufft I BOX in the form of two LEDs integrated into the RJ45 jack The device status is displayed by a multi color indicator also on the front of the unit 5 3 1 Network status Two LEDs in the lower corners of the RJ45 jack indicate the current network status of the Lufft I BOX The green LED may assume the following states Off No link On Link present Flashing Active data communication The yel...

Page 14: ...d for manual triggering a hardware reset When the button is held down the multi color display changes from green to yellow to red This process takes around 5 seconds Then all connections are closed and the system is restarted After startup is complete the indicator comes on green again including the underlaid pulsing which indicates the processor load ...

Page 15: ...stant is displayed After the Setup Assistant is finished it can be reactivated in the Settings Common menu Fig 4 Screenshot Setup Assistant The Setup Assistant allows to make settings for Language Administrator Date and time Network For setting details see the following sections After the Setup Assistant ist finished and the system was rebooted the system settings must be checked and adjusted on d...

Page 16: ...olatile setup of the Lufft I BOX The parameters set in this manner remain intact even after power interruptions and resets until they are changed via web based user interface 6 2 1 2 DHCP If automatic address assignment using DHCP is enabled the Lufft I BOX attempts to obtain its IP parameters from a DHCP server located in the network If no DHCP server is in the network or if the attempt to obtain...

Page 17: ...Settings Fig 5 Screenshot Common Settings System name System name long Notices The Administrator can make any notices about the Lufft I BOX e g purchasing date support contact inventory number Also the AcrtivationKeys for additionally installed Apps can be noted here ...

Page 18: ...l critical log events are being sent Contact details The contact details are shown on the prelogin screen Thus any person without login credentials know whom to contact in case of system administration To successfully change a password the current password has to be entered as well as the new password has to be confirmed If there is no input in the password fields the password is not changed on sa...

Page 19: ...trator can be switched off Whenever apps decide to send emails To send emails an email server is required If there is no email server configured no emails will be send at all Fig 7 Screenshot Email Settings 6 6 Time and date The System date and time can be set to the local time Date and time settings are battery buffered and do not reset during a power interruption ...

Page 20: ...the administrator change in Settings Common Date Time current sytem daten time change in Settings Time IP Address Network settings change in Settings Network Serial Number Unique Serial Number of this Lufft I BOX Uptime Period since last system boot d days h hours m minutes Free memory Memory free for measuring purposes System load 1 minute and 15 minute average system load of Lufft I BOX Installe...

Page 21: ...s or warnings Yellow there are warnings logged Red there are critical errors are in the log entries The results of the channel monitoring are also highlighted using colors However there are only two system states ok and warning Fig 10 Dashboard display of range checks Green there are no range exceedings Yellow some channels are exceeing defined ranges The log entries are shown by clicking on the i...

Page 22: ... Additionally there are shown Admin email Email address of the administrators Admin contact contact details of the administrator System name can be modified in Settings Common The system name is also displayed in the header Systemversion Firmware version of the Lufft I BOX 7 3 Firmware update Firmware updates change the fundamental behaviour of the Luff tI BOX For firmware updates you ll get speci...

Page 23: ...to be reinstalled manually For this reason ActivationsKeys and the installation files of these apps have to be backuped separately 7 5 Restore Apps that have been installed before a backup was started have to be reinstalled to make the restore process succeeding To start the restore process upload the backup file zip and then press the button Import Backup All system settings are overridden during...

Page 24: ...ot your password feature with basic password recovery support Password recovery can be done in two ways If there is an email server configured a new password is generated and sent to the configured administrator email address If there is no email address and no email server configured please contact our support team see section 3 Please specify the Lufft I BOX serial number also printed onto the L...

Page 25: ... feature set of the Lufft I BOX in any direction Apps have some advantages over well known industry software components Apps expand the functional features of the Lufft i BOX dynamically Apps can be installed during operation Apps can be reused for many devices Apps within the Lufft I BOX ecosystem can be of one of there types IN Apps Devices of IN Apps acquire measured values from measuring instr...

Page 26: ...manually download to your local harddrive and install it via upload to the Lufft i BOX Get apps from the Lufft I BOX App Store fully automatically With firmware 1 0 0 this feature is not yet available The Lufft I BOX App Store can be accessed via internet http lufft i box com 8 2 2 Technical information about apps Every app is specified by the app developer using these features Feature Description...

Page 27: ...nction To make it work devices have to be generated out the app Devices have specific configuration sets and can operate independently from each other For example a device of an OPUS20 IN app can be configured to get values from one OPUS20 measuring instrument while another device of an OPUS20 IN app get values from a different OPUS 20 instrument 8 2 5 Device overview The device types are listed a...

Page 28: ...uring normal operation or if the configuration has to be modified Minor Updates can normally be done without reconfiguring the devices Minor updates are updates with the first number of the version unchanged e g 1 2 0 1 3 0 8 2 7 App deinstallation When an app is deinstalled all devices of this app are deinstalled too Configuration sets of these are deleted irrecoverable When deinstallation is sta...

Page 29: ... E These instruments are connected to the Lufft I BOX via Ethernet and TCP IP All channels of OPUS20 devices are supported External sensors connected to an OPUS20 instrument are supported as well 9 2 Features feature description name OPUS20 type IN description This app acquires live values from Lufft OPUS20 measuring instruments family see microsite http www opus20 info or product website http www...

Page 30: ...the value acquisition inside the lufft I BOX measurement interval Interval between subsequent measurement value acquisitions IP configuration IP address of the connected OPUS20 device channels List of all channels with active value acquisition Fig 16 Screenshot OPUS20 Device Information tab Within the sub tab channels the channels can be configured The button get channels requests and displays the...

Page 31: ...critical if not persistent To activate the Ethernet Interface inside an OPUS20 measuring instrument refer to http www lufft com dateianzeige php Dateiname download manual 8120_e pdf An OPUS20 measuring instrument that is disconnected from power some time deactivates the Ethernet Interface It has to be reactivated manually During operation if warnings occur values cannot be acquired and stored in t...

Page 32: ...ted OPUS20 instruments The app supports all devices of the Lufft OPUS20 family Lufft OPUS20 THI Lufft OPUS20 THIP Lufft OPUS20 E Since broadcast mechanisms are limited to subnets in Ethernet networks OPUS20 instruments can only be reached in the same IP subnet the Lufft I BOX is connected to 10 2 Features feature description name OPUS Finder type SYS description This app finds Lufft OPUS20 devices...

Page 33: ...f devices To configure an OPUS20 device go to the Configuration tab The configuration parameters are name short Name of the device for display in the device list name long A longer name for the device description Notes about the device usage configuration device active Switches the device on or off When switched on the value acquisition process is running Fig 17 Screenshot Search results with 3 OP...

Page 34: ...ew device Apps Manage Apps and Devices Manage OPUS20 Go to configuration of the new device 10 4 Logging errors During OPUS Finder device operation several warnings or errors may happen They will get logged in the log tab log type Description e g action required Ethernet error on TCP IP connection layer check cable check if OPUS20 instruments is connected to the same subnet check if Ethernet connec...

Page 35: ...ript Object Notation please refer to Wikipedia see http en wikipedia org wiki Representational_State_Transfer and http en wikipedia org wiki JSON 11 1 Operating mode The App is an OUT app and delivers information on demand The client sends http GET requests and gets results in JSON format The app supports measured live values that are stored inside the Lufft I BOX delivering a channel list with al...

Page 36: ... responses are in JSON format For detailed JSON specification please refer to RFC 4627 http www ietf org rfc rfc4627 txt The responses in JSON fomat are coded with the UTF8 character set 11 3 3 Response errors All requests have a success field Successful requests set this field to true errors are indicated with false In case of an error there are two additional fields errorno und errormsg Response...

Page 37: ... 20 sum 21 vectorized average 11 4 2 Value request name getvalues description Returns one or more values URL Base URL getvalues valueids dev ch parameter dev ch Unique channel ID Concatenated field out of device ID a dash character and channel number see command getchannels This parameter can repeated comma separated in order to get multiple values Example for a valid request Base URL getvalues va...

Page 38: ...1 6 Logging errors While the JSON device is active there can be log entries log type Description e g action required Request Error in URL request check URL parameters These log entries are not critical 11 7 Beispiele von JSON Abfragen The command getchannels returns with thie JSON string example konfiguration http lufft i box websites ab index php json 1 api getchannels success true channels chann...

Page 39: ...emin 40 valuemax 80 errorno 0 errormsg The command getvalues returns with thie JSON string example konfiguration http lufft i box websites ab index php json 1 api getvalues valueids 73 100 73 120 success true values success false id 73 100 value 0 timestamp 2013 11 27 10 35 26 errorno 0 errortype success false id 73 120 value 0 timestamp 2013 11 27 10 35 26 errorno 0 errortype ...

Page 40: ... range Ranges can be set per channel If a value is out of range an email is sent description URL http lufft i box com app view name emailalarm licence name Ondics Lufft I BOX App EULA lizence URL http lufft i box com dev ondics eula html maximum devices 10 12 3 Configuration To configure an Email Alert device go to the Configuration tab The configuration parameters are name short Name of the devic...

Page 41: ... Logging errors During Email Alert device operation if ranges are exceeded info log entries are generated They will get logged in the log tab If an email could not be sent server down email address incorrect a warning is logged All info log entries are shown colored on the dashboard too green checks were performed no ranges were exceeded no alarms yellow checks were performed ranges habe been exce...

Page 42: ...EN 61000 4 5 2006 Surge EN 61000 4 6 2009 Conducted Immunity EN 61000 4 8 2010 H Field EN 61000 4 11 2004 Supply Voltage Dips and Interruptions 3 Product specific Low Voltage Directive for communications technology With a supply voltage of maximum 48V DC SELV the above product does not fall under the application area of the Low Voltage Directive 4 Restriction of the use of certain hazardous substa...

Page 43: ...heck Ethernet connection check network settings The Lufft I BOX does not respond after configuration activities A wrong ip address was configured See section 6 2 for recovery of the lufft I BOX Forgot your admin password There are several password recovery mechanisms Please see section 7 6 for password recovery Need more help Please see section 3 2 for more support options ...

Page 44: ...s of guarantee or repair please contact G Lufft Mess und Regeltechnik GmbH Gutenbergstraße 20 70736 Fellbach Postfach 4252 70719 Fellbach Germany Tel 49 711 51822 0 Hotline 49 711 51822 52 Fax 49 711 51822 41 E Mail info lufft de or your local distributor 15 1 Technical Support Our Hotline is available for technical questions via the following e mail address support lufft de You can also consult f...

Page 45: ...l Settings 19 Fig 8 Screenshot Dashboard Home 20 Fig 9 Dashboard display of system status 21 Fig 10 Dashboard display of range checks 21 Fig 11 Screenshot Login Screen 22 Fig 12 Screenshot Backup Restore 23 Fig 13 Screenshot App Management 25 Fig 14 Screenshot OUT Devices 27 Fig 15 Screenshot IN Device of OPUS20 app 28 Fig 16 Screenshot OPUS20 Device Information tab 30 Fig 17 Screenshot Search res...

Page 46: ...pment Description 10 errors 43 F Firmware update 22 First Startup 15 G Guarantee 6 44 I Incorrect Use 5 Installation 12 Internet of Things 35 J JSON API Commands 36 Requests 36 L LED 13 Login Screen 22 Lufft I BOX App Store 9 N Network Configuration 15 DHCP 16 Network name 16 Network connection 12 Network parameters 16 O OPUS Finder 32 OPUS20 App 29 Order numbers 8 P Password forgotten 24 Password...

Page 47: ...nd Regeltechnik GmbH Gutenbergstraße 20 70736 Fellbach P O Box 4252 70719 Fellbach Germany Tel 49 711 51822 0 Hotline 49 711 51822 52 Fax 49 711 51822 41 E Mail info lufft de WWW www lufft com Dokumentversion 10 2013 ...

Reviews:

No comments

Brands by name

Popular brands

Load more brands