Professional Documents
Culture Documents
SIMOCODE Pro V PN-Info Dashboard With Node-RED ENGLISH
SIMOCODE Pro V PN-Info Dashboard With Node-RED ENGLISH
SIMOCODE pro V PN
Node-RED
Dashboard
https://support.industry.siemens.com/cs/ww/de/view/109816582
Siemens
Industry
Online
Support
Legal Notice
Legal Notice
Use of application examples
In the application examples, the solution for various automation tasks using multiple interacting
components is explained in text, graphics and/or software modules. The application examples are
a free-of-charge service of Siemens AG and/or a subsidiary of Siemens AG ("Siemens"). They are
not binding and do not purport to be complete and functional in respect of the configuration and
equipment. Further, this application examples are not specific customer solutions, but are only
intended to provide support for typical applications. You are yourself responsible for proper and
safe operation of the products under the valid regulations and, to achieve this, you must check the
function of the application example and adapt it individually to your system.
You will receive from Siemens the non-exclusive, non-sublicensable and non-transferable right to
use of the application examples by technically trained personnel. Any change made to the
application examples is made on your own responsibility. Transmission to third parties or
reproduction of the application examples or excerpts thereof is only permitted in combination with
your own products. The application examples are not necessarily subjected to the usual tests and
quality checks of a charged-for product and can have functional and performance defects and
contain errors. You are obligated to use them in such a way that any malfunctions do not result in
damage to property or injury to persons.
Disclaimer of liability
Siemens excludes its liability for any legal reasons whatsoever, in particular for the usability,
availability, completeness and freedom from defects of the application examples, and the
associated notes, configuration and performance data and damage caused by these. This does not
apply if Siemens is necessarily liable, for example, under product liability legislation, in cases of
malice, gross negligence, due to negligently caused personal injury, death or impaired health,
failure to comply with the warranty given, due to willful concealment of a defect or due to culpable
breach of material contractual obligations. The claim for damages based on breach of material
contractual obligations shall, however, be limited to foreseeable damages typically covered by a
Siemens AG 2022 All rights reserved
contract unless liability is due to malice or gross negligence or due to personal injury, death or
impaired health. The provisions stated above do not imply a change in the burden of proof to your
detriment. You exempt Siemens from claims of third parties that exist or are made in relation to this,
unless Siemens is necessarily liable by law.
By using these application examples, you agree that Siemens cannot be held liable for possible
damage beyond the liability clause described.
Further information
Siemens reserves the right to make changes to the application examples at any time without prior
announcement. Where the recommendations in the application examples differ from other Siemens
publications, e.g. Catalogs, the contents of the other documentation take precedence. The Siemens
conditions of use apply in addition (https://support.industry.siemens.com).
Security information
Siemens provides products and solutions with industrial security functions that support the secure
operation of plants, systems, machines and networks.
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 constitute one element of such a concept. Customers are
responsible for preventing unauthorized access to their plants, systems, machines, and networks.
Such systems, machines and components should only be connected to an enterprise network or
the Internet if and to the extent such a connection is necessary and only when appropriate security
measures (e.g. firewalls and/or network segmentation) are in place. For additional information on
industrial security measures that may be implemented, please visit:
https://www.siemens.com/industrialsecurity.
Siemens’ products and solutions undergo continuous development to make them more secure.
Siemens strongly recommends that product updates are applied as soon as they are available and
that the latest product versions are used. Use of versions that are no longer supported, and failure
to apply the latest updates may increase your exposure to cyber threats. To stay informed about
product updates, subscribe to the Siemens Industrial Security RSS Feed under:
https://www.siemens.com/industrialsecurity.
Table of contents
Legal Notice.............................................................................................................. 2
1 Introduction and task definition..................................................................... 4
1.1 Introduction ....................................................................................... 4
1.2 Task description ................................................................................ 4
1.3 Components used ............................................................................. 5
2 Engineering .................................................................................................... 7
2.1 Hardware configuration ...................................................................... 7
2.2 Setting up Windows PC for Node-RED .............................................. 8
2.3 Preparing SIMOCODE with the SIMOCODE ES TIA Portal V17 ....... 12
2.4 Installing Node-RED node packages ................................................ 17
2.5 Import Node-RED application example ............................................ 21
2.6 SIMOCODE application in detail ...................................................... 24
2.6.1 Tab „SIMOCODE Control“ ............................................................... 24
2.6.2 Tab „SIMOCODE ON OFF“ ............................................................. 28
2.6.3 Tab „SIMOCODE Status“................................................................. 30
2.6.4 Tab „SIMOCODE Measured value“ .................................................. 33
2.6.5 SIMOCODE Dashboard ................................................................... 34
Siemens AG 2022 All rights reserved
From the amount of available data, it is often the task of an edge or cloud solution to
bundle the required data as needed and to display them at a glance. In most cases,
this data is displayed graphically in the form of a dashboard. For example, the user
can recognize key figures and performance indicators and derive process-related
measures. The following application example is intended to show how a connection
can be made using Node-RED and how a graphical display of relevant SIMOCODE
data can take place.
Node-RED makes it possible to implement tasks from the most diverse areas of
digitization for the "Internet of Things" in a simple, graphical way and according to
the modular principle. Ready-defined nodes ("nodes") are connected and
parameterized in a suitable manner. A large number of the nodes are provided free
of charge by developers worldwide on the basis of the open-source principle.
Node-RED can be used on many different platforms and system environments. For
example, a local installation on a PC system under Linux or Windows is conceivable.
However, implementations on platforms such as Raspberry PI (private applications)
or SIMATIC IOT2050 (industrial applications) have proven their worth, not least due
to the requirement of 24/7 operation of digital applications.
Please also note the device-specific operating instructions (Manual Collection) and
the system manual SIMOCODE pro motor management
https://support.industry.siemens.com/cs/de/de/view/109743957
The installation of the engineering tool SIMOCODE ES TIA Portal V17 is required.
This application example was created with the following software components:
Documentation 109816582_SIMOCODE -
pro V PN – Info dashboard
with Node-RED.pdf
SIMOCODE ES TIA Portal 109816582_SIMOCODE Project data TIA V17
V17 pro V PN – Info Dashboard
with Node-RED.zap17
Node-RED 109816582_SIMOCODE Contains all flows for Node-
pro V PN – Info Dashboard RED SIMOCODE
with Node-RED.json application
2 Engineering
2.1 Hardware configuration
Figure 1 - Hardware-Setup
PC z.B. SIMATIC Field-PG
Node-RED SIMATIC
Dashboard IOT 2050
400V AC
Option
Optioninstead
of a PCPC
anstelle
OPC UA
SIMOCODE
pro V PN
E-stop
Not-Halt
DM-F Local
(Optional)
This PowerShell application must remain open while Node-Red is being used.
After installing Node-RED, only the node-red node package is preinstalled. Add the
following node packages as shown:
Figure 17 – Call ‘manage palette’ for node installation via the install-tab
In the "OPC UA Client" node, the user has to make the adjustment to the
SIMOCODE IP address. The following figures show the procedure.
The inject node "Set ON" passes on the OPC UA data for switching on the
SIMOCODE to the node "OPC UA Client" via the payload and/or topic property.
The specification of the switch-on is done via the payload property by means of
"TRUE". The topic property contains the namespace "ns", the node ID "i" and the
data type "datatype".
Namespace, node ID and data type can be found in the function manual
"SIMOCODE pro motor management - Communication Manual". SIMOCODE can
be switched on using the buttons in Figure 36. The power-on command must then
be reset.
In this flow, the SIMOCODE is switched off in the same way as switching it on.
Hint: SIMOCODE can only be controlled via OPC UA if the OPC UA IDs in the
SIMOCODE ES V17 software are connected to the control station (or another
function).
The "SIMOCODE ON OFF" flow is part of the dashboard and forms with the nodes
"ON" and "OFF" one button each for switching the SIMOCODE on and off. These
nodes are taken from the previously installed node palette "node-red-contrib-
dashboard". The parameters of the nodes are made in the Properties window.
Figure 36 – Switching SIMOCODE on/off via ON/OFF button for the dashboard
Siemens AG 2022 All rights reserved
Resetting the switch-on or the switch-off command is time-delayed via the "delay"
node.
If the SIMOCODE is switched off in the event of overload, an
automatic reset is performed after receipt of the “overload" status.
In this flow, the queries of selected binary status information of the SIMOCODE
and their visualization on the "LED" displays in the dashboard are performed. The
query is performed via an array of node IDs so that the OPC UA client does not
have to establish a connection to the OPC UA server of SIMOCODE multiple
times. A data-efficient query can be created using the "READ MULTIPLE"
command and the transfer of an array field with namespace, node ID and data
type. The "switch" node assigns the data received from the OPC UA client to the
desired "LED" displays of the dashboard.
Selected SIMOCODE measured values are read out in this node. These are also
requested via an array transfer with the action "READ MULTIPLE" from the OPC
UA client to the OPC UA server of the SIMOCODE. The values are then ranked on
the "gauge" node and the "chart" node for the dashboard. The number of starts, the
maximum current in %, the active power in W and the voltage in V are displayed.
In addition to the display, the values "Maximum current in %" and "Active power in
W" are written to a file as a numerical value every second. The files are stored in
the root directory under \tmp\current.log and \tmp\power.log.
The SIMOCODE Dashboard can be accessed directly from Node-RED or via the
web address. The dashboard is designed in such a way that it has been adapted to
the format of a smartphone. It consists of the sections Operation, Status, Display
and Chart.
Alternatively, the dashboard can be accessed directly via the following link:
http://127.0.0.1:1880/ui/
3 Worth knowing
The property "OPC UA Server" for SIMOCODE pro V PN is assigned via the
parameters of the SIMOCODE. After calling the PROFINET parameters and
assigning a valid IP address, the property "OPC UA Server activated" has to be
checked in the "OPC UA Server/Web Server" section. Any change to the "Activate
OPC UA Server" parameter requires a restart of the communication interface. By
restarting the communication interface, all Ethernet and PROFINET connections
are interrupted and re-established.
SIMOCODE pro V PN supports the following safety functions for OPC UA:
In productive operation it’s recommenced to use the following settings for secure
communication between client and server:
4 Appendix
4.1 Service and Support
Industry Online Support
Do you have questions or need support?
Industry Online Support provides you with around-the-clock access to the entire
service and support know-how and our services.
Industry Online Support is the central address for information on our products,
solutions and services.
Product information, manuals, downloads, FAQs and application examples – all
information is accessible with a few mouse clicks:support.industry.siemens.com
Technical Support
The technical support from Siemens Industry supports you fast and competently
with all technical requests with numerous tailored offerings
– from basic support to individual support contracts.
You can make inquiries to Technical Support in the web form:
siemens.com/SupportRequest
With our training courses available worldwide for our products and solutions, we
support you with practical, innovative learning methods and with a coordinated
customer-specific concept.
You can find out more about the training and courses on offer and our sites and
dates at:
siemens.de/sitrain
Service offerings
Our service offerings include the following:
Plant data Services
Spare parts services
Repair services
Field and maintenance services
Retrofit and modernization services
Service programs and contracts
You will find detailed information about our service offerings in the service catalog:
support.industry.siemens.com/cs/sc
The Siemens Industry Mall is the platform on which the entire product portfolio of
Siemens Industry is accessible. From selection of the products through ordering and
delivery tracking, the Industry Mall enables complete procurement processing –
directly and independently of time and place:
mall.industry.siemens.com
Nr. Thema
Siemens AG 2022 All rights reserved
4.5 Tables
Table 1-1 – Hardware components............................................................................................5
Table 1-2 – Software components .............................................................................................6
Table 1-3 – Files of the application example ..............................................................................6
Table 3-1 – OPC UA security modes ....................................................................................... 40
Table 4-1 - Literature............................................................................................................... 42
Table 4-2 – Change history ..................................................................................................... 42
4.6 Figures
Figure 1 - Hardware-Setup ........................................................................................................7
Figure 2 – Download node.js .....................................................................................................8
Figure 3 – Node.js Setup...........................................................................................................8
Figure 4 – Check Installation .....................................................................................................9
Figure 5 – Installing Node-RED .................................................................................................9
Figure 6 – Starting Node-RED ................................................................................................. 10
Figure 7 – Call Node-RED in the web browser......................................................................... 11
Figure 8 – Opening the SIMOCODE application file in the TIA Portal ....................................... 12
Figure 9 – Opening the project ................................................................................................ 13
Figure 10 – Preparing the project for loading into SIMOCODE................................................. 14
Figure 11 – Importing project data into SIMOCODE................................................................. 15
Figure 12 – Open commissioning path .................................................................................... 15
Figure 13 - Connect online ...................................................................................................... 16
Figure 14 - Set time command (= PC time in UTC) .................................................................. 16
Figure 15 - Node RED nodes to be installed ............................................................................ 17
Figure 16 – Manage palette call for node installation ............................................................... 17
Figure 17 – Call ‘manage palette’ for node installation via the install-tab .................................. 18
Figure 18 – Search for node-red-contrib-opcua node collection .............................................. 18
Figure 19 – Install node-red-contrib-opcua node collection ...................................................... 18
Figure 20 – Node in installation phase ..................................................................................... 19
Figure 21 – Nodes added to the node collection ...................................................................... 19
Figure 22 – Successfully installed node-red-contrib-opcua node collection .............................. 19
Figure 23 – Successfully installed node collections .................................................................. 20
Siemens AG 2022 All rights reserved