Lufft I-BOX User manual

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

© G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany. We reserve the right to make technical changes at any time without notice.

G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany 3
Contents
1Please read before use .....................................................................................................5
1.1 Symbols used...........................................................................................................5
1.2 Safety Instructions....................................................................................................5
1.3 Designated Use........................................................................................................5
1.4 Incorrect Use............................................................................................................5
1.5 Guarantee................................................................................................................6
1.6 Serial number...........................................................................................................6
1.7 Brand Names...........................................................................................................6
2Scope of Delivery ..............................................................................................................7
3Order numbers and Support ............................................................................................8
3.1 Accessories..............................................................................................................8
3.2 Support ....................................................................................................................8
3.3 Lufft I-BOX App-Store..............................................................................................9
4Equipment Description...................................................................................................10
4.1 Lufft I-BOX Features..............................................................................................10
4.2 Technical data........................................................................................................10
5Installation .......................................................................................................................12
5.1 Power Supply.........................................................................................................12
5.2 Network connection................................................................................................12
5.3 LEDs......................................................................................................................13
5.4 Button: Hardware-Reset.........................................................................................14
6First 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
7User Interface ..................................................................................................................20
7.1 Dashboard / Home.................................................................................................20
7.2 Login-Screen..........................................................................................................22
7.3 Firmware update....................................................................................................22
7.4 Backup...................................................................................................................23
7.5 Restore ..................................................................................................................23
7.6 Password forgotten................................................................................................24
8Expanding the Lufft I-BOX with Apps............................................................................25

4G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany
8.1 Apps...................................................................................................................... 25
8.2 App lifecycle.......................................................................................................... 26
9The App „OPUS20“......................................................................................................... 29
9.1 Operating mode..................................................................................................... 29
9.2 Features................................................................................................................ 29
9.3 Configuration......................................................................................................... 30
9.4 Logging / errors..................................................................................................... 31
10 The App „OPUS Finder“................................................................................................. 32
10.1 Operating mode..................................................................................................... 32
10.2 Features................................................................................................................ 32
10.3 Configuration......................................................................................................... 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 Maintenance................................................................................... 44
15.1 Technical Support ................................................................................................. 44
16 List of figures.................................................................................................................. 45
17 Index................................................................................................................................ 46

G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany 5
1 Please read before use
1.1 Symbols used
Important information concerning hazards to the user
Important information concerning the correct operation of the equipment
1.2 Safety Instructions
Installation and commissioning must be carried out by suitably qualified specialist personnel
only.
Never take measurements on or touch live electrical parts.
Pay attention to the technical data and storage 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 not function.
It may be permanently damaged.
Danger of injury may exist if the equipment is allowed to fall.
If the equipment is not connected correctly:
It may not function.
It may be permanently damaged.
The possibility of an electrical shock may exist.

6G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany
1.5 Guarantee
The guarantee period is 12 months from the date of delivery. The guarantee is forfeited if the
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.

G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany 7
2 Scope of 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.

8G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany
3 Order numbers and Support
Part name
Order number
Website
Lufft I-BOX
8200.00
http://www.lufft.com/en/products/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).

G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany 9
3.3 Lufft I-BOX App-Store
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).

10 G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany
4 Equipment Description
The Lufft I-BOX is a measuring instruments gateway. Using the Lufft I-BOX measuring
values can be acquired from measuring instruments, buffered, sent actively (push) or
delivered upon request (pull) in machine readable formats. The Lufft I-BOX is a flexible tool
to integrate measurement instruments in enterprise networks and systems.
4.1 Lufft I-BOX Features
The Lufft I-BOX provides these features as shipped:
Acquisition of measurement values from up to 30 devices from the Lufft OPUS20
family (unlimited channels)
Caching 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 Network (RJ45)
Screw terminals for power supply (when not connected via PoE)
LEDs / Button
Multi-color-LED for system status display
Network speed and data transfer
Manual reset of device
Power supply
Power-over-Ethernet (PoE)
24 ... 48V DC (+ / -10%) over screw terminals
Power Comsumption
60mA @ 24V
40mA @ 48V
Temperatures / Humidity
Row mounting: 0 ... 65°C
Non-row mounting Montage: 0 ... 70°C
0 ... 90% rel. Humidity, non-condensing

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

12 G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany
5 Installation
5.1 Power Supply
The Lufft I-BOX can be powered either via PoE (Power over Ethernet) or from an external
power supply.
5.1.1 PoE
The Lufft I-BOX is designed for use in PoE environments according to IEEE802.3af. Power
is brought in here over the network infrastructure through the RJ45 terminal. The Lufft I-BOX
supports both phantom power on data pairs 1/2 and 3/6 and power on the unused wire pairs
4/5 and 7/8.
To provide the supplied components with power management, the Lufft I-BOX identifies itself
as a device in Power Class 2 (power consumption from 3.84W to 6.49W).
5.1.2 External power supply
Alternative to PoE the Lufft I-BOX can also be powered externally using the plug-in screw
terminal on the underside of the housing. The DC voltage must be in a range of
24 ... 48V DC (+/-10%)
When applying the power please note the correct polarity. The 2-pin 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 start of the system.
The capacitors are charged while operating the box.
5.2 Network connection
The Lufft I-BOX includes an IEEE 802.3 compatible network terminal. The physical
connection is made using TP copper cable.
5.2.1 10/100BaseT on RJ45
The 10/100BaseT network interface uses a shielded RJ45 connector. The pin configuration
and function corresponds to an Auto-MDI(X) interface. Connection to a hub, switch or other
network device is made using a maxim 100m long shielded patch cable.
Because the send and receive lines on connected devices are automatically detected, use of
any (straight and crossed) network cable is possible.
The network connection is galvanically isolated from the supply voltage for at least 500V.

G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany 13
The Lufft I-BOX uses autonegotiation. To prevent communication problems, caused for
example by a duplex mismatch, we recommend operating the port on the switch or hub in
this mode as well. Here both the transmission speed and the duplex procedure is
automatically negotiated and correspondingly set in the devices.
Managable switches often have special protocols (spanning tree protocol, port trunking, ...)
as needed for example for uplinks to other switches or broadband connection of servers.
These protocols are not generally needed for connecting normal terminal devices like the
Lufft I-BOX, and they may significantly slow down the opening of a connection after a restart.
We recommend disabling these protocols and functions on the port used for the Lufft I-BOX.
Please consult your responsible network administrator.
5.3 LEDs
Optical indication of the network status is provided 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 yellow LED indicates the current data rate:
Off: 10MBit
On: 100MBit
5.3.2 Multi-color indicator
The multi-color indicator on the front of the Lufft I-BOX is used to represent the current
system status:
Green: Normal state of the Lufft I-BOX. All services are started and the system is
fully ready. An underlaid cyclical flashing indicates the system load. The faster this
flashes, the greater the process load.
Blue: Booting. All services are being booted up. At this time no connections to the
Lufft I-BOX can be opened. When bootup is finished the LED changes shortly to red.
.Blue flashing: Network traffic to or from the Lufft I-BOX.
Red flashing (approx. 1Hz): No link
Red, solid on: Serious system error. The system can no longer be properly started.

14 G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany
5.4 Button: Hardware-Reset
The mechanical button inegrated into the multi-color display can be used 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.

G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany 15
6 First Startup
When power supply is connected and on first startup, the Lufft I-BOX comes up with IP-
Address 190.107.233.110. After the boot process is finished some system settings have to
be adjusted to make the Lufft I-BOX productive.
The Setup Assistent guides through the most important system settings.
6.1 Setup-Assistant
During first system startup and successful logon the Setup Assistant 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 demand.
6.2 Network-Configuration
After the Lufft I-BOX is powered on, it must be provided with valid TCP/IP-Settings. Contact
your network administrator for valid TCP/IP-settings.
The Lufft I-BOX initially comes up with the IP address 190.107.233.110.

16 G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany
In order to modify the network settings, the Lufft I-BOX and the PC have to be part of the
same physical network. A direct link using a patch cable from Lufft I-BOX to the PC is also
possible.
6.2.1 Managing network parameters
The Lufft I-BOX distinguishes between two modes with respect to its network-side basic
parameters:
Static.
DHCP
As shipped static address assignment is enabled.
Switching between DHCP and static TCP/IP-Settings can be done in Settings->Network
6.2.1.1 Static
The IP address, subnet mask and gateway are stored in the non-volatile 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 an IP address is rejected, the Lufft I-BOX operates using
the factory default IP address 190.107.233.110. When switching from Static to DHCP mode,
this default IP address is defaulted to until valid parameters are assigned.
6.2.2 Network name
To support an automatic update of the DNS system through the DHCP server, the Lufft I-
BOX identifies with a network name. The network name is set to “lufft-i-box”.

G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany 17
6.3 Common 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.

18 G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany
6.4 Administrator Settings
The Administrator hast to manage frictionless production of the Lufft I-BOX. He gets Emails
on critical log events.
Fig. 6: Screenshot Administrator Settings
Email address: To this email, 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 saving. The
password requires at least 5 and maximum 20 characters.

G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany 19
6.5 Email-Settings
Emails are sent upon several events:
Critical log entries
Daily status report to the administrator (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.

20 G. Lufft Mess- und Regeltechnik GmbH, Fellbach, Germany
7 User Interface
7.1 Dashboard / Home
The Dashboard is shown after successful login. Pressing the button “Home” (the little house
icon) it can be reached throughout the Lufft I-BOX user interface.
Fig. 8: Screenshot Dashboard / Home
The settings displayed in the dashboard are:
Administrator Contact details of 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
Installed apps Number of Apps installed in the Lufft I-BOX
Devices Number of devices generated from Apps
Active channels Number of channels configured and measured