WAGO Applikation IoT-Box User manual

Manual

WAGO Application IoT Box

2854-0099/0000-0001

2854-0099/0000-0003

Version 2.1.0

Up to software version 2.0.0

Application IoT Box 2/122

Handbuch

Version 2.1.0

Legal Information

WAGO Kontakttechnik GmbH & Co. KG

Hansastraße 27

D-32423 Minden

Phone +49 (0) 571 8 87 - 0

Fax +49 (0) 571 8 87 - 1 69

Email [email protected]

Web http://www.wago.com

Technical Support

Phone +49 (0) 571 8 87 - 44 5 55

Email [email protected]

Every conceivable measure has been taken to ensure the accuracy and completeness of this

documentation. However, as errors can never be fully excluded, we always appreciate any

information or suggestions for improving the documentation.

We wish to point out that the software and hardware names, as well as the trademarks of companies

used and/or mentioned in the present document, are generally protected by trademark or patent.

WAGO is a registered trademark of WAGO Verwaltungsgesellschaft mbH.

Application IoT Box 3/122

Handbuch

Version 2.1.0

Content

1. Information about This Documentation .........................................................................................5

1.1. Copyright ..............................................................................................................................5

1.2. Protected Rights ..................................................................................................................5

1.3. Number Notation ..................................................................................................................6

1.4. Font Conventions .................................................................................................................6

1.5. Symbols ...............................................................................................................................6

2. Legal Principles .............................................................................................................................8

Subject to Change ......................................................................................................................9

Personnel Qualification ...............................................................................................................9

Limitation of Liability ...................................................................................................................9

3. Function Description ....................................................................................................................10

3.1. Commissioning Overview ..................................................................................................11

3.2. Supported Browser ............................................................................................................12

3.3. System Limits ....................................................................................................................13

4. Installation ....................................................................................................................................14

4.1. Transfer Licenses ..............................................................................................................14

4.2. Changing Passwords .........................................................................................................16

4.3. Setting the Date and Time ................................................................................................18

4.3.1. Synchronisation via NTP Server ..............................................................................19

5. Application IoT Box .....................................................................................................................20

5.1. File .....................................................................................................................................22

5.1.1. File Management ......................................................................................................24

5.1.2. Project Settings ........................................................................................................26

5.1.3. Cloud Connectivity ...................................................................................................29

5.1.3.1. MQTT Frame Settings ....................................................................................32

5.1.4. Modbus Server Settings ...........................................................................................33

5.1.5. OPC UA Settings .....................................................................................................35

5.1.6. IO Module Configuration ..........................................................................................36

5.1.7. License Status ..........................................................................................................37

5.1.8. Information ................................................................................................................39

5.2. Inputs .................................................................................................................................40

5.2.1. Process Summary ....................................................................................................41

5.2.2. Digital Inputs .............................................................................................................43

5.2.2.1. Settings - Digital Input ....................................................................................45

5.2.2.2. QOS ................................................................................................................48

5.2.3. Analog Inputs ...........................................................................................................49

5.2.3.1. Settings - Analog Input ...................................................................................51

5.2.3.1.1. Calculate Gain and Offset .....................................................................53

5.2.4. Energy Measurement Modules ................................................................................54

5.2.4.1. 750-494 ...........................................................................................................55

5.2.4.1.1. Settings - Power Measurement I/O-Module ..........................................57

5.2.4.1.2. Faults .....................................................................................................59

5.2.4.1.2.1. Settings - Power Measurement I/O-Module Fault ........................60

5.2.4.2. 750-495 ...........................................................................................................62

5.2.4.2.1. Settings - Power Measurement I/O-Module ..........................................64

5.2.4.2.2. Faults .....................................................................................................66

5.2.4.2.2.1. Settings - Power Measurement I/O-Module Fault ........................67

5.3. Logger ................................................................................................................................69

5.3.1. Selective Logger .......................................................................................................70

5.3.1.1. Settings - Selective Logger ............................................................................72

5.3.2. Full Logger ...............................................................................................................74

5.3.2.1. Settings - Full Logger .....................................................................................76

Application IoT Box 4/122

Handbuch

Version 2.1.0

5.3.2.1.1. Header Change Full-Logger ..................................................................78

5.4. Alarms ................................................................................................................................79

5.4.1. Settings - Alarm .......................................................................................................81

5.5. Outputs ...............................................................................................................................84

5.5.1. Process Summary ....................................................................................................84

5.5.2. Digital Outputs ..........................................................................................................86

5.5.2.1. Settings - Digital Output .................................................................................88

5.5.3. Cloud Outputs ..........................................................................................................90

5.5.3.1. Settings - Cloud Output ..................................................................................92

5.6. Virtual Objects ....................................................................................................................94

5.6.1. Process Summary ....................................................................................................94

5.6.2. Mathematical Objects ...............................................................................................96

5.6.2.1. Settings - Mathematical Objects .....................................................................98

5.6.2.1.1. Value Selection ....................................................................................100

5.6.2.1.2. Formula Help .......................................................................................101

5.6.2.2. Calculation Steps ..........................................................................................102

5.6.2.3. Mathematical Constants ...............................................................................103

5.6.3. Energy Objects .......................................................................................................104

5.6.3.1. Settings - Energy Objects .............................................................................106

5.6.4. Modem Objects ......................................................................................................109

5.6.4.1. Settings - Modem Objects ............................................................................111

5.6.5. Controller Objects ...................................................................................................113

5.6.5.1. Settings - Controller Objects ........................................................................115

5.6.6. Accumulator Objects ..............................................................................................118

5.6.6.1. Settings - Accumulator Objects ....................................................................120

Application IoT Box 5/122

Handbuch

Version 2.1.0

1. Information about This Documentation

1.1. Copyright

This documentation, including all figures and illustrations contained therein, is subject to copyright

protection. Any use of this documentation that infringes upon the copyright provisions stipulated

herein is prohibited. Reproduction, translation, electronic and phototechnical filing/archiving (e.g.,

photocopying) and changes require the written consent of WAGO Kontakttechnik GmbH & Co. KG,

Minden, Germany. Non-observance will entail the right of claims for damages.

1.2. Protected Rights

Trademarks of third-party companies are used in this documentation. This section contains the

trademark definitions. The “®” and

“TM” trademark symbols are omitted hereinafter.

• BACnet®: registered trademark of the American Society of Heating, Refrigerating and Air

Conditioning Engineers, Inc. (ASHRAE).

• Bluetooth®: registered trademark of Bluetooth SIG.

• Inc. CiA® and CANopen®: registered trademarks of CAN in AUTOMATION – International

Users and Manufacturers Group e.V.

• DALI: registered trademarks of the Digital Illumination Interface Alliance (DiiA).

• EtherCAT®: registered trademark and patented technology of Beckhoff Automation GmbH.

• EtherNet/IP™: registered trademark of Open DeviceNet Vendor Association, Inc. (ODVA)

• EnOcean®: registered trademark of EnOcean GmbH.

• IO-Link: registered trademark of PROFIBUS Nutzerorganisation e.V.

• KNX®: registered trademark of KNX Association cvba.

• Linux®: registered trademark of Linus Torvalds.

• LON®: registered trademark of the Echelon Corporation.

• Modbus®: registered trademark of Schneider Electric, licensed for the Modbus Organization,

Inc.

• PROFIBUS®: registered trademark of Siemens AG.

• PROFINET®: registered trademark of Siemens AG.

• Subversion®: registered trademark of the Apache Software Foundation.

• Windows®: registered trademark of the Microsoft Corporation

Application IoT Box 6/122

Handbuch

Version 2.1.0

1.3. Number Notation

Number

System

Example Comment

Decimal 100 Normal notation

Hexadecimal 0x64 C notation

Binary '100'

'0110.0100'

In single quotation marks,

nibble separated by a period

1.4. Font Conventions

Font Type Explanation

monospaced Names of paths and files are displayed in a font type with uniform character width.

Example: notepad.exe

Menu Menu options are displayed in bold, e.g.: Save

> A “greater than” symbol between two names denotes the selection of a menu

option. Example: File > New

Input Names of input fields or drop-down lists are shown in bold. Example: Value

„Value“ Input or selection values are displayed in quotation marks. Example: Enter the

value “4 mA” under Start of measurement range.

[Button] Buttons are shown in bold in square brackets. Example: [OK]

[Key] Key labels on the keyboard are shown in bold and enclosed in square brackets.

Example: [F1]

Application IoT Box 7/122

Handbuch

Version 2.1.0

1.5. Symbols

Personal injury!

Indicates a high-risk, imminently hazardous situation which, if not avoided, can result in

death or serious injury.

Personal Injury Caused by Electric Current!

Indicates a high-risk, imminently hazardous situation which, if not avoided, can result

in death or serious injury.

Personal injury!

Indicates a moderate-risk, potentially hazardous situation which, if not avoided, could

result in death or serious injury.

Personal injury!

Indicates a low-risk, potentially hazardous situation which, if not avoided, may result in minor

or moderate injury.

Damage to property!

Indicates a potentially hazardous situation which, if not avoided, may result in damage to

property.

Damage to property caused by electrostatic discharge (ESD)!

Indicates a potentially hazardous situation which, if not avoided, may result in

damage to property.

Important note!

Indicates a potential malfunction which will not result in damage to property, however,

if not avoided.

Additional Information!

Refers to additional information which is not an integral part of this documentation

(e.g., the Internet).

Application IoT Box 8/122

Handbuch

Version 2.1.0

Application IoT Box 9/122

Handbuch

Version 2.1.0

2. Legal Principles

Subject to Change

WAGO Kontakttechnik GmbH & Co. KG reserves the right to make any alterations or modifications

that serve to increase the efficiency of technical progress. WAGO Kontakttechnik GmbH & Co. KG

owns all rights arising from the granting of patents or from the legal protection of utility patents. Third-

party products are always mentioned without any reference to patent rights. Thus, the existence of

such rights cannot be excluded.

Personnel Qualification

The use of the product described in this document is exclusively geared to specialists having

qualifications in PLC programming, electrical specialists or persons instructed by electrical specialists

who are also familiar with the appropriate current standards.

Moreover, the persons cited here must also be familiar with all of the products cited in this document,

along with the operating instructions. They must also be capable of correctly predicting any hazards

which may not arise until the products are combined.

WAGO Kontakttechnik GmbH & Co. KG assumes no liability resulting from improper action and

damage to WAGO products and third-party products due to non-observance of the information

contained in this document.

Limitation of Liability

This documentation describes the use of various hardware and software components in specific

example applications. The components may represent products or parts of products from different

manufacturers. The respective operating instructions from the manufacturers apply exclusively with

regard to intended and safe use of the products. The manufacturers of the respective products are

solely responsible for the contents of these instructions.

The sample applications described in this documentation represent concepts, that is, technically

feasible applications. Whether these concepts can actually be implemented depends on various

guidelines. For example, different versions of the hardware or software components can

require different handling than that described here. Therefore, the descriptions contained in this

documentation do not form the basis for assertion of a certain product characteristic.

Responsibility for safe use of a specific software or hardware configuration lies with the party that

produces or operates the configuration. This also applies when one of the concepts described in this

document was used for implementation of the configuration.

WAGO Kontakttechnik GmbH & Co. KG assumes no liability for the realization of these concepts.

Application IoT Box 10/122

Handbuch

Version 2.1.0

3. Function Description

The Application IoT Box can be used to capture and save energy and operating data and display

its progression over time. The data is made available for further processing steps. The integrated

user interface can be used to parameterize the signals of connected sensors. No programming

experience is required to use the Application IoT Box.

The captured signals (actual values) are saved to the controller’s SD card, preferably in a SQLite

database, optionally as a *.csv file. Furthermore, the captured data can be visualized with the

help of the data plotter. In this connection, see application note “Data Plotter 2019-06-26” on the

visualization tool, which is available for download at www.wago.com.

The Application IoT Box processes process data from digital and analog interfaces arising in the

following domains:

• Electrical energy

• Heat quantity

• Water quantity

• Gas quantity

• Volume flow

• Temperature

• Humidity

For the respective measurements, the sensors to be used must be connected to the

subassemblies from the WAGO-I/O-SYSTEM 750 corresponding to the signal type.

Application IoT Box 11/122

Handbuch

Version 2.1.0

3.1. Commissioning Overview

Application IoT Box 12/122

Handbuch

Version 2.1.0

3.2. Supported Browser

The following browsers have been successfully tested with the Application IoT Box:

•

Google Chrome Version 80.0

•

Mozilla Firefox Version 73.0

•

Microsoft Edge Version 80.0

Web visualization!

Only one browser (client) can access the Application IoT Box at a time.

Simultaneous display in a desktop browser and a display device is not possible.

Other browsers!

Use of other browsers is possible, but functional limitations cannot be ruled out.

Application IoT Box 13/122

Handbuch

Version 2.1.0

3.3. System Limits

Connections/Objects Number (Max.) Number of Data Points (Max.)

Digital and analog inputs 40

Alarms 10

Digital outputs / cloud

connection

25

Virtual objects 5

Log files 5

Application IoT Box 14/122

Handbuch

Version 2.1.0

4. Installation

4.1. Transfer Licenses

This chapter is only relevant if you use the "Multicloud Connectivity"!

Note the Tutorials on YouTube

You can find the tutorial “WAGOupload - License Manager” on YouTube. This

video shows how to use the “WAGOupload” software to record licenses and how

to load them onto one or more devices.

1.

Launch the WAGOupload software.

2.

Click the menu item “Synchronize Licenses” menu item to define the devices to which the

licenses are to be transferred.

In this step, the licenses are identified that already exist in the devices. Depending on the

configuration of the devices, a password must be entered beforehand.

3. Enter the IP addresses of your controllers in the dialog or start the search function. The

identified devices are listed.

4. Select a controller and follow the prompt.

5. In the dialog below, select which of the available licenses should be loaded onto the previously

loaded devices by selecting the value “1” in the "Licenses to be Transferred" selection field.

Application IoT Box 15/122

Handbuch

Version 2.1.0

After transferring the licenses, a summary of the process is stored in the log directory in the form

of a proof of use for the licenses. Detailed information on using WAGOupload can be found in the

software manual, which is also available for download.

Application IoT Box 16/122

Handbuch

Version 2.1.0

4.2. Changing Passwords

Retrieval Address for WBM

1.

Open a Web browser in order to open WBM.

2.

Enter the controller’s IP address in the address line: “https://<controller IP>/

wbm” (here: https://192.168.1.17/wbm).

3.

Bypass the security warning by continuing to load the website.

Login/Logout

1.

In the “Login” dialog, log in with username “admin,” password “wago.”

2.

Confirm your entry with the [Submit] button.

The corresponding HTML page loads. If you have not yet changed the password, the

following message will appear: “Security message: please change your password!”

Application IoT Box 17/122

Handbuch

Version 2.1.0

User

(Username)

Rights Default Password

admin All

(Administrator)

wago

user Limited user

guest Display only

Change passwords

The pre-set default passwords (see table above) do not offer adequate

protection! Change the passwords to meet your particular needs! If you

do not change these passwords, a warning will appear each time you

open a website after logging in.

Application IoT Box 18/122

Handbuch

Version 2.1.0

4.3. Setting the Date and Time

The date and time can be set in the Web-Based Management system of the application controller

on the Clock tab in the navigation bar. These settings are described in detail in the controller

manual.

We recommend synchronizing the time at regular intervals, as the system clock tends to drift. The

Application IoT Box offers two options for this:

1.

Synchronization of the system clock via an NTP server.

2.

Synchronization of the system clock using the GPS signal.

Application IoT Box 19/122

Handbuch

Version 2.1.0

4.3.1. Synchronisation via NTP Server

NTP clients can be set in the Web-Based Management system of the controller under menu item

Ports and Services > NTC Client. These settings are described in detail in the controller manual.

Application IoT Box 20/122

Handbuch

Version 2.1.0

5. Application IoT Box

The Application IoT Box can be opened in a Web browser at the following link: “https://<controller

IP>/webvisu/webvisu.htm” (here: https://192.168.1.17/webvisu/ webvisu.htm).

Login

1.

Click the [Login] button. The “Login” dialog opens.

1.

Log in using your username and password.

2.

Confirm your entry by clicking [OK].

3.

After a successful login, the main window opens.

If the user name or password are incorrect, the dialog stays open.

The preset username is “admin” and preset password is “wago.” You can create and modify

user groups in the "User Administration".

If modules are added, removed or moved after the initial configuration, a warning message

appears after login:

Page is loading ...

WAGO Applikation IoT-Box User manual

WAGO Applikation IoT-Box User manual

Related papers

Other documents