Application example 12/2016

SIMATIC IOT2000 S7-

Communication
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 customers 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 S7 communication

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 ......................................................................................... 5
2.1 Preconditions for S7 communication .................................................... 5
2.2 Install node-red S7 node ...................................................................... 6
2.3 Start node-red ...................................................................................... 7
2.4 Open node-red Web interface .............................................................. 7
2.5 Configure node-red program ................................................................ 8
3 Checklist ........................................................................................................... 11
4 Related links ..................................................................................................... 12
5 History............................................................................................................... 12
Siemens AG 2016 All rights reserved

SIMATIC IOT2000 S7 communication

Version 1.0, 12/2016 3
 1 Task

1 Task
1.1 Overview
Introduction
This application example shows how to read out a variable from a Siemens S7-
1500 PLC via S7 communication. As PLC 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 node for S7 communication
read a value
Store the data in a file on the IOT2000

NOTICE Precondition!
To use this sample it is required that the Initial Operation in the Document
Setting up the SIMATIC IOT2000 has been executed once.
Siemens AG 2016 All rights reserved

SIMATIC IOT2000 S7 communication

Version 1.0, 12/2016 4
 2 Application Example

2 Application Example
This chapter describes how an application can be created with node-red.
This application contains a node-red S7 communication node reading two values
from a data block of the SIMATIC S7-1500 Software Controller. The values are
saved in a file on the IOT2000.

2.1 Preconditions for S7 communication

These are preconditions regarding settings which have to be done in TIA-Portal.
Table 2-1
No. Action
1. You can only use non-optimized data blocks. This feature can be set in the
properties of the data block. Make sure the box is unchecked.
Siemens AG 2016 All rights reserved

2. You have to enable PUT/GET communication in the device configuration of

the S7-1500 PLC. Make sure the box is checked

NOTE Doing No. 2 opens up the controller for other access by other applications as
well, so be aware of the security implications of doing this.

SIMATIC IOT2000 S7 communication

Version 1.0, 12/2016 5
 2 Application Example

2.2 Install node-red S7 node

From version V2.1.2 of the example image the program node-red is preinstalled.
The additional node for S7 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-2
No. Action
3. Open a valid Putty Connection to your IOT2000
4. Type in cd /usr/lib/node_modules to go to the node-red directory
5. Type in npm install node-red-contrib-s7 to install the node
Siemens AG 2016 All rights reserved

SIMATIC IOT2000 S7 communication

Version 1.0, 12/2016 6
 2 Application Example

2.3 Start node-red

The following table shows how to start node-red.

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

2.4 Open node-red Web interface

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

Table 2-4
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 S7 communication

Version 1.0, 12/2016 7
 2 Application Example

2.5 Configure node-red program

Configure S7 node
Table 2-5
No. Action
1. Choose s7 in on the left hand side and add it per Drag&Drop to the middle
2. Double-click on the node

3. Add a new Endpoint with IP address, Port, Rack- and Slot number of the
S7-PLC and a reading cycle time.
Siemens AG 2016 All rights reserved

You can find this information in the Device Configuration of the S7-PLC in
the TIA-Portal.

4. Click on the tab Variables

SIMATIC IOT2000 S7 communication

Version 1.0, 12/2016 8
 2 Application Example

No. Action
5. Add the variables you want to read out and give them a name.
The address is DB,DatatypeOffset. You can get this information from the
TIA Portal.
Siemens AG 2016 All rights reserved

Click Add
6. Choose a Mode and give the node an optional name
Click Done

7. Scroll the left bar to storage and choose the output node file add it per
Drag&Drop to the middle
8. Double-click on the node

SIMATIC IOT2000 S7 communication

Version 1.0, 12/2016 9
 2 Application Example

No. Action
9. Configure Filename, Action and an optional name
Click Done

10. Wire the nodes and click on deploy

Siemens AG 2016 All rights reserved

11. Every time a value changes, both values will be appended to the file on the
IOT2000

SIMATIC IOT2000 S7 communication

Version 1.0, 12/2016 10
 3 Checklist

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

Table 3-1
No. Action
1. Make sure preconditions in TIA Portal are given
2. Install S7 node
3. Start node-red
4. Open node-red Web interface
5. Configure S7 node and deploy
6. Check file on IOT2000
Siemens AG 2016 All rights reserved

SIMATIC IOT2000 S7 communication

Version 1.0, 12/2016 11
 4 Related links

4 Related links
Table 4-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/
\4\ Description of the nodeS7
https://github.com/plcpeople/nodeS7

5 History
Table 5-1
Siemens AG 2016 All rights reserved

Version Date Modifications

V1.0 12/2016 First version

SIMATIC IOT2000 S7 communication

Version 1.0, 12/2016 12