User Guide for softing models including: edgePlug, SINUMERIK CNC Docker Containers, Docker Containers, edgePlug, SINUMERIK CNC

edgePlug SINUMERIK CNC

edgePlug SINUMERIK CNC | User Guide

edgePlug SINUMERIK CNC | Softing

edgePlug SINUMERIK CNC


File Info : application/pdf, 22 Pages, 4.72MB

PDF preview unavailable. Download the PDF instead.

edgePlug SINUMERIK CNC U V1 00 EN
User Guide
edgePlug SINUMERIK CNC
Version: EN-052022-1.00
© Softing Industrial Automation GmbH

Disclaimer of liability
The information contained in these instructions corresponds to the technical status at the time of printing of it and is passed on with the best of our knowledge. Softing does not warrant that this document is error free. The information in these instructions is in no event a basis for warranty claims or contractual agreements concerning the described products, and may especially not be deemed as warranty concerning the quality and durability pursuant to Sec. 443 German Civil Code. We reserve the right to make any alterations or improvements to these instructions without prior notice. The actual design of products may deviate from the information contained in the instructions if technical alterations and product improvements so require.
Trademarks
SINUMERIK is a registered mark of Siemens AG, Germany.
OpenSource
To comply with international software licensing terms, we offer the source files of open source software used in our products. For details see https://opensource.softing.com/ If you are interested in our source modifications and sources used, please contact: info@softing.com
Softing Industrial Automation GmbH Richard-Reitzner-Allee 6 85540 Haar / Germany https://industrial.softing.com
+ 49 89 4 56 56-340 info.automation@softing.com support.automation@softing.com https://industrial.softing.com/support/support-form
Scan the QR code to find the latest documentation on the product web page under Downloads.

Table of Contents

Table of Contents

Chapter 1
1.1 1.2 1.3 1.4 1.5 1.6
Chapter 2
2.1 2.2 2.3 2.4
Chapter 3
3.1 3.2 3.3 3.4 3.4.1 3.4.2
Chapter 4
4.1 4.2 4.2.1 4.2.2 4.2.3 4.3
Chapter 5
5.1 5.2
Chapter 6

About this guid.e..................................................................................... 5
Read me firs.t.............................................................................................................. 5 Target audie.n..c..e.......................................................................................................... 5 Typographic..c.o..n...v.e..n...t.i.o..n..s........................................................................................... 5 Document h.i.s.t..o..r.y....................................................................................................... 5 Related docu..m...e..n...t.a..t.i.o...n............................................................................................. 6 Document fe..e..d..b..a..c..k................................................................................................... 6
About edgePlu.g..S..I.N...U..M...E..R..I.K...C..N...C........................................................... 7
Intended use............................................................................................................... 7 Features and...b..e..n..e..f..i.t.s................................................................................................ 7 Technical da.t.a............................................................................................................. 7 System requ.i.r.e..m...e..n...t.s................................................................................................. 7
Installation ...................................................................................... 8
Prerequisites............................................................................................................... 8 Copying edg.e..P..l.u..g...t.o...I.E..M............................................................................................. 8 Installing ed.g.e..P..l.u...g..t..o...I.E..D........................................................................................... 8 Physical con..n...e..c.t..i.o..n...t.o....S.I.N...U...M...E..R..I.K...8..4..0..D....c.o..n...t.r.o...l.l.e..r.............................................. 10 SINUMERIK 84.0..D...S..L.................................................................................................. 10 SINUMERIK 84.0..D...P..L.................................................................................................. 12
Configuration...................................................................................... 14
Prerequisite..s............................................................................................................. 14 IIH Configur..a..t.o..r........................................................................................................ 14 Data source co..n..f.i.g..u..r..a..t.i.o..n........................................................................................ 14 Data point con..f.i.g..u..r..a..t.i.o..n.......................................................................................... 16 Databus gatew..a..y...................................................................................................... 16 Diagnosis ............................................................................................................... 17
Connecting w.i.t.h...I.E...M...Q...T.T...c..o..n..n..e..c.t..o..r................................................... 18
Configure t.h..e...I.E...M...Q...T..T...C..o..n...n..e..c.t..o..r.......................................................................... 18 Connect an..M....Q..T..T...c..l.i.e..n..t.......................................................................................... 19
Glossary ...................................................................................... 21

Version EN-052022-1.00

3

This page is intentionally left blank.

4

Version EN-052022-1.00

Chapter 1 - About this guide
1 About this guide
1.1 Read me first
Please read this guide carefully before using the device to ensure safe and proper use. Softing does not assume any liability for damages due to improper installation or operation of this product. This document is not warranted to be error-free. The information contained in this document is subject to change without prior notice. To obtain the most current version of this guide, visit the product website.

1.2 Target audience
This guide is intended for experienced operation personnel and network specialists configuring and maintaining field devices in a Siemens network environment. Before installing and operating the edgePlug SINUMERIK CNC make sure that you have read and fully understood the safety requirements and working instructions in this guide.

1.3 Typographic conventions

The following typographic conventions are used throughout Softing customer documentation:

Keys, buttons, menu items, commands and other

à à Open Start Control Panel Programs

elements involving user interaction are set in bold font

and menu sequences are separated by an arrow

Buttons from the user interface are enclosed in brackets and set to bold typeface

Press [Start] to start the application

Coding samples, file extracts and screen output is set in Courier font type

MaxDlsapAddressSupported=23

Filenames and directories are written in italic

Device description files are located in C: \<Application name>\delivery\software\Device Description files

CAUTION
CAUTION indicates a potentially hazardous situation which, if not avoided, may result in minor or moderate injury.

Note
This symbol is used to call attention to notable information that should be followed during installation, use, or servicing of this device.

1.4 Document history

Document version 1.00

Changes since last version § first version

Version EN-052022-1.00

5

edgePlug SINUMERIK CNC - User Guide
1.5 Related documentation
The following links direct you to additional product information.
You will find the user manuals and release notes of the Siemens Industrial Edge system in the Documents section of the Siemens Industrial Edge Hub.
1.6 Document feedback
We would like to encourage you to provide feedback and comments to help us improve the documentation. You can write your comments and suggestions to the PDF file using the editing tool in Adobe Reader and email your feedback to support.automation@softing.com. If you prefer to write your feedback directly as an email, please include the following information with your comments: § document name § document version (as shown on cover page) § page number

6

Version EN-052022-1.00

Chapter 2 - About edgePlug SINUMERIK CNC
2 About edgePlug SINUMERIK CNC
The Softing edgePlug SINUMERIK CNC is a Linux-based containerized software application running on a Docker engine. It has been designed to stream SINUMERIK 840D CNC data to the Siemens Industrial Edge applications.
2.1 Intended use
The edgePlug SINUMERIK CNC integrates smoothly into the Siemens Industrial Edge connectivity and are designed to utilize all services and features of the Siemens connectivity suite.

2.2 Features and benefits
§ Access to SINUMERIK 840D CNC machine tool data for the Siemens Industrial Edge § No change of CNC program needed § No data point configuration needed with pre-defined standard namespace § Tight integration into Siemens Industrial Edge § Use the IIH configurator to configure the edgePlug connectivity § CS Databus Gateway makes the controller data available at the IE Databus § Existing applications which use the IE Databus can consume the data provided by the edgePlug
without changes

2.3 Technical data

Supported CNCs
Tested with
Minimal Hardware Requirements Licensing Software

Siemens SINUMERIK 840D Solution Line, Software Version >= V2.7 Siemens SINUMERIK 840D Power Line, Software Version >= V5.3 Siemens Industrial Edge V1.4.0 Siemens Industrial Information Hub V1.1 Siemens IPC227E 256 MB free disk space, 32 MB RAM Over Siemens Industrial Marketplace
Siemens Industrial Edge Application

2.4 System requirements
The edgePlug SINUMERIK CNC is a connector for the Siemens Industrial Information Hub. You must have the Siemens Industrial Infomation Hub (IIH) installed on a Siemens Industrial Edge Device to use the edgePlug SINUMERIK CNC.

Version EN-052022-1.00

7

edgePlug SINUMERIK CNC - User Guide
3 Installation
The edgePlug SINUMERIK CNC can be purchased and installed over the Siemens Industrial Edge marketplace.
3.1 Prerequisites
To be able to work with edgePlug SINUMERIK CNC you need a Siemens Industrial Edge Hub Account, a Siemens Industrial Edge Management installation and at least one Siemens Industrial Edge device. Please have a look at the "Industrial Edge Management - Getting Started" manual from Siemens which explains the installation of the Siemens Industrial Edge environment.
3.2 Copying edgePlug to IEM
After you have purchased edgePlug SINUMERIK CNC in the Siemens marketplace check the user manual of the IE Hub for further details on how to copy your edgePlug SINUMERIK CNC to IEM .
1. Click the copy to IEM catalog icon. 2. Select the IEM instances in the displayed dialog.
The edgePlug SINUMERIK CNC will be installed to the catalog of the IEM.
3.3 Installing edgePlug to IED
1. Double-click the edgePlug SINUMERIK CNC icon in the catalog of the IEM.

2. Click [Install]. 8

Version EN-052022-1.00

Chapter 3 - Installation 3. Open the to Install App dialog. 4. Click [Next] on the Configurations page and select the IED to which you want to install the App.
5. Click [Install Now] to install the App on the device.

Version EN-052022-1.00

9

edgePlug SINUMERIK CNC - User Guide
3.4 Physical connection to SINUMERIK 840D controller
The SINUMERIK 840D variants offer two types of physical connection. SINUMERIK 840D SL variant has 3 Ethernet interfaces while SINUMERIK 840D PL variant only provides MPI access.

3.4.1

SINUMERIK 840D SL
§ Ethernet interface X120 for the device connection to HMIs and keyboards § Ethernet interface X130 for the company network § Ethernet interface X127 for service purposes

10

Version EN-052022-1.00

Chapter 3 - Installation

Ethernet interface

Description

X120
X127 X130

This interface is used for connecting the automation network (operator panel interface). The interface is not isolated by a firewall. Ideally, the Softing dataFEED edgeConnector 840D should therefore be operated using this interface.
This interface uses the fixed IP address 192.168.214.1. For connecting to the machine network the gateway then should be configured using a fixed IP address as well(e.g. an IP address higher than 192.168.214.250).
This interface serves exclusively as a service socket (service interface). It cannot be used for connection purposes.
This interface connects the controller to the factory network (company Ethernet).
This interface can be used as an alternative interface for connecting the dataFEED edgeConnector 840D. Here, however, the NCU firewall (port TCP/102) has to be enabled to allow for SIMATIC S7 communication.

The Softing dataFEED edgeConnector 840D uses the SIMATIC S7 communication protocol (TCP/102) of SINUMERIK 840D SL. By default, this protocol is available at the X120 interface. Alternatively, it can be enabled for the X130 interface.

The host PC running the dataFEED edgeConnector 840D therefore needs either a physical connection to the X120 interface and a unique IPv4 address within the corresponding network or a physical connection to the X130 interface, a unique IPv4 address within the corresponding network as well as the SIMATIC S7 communication protocol explicitly enabled for this interface.

Version EN-052022-1.00

11

edgePlug SINUMERIK CNC - User Guide

3.4.2

SINUMERIK 840D PL
As the SINUMERIK 840D PL does not have an Ethernet interface, a D-Sub 9 connector is required for connectivity purposes to map the SINUMERIK 840D PL-specific communication to Ethernet communication.
The Softing product echolink S7-compact supports the PG/MPI to Ethernet conversion. The Ethernet-toMPI converter translates the RFC-1006 TSAP addresses to MPI addresses. As a result the default SINUMERIK 840D PL MPI addresses are translated into the following TSAP settings:
§ TSAP NCK (powerline): 03 03
§ TSAP PLC (powerline): 03 02
It must be ensured that the SINUMERIK 840D PL has been switched on and its communication settings are correct. Ensure that a valid MPI address is assigned and that it is not assigned twice in the configuration. Individually configured addresses can be determined by checking the hardware configuration of the SIMATIC STEP 7 project. As MPI address 30 is typically not used it can be assigned toecholink S7-compact.

Ethernet interface X120
X101

Description
This interface is used for connecting a programming or remote maintenance device (PG interface) and is recommended for the echolink S7-compact. It requires its own 24 V power supply, since the connector X122 does not provide any voltage.
If a connector is connected echolink S7-compact can be plugged on top or in between.
It is used for connecting the control panel/operating panel (control panel interface) and is not recommended for communication via echolink S7compact .

12

Version EN-052022-1.00

Chapter 3 - Installation

Configure echolink S7-compact
The echolink S7-compact configuration is performed in the appropriate configuration page (see the figure below).
The important echolink S7-compact settings include:

Variable IP Address
Baudrate Own Station Address
Set Default Bus Parameter

Description
Address for reaching echolink S7-compact. The IP address is freely selectable (e.g. 192.168.214.XXX), but has to be located in the same network as the MACHINE network of dataFEED edgeConnector 840D. The transmission speed has to be set to 187.5 kBit/s. MPI address of echolink S7-compact. Important: This address must not be used by another station. Select MPI and use the default parameters.

Version EN-052022-1.00

13

edgePlug SINUMERIK CNC - User Guide
4 Configuration
4.1 Prerequisites
§ The IED along with the installed edgePlug SINUMERIK CNC is connected over Ethernet to a SINUMERIK 840D CNC controller.
4.2 IIH Configurator
1. Click the Apps page in the user interface of the IED to run the IIH configurator. The browser will open a new tab displaying the configurator.
2. See the Connector Configuration page for a list of installed and running connectors.

3. Select the edgePlug SINUMERIC CNC.

4.2.1

Data source configuration
1. Open the Tags tab of the edgePlug SINUMERIK CNC. 2. Click Add Datasource.

3. See the Connector Configuration page for a list of installed and running connectors. 4. Enter the Data Source connection parameters into the Add Data Source dialog fields. 5. Click [Save].

14

Version EN-052022-1.00

Chapter 4 - Configuration

Field PLC Type
Name IP Address or hostname Enable NCU Alarm
NCK Tooling Access
Log Level

Description 840D SL for SINUMERIK 840D Solution Line controllers 840D PL for SINUMERIK 840D Power Line controllers Name of the connection used within the IE applications The IP address or hostname of the SINUMERIK CNC
Enable the monitoring of NCU alarms. This creates an additional communication load on the CNC. Enable the monitoring of NCU tooling data. This creates an additional communication load on the CNC. The level of generated logs 0 = Only Error logs 1 = Error and Warning logs 2 = Error, Waring and Information logs 3 = Error, Waring, Information and Debug logs

6. Select the datasource and press [Deploy] to write the configuration to the edgePlug SINUMERIK CNC.

Version EN-052022-1.00

15

edgePlug SINUMERIK CNC - User Guide
4.2.2 Data point configuration

840D SL All accessible data points are listed below the connection on the "Tabs" page. You can't add additional data points.
840D PL All accessible data points are listed below the connection on the "Tabs" page. You can't add additional data points.
Note To see the data points after the configuration of the data source, close the IIH Configurator and reopen it after 30 seconds.
Note With the V1.2 of the IIH Configurator the configuration of the Databus Gateway is only possible for one connector.

4.2.3

Databus gateway
1. Now you can select the data points you want to be available on the IE Databus.
2. Select the data points and check the "DEPLOY TO DATABUS" box for the ones you want be available on the IE Databus and press [Deploy]. This will reconfigure and restart the Databus Gateway and will make the datapoints available on the IE Databus.

16

Version EN-052022-1.00

Chapter 4 - Configuration
4.3 Diagnosis
The Softing Support Team will assist you in troubleshooting your edgePlug SINUMERIK CNC. 1. Open the IIH Configurator and set the Log Level of one of the configured data sources to 3 and
deploy it. This will give you a complete set of diagnostic data. 2. Contact Softing support and email our team the diagnostics of your edgePlug SINUMERIK CNC. 3. Open the Apps page. 4. Click the 3 dots of the edgePlug SINUMERIK CNC and select the Download Logs menu. The Log file is downloaded to the Downloads folder of your PC.

Version EN-052022-1.00

17

edgePlug SINUMERIK CNC - User Guide
5 Connecting with IE MQTT connector
The easiest way to access the data points on the IE Databus which are provided by the edgePlug is to use the IE MQTT Connector.
5.1 Configure the IE MQTT Connector
§ Download the User Manual oft he IE MQTT Connector by pressing the icon Show Support Documentation.
The User Manual describes how to configure the IE MQTT Connector. § Create a configuration with the following settings and deploy it. § Select a user name of your choice.

18

Version EN-052022-1.00

Chapter 5 - Connecting with IE MQTT connector

5.2 Connect an MQTT client
You can use a standard MQTT client, like MQTTX which is used in the screenshots, to connect to the IE MQTT Connector. The URL for the connection is: mqtt://<IP Address of the IED>:9883 using the configured user (softing) with its password. You must subscribe to the ,,ie/#" topic tree.

Version EN-052022-1.00

19

edgePlug SINUMERIK CNC - User Guide

You will receive MQTT messages on the following topics:
§ ie/s/j/simatic/v1/edgeplug-sinumerik-cnc-20/status Status messages of the Databus Gateway regarding the edgePlug connector
§ ie/m/j/simatic/v1/edgeplug-sinumerik-cnc-20/dp Metadata of the Databus Gateway for the edgePlug connector. This includes information about subscribed data points
§ ie/d/j/simatic/v1/edgeplug-sinumerik-cnc-20/dp/r/<Connection Name> Change notifications for the values of the subscribed data points

20

Version EN-052022-1.00

6 Glossary

Terms & Abbreviations CNC IED IEM MQTT OPC UA PL PLC SaaS SL

Definition Computerized Numerical Control Industrial Edge Device Industrial Edge Management Message Queuing Telemetry Transport OPC Unified Architecture Power Line Programmable Logic Controller Software as a Service Solution Line

Chapter 6 - Glossary

Version EN-052022-1.00

21

Softing Industrial Automation GmbH
Richard-Reitzner-Allee 6 85540 Haar / Germany https://industrial.softing.com

+ 49 89 45 656-340 + 49 89 45 656-488 info.automation@softing.com



References

Help Manual by EC Software GmbH