Weitere Integrationen
Yggio integriert mit mehr Systemen, als eine eigene Seite haben. Diese hier sammelt den Rest: was jede hereinholt oder hinausschickt, und wo sie eingerichtet wird. Keine davon braucht eine eigene Seite, aber zu wissen, dass es sie gibt, erspart es, etwas nachzubauen, das bereits da ist.
Sie zerfallen nach Richtung in zwei Gruppen, und die Richtung ist das Erste, was man über eine Integration klären sollte, denn wenige gehen in beide Richtungen. Delta Controls und Siemens Desigo CC stehen in beiden Listen, und das ist nicht dieselbe Integration doppelt gezählt: aus einem System zu lesen und in es zurückzuschreiben wird getrennt eingerichtet, und das eine zu haben gibt Ihnen nicht das andere.
Herein
Diese legen in Yggio Geräte aus dem System oder Dienst eines anderen an. Die meisten sind älter als die Connector-Auswahl und werden über New Device in der Geräteliste angelegt statt unter Connectors.
| Integration | Was sie hereinholt | Angelegt über |
|---|---|---|
| Celsiview | Sensordaten aus dem Celsiview-Portal, meist NB-IoT-Geräte | New Device |
| Klimator RSI | Straßenwetterdaten von Klimators Straßenwetterstationen, über deren RSI-Portal | New Device |
| Delta Controls | Eine Gebäudeleittechnik, über die EnteliWeb-REST-API | New Device |
| Siemens Desigo CC | Eine Gebäudeleittechnik | New Device |
| The Things Network | Der LoRaWAN-Network-Server TTN | New Device |
| BLE Dusoniot | BLE-Gateways von Dusoniot | New Device |
| Open Weather Map | Wetter und Vorhersage für einen Breiten- und Längengrad, als Wettergerät | New Device |
| Elvaco CMe | Zählerstände über HTTP von einem M-Bus-Gateway, Berichtsvorlage 3108 | Konfiguration des Gateways |
| BACnet IP | Technik in einem BACnet-Netz, direkt erreicht | Support kontaktieren |
| Modbus TCP | Technik in einem Modbus-Netz, direkt erreicht | Support kontaktieren |
Die letzten beiden brauchen direkten Netzzugang, deshalb schaltet der Support sie frei und nicht die Auswahl. Zu BACnet und Modbus siehe Gebäudeautomation, wo die vier Wege in ein Gebäude stehen und wann es richtig ist, die Technik direkt zu erreichen.
Elvaco CMe
Ein Elvaco-CMe-Gateway liest die Zähler an seinem M-Bus und schickt sie nach Zeitplan an Yggio. Auf der Yggio-Seite wird außer einem Benutzerkonto nichts konfiguriert: das Gateway hält die gesamte Konfiguration, und Yggio fragt es nie ab.
Diese Integration ist älter als das Connector-Muster und folgt ihm nicht. Es gibt keinen Connector anzulegen und keinen Translator zuzuweisen, das Gateway meldet sich mit Benutzername und Passwort eines Yggio-Benutzers an statt mit einem Credential Set, und die Nutzlast ist CSV statt JSON. So arbeitet sie heute, folgen Sie also den Schritten unten und nicht dem Muster, das sonst in diesem Abschnitt gilt.
Die Einrichtung
- Legen Sie einen Yggio-Benutzer für diese Integration an und für sonst nichts. Das Gateway meldet sich als dieser Benutzer an, und jedes Gerät, das es anlegt, gehört diesem Benutzer. Ein eigenes Konto hält die Zähler aus dem Bestand einer Person heraus und lässt die Zugangsdaten für sich widerrufen.
- Setzen Sie in der Berichtskonfiguration des CMe die URL auf
https://<Ihr Yggio>/http-push/elvaco, Benutzername und Passwort auf die dieses Yggio-Benutzers und die Berichtsvorlage auf 3108. - Stellen Sie das Berichtsintervall am Gateway ein. Was es sendet, nimmt Yggio entgegen.
Was ankommt
Vorlage 3108 erzeugt eine semikolongetrennte CSV, deren Kopfzeile mit #serial-number beginnt. Yggio
liest sie und legt ein Gerät je Zähler an oder aktualisiert es, ein Gateway mit sechzig Zählern
ergibt also sechzig Yggio-Geräte und nicht ein Gerät mit sechzig Feldern.
- Zeilen werden über device-identification einem Gerät zugeordnet. Das ist es, was den zweiten Bericht das Gerät des ersten aktualisieren lässt, statt ein weiteres anzulegen.
- Ein so angelegtes Gerät heißt
Elvaco-<device-identification>. - Jede Spalte des Berichts wird zu einem Feld am Gerät, was die Vorlage also mitbringt - Volumen, Energie, Durchfluss, Temperatur - kommt benannt an und ist in Ansichten, Regeln und Berichten nutzbar.
createdwird zum Zeitstempel des Messwerts.reportedAtist der Empfang durch Yggio.- Dezimalkommas werden umgesetzt,
12,345kommt also als Zahl 12.345 an.
Zeilen ohne #serial-number oder ohne device-identification werden verworfen und protokolliert.
Fehlen Zähler in Yggio, ist das das Erste, was zu prüfen ist.
Wenn ein Bericht nicht ankommt
| Antwort | Bedeutung |
|---|---|
| 200 | Angenommen |
| 401 | Benutzername oder Passwort ist falsch |
| 400 | Der Upload war nicht als die erwartete CSV lesbar, meist die falsche Berichtsvorlage |
| 500 | Authentifiziert und gelesen, aber das Speichern der Geräte schlug fehl |
Hinaus
Diese sind Channels, keine Connectors. Ein Channel wird auf einem Gerät angelegt und veröffentlicht dessen Daten an ein externes System, sobald sie sich ändern.
Ein Channel braucht in der Regel einen Connector dahinter, und mit der Zeit werden es alle. Sehen Sie einen Connector als Teil der Einrichtung eines Channels, nicht als Alternative dazu.
| Channel | Schreibt nach |
|---|---|
| Azure IoT Hub | Einen Azure IoT Hub, über einen Connection String |
| Siemens Desigo CC | Siemens Desigo CC |
| Delta Controls | Delta Controls |
| Vyer | Vyer |
| HTTP | Jede URL, die Sie angeben, also der Webhook-Fall |
| MQTT | Yggios eigenen Broker |
Manche der benannten brauchen zusätzlich ein Feld-Mapping, denn das empfangende System hat eigene Feldnamen. Channels werden je Gerät unter Channels angelegt, oder für viele Geräte auf einmal mit Mehrere auswählen.
Wenn das Gesuchte nicht dabei ist
Diese Seite ist nicht die vollständige Liste und soll es auch nicht sein. Yggio trägt eine Reihe kundenspezifischer Integrationen, die nicht öffentlich dokumentiert sind, weil sie für die Systeme einer einzelnen Organisation gebaut wurden und für alle anderen nichts bedeuten würden. Es gibt außerdem Connectors, die nicht in der Auswahl stehen, und es kommen mit der Zeit weitere dazu.
Dass ein System hier fehlt, sagt also nichts darüber aus, ob Yggio sich damit integrieren kann. Fragen Sie Ihren Support-Kontakt, bevor Sie annehmen, eine Integration müsse von Grund auf gebaut werden.
Verwandt
- Connectors - die vollständige Liste der Connector-Typen
- Channels - wie ein Channel auf einem Gerät angelegt wird
- Gebäudeautomation - BACnet, Modbus und die GLT-Integrationen im Zusammenhang