Configuration Manual

How to Connect dataFEED OPC Suite to Azure IoT Hub

Configuration Manual

How to Connnect dataFEED OPC Suite to Azure IoT Hub1. Download Device ExplorerIf not available yet, download latest Device Explorer version from• https://github.com/Azure/azure-iot-sdk-csharp/releases

2. Connect Device Explorer to Azure IoT HubIn Azure IoT Hub:

• Search for IoT Hub

• Select IoT Hub to be connected or create a new one

Configuration Manual

• Select Shared access policies Settings

• Select iothubowner Policy• Copy Connection string - primary key

Configuration Manual

In Device Explorer:

• Paste connection string to IoT Hub Connection String field• Press Update button

3. Create MQTT Connection in Azure IoT HubIn Azure IoT Hub:

• Select IoT devices policies Explorers• Click Add link

Configuration Manual

• Define unique Device ID (23 characters maximum)• Do not modify default settings for rest of the fields• Press Save button

In Device Explorer:

• Select Management tab• Select IoT Hub device• Press SAS Token... button

Configuration Manual

• Define SAS duration in TTL (Days) (e.g. to 365 days)• Copy generated SAS token string for later use• Press Generate button

4. Connect dataFEED OPC Suite to Azure IoT Hub• Start dataFEED OPC Suite configuration• Select Data Destination / MQTT Broker• Add MQTT Broker connection

• Enter connection name in Connection name field• Enter device ID of created Azure IoT Hub device in Client ID field• Press Next button

Configuration Manual

• Set MQTT Broker URI to ssl://<IoT Hub Name>.azure-devices.net:8883• Set User Identity in Authentication Settings to User name and password• Set User Name in Authentication Settings to IoT Hub Name>.azure-devices.net/<DeviceID• Set Password in Authentication Settings to part of generated SAS Token after SharedAccessSignature=

string (e.g. string beginning with SharedAccessSignature sr=Softing-IoT-Hub-SalesDemo.azure-devices.net)

• Press Connection Test button to verify connection• Press Next button

Configuration Manual

• Define devices / <Device ID> / messages / events hierarchy• Add topics for data to be sent below• Select topic and press Properties button

Configuration Manual

• Define Publish Format• Press OK button

• Press Next button at MQTT Topic definition page

Configuration Manual

• Select Enable Last Will and Testament checkbox, if required• Enter devices/<Device ID>/messages/events/state in Fully hierarchical topic name field• Select Retain checkbox• Leave Disconnected in Message field• Press Finish button

Configuration Manual

5. Configure Data Exchange• Select Data Processing / Exchange in dataFEED OPC Suite configuration

• Select individual data source item to be sent in Local Namespace - Source Items section• Select individual MQTT item to be used for data exchange in Local Namespace - Destination Items

section• Click Create Exchange Action button for each individual data exchange item pair

Configuration Manual

6. Test MQTT Connection and Data Exchange• Start dataFEED OPC Suite application

MQTT messages then are sent to Azure IoT Hub

In Azure IoT Hub:

• Select Overview page

In Device Explorer:

• Monitor received data after connecting to IoT Hub

Configuration Manual

Technical changes reserved © Softing Industrial Automation GmbH, dataFEEDOPCSuite_MicrosoftAzure_C_EN_190501_100, May 2019

Softing Industrial Automation GmbHRichard-Reitzner-Allee 685540 Haar / GermanyPhone: +49 89 456 56 -113Fax: +49 89 456 56 -606info.idi@softing.com https://data-intelligence.softing.com