OpenBOS
Die OpenBOS-App ermöglicht die Integration und Synchronisation zwischen Eliona und ABB Ability™ Building Edge (unter Verwendung der OpenBOS-Software).
Übersicht
Diese Anleitung bietet Anweisungen zur Konfiguration, Installation und Nutzung der OpenBOS-App zur Verwaltung von Ressourcen und Synchronisation von Daten zwischen Eliona und OpenBOS Edge.
Erforderliche Schritte in OpenBOS Building Edge
Die vollständige Dokumentation zur Nutzung des Edge Editors, einem integrierten Tool des Building Edge zur Konfiguration, ist hier verfügbar. Im Folgenden wird sie als Edge Editor Doc bezeichnet, und der Inhalt entspricht der Revision G der englischen Version.
Topologie und Dienste
Die Gebäudedaten werden vom Building Edge erfasst, Assets zugeordnet und an die ABB Ability Cloud gesendet. Von dort werden die Assets über die Eliona-App abgerufen und automatisch erstellt.
Erstinstallation
Die folgenden Konfigurationen müssen während der Erstinstallation vorgenommen werden:
Lokale Konfiguration
Sobald das Building Edge eingeschaltet ist, kann darauf über einen Browser über LAN-Port 1 oder 2 zugegriffen werden.
Führen Sie die weiteren Schritte gemäß der Edge Editor Doc (Seiten 23–32) aus.
Cloud-Konfiguration
Damit das Edge mit der Cloud verbunden werden kann, muss es sich in einem Netzwerk mit Internetzugang befinden. Passen Sie die IP-Adresse entsprechend an (siehe Edge Editor Doc, Seite 43).
Um auf die ABB Cloud zuzugreifen, muss ein personalisierter Login erstellt werden. Danach folgen Sie den Schritten in der Edge Editor Doc (Seiten 33–40).
Allgemeine Einrichtung
Überprüfen Sie als Nächstes die allgemeinen Einstellungen und passen Sie sie gegebenenfalls an oder vervollständigen Sie sie gemäß Edge Editor Doc, Seiten 42–81.
Integration von Felddaten
Um Datenpunkte aus einem Bussystem abzurufen, muss unter „Field Network“ ein neues Netzwerk für das entsprechende Protokoll erstellt werden.
Die Ability Cloud ist erreichbar unter: https://buildings.ability.abb
Führen Sie die Schritte gemäß der Edge Editor Doc (Seiten 112–123) aus.
Hinzufügen von Geräten und Datenpunkten
Zum Hinzufügen von Geräten und Datenpunkten kann der CSV-Import genutzt werden. Es wird empfohlen, zunächst eine (leere) CSV-Datei zu exportieren und mit Daten zu füllen.
Zugriff über API erlauben
Damit Eliona Updates von Datenpunkten empfangen kann, muss jeder Datenpunkt für API-Abonnements konfiguriert werden:
In der Library/Asset-Vorlage:
Wählen Sie Ihr Asset aus.
Klicken Sie auf das Bearbeiten-Stiftsymbol.
Gehen Sie zu API-Abonnement.
Aktivieren Sie das gewünschte Abonnement.
Vergessen Sie nicht, auf Speichern zu klicken (oben rechts in der Leiste neben „API-Abonnement“).
Registrierung der App in OpenBOS
Um Eliona mit Ihrem OpenBOS Edge zu verbinden, muss das Edge so konfiguriert sein, dass API-Verbindungen erlaubt sind. Kontaktieren Sie den ABB-Support für weitere Informationen. Sie müssen die öffentliche API-URL von Eliona angeben:
https://{your-eliona-domain.io}/apps-public/open-bos.
Eliona benötigt die Gateway-ID, Client-ID und das Client-Secret zur Authentifizierung.
Installation
Installieren Sie die OpenBOS-App über den Eliona App Store.
Konfiguration
Die OpenBOS-App erfordert eine Konfiguration über die Eliona-Einstellungsoberfläche. Die folgenden Schritte sind zur Konfiguration der App erforderlich.
Konfiguration der OpenBOS-App
Konfigurationen können in Eliona unter Einstellungen > Apps > OpenBOS erstellt werden, wodurch das Generic Frontend der App geöffnet wird. Hier können Sie die \configs-Schnittstelle mit der POST-Methode nutzen. Jede Konfiguration erfordert die folgenden Daten:
gwid
Die ID des Gateway-Geräts, das in den API-Anfragen verwendet wird.
clientID
Die Client-ID für die OAuth 2.0-Authentifizierung.
clientSecret
Das Client-Secret für die OAuth 2.0-Authentifizierung.
appPublicAPIURL
URL der öffentlichen API dieser App. Wird automatisch aus der Anfrage abgeleitet. Beispiel: "https://{your-eliona-instance.io}/apps-public/open-bos".
enable
Flag zum Aktivieren oder Deaktivieren des Abrufs von dieser API. Standard: true.
refreshInterval
Intervall in Sekunden für das Abrufen von Daten von der API. Standard: 24.
requestTimeout
Timeout für API-Abfragen in Sekunden. Standard: 120.
active
Wird von der App auf true gesetzt, wenn sie läuft, und auf false, wenn sie gestoppt wird. Nur lesbar.
projectIDs
Liste der Eliona-Projekt-IDs für die Datenerfassung. Für jede Projekt-ID werden alle Smart Devices automatisch als Assets in Eliona erstellt, wobei die Zuordnungen in der OpenBOS-App gespeichert werden. Beispiel: ["42", "99"].
Beispiel einer vollständigen Konfigurationsdatei im JSON-Format:
Einige Felder haben Standardwerte, daher kann eine minimalistische Konfigurationsdatei so aussehen:
Kontinuierliche Asset-Erstellung
Nach der Konfiguration beginnt die App mit der kontinuierlichen Asset-Erstellung (CAC). Erkannte Ressourcen werden automatisch als Assets in Eliona erstellt, und der Benutzer, der die App konfiguriert hat, wird über das Eliona-Benachrichtigungssystem informiert.
Strukturierung der Assets
Nach der Erstellung werden die Assets in Eliona in derselben Struktur organisiert wie in OpenBOS. Diese Struktur bleibt synchronisiert, und Änderungen in Eliona (z. B. Umbenennen eines Assets oder Verschieben eines Raums in ein anderes Gebäude) werden bei der nächsten Ontologie-Aktualisierung überschrieben.
Die einzige Ausnahme sind die Root-Assets. Diese werden im obersten Verzeichnis erstellt und entsprechen der obersten Ebene der OpenBOS-Ortsstruktur. In der Regel gibt es eine „Site“ in dieser Rolle. Ein weiteres Root-Asset ist das "OpenBOS unassigned", das nicht zugewiesene Assets und Datenpunkte enthält.
Sie können die Root-Assets beliebig umbenennen oder verschieben, wobei die gesamte Ontologie mitbewegt wird.
Es ist nicht möglich, GAIs in Eliona für Assets zu ändern.
Asset-Filterung
Falls nicht alle Assets von OpenBOS nach Eliona importiert werden sollen, kann ein Asset-Filter definiert werden, um nur bestimmte Assets einzuschließen. Die App kann Assets nach ID, Name und TemplateID filtern (für Assets und Räume). Die Anleitung zur Filtererstellung finden Sie in der Asset-Filter-Dokumentation.
Asset-Typen
Asset-Typen werden automatisch aus den OpenBOS-Asset-Vorlagen erstellt und synchronisiert.
Asset-Typ
Asset-Vorlage
Attribut - Input
Datenpunkt mit Richtung "Feedback"
Attribut - Output
Datenpunkt mit Richtung "Command" oder "CommandAndFeedback"
Attribut - Info
Eigenschaft
Grenzwerte
Min/Max
Einheit
Einheit
Wertemapping
Enums
Komplexe Datentypen aus OpenBOS werden in separate Attribute in Eliona aufgeteilt.
Verwaiste Datenpunkte
Falls ein Asset in OpenBOS gelöscht wird, aber noch ein Alarm mit diesem Datenpunkt verknüpft ist, bleibt dieser Datenpunkt in der Ontologie erhalten. Eliona übernimmt dieses Verhalten und weist solche Datenpunkte dem "OpenBOS unassigned" Asset zu.
Alarme
In OpenBOS ausgelöste Alarme werden mit Eliona synchronisiert. Sie werden in Eliona als Alarmregeln des Typs "External" erstellt und durch Updates von OpenBOS gesteuert. Wenn ein Alarm in OpenBOS ausgelöst wird, erscheint er auch in Eliona und wird entsprechend entfernt, wenn er in OpenBOS endet.
Externe Alarme sind Alarme, die nicht von Eliona verwaltet werden. Alarmregeln werden angezeigt, sodass Benutzer sie taggen und kategorisieren können, aber Eliona ist nicht für die Überprüfung verantwortlich, ob ein Alarm ausgelöst werden soll. Ein externes System (in diesem Fall OpenBOS) ist für die Alarmsteuerung verantwortlich.
Falls ein Alarm eine Bestätigung erfordert, kann er in Eliona bestätigt werden, und diese Bestätigung wird mit OpenBOS synchronisiert.
Überwachung des App-Status
Zusammen mit der Asset-Erstellung wird auch ein Asset namens „OpenBOS app“ erstellt. Es dient dazu, die Benutzer über den Status der App zu informieren - es signalisiert, ob die App läuft (Asset-Status -> Aktiv/Inaktiv) und welchen Status sie hat - das Attribut Status. Wenn der App-Status nicht „OK“ ist, bedeutet dies, dass die App möglicherweise nicht richtig funktioniert. Wenn der Fehlerstatus weiterhin besteht, lassen Sie es uns wissen, indem Sie einen Fehlerbericht einreichen.
Last updated
Was this helpful?