industrial-edge/profinet-io-connector-getting-started

​This example shows how to use the Industrial Edge App “PROFINET IO Connector”. This app implements a PROFINET Controller which cyclically reads the PN IO data of the configured PROFINET network.

PROFINET IO Connector Getting Started

This getting started shows how to use the Industrial Edge App “PROFINET IO Connector”.

• PROFINET IO Connector Getting Started
  • Description
    • Overview
    • General task
  • Requirements
    • Prerequisities
    • Used components
    • TIA Project
  • Configuration steps
  • Usage
  • Documentation
  • Contribution
  • Licence and Legal Information
  • Disclaimer

Description

Overview

This document describes how a PROFINET IO Controller which cyclically reads the PN IO data of the configured PROFINET network can be implemented.

General task

In this getting started the PN IO data of PROFINET network are cyclically read using the PROFINET IO Connector application. The data are published via the PROFINET IO Connector in binary data form or JSON data form on the IE databus. First, the PROFINET IO Connector must be configured in the Common Configurator application. The XML file exported from TIA Portal including the PROFINET configuration should be uploaded in this step. The IE Databus will transfer the data from the PROFINET IO Connector for further processing under the respective topic. This data can be further processed in the applicatios such as IIH Essentials or FlowCreator.

Requirements

Prerequisities

• Access to an Industrial Edge Management System (IEM)
• Onboarded Industial Edge Device (IED) on IEM
• Installed system configurator for Databus
• Installed system app Databus
• Installed apps Common Configurator, Registry service, PROFINET IO Connector and IIH Essetials
• IED is connected to PLC
• IED is in the same network as PLC (PLC is reachable from IED)
• The PROFINET Driver configured correctly in TIA Portal project
• TIA Portal project loaded on PLC (EdgeHowTos including the Tank application)
• Google Chrome (Version ≥ 72) or Firefox (Version ≥ 62)

Used components

• Industrial Edge Management (IEM) V1.5.2-4
• Industrial Edge Device (IED) IPC227E V1.12.0-10
• Common Configurator V1.8.1-1
• Registry Service V1.8.0-4
• PROFINET IO Connector 2.1.0-4
• IIH Essentials V1.8.1
• TIA Portal V18
• S7-1515-2 PN
• Web browser (Google Chrome)

TIA Project

The used TIA Portal project can be found in the miscellenous repository. This project is also used for several further application examples. It is preferred to configure the PROFINET Driver from scratch to be aware of configuration. In case of some issues in the TIA Portal, the same project where the mentioned configuration is already done can be found in the src directory under the following name:

• EdgeHowTos.7z.

Configuration steps

• Configure IED Layer 2 access
• Configure Databus
• Configure PROFINET Driver in TIA Portal
• Configure PROFINET IO Connector in Common Configurator

You can find the further information about the following steps in the Installation.

Usage

Once the PROFINET IO Connector application is configured, the data can be read from the PLC in binary or JSON form and made available for further processing in the IIH Essentials or in the Flow Creator application.

Documentation

You can find further documentation and help in the following links

• PROFINET IO Connector documentation
• Industrial Edge Hub
• Industrial Edge Forum
• Industrial Edge landing page

Contribution

Thank you for your interest in contributing. Anybody is free to report bugs, unclear documentation, and other problems regarding this repository in the Issues section. Additionally everybody is free to propose any changes to this repository using Pull Requests.

If you haven't previously signed the Siemens Contributor License Agreement (CLA), the system will automatically prompt you to do so when you submit your Pull Request. This can be conveniently done through the CLA Assistant's online platform. Once the CLA is signed, your Pull Request will automatically be cleared and made ready for merging if all other test stages succeed.

License and Legal Information

Please read the Legal information.

Disclaimer

IMPORTANT - PLEASE READ CAREFULLY:

This documentation describes how you can download and set up containers which consist of or contain third-party software. By following this documentation you agree that using such third-party software is done at your own discretion and risk. No advice or information, whether oral or written, obtained by you from us or from this documentation shall create any warranty for the third-party software. Additionally, by following these descriptions or using the contents of this documentation, you agree that you are responsible for complying with all third party licenses applicable to such third-party software. All product names, logos, and brands are property of their respective owners. All third-party company, product and service names used in this documentation are for identification purposes only. Use of these names, logos, and brands does not imply endorsement.

profinet-io-connector-getting-started's Issues

Overview Picture misleading

The Overview picture should only show what is really part of the getting started.
From the picture it looks like data is subscribed by the Flow Creator as well as displayed in Performance insight.
Having a quick at the getting started none of both apps are part of the getting started, this will confuse the user working with the getting started.
Either change the overview picture or add the parts to the getting started.
You could e.g. also link to the Performance Insight Getting Started for further steps after Data-Service was initiliized

Adapt link to the tank application

Adapt link to the tank application, since the old file tia-tank-application.7z is not available any more.
Better refer to the miscellaneous/tank application folder and not directly to the file.