Professional Documents
Culture Documents
MindConnect Nano
MindConnect Nano
MindConnect Nano
___________________
Safety Notes 2
___________________
3
MindSphere Introduction
___________________
Overview of MindConnect
Elements 4
Getting Connected to MindSphere Mounting and installing
5
MindConnect Elements
___________________
Connecting MindConnect
Elements 6
Getting Started
Onboarding MindConnect
Elements 7
Configuring data in Asset
Manager 8
9
___________________
Configuring protocols
10
___________________
Firmware update
A
___________________
Appendix
02/2019
V1801.Feb/2019.1
Legal information
Warning notice system
This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent
damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert
symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are
graded according to the degree of danger.
DANGER
indicates that death or severe personal injury will result if proper precautions are not taken.
WARNING
indicates that death or severe personal injury may result if proper precautions are not taken.
CAUTION
indicates that minor personal injury can result if proper precautions are not taken.
NOTICE
indicates that property damage can result if proper precautions are not taken.
If more than one degree of danger is present, the warning notice representing the highest degree of danger will
be used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to
property damage.
Qualified Personnel
The product/system described in this documentation may be operated only by personnel qualified for the specific
task in accordance with the relevant documentation, in particular its warning notices and safety instructions.
Qualified personnel are those who, based on their training and experience, are capable of identifying risks and
avoiding potential hazards when working with these products/systems.
Proper use of Siemens products
Note the following:
WARNING
Siemens products may only be used for the applications described in the catalog and in the relevant technical
documentation. If products and components from other manufacturers are used, these must be recommended
or approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and
maintenance are required to ensure that the products operate safely and without any problems. The permissible
ambient conditions must be complied with. The information in the relevant documentation must be observed.
Trademarks
All names identified by ® are registered trademarks of Siemens AG. The remaining trademarks in this publication
may be trademarks whose use by third parties for their own purposes could violate the rights of the owner.
Disclaimer of Liability
We have reviewed the contents of this publication to ensure consistency with the hardware and software
described. Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the
information in this publication is reviewed regularly and any necessary corrections are included in subsequent
editions.
WARNING
Life-threatening voltages are present with an open control cabinet
When you install the device in a control cabinet, some areas or components in the open
control cabinet may be carrying life-threatening voltages.
If you touch these areas or components, you may be killed by electric shock.
Switch off the power supply to the cabinet before opening it.
System expansions
NOTICE
Damage through system expansions
Device and system expansions may be faulty and can affect the entire machine or plant.
The installation of expansions can damage the device, machine or plant. Device and
system expansions may violate safety rules and regulations regarding radio interference
suppression. If you install or exchange system expansions and damage your device, the
warranty becomes void.
NOTICE
"Open Type" UL508
Note that the device is classified as "Open Type" for use in the area of Industrial Control
Equipment (UL508).
Installation of the device in an enclosure complying with UL508 is a prerequisite for
approval or operation in accordance with UL508.
WARNING
Risk of explosion and release of harmful substances
Improper handling of lithium batteries can result in an explosion of the batteries.
Explosion of the batteries and the released pollutants can cause severe physical injury.
Worn batteries jeopardize the function of the device.
Note the following when handling lithium batteries:
• Replace used batteries in good time; see the section "Replacing the backup battery" in
the operating instructions.
• Replace the lithium battery only with an identical battery or types recommended by the
manufacturer.
• Do not throw lithium batteries into fire, do not solder on the cell body, do not recharge,
do not open, do not short-circuit, do not reverse polarity, do not heat above 100°C and
protect from direct sunlight, moisture and condensation.
NOTICE
Observe immunity to RF radiation
The device has an increased immunity to RF radiation according to the specifications on
electromagnetic compatibility in the technical specifications.
Radiation exposure in excess of the specified immunity limits can impair device functionality
resulting in malfunctions and therefore injuries or damages.
Read the information on immunity to RF radiation in the technical specifications.
ESD Guideline
Electrostatic sensitive devices can be labeled with an appropriate symbol.
NOTICE
Electrostatic sensitive devices (ESD)
When you touch electrostatic sensitive components, you can destroy them through voltages
that are far below the human perception threshold.
If you work with components that can be destroyed by electrostatic discharge, observe the
ESD Guideline. Refer to the chapter ESD guideline (Page 105).
Industrial Security
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 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.
NOTICE
Possible functional restrictions in case of non-validated plant operation.
The device is tested and certified on the basis of the technical standards. In rare cases,
functional restrictions can occur during plant operation.
Validate the correct functioning of the plant to avoid functional restrictions.
Mindsphere provides a highly reliable system, however the MindConnect can be affected
by system internal incidents.
Note
Use in an industrial environment without additional protective measures.
This device was designed for use in a normal industrial environment according to IEC
60721-3-3.
Note
Firmware MiniWeb versions
The connection to a SIMOCODE, SIMOTION, SINAMICS OPC UA Server cannot
reestablish automatic if the used Firmware has a MiniWeb version is less than V5.1. It's
recommended to upgrade to a new Firmware version of the SIMOCODE, SIMOTION,
SINAMICS device.
Convention
The term “device” is used to refer to MindConnect Nano and MindConnect IoT2040. The
terms for MindSphere can be found in Glossary in the Appendix of this documentation.
The configuration parameters should be extracted out of the text or tables
and depend respectively on the needs and constellation of the individual system.
Internet address
Click the following link to find MindSphere documentation: MindSphere Documentation Area
(http://documentation.mindsphere.io)
You will work through typical steps involved in configuring MindConnect Elements and your
asset data. You will become familiar with the tools that MindSphere provides for
configuration and visualization of assets and aspects.
Requirements
● Internet connection and newest version of your internet browser(e. g. Google chrome or
Firefox) for online user interface
● Internet connection for MindConnect Nano/IoT2040 device
● Provide standard HTTPS capabilities for MindConnect Nano/IoT2040 - outbound HTTPs
connection(s) on port 443
● Link to the online Launchpad with user and password data as supplied by Siemens
● Device (PC, tablet etc.) with minimum screen resolution of 1024x768
Configuring steps
Definition asset
An asset is a digital representation of a machine or an automation system with one or
multiple automation units (e.g. PLC) connected to MindSphere.
MindSphere data collection and data provisioning is based on so called (virtual) assets. This
can be anything like a pump, motor, PLC, an entire tool machine, a production line, a robot,
a crane, a car, a wind turbine and so on. The data of an asset is collected and sent to
MindSphere to make that data available for further processing and analytics.
Definition aspect
Aspects are a data modeling mechanisms for assets. Aspects group related data points
based on their logical association. For example: The pump skid has an aspect e.g.
"Energy_consumption" that contains the data points: "power", "current", "voltage" etc. Aspect
is specified in Asset Manager and its name can be freely chosen, but should have
conjunction to datapoints and a physical asset. An aspect can consist of several variables.
Data model
The following graphic shows the data model in Asset Manager:
In Asset Manager devices like MindConnect Nano are defined as the data source. The
device sends data points to MindSphere. These data points must be connected to the
aspects and variables. Asset Manager uses aspects and variables as data containers.
Within MindSphere you add data points to a data source to collect the data, for example from
a control unit. In the next step you have to link the data points to the respective variables of
an aspect.
To enable data connecting and in order to use your data in MindSphere you have to fulfill the
following processes:
● Onboarding (Page 45): Onboarding is the process of attaching a MindConnect Element to
MindSphere.
● Data mapping (Page 65): Data mapping matches variables of an aspect with the
respective data points of a data source.
MindConnect Nano
MindConnect Nano is a preconfigured Industrial PC that allows connectivity to MindSphere.
The device supports the transmission of data encrypted through a secured Internet
connection to MindSphere. MindConnect Nano allows fast and easy IoT connectivity of
machines and systems. For more information refer to chapter Technical specifications of
MindConnect Nano (Page 95). The following graphic shows the MindConnect Nano:
MindConnect IoT2040
MindConnect IoT2040 has compact a design and can also be used for collecting and
transferring data to MindSphere in smaller production environments. The device supports the
transmission of encrypted data over a secured Internet connection to enable cloud-based
applications and services. For more information refer to chapter Technical specifications of
MindConnect IoT2040 (Page 98). The following graphic shows the MindConnect IoT2040:
Note
Damage to the device during transport and storage
If a device is transported or stored without packaging, shocks, vibrations, pressure and
moisture may impact the unprotected unit. Damaged packaging indicates that ambient
conditions may have already had a massive impact on the device.
The device may be damaged.
Do not dispose of the original packaging. Pack the device during transportation and
storage.
5. Check the content of the packaging and any accessories you may have ordered for
completeness and damage.
6. If the content of the package is incomplete, damaged or does not match your order,
inform the responsible delivery service immediately.
WARNING
Electric shock and fire hazard due to damaged device
A damaged device can be under hazardous voltage and trigger a fire in the machine or
plant. A damaged device has unpredictable properties and states.
Death or serious injury could occur.
Make sure that the damaged device is not inadvertently installed and put into operation.
Label the damaged device and keep it locked away. Return the device for immediate
repair.
NOTICE
Damage from condensation
If the device is subjected to low temperatures or extreme fluctuations in temperature
during transportation, for example in cold weather, moisture could build up on or inside
the HMI device.
Moisture causes a short circuit in electrical circuits and damages the device. In order to
prevent damage to the device, proceed as follows:
• Store the device in a dry place.
• Bring the device to room temperature before starting it up.
• Do not expose the device to direct heat radiation from a heating device.
• If condensation develops, wait approximately 12 hours or until the device is
completely dry before switching it on.
7. Please keep the enclosed documentation in a safe place. It belongs to the device. You
will need the documentation when you commission the device for the first time.
8. Write down the identification data of the device.
Note
Security of MindConnect Elements
In order to ensure the security of your MindConnect Element, you should mount it in a
restricted access location e. g. lockable cabinet.
This reduces the possibility of manipulations on the device/customer data.
Note
> 50 °C: Install in RAL
RAL = Restricted Access Location - e.g. a lockable cabinet
Note
Maximum height
The maximum altitude to install MindConnect Nano is 4000 m.
Note
> 50 °C: Install in RAL
RAL = Restricted Access Location - e.g. a lockable cabinet
Note
Ensure that the mounting surface on the wall can bear four times the total weight of the
device, including attached elements.
Use only the anchors and screws specified in the operating instructions.
Mounting on rails
Wall mounting
LED lights
The LED lights status provide information on efficient self-diagnostics. The following graphics
show the LED lights of the MindConnect Nano:
You can find more information about LED error codes in section Troubleshooting (Page 28).
LED lights
The LED lights provide information on the status of the device for efficient self-diagnostics.
The following table describes the device behavior associated when a different USER LED
status is displayed
You can find more information about LED error codes in section Troubleshooting (Page 28).
5.4.3 Troubleshooting
"Commands": [
"Cmd":"CopyAgentLogsToUsbStick"
"Commands": [
"Cmd":"CopyArchivedLogsToUsbStick",
"DeleteAfterCopy":"false"
"Commands": [
"Cmd": "CopySystemFilesToUsbStick",
"TypeOfFiles": "LinuxSystemFiles"
System files:
Depending on the value of TypeOfFiles the .tar.gz file will contain different system files.
"Commands": [
"Cmd": "SetSystemTime",
"NewTime": "2017-09-19T12:34:56"
JSON format:
{
"Commands": [
"Cmd": "DoFactoryReset",
"DeviceID": "_MindConnect_ID_"
You can find more information on how to set a MindConnect Element to factory settings in
chapter Manual firmware update of MindConnect Element (Page 85)
Objective
The MindConnect Elements should be connected to the power supply and commissioned.
Requirements
● The protective conductor is connected (valid only for MindConnect Nano). Refer to the
chapter Connecting the protective earth (Page 22).
● A two-core cable with a cable cross-section of 0.75 mm² to 2.5 mm².
● A slotted screwdriver with a 3 mm blade.
NOTICE
Power supply requirements
MindConnect Nano should only be connected to a 24 V DC to power supply which satisfies
the requirements of safety extra low voltage (SELV) according to IEC/EN/DIN EN/UL
60950-1.
MindConnect IoT2040 should only be connected to a 9...36 V DC power supply which
meets the requirements of safe extra low voltage (SELV) according to IEC/EN/DIN EN/UL
60950-1.
The power supply must meet the NEC class 2 or LPS requirement in accordance with
IEC/EN/DIN EN/UL 60950-1.
Note
The MindConnect Nano/IoT2040 package does not include power supply. The appropriate
power supply product from Siemens with the name SITOP can be used.
Procedure
CAUTION
Danger of burns
The surface of the device can reach temperatures of over 70 °C. Any unprotected contact
may cause burns.
Avoid direct contact during operation of the device. Touch the device only with appropriate
protective gloves.
– The graphic demonstrates the steps how to connect the power supply for
MindConnect IoT2040:
Result
MindConnect Nano/IoT2040 is now prepared and you can onboard it to MindSphere.
If the green light does not appear, refer to section Troubleshooting (Page 28) for more
information about LED messages.
① X63 port
② PN/IE LAN X1 P1 port
③ PN/IE LAN X2 P1 port
Port Description
X63 USB 2.0 port, high current. Configuration file on USB stick.
Required during onboarding process.
PN/IE LAN X1 P1 RJ45 Ethernet connection 1 for 10/100/1000 Mbps. Access to the Internet (to MindSphere).
Required to start onboarding process.
PN/IE LAN X2 P1 RJ45 Ethernet connection 2 for 10/100/1000 Mbps. Access to the plant network or asset (e.g. S7,
OPC UA).
Required to complete onboarding process.
Procedure
Before you start onboarding, connect MindConnect Nano to MindSphere, as follows:
Insert Ethernet cable into the port labeled with X1 P1 to connect MindConnect Nano to
MindSphere.
Note
MindConnect Nano MAC address
The type plate on of the MindConnect Nano shows 2 MAC addresses. The first MAC
address belongs to port X1 P1.
① X60 port
② PN/IE LAN X1 P1 port
③ PN/IE LAN X2 P1 port
Port Description
X60 USB 2.0 port, high current. Configuration file on USB stick.
Required during onboarding process.
PN/IE LAN X1 P1 RJ45 Ethernet connection 1 for 10/100/1000 Mbps. Access to the Internet (to MindSphere).
Required to start onboarding process
PN/IE LAN X2 P1 RJ45 Ethernet connection 2 for 10/100/1000 Mbps. Access to the plant network (e.g. S7, OPC
UA).
Required to complete onboarding process.
Procedure
Before you start onboarding, connect MindConnect IoT2040 to MindSphere, as follows:
Insert Ethernet cable for Internet into the port labeled with X1 P1.
Note
During the onboarding process, only one USB stick is supported. Do not plug in more than
one USB stick. The recommended USB port is the USB port with label X60.
Objective
The MindConnect Element can now be connected to the plant network or asset.
Requirements
● An asset has been created in Asset Manager.
● The configuration has been transferred via USB stick to the MindConnect Element.
Procedure
To connect the MindConnect Element to your plant network or asset, insert the Ethernet
cable into the port labeled with X2 P1.
The following graphic shows the connecting port of the MindConnect Nano:
The following graphic shows the connecting port of the MindConnect IoT2040:
Requirements
● MindConnect Nano/IoT2040 is connected to the Internet and powered on.
● The connection cable for the Internet is correctly plugged into the Ethernet port for the
Internet (MindSphere).
● MindConnect Nano/IoT2040 is connected to asset or plant network.
● You have received the link to the MindSphere UI with credentials (user and password
data).
● A customer account is created.
● A standard USB device with a single partition in FAT or FAT32 is formatted.
● You have the role "mdsp:core:TenantAdmin". The user roles are set in Settings.
Note
Prepare MindConnect Elements
To prepare your MindConnect Element for MindSphere V3, you have to update the firmware
for boxes that were already connected to MindSphere V2 (SAP).
You can find more information in chapter Manual firmware update of MindConnect Element
(Page 85).
Onboarding Procedure
In order to onboard MindConnect Nano/IoT2040, you must perform the following steps:
1. Login to MindSphere. (Page 46)
2. Create an asset in Asset Manager. (Page 46)
3. Enable connection to MindConnect Element in Asset Manager. (Page 48)
Note
MindSphere supports English and German languages. Therefore it is recommended to set
the browser default to English, if you use a different language.
Procedure
To create an asset proceed as follows:
1. Select Asset Manager from the Launchpad.
2. Click "Assets" in the navigation area.
3. To create a new asset click .
The asset type overview window is opened.
4. Select the respective asset type for your MindConnect Element, e. g. MindConnect Nano.
5. Enter a name and the data for the asset, e. g. "Wind turbine"
6. Confirm the entries with "Save".
Result
The new asset is available at the asset list.
The following graphic shows the created asset:
Procedure
To enable the connection to the MindConnect Element proceed as follows:
1. Select the asset in the "Asset" tab.
2. Click on the asset icon, e. g. "MindConnect Nano".
The "Create MindConnect" screen appears.
Result
You have enabled the connection to the MindConnect Element.
See also
Adding a data source and data points (Page 61)
Procedure
To configure the network setting, follow these steps:
1. Select the asset in the "Asset" tab.
2. Click on the asset icon, e. g. "MindConnect Nano".
4. Activate DHCP if a DHCP server is available in your company network or enter the
respective information for static IP address.
The following graphic shows the IP address input fields:
5. Enter the proxy data area "Communication Settings" if necessary and click "Save".
– In this case, contact your network administrator to get the proxy data.
Note
If nothing else is configured manually, MindConnect Nano/IoT2040 will try to obtain IP
addresses for both adapters via DHCP.
Requirement
● A standard USB device with a single partition in FAT or FAT32 is formatted.
● You have enabled the connection to the MindConnect Element.
● You have configured the network settings.
Procedure
WARNING
USB stick information
The configuration created in this step includes security relevant information. You can
encrypt and sign the information. Take care of the USB stick and the information flow from
MindSphere to USB stick and from USB stick to the MindConnect Element. Delete the USB
stick after use.
2. In order to encrypt the onboarding key data, activate the "Encrypted" checkbox.
3. Click on "Download Onboarding Key".
4. Save the downloaded file to the root directory of your USB stick.
5. Insert the USB stick into the USB port of the MindConnect Element, e. g. "MindConnect
Nano"
Note
During the import of the configuration, the following LED-states are to be expected:
1. MAINT LED flashes orange
2. RUN LED blinks green
3. On-boarding result
– RUN LED green: MindConnect onboarded successfully
– MAINT LED orange: onboarding failed
The process can take up to 30 minutes. Please do not remove the USB stick during this
time.
6. After successfully importing the configuration, remove the USB stick from the
MindConnect Element.
7. Check the status of the MindConnect Element at the Overview.
Result
The connection status in Asset Manager at the overview has changed to "Onboarded". The
configuration of the asset has been transferred to the MindConnect Element. The connection
between the MindConnect Element and MindSphere is established.
Once MindConnect Nano/IoT2040 is onboarded, the connection to your asset is permanent
and your asset for data collection can be configured. This requires configuration of machine
data to be monitored. Any additional configuration (except network configuration) of the
connected asset will automatically be synchronized with your onboarded MindConnect
Nano/IoT2040.
The connection to the asset is permanent and can only be cancelled by offboarding. For this
purpose, refer to the Asset Manager documentation.
Procedure
To add an aspect type in Asset Manager, e. g. "Generator", follow these steps:
1. On the start screen click "Aspects".
2. To create a new aspect click .
3. Enter your Tenant ID for the aspect, e. g. "idevdoc.generator".
Note
All custom aspects and types must be named as "<TenantID>.xxx"
Note
• The units and data types specified here will need to match exactly(also case
sensitive) with the physical data source.
Result
The new aspect type with its variables is available in the aspect list.
Requirement
● You have created an aspect.
Procedure
To create an asset type proceed as follows:
1. Click on the "Types" tab in Asset Manager.
2. Click on "BasicDevice".
3. To create a new asset type click .
4. Enter ID and name for asset type, e. g. "Wind turbine".
Note
The ID must be named as "TenantID.xxx".
5. Select an aspect type from the dropdown menu, e. g. "Generator". You can find additional
information on aspects in the chapter Creating an aspect and variables (Page 56)
6. Enter an aspect name and click "Add".
7. To save the asset type click "Save".
Result
You created a new asset type. The new asset type is now available in the presets. The
following graphic shows the new available asset type "Wind turbine" in assets.
Requirement
● You have created an asset and an aspect.
● You have enabled the connection to the MindConnect Element.
● You have the IP address of the asset inside of your network.
Procedure
To add a data source to an asset of type MindConnect, e. g. "Generator", follow these steps:
1. Click on the asset in the "Assets" tab, e. g. "Wind turbine".
2. Click on the asset icon, e. g. "MindConnect Nano".
Note
• The default reading cycle is 86400 seconds, which is one day.
• You can find additional information on supported protocols in the chapter Configuring
protocols (Page 68).
Result
You have now created a new data source. The new data source is available at the asset
details of your MindConnect Element.
The following graphic shows the added data source:
Note
Health status
The health status shows the quality of the connection of the data point. You can click on the
status to get further information. You can find additional information about quality code in
chapter Quality code settings (Page 92).
Requirement
● You have created a data source.
Procedure
To add a data point to a data source, e. g. "RotationSpeed", follow these steps:
1. Click on the asset in the "Assets" tab, e. g. "Wind turbine".
2. Click on the asset icon, e. g. "MindConnect Nano".
3. To edit the data source you have to click on "Enter Edit Mode".
– Edit functions appear next to the data source.
4. Click on "Add Datapoint".
5. Enter data point data.
Note
• The units and data types specified here will need to match exactly with the aspects
and variables. If they are different, the aspect cannot be connected to the data point.
• The protocol datatypes specify the Datapoint Address. You can find additional
information on protocol datatypes in the chapter Configuring protocols (Page 68).
Result
The new data point is available at the data source.
In order to send the changes to the device, you have to click "Apply Changes" in the
MindConnect plugin.
The following graphic shows the health status of the new data point:
Requirement
You have now created an asset based on your desired aspect and asset type.
Procedure
To map a variable to a data point, e. g. "RotationSpeed", follow these steps:
1. Click on the asset in the "Assets" tab, e. g. "Wind turbine1".
2. Click on the MindConnect Element Plugin icon, e. g. "MindConnect Nano".
3. Click "View data mapping".
4. Select the aspect, e. g. "Generator".
5. Select the variable you want to map to the data point, e. g. "RotationSpeed".
6. Select the data point you want to map and click "Link Variable".
The following graphic shows the "Link Variable" option:
7. Select the previously created asset type and click "Accept", e. g. "Wind turbine".
Note
You can find additional information on asset types in the chapter Creating a type in Asset
Manager (Page 58).
Note
Only units and data types that match exactly with the aspects and variables are available.
If they are different, the aspect can’t be connected to the data point (also case sensitive).
Result
The data point is now mapped to the variable.
The following graphic shows a mapped variable:
Note
Symbolic access
This solution does not allow full symbolic access.
Note
Signed values
If you want to read a signed value, you have to use the respective signed datablock.
Example:
DB1831.DBW508 is unsigned. You can use DB1831.DBINT508 instead.
Area Types
S7 datapoint addresses must contain an area type.
Area Number
S7 datapoint addresses must contain area number.
e.g.: DB10 (10. datablock)
Variable Types
Area types other than timer and counter must contain a variable type.
S7 data type Length Asset data point type Asset data point address
Byte (unsigned) 1 byte Integer DB1.DBX0.0
Char (signed) 1 byte Integer DB1.DBB1, DB1.DBCHAR8
DINT (signed) 4 bytes Long DB1.DBDINT4
DWord (unsigned) 4 bytes Long DB1.DBDWORD10
Int (signed) 2 bytes Integer DB1.DBINT2
Real 4 bytes Double DB1.DBREAL16, DB1.DBD16
String 254 bytes String DB1.DBSTRING16,254
Word (unsigned) 2 bytes Integer DB1.DBW8
Offset
Variable types must have an offset. Offset is the starting byte number.
e. g. DW4 (a double word starting from byte 4)
String
Note
You must enclose your character string in single quotation marks.
The following example shows the byte order when specifying the datatype STRING[4] with
the output value 'AB'.
* Tod
* Time
Returns milliseconds.
Format
The DT (DATE_AND_TIME) datatype saves the information on date and time of day in BCD
format.
For the OPCUA protocol, the data source input supports the following parameters:
Parameter Description
Protocol Shows the selected protocol type.
Name Name of the data source.
Description Add a description for data source.
Reading Cycle Enter a reading cycle for the data source.
OPC UA Server Name Enter the name of the OPC UA Server Name.
OPC UA Server IP Enter the OPC UA Server IP Address.
Address
Parameter Description
OPC UA Authentica- You can choose between the following types:
tion Type
• NONE: No authentication enabled.
• BASIC: Enables the OPC UA BASIC authentication.
OPC UA Security You can choose between the following modes:
Mode
• NONE: No security mode
• CERTIFICATE: Enables to upload a certificate in the following formats: *.pfx, *.pf12, *.cer,
*.crt, *.der, *.p7b, *.p7r, *.spc
Note
OPC browsing is not supported.
Field Description
NamespaceIndex The index of the OPC UA Server namespace in which the address resides. If the index is 0, the
entire ns=;= clause is omitted.
IdentifierType The type of address. OPC UA supports the following four address types:
i A numeric address represented with 32-bit unsigned integer
s A string address containing characters that can be encoded using UTF-8
g A GUID address in the format of XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
b An opaque address (such as a byte string)
Identifier The address that is formatted as a string. This address may be numeric, string, GUID, or opaque.
Examples NodeId
Below you can see examples of an OPC UA Addresses (NodeId) representation:
String
Note
String for Identifier
The string you enter at the four Identifier will be case sensitive.
Numeric
Guid
Base64(Opaque)
Datatypes Conversion
The following table shows the Datatype Conversion:
Note
“NodeID“ is not a valid part of the OPC string anymore.
You can select the protocol type SIMATIC I/O Shield while adding a new data source in
Asset Manager.
The following picture shows the protocol selection in Asset Manager:
After selecting the protocol you can enter the parameter Name, Description and Reading
Cycle.
Note
Modbus configuration
The Modbus configuration view is only visible after a successful onboarding of the
MindConnect IoT2040/Nano. The MindConnect Nano Version must be higher than V3.3.0.2.
For more information about how to create a new data source see chapter AUTOHOTSPOT.
Parameter Description
IP Address IP address of the Modbus device
Port Port number of the Modbus device (default: 502)
Parameter Description
Serial Port Available serial ports:
• COM1
• COM2
Serial Type Supported serial communication standards:
• RS232
• RS422
• RS485
Baud rate Baud rate for serial communication:
• 9600
• 2400
• 4800
• 19200
• 38400
• 57600
• 115200
Data bits Data bits for serial communication:
• 5
• 6
• 7
• 8
Stop bits You can select the number of stop bits for serial communication:
• 1
• 2
Parity Parity for serial communication:
• Odd
• None
• Even
Termination Onboard termination:
• On
• Off
The following table shows the parameter of the Modbus RTU data point window:
Parameter Description
Data Type Data type supported by backend (e.g. INT).
Function Type Function type - depends on the type of the data (see manual of the Modbus device).
1: Read Coils
2: Read Inputs
3: Read Holding Registers
4: Read Input Registers
Currently function codes 1..4 are supported.
Slave Number Address/Slave number of the Modbus device.
Start Address Start address (offset) of the data.
Quantity Quantity of data to be read.
VariableType You can choose the following variable types of the Modbus data to be read:
1: char
2: unsigned char
3: short
4: unsigned short
5: long
6: unsigned long
7: float
8: double
9: ASCII-Text
Real Type Real type - determines, if the registers of real values have to be processed in reversed order
0: Normal order
1: Reversed order
Response Address Offset of the data to return in register units.
Offset
Response Quantity Quantity of the returned data. Only for string data a value greater than 1 is supported.
Technical specification
Each category has its own set of variables which will be described in the following.
CPU information
The following table shows the available variables for the category CPU information:
Memory information
The following table shows the available variables for the category Memory information:
Network information
The following table shows the available variables for the category Network information:
Disk information
Disk collects information about disk usage and provides the following subcategories:
● root
● persistent
● persistent_appconfig
● persistent_massdata
The following table shows the available variables for the category Disk information:
Note
This procedure is only necessary for boxes that were already connected to MindSphere V2
(SAP). V1 cannot be upgraded.
"Commands": [
"Cmd": "DoFactoryReset",
"DeviceID": "MindConnectID"
Note
MindConnectID has to be replaced with the serial number of the device.
NOTICE
Outdated version
Please keep your firmware always updated.
Requirements
● MindConnect Nano/IoT2040 is connected to the internet and onboarded.
● Aspects and variables are configured in Asset Manager.
Procedure
To see the visualized data in Fleet Manager, you can proceed as follows:
1. Select a required asset to view its data. (Page 87)
2. View aspects of a selected asset. (Page 89)
3. View events of a selected asset. (Page 91)
Requirement
You have created assets in Asset Manager.
Procedure
To select an asset in Fleet Manager, proceed as follows:
1. In the MindSphere Launchpad, click "Fleet Manager".
The overview page of Fleet Manager appears and you can see the list with assets on the
left-hand side.
2. To view an asset, select between "Fleet" or "Hierarchy" views.
– Or click the “Filter & sort" button to restrict the asset list.
Result
The navigation displays the selected asset that corresponds to the search or filter
parameters.
Requirement
You have created aspects in Asset Manager.
Procedure
To view variables of aspects in the "Aspect" extension, proceed as follows:
1. In the right-hand side of Fleet Manager, click the "Aspects" extension icon.
– The "Aspects" extension opens on the right-hand side.
2. Select and expand an aspect e.g. "Generator":
– Aspect "Generator" is opened.
– You can set a time frame (Time picker: day, week, and month) and see the variables,
which you want to monitor.
3. Select the dates from the last week in the calendar.
4. To show the exact measured values, move the mouse over the graph.
Result
The "Aspects" extension shows the chosen aspect of an asset.
Requirements
● You have created assets in Asset Manager.
● Events have been created and are already available.
Procedure
1. Select the required asset e.g. “Wind turbine", in the left-hand side of the window.
2. In the right-hand side, click the "Events" extension icon.
3. Click the tab "Events".
Result
The events data of asset "Wind turbine" is displayed.
If the data provider (e.g. S7 PLC, OPC UA Server) is not available, the MindConnect
Element or the data provider client will send up a "0" with a quality code. The value of the
quality code shows that this is not a valid data.
● If the function "Quality code" is enabled for this data point all the information can be
stored in the database. The database creates a request to Fleet Manager to show the
bad quality code information in a chart.
● If the function "Quality code" is disabled, the value 0 will be saved anyway. But you
cannot figure out if this data is valid.
Functions
Field protocol – S7 Siemens S7 (for S7-3xx / S7-4xx / S7-12xx/ S7-15xx / ET-200s PLCs)
Field protocol – OPC UA Part 8 of the OPC UA specification (Data Access)
Functions
Configuration of data collection With Asset Manager in MindSphere
Data buffering Up to 500 MB buffering space for collected data
Proxy support Yes
DHCP support Yes
Security Connection outbound via HTTPS on port 443 to MindSphere only; no incoming con-
nection accepted SSL/TLS encryption of data in transit to MindSphere
Supply voltage
Type of supply voltage 24 V
Current consumption max. 1.8 A at 24 V
Mains buffering
Mains/voltage failure stored energy 20 ms
time
Interfaces
USB port 1x USB 3.0 / 3x USB 2.0
PCIe slot 1x PCIe x1 (Disabled)
serial interface 1x COM (Disabled)
Video interfaces
Graphics interface 1x DisplayPort (Disabled)
Industrial Ethernet
Industrial Ethernet interface 2x 1000 Mbit RJ45
Monitoring functions
Status LEDs Yes
Fan No
EMC
Interference immunity against discharge of static electricity
Interference immunity against dis- ±6 kV contact discharge acc. to IEC 61000-4-2; ±8 kV air discharge acc. to IEC
charge of static electricity 61000-4-2
Interference immunity to cable-borne interference
Interference immunity on supply • ±2 kV acc. to IEC 61000-4-4, burst; ±1 kV acc. to IEC 61000-4-5, surge symmet-
cables ric;
• ±2 kV acc. to IEC 61000-4-5, surge asymmetric;
Interference immunity on signal • ±2 kV acc. to IEC 61000-4-5, surge, length > 30 m;
cables >30m
Interference immunity on signal • ±1 kV acc. to IEC 61000-4-4; burst; length < 3 m;
cables < 30m
• ±2 kV acc. to IEC 61000-4-4; burst; length > 3 m;
EMC
Interference immunity against voltage surge
asymmetric interference ±2 kV acc. to IEC 61000-4-5, surge asymmetric
symmetric interference ±1 kV acc. to IEC 61000-4-5, surge symmetric
Interference immunity against high-frequency electromagnetic fields
Interference immunity against high • 10 V/m for 80 - 1000 MHz and 1.4 - 2 GHz, 80% AM acc. to IEC 61000-4-3;
frequency radiation
• 3 V/m for 2 - 2.7 GHz, 80% AM acc. to IEC 61000-4-3;
• 10 V/m for 10 kHz - 80 MHz, 80% AM acc. to IEC 61000-4-6
Interference immunity to magnetic fields
Interference immunity to magnetic 100 A/m; to IEC 61000-4-8
fields at 50 Hz
Emission of conducted and non-conducted interference
Interference emission via line/AC EN 61000-6-3, EN 61000-6-4, CISPR 22 Class B, FCC Class A
current cables
Ambient conditions
Ambient temperature during operation
Ambient temperature during opera- 0 °C up to 60 °C
tion
min. 0 °C
max. 60 °C
Ambient temperature during storage/transportation
Ambient conditions
min. -20 °C
max. 60 °C
Relative humidity
Relative humidity Tested according to IEC 60068-2-78, IEC 60068-2-30: Operation: 5% to 80% at 25
°C (no condensation), Storage: 5% to 95% at 25 °C (no condensation)
Vibrations
Vibration load in operation Tested to DIN IEC 60068-2-6: 10 Hz to 58 Hz: 0.075 mm, 58 Hz to 200 Hz: 9.8 m/s²
(1 g)
Shock testing
Shock load during operation Tested according to IEC 60068-2-27: 150 m/s², 11 ms
Software
MindConnect Software Pre-installed MindConnect Software
Dimensions
Width 191 mm
Height 100 mm
Depth 60 mm
Functions
Field protocol – S7 Siemens S7 (for S7-3xx / S7-4xx / S7-12xx/ S7-15xx/ ET-200s PLCs)
Field protocol – OPC UA Part 8 of the OPC UA specification (Data Access)
Configuration of data collection With Asset Configuration tool in MindSphere
Data buffering Up to 500 MB buffering space for collected data
Proxy support Yes
DHCP support Yes
Security Connection outbound via HTTPS on port 443 to MindSphere only; no incoming con-
nection accepted SSL/TLS encryption of data in transit to MindSphere
Installation type/mounting
Design IoT Gateway, built-in unit
Mounting DIN rail, wall mounting
Supply voltage
Type of supply voltage DC 9…36 V, no galvanic isolation
Mains buffering
Mains/voltage failure stored energy 5 ms
time
Interfaces
USB port 1x USB 2.0, 1x USB client
Connection for keyboard/mouse USB / USB
serial interface 2x COM ports (RS 232, RS 485)
Industrial Ethernet
Industrial Ethernet interface 2 x Ethernet (RJ45)
100 Mbps Yes
1000 Mbps No
Monitoring functions
Watchdog Yes
Status LEDs Yes
EMC
Interference immunity against discharge of static electricity
Interference immunity against dis- ±4 kV contact discharge acc. to IEC 61000-4-2; ±8 kV air discharge acc. to IEC
charge of static electricity 61000-4-2
Interference immunity against high-frequency electromagnetic fields
Interference immunity against high • 10 V/m for 80 - 1000 MHz, 80% AM acc. to IEC 61000-4-3;
frequency radiation
• 3 V/m for 1.4 - 2 GHz, 80% AM acc. to IEC 61000-4-3;
• 1 V/m for 2 - 2.7 GHz, 80% AM acc. to IEC 61000-4-3;
• 10 V for 150 kHz - 80 MHz, 80% AM acc. to IEC 61000-4-6;
Interference immunity to cable-borne interference
Interference immunity on supply • ±2 kV acc. to IEC 61000-4-4, burst;
cables
• ±1 kV acc. to IEC 61000-4-5, surge symmetric;
• ±2 kV acc. to IEC 61000-4-5, surge asymmetric;
Interference immunity on signal ±2 kV acc. to IEC 61000-4-5, surge, length > 30 m
cables >30m
Interference immunity on signal ±2 kV in accordance with IEC 61000-4-4, burst, length > 30 m
cables < 30m
Interference immunity against voltage surge
Asymmetric interference ±2 kV acc. to IEC 61000-4-5, surge asymmetric
Symmetric interference ±1 kV acc. to IEC 61000-4-5, surge symmetric
Interference immunity to magnetic fields
EMC
Interference immunity to magnetic 100 A/m; to IEC 61000-4-8
fields at 50 Hz
Emission of conducted and non-conducted interference
Emission of conducted and non- EN 61000-6-4:2007 +A1:2011
conducted interference
Ambient conditions
Ambient temperature during operation
Ambient temperature during opera- 0 °C to 50 °C
tion
min. 0 °C
max. 50 °C
Relative humidity
Relative humidity • Tested according to IEC 60068-2-78
• IEC 60068-2-30: Operation: 5 % to 85 % at 30 °C (no condensation)
• storage / transport: 5 % to 95 % at 25 / 55 °C (no condensation)
Vibrations
Vibration load in operation Tested according to IEC 60068-2-6: 5 Hz to 9 Hz: 3.5 mm; 9 Hz to 200 Hz: 9.8 m/s²
Shock testing
Shock load during operation Tested according to IEC 60068-2-27: 150 m/s², 11 ms
Software
MindConnect Software Pre-installed MindConnect Software
Dimensions
Width 144 mm
Height 90 mm
Depth 53 mm
The following example shows the buffer time for a MindConnect Nano with 500 MB data
buffer:
In this case, 120 bytes is the memory needed for one data point.
Note
Reading data from a data provider will always cause an effect on it. The performance of the
data provider (PLC / OPC Server / Modbus) is one of the most important limiting factors. If
more devices (e.g. OPC server, HMIs, SCADA systems,...) are connected to this data
provider (e.g. PLC) the reading cycle can rise.
Note
To make sure a configuration works for your setup it needs to be monitored over a longer
period of time.
MindConnect NANO
MindConnect IOT2040
● Read of a string data point you have to multiply the time with 2,5 per data point
● All devices are around 75% full
① Corporate / Office Network with route to the internet or direct internet access, e.g. via a DSL modem
② Production / Machine Network
NOTICE
Damage to ESD from touch
Electrostatic sensitive devices, ESD, can be destroyed by voltages which are far below the
human perception limit. If you touch a component or electrical connections of a module
without discharging any electrostatic energy, these voltages may arise.
The damage to a module by an overvoltage can often not be immediately detected and only
becomes evident after an extended period of operation. The consequences are incalculable
and range from unforeseeable malfunctions to a total failure of the machine or system.
Avoid touching components directly. Make sure that persons, the workstation and the
packaging are properly grounded.
Charge
Every person without a conductive connection to the electrical potential of his/her
surroundings can be electrostatically charged.
The material with which this person comes into contact is of particular significance. The
figure shows the maximum electrostatic voltages with which a person is charged, depending
on humidity and material. These values conform to the specifications of IEC 61000-4-2.
① Voltage
② Synthetic materials
③ Wool
④ Antistatic materials such as wood or concrete
⑤ Relative humidity
NOTICE
Grounding measures
There is no equipotential bonding without grounding. An electrostatic charge is not
discharged and may damage the ESD.
Protect yourself against discharge of static electricity. When working with electrostatic
sensitive devices, make sure that the person and the workplace are properly grounded.
Abbreviation Description
DMZ Demilitarized Zone (referred to a perimeter network)
GUI Graphical User Interface
HTTPS Hyper Text Transfer Protocol Secure
IoT Internet of things
IoT2040 MindConnect IoT2040
IP Internet Protocol
LAN Local Area Network
MCN MindConnect Nano
MSU MindSphere Unit
NAPT Network Address and Port Translation
OEM Original Equipment Manufacturer
OPC UA Open Platform Communications Unified Architecture
PC Personal Computer
S7 STEP 7
UI User Interface
Aspect
Aspects are a data modeling mechanisms for assets. Aspects group the data points based
on logical sense. For example: The pump skid has an aspect e.g. “Energy_consumption” that
contains the data points: "power", "current", "voltage" etc.
Aspect is specified in Asset Manager and its name can be freely chosen, but should bring
together a logical grouping of data points and a physical asset.
Asset
An asset is a digital representation of a machine or an automation system with one or
multiple automation units (e.g. PLC) connected to MindSphere.
MindSphere data collection and data provisioning is based on so called (virtual) assets. This
can be anything such as a pump, motor, PLC, an entire tool machine, a production line, a
robot, a crane, a car, a wind turbine and so on. The data of an asset is collected and sent to
MindSphere to make that data available for further processing and analytics.
Asset Identifier
Asset Identifier is an identifier assigned by the manufacturer of the device, to which
MindConnect Nano will be connected. After the onboarding process, MindConnect Nano is
connected to this device. The serial number identifies the asset to which the data belongs.
Asset Manager
Asset Manager is a Web Graphical User Interface for asset configuration. According to these
configurations, the following functions are available:
Asset Configuration: assets can be created, onboarded, modified, cloned, moved, deleted or
offboarded.
Asset type
Asset type is a sort or kind of a product line made by one manufacturer.
Components
Components represent built-in functionality in MindSphere. Components are:
● Asset Manager
● Fleet Manager
● Settings
● UTC Reporting
For the complete list and description of Components, refer to the “MindSphere”
documentation.
Data point
Data points refer to elements (variables), which allow values to be obtained from data
sources (OPC UA or S7 etc.). They are combined into a relevant aspect. For example,
“temperature” and “torque” are data points of an aspect “Energy_consumption”.
Data points are configured in "Asset Manager”. In “Fleet Manager”, their values are
visualized as time series.
Data source
A data source is a physical element of a device, which can be monitored by MindSphere.
For example: OPC UA Server, S7.
Event
In "Fleet Manager", an event is a change of a datapoint state. Events are used for the
requests. With a rule it is possible to define the request, which will be created in MindSphere
when the event is triggered.
Besides the monitoring rule, a description of event (e.g. “The limit is exceeded, this may
indicate damage in the pump”), the resulting action (e.g. “Please contact your hotline”) and
priority (urgent, important or info) can be lodged.
See also “request”, “rule".
Fleet Manager
Fleet Manager is a visualization tool which provides an overview of existing assets and their
information (asset name, customer name, location). Fleet Manager displays your configured
asset, aspects with datapoints in charts and list of all requests etc.
Last Connection
"Last Connection" status in “Asset Manager” gives the information, when a MindConnect
Element was online for the last time.
MindConnect Element
MindConnect Elements are devices for transferring data and allow connectivity to
MindSphere such as MindConnect Nano, MindConnect IoT2040 or MindConnect FB.
MindSphere
MindSphere is the Siemens Industrial IoT operation system comprising the core cloud
services and applications, whereas the MindConnect Element provides secure and easy
connectivity from the field or machine to MindSphere. In MindSphere, submitted data by a
MindConnect Element is processed and stored for analysis and further management
purposes.
For more information, refer to the “MindSphere” documentation.
MindSphere Launchpad
MindSphere Launchpad is the entry point for components as well as for available
applications.
Organization
Organization is the part of hierarchical asset configuration in Asset Manager. Within
organization, areas/assets are specified.
As the administrator (OEM), you manage organizations, their customers and assets. As the
user of an organization, you can access the assets assigned only to this organization.
In the context of MindSphere, an organization can be anything and is defined by the
administrator depending on their requirements: customer, cost center, branch etc.
Request
Requests are the messages which log asset incidents based on predefined rules.
You can create manual requests as well as requests for the regular acquisition of measured
quantities with measuring series.
See also “event", "rule".
Rule
With rules you can configure an automatic monitoring of datapoints on events. For example,
a request will be created automatically by the system, if a value exceeds or falls below a
threshold (edge trigger).
See also “event", "request".
Settings
Settings is a Web Graphical User Interface for user, organization and role configuration.
Time series
Time series is a sequence of measurements which are produced by data sources over time.
Analysis and visualization tools (e.g. Fleet Manager) can retrieve collected time series and
present it to the user after processing. In Asset Manager, the measurements, that have to be
collected, can be specified.