Application example  12/2016

SIMATIC IOT2000 OPC UA

Client
SIMATIC IOT2020, SIMATIC IOT2040
 Warranty and liability

Warranty and liability

Note The Application Examples are not binding and do not claim to be complete
regarding the circuits shown, equipping and any eventuality. The Application
Examples do not represent customer-specific solutions. They are only intended
to provide support for typical applications. You are responsible for ensuring that
the described products are used correctly. These Application Examples do not
relieve you of the responsibility to use safe practices in application, installation,
operation and maintenance. When using these Application Examples, you
recognize that we cannot be made liable for any damage/claims beyond the
liability clause described. We reserve the right to make changes to these
Application Examples at any time without prior notice.
If there are any deviations between the recommendations provided in these
Application Examples and other Siemens publications – e.g. Catalogs – the
contents of the other documents have priority.

We do not accept any liability for the information contained in this document.
Any claims against us – based on whatever legal reason – resulting from the use of
the examples, information, programs, engineering and performance data etc.,
described in this Application Example shall be excluded. Such an exclusion shall
not apply in the case of mandatory liability, e.g. under the German Product Liability
Act (“Produkthaftungsgesetz”), in case of intent, gross negligence, or injury of life,
body or health, guarantee for the quality of a product, fraudulent concealment of a
 Siemens AG 2016 All rights reserved

deficiency or breach of a condition which goes to the root of the contract

(“wesentliche Vertragspflichten”). The damages for a breach of a substantial
contractual obligation are, however, limited to the foreseeable damage, typical for
the type of contract, except in the event of intent or gross negligence or injury to
life, body or health. The above provisions do not imply a change of the burden of
proof to your detriment.
Any form of duplication or distribution of these Application Examples or excerpts
hereof is prohibited without the expressed consent of the Siemens AG.

Security Siemens provides products and solutions with industrial security functions that
informa- support the secure operation of plants, systems, machines and networks.
tion In order to protect plants, systems, machines and networks against cyber
threats, it is necessary to implement – and continuously maintain – a holistic,
state-of-the-art industrial security concept. Siemens’ products and solutions only
form one element of such a concept.
Customer is responsible to prevent unauthorized access to its plants, systems,
machines and networks. Systems, machines and components should only be
connected to the enterprise network or the internet if and to the extent necessary
and with appropriate security measures (e.g. use of firewalls and network
segmentation) in place.
Additionally, Siemens’ guidance on appropriate security measures should be
taken into account. For more information about industrial security, please visit
http://www.siemens.com/industrialsecurity.
Siemens’ products and solutions undergo continuous development to make them
more secure. Siemens strongly recommends to apply product updates as soon
as available and to always use the latest product versions. Use of product
versions that are no longer supported, and failure to apply latest updates may
increase customer’s exposure to cyber threats.
To stay informed about product updates, subscribe to the Siemens Industrial
Security RSS Feed under http://www.siemens.com/industrialsecurity.

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 2
 Table of contents

Table of contents
Warranty and liability ................................................................................................... 2
1 Task ..................................................................................................................... 4
1.1 Overview............................................................................................... 4
2 Application Example – Subscribe .................................................................... 5
2.1 Install node-red OPC UA node ............................................................. 5
2.2 Start node-red ...................................................................................... 6
2.3 Open node-red Web interface .............................................................. 6
2.4 Configure node-red program ................................................................ 7
3 Application Example – Write .......................................................................... 13
3.1 Configure the node-red program ........................................................ 13
4 Checklist ........................................................................................................... 18
5 Related links ..................................................................................................... 19
6 History............................................................................................................... 19
 Siemens AG 2016 All rights reserved

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 3
 1 Task

1 Task
1.1 Overview
Introduction
This application example shows how to implement an OPC UA Client via node-red
on the IOT2000. As OPC UA Server a SIMATIC S7-1500 Software Controller V2.0
is used.

Goals
After working through this document you will know how to
 Use the node-red OPC UA Client
 Subscribing a value
 Writing a value
 Display the data on the node-red Dashboard

NOTICE Precondition!
 Siemens AG 2016 All rights reserved

To use this sample it is required that the Initial Operation in the Document
“Setting up the SIMATIC IOT2000” has been executed once.

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 4
 2 Application Example – Subscribe

2 Application Example – Subscribe

This chapter describes how an application can be created with node-red.
This application contains a node-red OPC UA Client subscribing a temperature
value from the OPC UA Server of the SIMATIC S7-1500 Software Controller and
writing a value to this server. The values are displayed on the node-red dashboard.

2.1 Install node-red OPC UA node

From version V2.1.2 of the example image the program node-red is preinstalled.
The additional node for OPC UA communication has to be installed by the user.

NOTE For installing an internet connection is required!

The following table shows how to install the additional node.

Table 2-1
No. Action
1. Open a valid Putty Connection to your IOT2000
2. Type in cd /usr/lib/node_modules to go to the node-red directory
 Siemens AG 2016 All rights reserved

3. Type in npm install node-red-contrib-opcua to install the node

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 5
 2 Application Example – Subscribe

2.2 Start node-red

The following table shows how to start node-red.

Table 2-2
No. Action
1. Type in node /usr/lib/node_modules/node-red/red & to start node-red
 Siemens AG 2016 All rights reserved

2.3 Open node-red Web interface

The following table shows how to open the Web interface of node-red.

Table 2-3
No. Action
1. Add the IP-Address of the IOT2000 and the port 1880 to a browser (i.e
http://192.168.200.1:1880)

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 6
 2 Application Example – Subscribe

2.4 Configure node-red program

Configure OPC UA Client node
Table 2-4
No. Action
1. Scroll down the left bar to “opcua”
2. Choose “OpcUa Client” and add it per Drag&Drop to the middle
3. Double-click on the node
 Siemens AG 2016 All rights reserved

4. Add a new Endpoint with IP address and port from the OPC UA Server and
click “Add”

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 7
 2 Application Example – Subscribe

No. Action
5. Choose Subscribe as Action, the required interval and give the node an
optional name. Click Done
 Siemens AG 2016 All rights reserved

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 8
 2 Application Example – Subscribe

Configure Inject node

Table 2-5
No. Action
1. Scroll the left bar to the top
2. Choose the “inject” node and add it per Drag&Drop to the middle
3. Double-click on the node
 Siemens AG 2016 All rights reserved

4. Choose String, add the NodeID of the required value to Topic and give the
node an optional name. Click Done

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 9
 2 Application Example – Subscribe

Configure Dashboard
Table 2-6
No. Action
1. Scroll the left bar to dashboard
2. Choose the “gauge” node and add it per Drag&Drop to the middle
3. Double-click on the node
4. Add a new ui_group
 Siemens AG 2016 All rights reserved

5. Add new ui_tab

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 10
 2 Application Example – Subscribe

No. Action
6. Give the ui_group a name

7. Configure the gauge

 Siemens AG 2016 All rights reserved

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 11
 2 Application Example – Subscribe

Load and start the program

Table 2-7
No. Action
1. Wire the nodes via Drag&Drop
2. Click on Deploy to download the program

3. Inject the NodeID to the OPC UA Client by clicking on the left square of the
inject node
 Siemens AG 2016 All rights reserved

4. Go to the dashboard of node-red by adding /ui to the address

5. The value is displayed in a gauge

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 12
 3 Application Example – Write

3 Application Example – Write

3.1 Configure the node-red program
In addition to the program in the last chapter add the nodes shown in the following
table.
With this program you can change the value of the variable “Mode” in the S7-1500
Software Controller with a dropdown menu in the dashboard of node-red. The
current value is displayed too.
 Siemens AG 2016 All rights reserved

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 13
 3 Application Example – Write

Table 3-1
No. Action
1. Add the following nodes and wire them:
a. Dropdown
b. OPC UA Item
c. OPC UA Client
d. OPC UA Client
e. text

2. Configure the Dropdown node. Add a new UI Group and add the options to
write
 Siemens AG 2016 All rights reserved

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 14
 3 Application Example – Write

No. Action
3. Configure the OPC UA Item. Add the NodeID of the value to write to Item
and choose its datatype

4. Configure the OPC UA Client to write. Add the IP-Address and the Port of the
OPC UA Server to Endpoint and choose Write as Action
 Siemens AG 2016 All rights reserved

5. Configure the OPC UA Client to subscribe. Add the IP-Address and the Port
of the OPC UA Server to Endpoint, choose Subscribe as Action and choose
the required Interval

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 15
 3 Application Example – Write

No. Action
6. Configure the text output-node. Choose the UI Group created in the
Dropdown node and choose a Layout
 Siemens AG 2016 All rights reserved

7. Click on Deploy to download the program to the IOT2000

8. Open a browser and go to the dashboard of node-red

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 16
 3 Application Example – Write

No. Action
9. The variable can be written to the OPC UA Server by choosing a value from
the dropdown menu
 Siemens AG 2016 All rights reserved

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 17
 4 Checklist

4 Checklist
This chapter contains a Checklist which summarizes all important steps in this
application example.

Table 4-1
No. Action
1. Install OPC UA node
2. Start node-red
3. Open node-red Web interface
4. Configure node-red program for subscribing
5. Configure node-red program for writing
 Siemens AG 2016 All rights reserved

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 18
 5 Related links

5 Related links
Table 5-1
Topic
\1\ SIMATIC IOT2000 forum
www.siemens.com/iot2000-forum
\2\ SIMATIC IOT2000 Setting Up
https://support.industry.siemens.com/tf/ww/en/posts/155642/
\3\ SIMATIC IOT2000 Getting Started
https://support.industry.siemens.com/tf/ww/en/posts/155643/

6 History
Table 6-1
Version Date Modifications
V1.0 12/2016 First version
 Siemens AG 2016 All rights reserved

V1.0 12/2016 Corrected some typing errors

SIMATIC IOT2000 OPC UA Client

Version 1.0, 12/2016 19