# Connectivity as a Service

## Über dieses Kapitel

Dieses Kapitel beschreibt, wie externe Geräte mit BuildingPro Suites verbunden und Daten dieser Geräte in BuildingPro Suites angezeigt werden.

## Vorgehensweise

### Übersicht

Der erste Schritt besteht darin, eine Kommunikationsverbindung zwischen BuildingPro Suites und den zu verbindenden Geräten herzustellen. In Abb. 1 ist dies Phase „B“.

Im zweiten Schritt müssen die eingehenden Rohdaten in der Regel dekodiert werden. Das liegt daran, dass externe Geräte ihre Daten (Payload) kodiert oder in einem anderen, nicht verwendbaren Format senden.

Im dritten Schritt werden die dekodierten Datenwerte schließlich den einzelnen [↗ Attributen](https://docs.buildings.ability.abb/collection/german/pflichtbasis/assets/attribute-functions) eines Assets über Formate zugeordnet.

Die letzten beiden Schritte erfolgen in Phase C.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FFnLBlo0MQ2EMuWCt0glL%2Farchitektur-eliona.jpg?alt=media&#x26;token=2592dcfa-1f51-4706-9e3e-d6f05a05c30e" alt=""><figcaption></figcaption></figure>

### Details

Abb. 1 zeigt den schematischen Datenfluss von einem externen Gerät zu BuildingPro Suites.

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FVQtGVRTs50wuvPIPPgi2%2FEliona%20Verbindungen%20Visualisierung.png?alt=media&#x26;token=6e17cabb-93b7-4fc5-9a92-e05248bebff3" alt=""><figcaption><p>Abb. 1 – Datenfluss von externen Geräten zu BuildingPro Suites.</p></figcaption></figure></div>

#### Phase A

Phase A findet vollständig außerhalb von BuildingPro Suites statt. In Phase A werden Rohdaten von einzelnen Geräten bereitgestellt und an einen Server oder Broker gesendet. Ein Beispiel für einen solchen Server ist [↗ TTN \[Externer Link\]](https://www.thethingsnetwork.org/)

Die Details, z. B. welches Übertragungsformat verwendet wird, unterscheiden sich je nach Hersteller und Gerät erheblich. Phase A ist kein Bestandteil von BuildingPro Suites und wird in dieser Dokumentation nicht näher erläutert. Weitere Informationen zu diesem Thema finden Sie in der Dokumentation der externen Geräte oder Server.

{% hint style="info" %}
Für die weiteren Schritte in diesem Dokument wird davon ausgegangen, dass Sie Zugriff auf korrekt konfigurierte externe Geräte und/oder Zugriff auf einen Server haben.
{% endhint %}

#### Phase B

In Phase B erfolgt die eigentliche Verbindung von BuildingPro Suites und den Gerätedaten. In dieser Phase wird eine Datenverbindung zwischen BuildingPro Suites und den externen Geräten hergestellt.

BuildingPro Suites unterstützt die folgenden Schnittstellen:

* [↗ MQTT](https://docs.buildings.ability.abb/collection/german/pflichtbasis/platform-core/connect-hub/connectivity-as-a-service/connect-devices-via-mqtt)
* [↗ Webhook](https://docs.buildings.ability.abb/collection/german/pflichtbasis/platform-core/connect-hub/connectivity-as-a-service/connect-devices-via-webhook)
* [↗ RESTful](https://docs.buildings.ability.abb/collection/german/pflichtbasis/platform-core/connect-hub/connectivity-as-a-service/connect-devices-via-restful/configure-restful-connection)
* [↗ Kafka](https://github.com/sasax7/gitbook/blob/main/connectivity-as-a-service/connect-devices-to-abb-buildingpro/...with-kafka)
* [↗ OPC UA](https://docs.buildings.ability.abb/collection/german/pflichtbasis/platform-core/connect-hub/connectivity-as-a-service/connect-devices-via-opc-ua)

Klicken Sie auf einen Link, um direkt zu den Anweisungen zu springen, die beschreiben, wie eine Datenverbindung über die entsprechende Schnittstelle hergestellt wird.

#### Phase C

In Phase C werden die Daten verarbeitet und innerhalb von BuildingPro Suites nutzbar gemacht.

* Die von den externen Geräten gesendeten und in BuildingPro Suites empfangenen Daten sind in den meisten Fällen nicht ohne Weiteres lesbar. Je nach Hersteller sind diese Rohdaten kodiert oder liegen in einem Format vor, das nicht weiterverwendet werden kann. Daher werden diese Rohdaten mit **↗ Funktionen** dekodiert und in ein menschenlesbares .json-Format konvertiert.
* Die dekodierten Daten werden den einzelnen Attributen eines Assets über **↗ Formate**.

## Voraussetzungen

Folgende Voraussetzungen müssen erfüllt sein, um externe Geräte zu verbinden:

#### Korrekt konfigurierte externe Geräte und Server

Die zu verbindenden Geräte müssen korrekt konfiguriert sein und Daten ordnungsgemäß senden.

Server und Broker müssen korrekt konfiguriert sein.

#### Vorhandene Zugangsdaten für Server, Broker und andere Dienste

Die Zugangsdaten für Server und Broker müssen bekannt sein.

#### Asset-Vorlagen

Es wird vorausgesetzt, dass Sie korrekte Asset-Vorlagen erstellt haben. Die Asset-Vorlage muss die erforderlichen Asset-Attribute haben

#### Assets

Assets müssen auf Grundlage der Asset-Vorlage erstellt werden.