Common Databus Payload Format

This tutorial explains the common databus payload format and shows an example how to create a custom connector out of it.

Common Databus Payload Format

Description

Overview

The Industrial Edge Common Databus Payload Format defines how connectors should publish data to the IE Databus via MQTT. Connectors that fulfill this specification can then reuse the existing functionality of Industrial Edge apps in the Industrial Edge Ecosystem.

The official documentation can be found here under chapter "General Common Payload Format":

Industrial Edge Common Databus Payload Format

General Task

The first section explains the structure of the Common Databus Payload Format. Here all possible operations and the dedicated topics are listed. Furthermore the responding messages are explained.

The second section shows an example of a custom connector using this format. Here we use a simple docker app "Custom Connector App", that acts as custom connector and provides some data. The data is published to the IE Databus via MQTT and can be then used by further apps. In this case we use the IE Flow Creator to read out the data and write some data back to the custom connector.

Requirements

Prerequisites

Access to an Industrial Edge Management (IEM)
Onboarded Industial Edge Device (IED) on IEM
IEM: Installed system configurator for Databus
IED: Installed system app Databus
IED: Installed app Flow Creator
Linux VM with docker and docker-compose installed
Installed Industrial Edge App Publisher
HTML5-capable Internet browser (in general it is advised to use Chrome, for Linux based systems it is recommended to use Firefox)

Used components

Industrial Edge Management OS V1.5.2-4
- Databus Configurator V2.1.0-3
Industrial Edge Management App V1.13.10
- Databus V 2.1.0-4
- Flow Creator V1.15.0-2
Industrial Edge Device V 1.12.0-10
Industrial Edge App Publisher V1.11.5
Docker Engine V24.0.5
Docker Compose V1.29.2

Format of Common Databus Payload

You can find a detailed description of the Common Databus Payload Format here:

Custom connector

To successfully run the example app "Custom Connector App", you need to follow these steps:

Documentation

You can find further documentation and help in the following links:

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.

industrial-edge / common-databus-payload-format Goto Github PK