Connectivity

Overview

Everything you need to know about building and deploying device connectors.

New systems can be added by deploying connectors for these systems. If the systems already ship with a SiLA 2 interface natively, only a UniteLabs edge gateway is required. If the system does not have a standardised interface, a new connector must be created.

The Cloud Connector and the Edge Gateway require the connection details of the tenant's cloud endpoint to establish a connection with their respective UniteLabs instance. Ask your system administrator or reach out to UniteLabs customer service. For further information on the deployment process please refer to the deployment guide.

Tenant Cloud Endpoint UUID: A standardised Universally Unique IDentifier with consisting of 32 characters separated by hyphens. An example UniteLabs Tenant Cloud Endpoint ID can look like this: 00000000-0000-0000-0000-000000000000. Note: This is not the same as the Tenant UUID!

Connector Development

Connectors distributed by UniteLabs are either a docker image or a Python application. Connectors distributed by UniteLabs will have detailed information regarding deployment in their respective documentation.

New Connectors can be developed either with our open-source UniteLabs Connector Framework (Python) that is based on the SiLA 2 standard or any other SiLA 2 reference implementation. Development is performed by UniteLabs but can also be done by any third party or internally. We gather standard-compliant connectors on our UniteHub.

For new developments, we recommend using our Connector Framework (Python, SiLA 2 1.1).

Other basic SiLA 2 frameworks include:

Connector Development Kit (CDK)

You can find the source code in the UniteLabs Connector Development Kit repository. The documentation includes a step-by-step tutorial on how to develop a connector based on the Connector Starter example project.

SiLA Browser

The open-source UniteLabs SiLA Browser is a lightweight web application that can be used to auto-discover and test SiLA-compliant servers in the local network. Once a connection is established, the server can be tested interactively. The SiLA Browser repository contains detailed documentation on the installation procedure including a user manual.

SiLA Python

This SiLA 2 Python repository is an un-opinionated SiLA 2 library written in Python. It is a core dependency of the Connector Framework. Usage of the Connector Framework does not require familiarity with the SiLA Python implementation. Taking a deep-dive into this repository is only recommended for advanced connector developers.

SiLA JS

This SiLA 2 JS repository is an un-opinionated SiLA 2 library written in JavaScript. This is one of our developer libraries that only implements the client side of the SiLA communication. SiLA JS has not been released yet.

We are working towards a comprehensive Connector Development Kit (CDK) that includes many more tools for e.g. a SiLA XML to SiLA Python converter, a library of feature templates, a Python implementation of OPC-UA LADS, a data model builder for OPC-UA servers, an in-built OPC-UA universal client.

Copyright © 2024