Preface

Table of Contents

SIAPP 1
SICAM A8000 Series Device Configuration 2
SIAPP Configuration
IoT Time Series 3
for IoT Gateway
SIAPP Configuration 4
V1.2.x Literature

Manual

DC8-102-2
 NOTE

i For your own safety, observe the warnings and safety instructions contained in this document, if available.

Disclaimer of Liability Copyright

Subject to changes and errors. The information given in Copyright © Siemens 2023. All rights reserved.
this document only contains general descriptions and/or The disclosure, duplication, distribution and editing of this
performance features which may not always specifically document, or utilization and communication of the content
reflect those described, or which may undergo modifica- are not permitted, unless authorized in writing. All rights,
tion in the course of further development of the products. including rights created by patent grant or registration of a
The requested performance features are binding only when utility model or a design, are reserved.
they are expressly agreed upon in the concluded contract.
Document version: DC8-102-2.08 Trademarks
Edition: 05.2023
SIPROTEC, DIGSI, SIGRA, SIGUARD, SIMEAS, SAFIR, SICAM,
Version of the product described: V1.2.x and MindSphere are trademarks of Siemens. Any unauthor-
ized use is prohibited.
Preface

Purpose of the Manual

This manual describes the configuration and engineering steps needed to use the IoT Gateway for
SICAM A8000-SIAPP.

Target Audience
This manual is addressed to personnel and customers who are responsible for evaluation, conceptual design,
configuration, and technical system maintenance.

Scope
This manual is valid for the SICAM A8000 series.

Additional Support
For questions about the system, contact your Siemens sales partner.

Customer Support Center

Our Customer Support Center provides a 24-hour service.
Siemens AG
Smart Infrastructure – Protection Automation Tel.: +49 911 2155 4466
Customer Support Center E-Mail: energy.automation@siemens.com

Training Courses
Inquiries regarding individual training courses should be addressed to our Training Center:
Siemens AG
Siemens Power Academy TD Phone: +49 911 9582 7100
Humboldtstraße 59 E-mail: poweracademy@siemens.com
90459 Nuremberg Internet: www.siemens.com/poweracademy
Germany

Notes on Safety
This manual is not a complete index of all safety measures required for operation of the equipment (module
or device). However, it includes important information that must be followed for personal safety and to avoid
material damage. Information is highlighted and illustrated as follows according to the degree of danger:

! WARNING
WARNING means that death or severe injury may result if the measures specified are not taken.
² Comply with all instructions, in order to avoid death or severe injuries.

SICAM A8000 Series, SIAPP Configuration, Manual 3

DC8-102-2, Edition 05.2023
Preface

! CAUTION
CAUTION means that medium-severe or slight injuries can occur if the specified measures are not taken.
² Comply with all instructions, in order to avoid moderate or minor injuries.

NOTE

i Important information about the product, product handling or a certain section of the documentation
which must be given attention.

OpenSSL
This product includes software developed by the OpenSSL Project for use in OpenSSL Toolkit (http://
www.openssl.org/).
This product includes software written by Tim Hudson (tjh@cryptsoft.com).
This product includes cryptographic software written by Eric Young (eay@cryptsoft.com).

4 SICAM A8000 Series, SIAPP Configuration, Manual

DC8-102-2, Edition 05.2023
Table of Contents

Preface.......................................................................................................................................................... 3

1 SIAPP.............................................................................................................................................................7
1.1 Introduction........................................................................................................................8
1.2 HTTPS Network Topology.................................................................................................... 9
1.3 HTTPS MindSphere............................................................................................................11
1.4 Fast Acquisition File Upload over MQTT............................................................................. 12
1.5 MQTT MindSphere ........................................................................................................... 13

2 Device Configuration..................................................................................................................................15
2.1 Importing SIAPP................................................................................................................ 16
2.2 Adding Hardware and Configuring Ports............................................................................ 17
2.3 Adding Firmware.............................................................................................................. 19
2.4 Adding Licenses................................................................................................................ 20

3 IoT Time Series........................................................................................................................................... 21

3.1 Signal Assignment............................................................................................................ 22
3.2 HTTPS Configuring Signals.................................................................................................24
3.3 MQTT Configuring Signals................................................................................................. 25
3.4 MQTT Unit Configuration Signals.......................................................................................27

4 SIAPP Configuration................................................................................................................................... 29
4.1 Configuring SIAPP............................................................................................................. 30
4.2 HTTPS Configuring Application Settings............................................................................. 32
4.3 MQTT Configuring Application Settings............................................................................. 34
4.4 Uploading SIAPP Configuration to the Device.....................................................................37

Literature.................................................................................................................................................... 39

SICAM A8000 Series, SIAPP Configuration, Manual 5

DC8-102-2, Edition 05.2023
6 SICAM A8000 Series, SIAPP Configuration, Manual
DC8-102-2, Edition 05.2023
1 SIAPP

1.1 Introduction 8
1.2 HTTPS Network Topology 9
1.3 HTTPS MindSphere 11
1.4 Fast Acquisition File Upload over MQTT 12
1.5 MQTT MindSphere 13

SICAM A8000 Series, SIAPP Configuration, Manual 7

DC8-102-2, Edition 05.2023
SIAPP
1.1 Introduction

1.1 Introduction
The SICAM application SIAPP can be used on a CP-8031 or CP-8050 to communicate with MindSphere. This
gateway provides 2 main features.
Only one type of transmission can be used, either HTTPS or MQTT.

• HTTPS connection
HTTPS communicates with the MindSphere API using the MindConnect Library V4 (MCL). This implemen-
tation of the MindConnect Library V4 provides a monitoring-towards-cloud solution only.
– MindSphere file upload
The file upload is explicitly used for MQTT messages provided by the AssetGuard. The MQTT
message payload must meet the fast acquisition (FAC) JSON structure (see 1.4 Fast Acquisition
File Upload over MQTT).
– MindSphere time series upload
All signals provided via the EdgeDataApi are uploaded as time series data in a specific time schedule.
The signals are divided into spontaneous and periodic data types (see 3.1 Signal Assignment).

• MQTT connection
The IOT Gateway communicates with MindSphere over an encrypted MQTT Broker – Client system. This
implementation provides a monitor and command solution for MindSphere.
– MindSphere monitoring
All signals provided via the EdgeDataApi are uploaded as time series data in a specific time schedule
from 30 s.
– MindSphere commanding
Commanding signals provided via the EdgeDataApi are possible to set in MindSphere with the
SICAM Navigator.
The following requirements must be met in order to run SIAPP:

• Devices:
– SICAM CP-8031 Master Module or
– SICAM CP-8050 Master Module

• Engineering:
– SICAM Device Manager V3.90 and higher

• Firmware:
– CPCI85 V4.90 and higher
– SICWEB V5.80 and higher
– LXAR85 V4.85 and higher

• License:
– SICAM Application Runtime license

8 SICAM A8000 Series, SIAPP Configuration, Manual

DC8-102-2, Edition 05.2023
 SIAPP
1.2 HTTPS Network Topology

1.2 HTTPS Network Topology

[dw_Network_diagram, 1, en_US]

The communication between the IoT Gateway and the MindSphere MindConnect Library can only be estab-
lished by the client. Data can only be sent to MindSphere. The other direction - out of MindSphere is not
possible.
The communication is based on the MindSphere REST JSON API via HTTP and a TLS V1.2 encryption.
Authentication is done by a shared secret, generated by the user on the MindSphere MindConnect Web
application.

SICAM A8000 Series, SIAPP Configuration, Manual 9

DC8-102-2, Edition 05.2023
SIAPP
1.2 HTTPS Network Topology

In order to resolve the MindSphere Gateway host name, a DNS is required. The firewall settings must be set to
port 443, TCP (HTTPS) and port 53, UDP (DNS). It must be possible to ping the DNS server (ICMP).

10 SICAM A8000 Series, SIAPP Configuration, Manual

DC8-102-2, Edition 05.2023
 SIAPP
1.3 HTTPS MindSphere

1.3 HTTPS MindSphere

² Create an onboarding.json configured as shared secret on the MindSphere Asset Manager application.
² Upload this configuration file via the SICAM Device Manager in the SIAPP configuration.

NOTE

i • The communication between devices and the MindSphere cloud services takes place through HTTPS
and signed URLs.

• OAuth 2.0 mechanisms is used for authentication and authorization.

• Security tokens have a limited validity period and must be renewed regularly.

• The file upload via the SICAM Device Manager is encrypted and secure.

SICAM A8000 Series, SIAPP Configuration, Manual 11

DC8-102-2, Edition 05.2023
SIAPP
1.4 Fast Acquisition File Upload over MQTT

1.4 Fast Acquisition File Upload over MQTT

This File Upload is the 2nd main function of the HTTPS IoT Gateway. Connected Assetguards can communi-
cate with SIAPP via the MQTT protocol. Currently, only messages in Fast Acquisition (FAC) format can be
processed. The maximum payload size of a FAC message is set to 4 MB.
A fast acquisition message from an Assetguard is sent to MindSphere as a file over HTTPS. This file is
compressed as a tar.gz file and has the time stamp as file name (for example 1624264289000.tar.gz).
The MQTT topic, with which the message was sent to SIAPP by the Assetguard, reflects the folder structure
(for example: v1/ds-cs/de/Asset_GERVASIO/@HF/ FCOV_AXE_Z/).
To prevent data loss if the network connection is unstable, the internal ring buffer can temporarily store up to
32 FAC files.

MQTT Broker Configuration

For configuration, a mqtt_config.json file must be created, which is required for communication with the
Assetguards. This file must be uploaded as MQTT Config File for the Assetguard.
Configuration example:
{
"port": "<8883 or 1883>",
"user": "<MQTT user>",
"password": "<MQTT password>",
"psk": "<MQTT psk key base64>",
"psk_id": "<MQTT psk id>"
"version": "1.2.3"
}

NOTE

i • These settings need to be identical to the Assetguard config.txt file.

• Due to the preconfiguration of SIAPP, only port 1883 and port 8883 are valid ports.

• Only the port setting is mandatory. If user/password and/or psk encrypted communication is not
used, remove the related lines from the file.

12 SICAM A8000 Series, SIAPP Configuration, Manual

DC8-102-2, Edition 05.2023
 SIAPP
1.5 MQTT MindSphere

1.5 MQTT MindSphere

² Download MindSphere Broker Root CA1 from the MindSphere Asset Manager application.
² Create a Client Device Certificate with SICAM GridPass.
² Upload these bought certificates via SICAM Device Manager in SIAPP.

NOTE

i • The communication between devices and the MindSphere cloud services takes place through
encrypted MQTT.

• The file upload via SICAM Device Manager is encrypted and secure.

SICAM A8000 Series, SIAPP Configuration, Manual 13

DC8-102-2, Edition 05.2023
14 SICAM A8000 Series, SIAPP Configuration, Manual
DC8-102-2, Edition 05.2023
2 Device Configuration

2.1 Importing SIAPP 16

2.2 Adding Hardware and Configuring Ports 17
2.3 Adding Firmware 19
2.4 Adding Licenses 20

SICAM A8000 Series, SIAPP Configuration, Manual 15

DC8-102-2, Edition 05.2023
Device Configuration
2.1 Importing SIAPP

2.1 Importing SIAPP

Before the application can be configured and loaded onto a device, it must be imported into the Device
Manager.
To do this, the following steps can be carried out in an opened project.
² Close all device tabs.

[sc_SIAPP_Upload_kl, 1, en_US]

² Select menu.

² Select SIAPP....
The dialog appears.

[sc_Import_siapp, 1, en_US]

² Use the following icon to import the SIAPP file.

² Select the desired SIAPP file (*.siapp) from your file system and click confirm.
The selected file is displayed and ready for import.

[sc_SIAPP_upload_05, 2, en_US]

² Confirm the dialog.

The file is imported.

16 SICAM A8000 Series, SIAPP Configuration, Manual

DC8-102-2, Edition 05.2023
 Device Configuration
2.2 Adding Hardware and Configuring Ports

2.2 Adding Hardware and Configuring Ports

For the use of SIAPP a second LAN port is needed, the following steps show the required activation process.

Adding Hardware
² Select Hardware on the homepage.

[sc_Start_Hardware, 1, --_--]

² Use the following icon to add a new module.

² Add a master module and a power supply.

² Confirm the Select firmware dialog.

Configuring Ports
² Click on the top of the master module.

[sc_Config_HW_Module, 1, en_US]

SICAM A8000 Series, SIAPP Configuration, Manual 17

DC8-102-2, Edition 05.2023
Device Configuration
2.2 Adding Hardware and Configuring Ports

² Select Properties of module.

The dialog Hardware settings – CP opens to configure the device.

[sc_Hardware_settings, 2, en_US]

² If you need a 2nd Ethernet port add a new row in LAN port groups. Select Singular in the Type column.
A 2nd port for CP-X2 will be activated automatically.
² Confirm your entries.

18 SICAM A8000 Series, SIAPP Configuration, Manual

DC8-102-2, Edition 05.2023
 Device Configuration
2.3 Adding Firmware

2.3 Adding Firmware

Before the application can be loaded onto the device, the runtime must be installed first.
² Select Application configuration and licensing on the homepage.

[sc_Start_Application_best, 1, en_US]

² Select SIAPP Runtimes.

[sc_Firmware_application_settings, 1, en_US]

² Select Add.
² Confirm the dialog.

[sc_Add_firmware, 2, en_US]

SICAM A8000 Series, SIAPP Configuration, Manual 19

DC8-102-2, Edition 05.2023
Device Configuration
2.4 Adding Licenses

2.4 Adding Licenses

² Select Application configuration and licensing on the homepage.

[sc_Start_Application_best, 1, en_US]

² Select Licenses.

[sc_Licenses_Start, 2, en_US]

² Use the following icon to add a new license.

² Select a license and click confirm.

² Add the selected license in License Key / License Number.

[sc_Licenses_Activation, 2, en_US]

20 SICAM A8000 Series, SIAPP Configuration, Manual

DC8-102-2, Edition 05.2023
3 IoT Time Series

3.1 Signal Assignment 22

3.2 HTTPS Configuring Signals 24
3.3 MQTT Configuring Signals 25
3.4 MQTT Unit Configuration Signals 27

SICAM A8000 Series, SIAPP Configuration, Manual 21

DC8-102-2, Edition 05.2023
IoT Time Series
3.1 Signal Assignment

3.1 Signal Assignment

All signals that can be assigned to the EdgeDataApi are sent from SIAPP to MindSphere.
So you can transfer signals, that are connected to CP-8031 or CP-8050 via protocols like Modbus,
IEC 60780-5-104 etc.
The signals are transmitted as time series.

[dw_SIAPP_Edgedata_to_Mindsphere_Timeseries, 1, en_US]

There are 2 types of signals:

• Periodic
All parameterized periodic signals are recorded every 30 s and transmitted every 60 s. This means that 2
time series are sent to MindSphere every minute.

• Spontaneous
Spontaneous signals are only transmitted when they have changed. If the signal changes, a time slot of
30 s opens and then each changed signal is transmitted to MindSphere.
With the Keyframe function a snapshot of all signals in a 15 min time frame (periodic and spontaneous) is
sent to MindSphere.

NOTE

i Be aware that the maximum number of assignable signals is 2000.

NOTE

i When using MQTT, the spontaneous signals and commands are transmitted immediately. Periodic signals
are transmitted by change in 30 second slots. There is no keyframe when using MQTT.

NXpower Monitor Time Series Workaround

To interpret IEC 60870 data types, a naming convention for the SIAPP signal names is required. Use the prefix
“TIxx_” for the required signal type, for example “TI31_CB_ON_OFF_AH01”.
Signal Type IEC 60870 EDGE Data Type MindConnect Lib V4 Data Type
Spontaneous TI30 E_EDGE_DATA_TYPE_UINT32 E_MCL_DATA_TYPE_BOOLEAN
Spontaneous TI31 E_EDGE_DATA_TYPE_UINT32 E_MCL_DATA_TYPE_DOUBLE

22 SICAM A8000 Series, SIAPP Configuration, Manual

DC8-102-2, Edition 05.2023
 IoT Time Series
3.1 Signal Assignment

Signal Type IEC 60870 EDGE Data Type MindConnect Lib V4 Data Type
Spontaneous TI32 E_EDGE_DATA_TYPE_INT32 E_MCL_DATA_TYPE_DOUBLE
Spontaneous TI33 E_EDGE_DATA_TYPE_UINT32 E_MCL_DATA_TYPE_DOUBLE
Periodic TI34 E_EDGE_DATA_TYPE_FLOAT32 E_MCL_DATA_TYPE_DOUBLE
Periodic TI35 E_EDGE_DATA_TYPE_INT32 E_MCL_DATA_TYPE_DOUBLE
Periodic TI36 E_EDGE_DATA_TYPE_FLOAT32 E_MCL_DATA_TYPE_DOUBLE
Spontaneous TI37 E_EDGE_DATA_TYPE_INT32 E_MCL_DATA_TYPE_DOUBLE
Spontaneous TI45 E_EDGE_DATA_TYPE_UINT32 E_MCL_DATA_TYPE_DOUBLE
Spontaneous TI46 E_EDGE_DATA_TYPE_UINT32 E_MCL_DATA_TYPE_DOUBLE
– – E_EDGE_DATA_TYPE_INT64 E_MCL_DATA_TYPE_LONG
– – E_EDGE_DATA_TYPE_UINT64 E_MCL_DATA_TYPE_LONG
– – E_EDGE_DATA_TYPE_DOUBLE64 E_MCL_DATA_TYPE_DOUBLE

SICAM A8000 Series, SIAPP Configuration, Manual 23

DC8-102-2, Edition 05.2023
IoT Time Series
3.2 HTTPS Configuring Signals

3.2 HTTPS Configuring Signals

² Select RTU Signals on the home page.

[sc_Start_Signals_RTU, 1, --_--]

² Select Central Processing (M). Here you can define the SIAPP signals.

[sc_Signal_settings, 1, en_US]

² Expand the signal list.

² Select Add to add required signals.

[sc_Signal_parameter, 1, en_US]

² Select collapse signal list.

² Select the signals from the right side and click assign to SIAPP.
² Select the processing type as SIAPP slot 0 input.
² Select Parameter.

[sc_Signal_parameter_details, 1, en_US]

² Enter the corresponding PDA names for each signal.

The signal naming format must be <TIxx> _<signalname> .

24 SICAM A8000 Series, SIAPP Configuration, Manual

DC8-102-2, Edition 05.2023
 IoT Time Series
3.3 MQTT Configuring Signals

3.3 MQTT Configuring Signals

² Select RTU Signals on the home page.

[sc_Start_Signals_RTU, 1, --_--]

² Select Central Processing (M). Here you can define the SIAPP signals.

[sc_Signal_settings_MQTT, 1, en_US]

² Expand the signal list.

² Select Add to add required signals.

[sc_Signal_parameter_MQTT, 1, en_US]

² Select collapse signal list.

² Select all signals (also commanding) from the right side and click assign to SIAPP.

SICAM A8000 Series, SIAPP Configuration, Manual 25

DC8-102-2, Edition 05.2023
IoT Time Series
3.3 MQTT Configuring Signals

² Select all commanding signals again from the right side and click assign to SIAPP.
² Select the processing type as SIAPP slot 0 input for all signals.
² Select the processing type as SIAPP slot 0 output for all commanding signals.
² Select Parameter.

[sc_Signal_parameter_details_MQTT, 1, en_US]

² Enter a signal name in the column Name with the following format:
TIxx_<signalname> → and for TI36: TI36_<UNIT>_<signalname>
² Select SIAPP 0 output.
² Enter exact the same naming for all commanding signals.

[sc_Signal_parameter_close_MQTT, 1, en_US]

NOTE

i • Commanding signals must be defined two times. Enter the exact same name in the column Name as
input and as output.

• The unit is only available for measured values, TI36.

26 SICAM A8000 Series, SIAPP Configuration, Manual

DC8-102-2, Edition 05.2023
 IoT Time Series
3.4 MQTT Unit Configuration Signals

3.4 MQTT Unit Configuration Signals

The naming of the MQTT Signals must be in the following format:
<TIxx>_<signalname>
IEC 60870 EDGE Data Type Type MindSphere Type
TI30 E_EDGE_DATA_TYPE_UINT32 Single Point Information SPI
TI31 E_EDGE_DATA_TYPE_UINT32 Double Point Information DPI
TI32 E_EDGE_DATA_TYPE_INT32 Step Position Information FLOAT32
TI33 E_EDGE_DATA_TYPE_UINT32 Bitstring FLOAT32
TI34 E_EDGE_DATA_TYPE_FLOAT32 Measured value, normalized value FLOAT32
TI35 E_EDGE_DATA_TYPE_INT32 Measured value, scaled FLOAT32
TI36 E_EDGE_DATA_TYPE_FLOAT32 Measured value, floating point FLOAT32
TI37 E_EDGE_DATA_TYPE_INT32 Integrated Totals INT
TI45 E_EDGE_DATA_TYPE_UINT32 Single Command SC
TI46 E_EDGE_DATA_TYPE_UINT32 Double Command DC
TI48 E_EDGE_DATA_TYPE_FLOAT32 Set Point Command, normalized value FLOAT32
TI49 E_EDGE_DATA_TYPE_FLOAT32 Set Point Command, scaled FLOAT32
TI50 E_EDGE_DATA_TYPE_FLOAT32 Set Point Command, floating point FLOAT32

Unit
A unit must be defined for all TI36 signals.
To define a unit, use the underline “_” directly after the “IEC 60870” TI36 type. Followed by a second underline
“_” after the unit.
TI36_<UNIT>_<signalname> → TI36_kWh_Energy

NOTE

i The unit is only available for the type TI36.

SICAM A8000 Series, SIAPP Configuration, Manual 27

DC8-102-2, Edition 05.2023
28 SICAM A8000 Series, SIAPP Configuration, Manual
DC8-102-2, Edition 05.2023
4 SIAPP Configuration

4.1 Configuring SIAPP 30

4.2 HTTPS Configuring Application Settings 32
4.3 MQTT Configuring Application Settings 34
4.4 Uploading SIAPP Configuration to the Device 37

SICAM A8000 Series, SIAPP Configuration, Manual 29

DC8-102-2, Edition 05.2023
SIAPP Configuration
4.1 Configuring SIAPP

4.1 Configuring SIAPP

Settings

NOTE

i To avoid communication certificate errors ensure that the time is set correctly for CP-8031 or CP-8050.

² Select SIAPP on the homepage.

[sc_Start_SIAPP, 2, en_US]

² Select SIAPP Runtime 0 (SIAR 0) and add a new row.

² Select Singular CP-X2 for the port group.
² Enter the SIAPP IPv4 address.

NOTE

i The SIAPP IPv4 address needs to be in the same subnet as the router.

² Enter the SIAPP IPv4 subnet mask.

² Enter the SIAPP IPv4 default gateway address.
² Change the RAM Limit to 300 MB.
² Change the CPU share to 60.
² Change the Limit number of processes to 200.

[sc_SIAPP_RuntimeConfig, 2, en_US]

² Select SIAPPs and add a new row.

² Select iotgateway in the column Name.
² Select 500 in the column Flash memory [MB].

30 SICAM A8000 Series, SIAPP Configuration, Manual

DC8-102-2, Edition 05.2023
 SIAPP Configuration
4.1 Configuring SIAPP

² Select Restart in the column SIAPP behavior after a terminating error.

[sc_SIAPPs_Config, 3, en_US]

SICAM A8000 Series, SIAPP Configuration, Manual 31

DC8-102-2, Edition 05.2023
SIAPP Configuration
4.2 HTTPS Configuring Application Settings

4.2 HTTPS Configuring Application Settings

NOTE

i For this step SIAPP must already be imported.

² Select iotgateway (SIAPP 0).

[sc_IoT_General_Settings_HTTPS, 1, en_US]

IoT-Gateway General Settings

NOTE

i The MindSphere connection type can be HTTPS or MQTT. Leave the settings for the unused protocols as
default.

² Select HTTPS in the column MindSphere connection tpye.

² If a user-defined DNS Server is needed enter the DNS IP address.

HTTPS Settings [use if HTTPS is selected]

² Use the followig icon to upload the files.

² Upload the MQTT config file for AssetGuard. The file format must be a json.
² Choose the file and click confirm.

32 SICAM A8000 Series, SIAPP Configuration, Manual

DC8-102-2, Edition 05.2023
 SIAPP Configuration
4.2 HTTPS Configuring Application Settings

[sc_Config_Assetguard, 1, en_US]

² Upload the Onboarding file from MindSphere. The file format must be a json.
² Choose the file and click confirm.

[sc_Config_MindSphere, 1, en_US]

² If a file compression is needed select yes under Enable File Compression.

² If a proxy is needed select yes under Enable Proxy and enter the proxy IP address and port.

SICAM A8000 Series, SIAPP Configuration, Manual 33

DC8-102-2, Edition 05.2023
SIAPP Configuration
4.3 MQTT Configuring Application Settings

4.3 MQTT Configuring Application Settings

NOTE

i For this step SIAPP must already be imported.

² Select iotgateway (SIAPP 0).

[sc_Config_Application_MQTT_Start, 1, en_US]

IoT-Gateway General Settings

NOTE

i The MindSphere connection type can be HTTPS or MQTT. Leave the settings for the unused protocols as
default.

² Select MQTT in the column MindSphere connection tpye.

² If a user-defined DNS Server is needed enter the DNS IP address.

MQTT Settings [use if MQTT is selected]

² For Tenant ID, enter your tenant from MindSphere.
² For Device ID (Same as certificate name), enter your Device ID.

NOTE

i The Device ID must match the certificate name from SICAM GridPass.

² For Address, enter the MindSphere web address.

34 SICAM A8000 Series, SIAPP Configuration, Manual

DC8-102-2, Edition 05.2023
 SIAPP Configuration
4.3 MQTT Configuring Application Settings

² For Port, enter the MindSphere web address port.

² Use the followig icon to upload the certificates.

² Upload the MQTT CA Certificate (MindSphere Root Certificate). The file format must be *.pem.
² Choose the file and click confirm.

[sc_Config_MQTT_pem, 1, en_US]

² Upload the MQTT Client Device Certificate. The file format must be *.p12.
² Choose the file and click confirm.

SICAM A8000 Series, SIAPP Configuration, Manual 35

DC8-102-2, Edition 05.2023
SIAPP Configuration
4.3 MQTT Configuring Application Settings

[sc_Config_MQTT_p12, 1, en_US]

² Select Pin for the Client Device Certificate.

The dialog to enter the password appears (no password change required).
² Enter and repeat the already defined pin/password for the MQTT and click confirm.

[sc_Password_Pin, 1, en_US]

² If a MQTT Commanding is needed, select yes under Enable MQTT Commanding.

36 SICAM A8000 Series, SIAPP Configuration, Manual

DC8-102-2, Edition 05.2023
 SIAPP Configuration
4.4 Uploading SIAPP Configuration to the Device

4.4 Uploading SIAPP Configuration to the Device

² Select Upload & Download on the homepage.

[sc_Start_Upload, 1, en_US]

² Log on to the device.

The dialog appears.

[sc_Upload_device, 1, en_US]

² Select Upload to device.

² Confirm the dialog to accept the changes and wait for the update to take place.
² Execute a selective restart.

NOTE

i • The online status is only visible in MindSphere.

• The data model is uploaded only once when SIAPP is first started. It is possible to add a signal (new
data point) to SIAPP. But all existing data points will not be updated, only the changed or new signals.

• To update the whole data model, a new device name with a new certificate is necessary.

SICAM A8000 Series, SIAPP Configuration, Manual 37

DC8-102-2, Edition 05.2023
38 SICAM A8000 Series, SIAPP Configuration, Manual
DC8-102-2, Edition 05.2023
Literature

/1/ SICAM A8000 Series CP-8031, CP-8050 Manual

DC8-025-2
/2/ SICAM Device Manager Manual
D51-007-1

SICAM A8000 Series, SIAPP Configuration, Manual 39

DC8-102-2, Edition 05.2023
40 SICAM A8000 Series, SIAPP Configuration, Manual
DC8-102-2, Edition 05.2023