ABB free@home
ABB Free@home
BuildingPro Suites-App für die ABB Free@home-Integration
Einfach smart. ABB-free@home® macht aus einem Haus oder einer Wohnung ein Smart Home. Ob Jalousien, Lichter, Heizung, Klimaanlage, Türkommunikation oder Szenen. Einfach per Schalter an der Wand, mit einem Laptop oder mit einem Smartphone steuerbar. Sehr praktisch. Äußerst komfortabel. Sehr energieeffizient. Besonders attraktiv: Die Kosten sind im Vergleich zu herkömmlichen Elektroinstallationen minimal.
Diese App ermöglicht den Zugriff auf ABB Free@home-Systeme direkt in BuildingPro Suites über das ABB ProService-Portal. Der Benutzer kann Werte überwachen, Statistiken durchsuchen, die Free@home-Geräte steuern und vor allem ABB-Geräte mit Systemen anderer Hersteller vernetzen.
Installation
Die ABB Free@home-App wird über den App Store in BuildingPro Suites installiert.
Assets
Die ABB Free@home-App erstellt selbstständig alle erforderlichen Assets und Asset-Typen.
Asset-Struktur
Die folgenden Asset-Typen werden nur erstellt, um in BuildingPro Suites eine Struktur zu erzeugen:
Etagen: Repräsentiert eine bestimmte Ebene in einem Gebäude.
ID
Stockwerkskennung
Name
Stockwerksname
Ebene
Stockwerksebene
Raum: Repräsentiert einen bestimmten Raum auf einer Etage.
ID
Raumkennung
Name
Raumname
System: Repräsentiert ein zentrales System, das mehrere Geräte steuert.
ID
System-ID
x
GAI
GAI
x
Name
Systemname
x
Gerät: Repräsentiert ein bestimmtes Gerät im System. Geräte sind in den Asset-Baum von BuildingPro Suites mit ihren jeweiligen Systemen und Standorten verknüpft.
ID
Gerätekennung
x
GAI
GAI
Name
Gerätename
x
Ort
Gerätestandort
Kanäle
Kanäle sind mit Geräten verknüpft. Diese Kanäle bieten die eigentliche Funktionalität:
Switch: Ein normaler Lichtschalter.
SwitchState
Schalterzustand
Eingabe
Switch
Switch
Ausgabe
Dimmer: Ein Kanal zur Steuerung der Lichtintensität.
SwitchState
Schalterzustand
Eingabe
DimmerState
Dimmer-Zustand
Eingabe
Switch
Switch
Ausgabe
Dimmer
Dimmer
Ausgabe
HueActuator: Ein Kanal zur Steuerung farbiger Beleuchtung.
SwitchState
Schalterzustand
Eingabe
DimmerState
Dimmer-Zustand
Eingabe
HSVState
HSV-Zustand
Eingabe
ColorModeState
Farbmodus-Status
Eingabe
ColorTemperatureState
Farbtemperatur-Status
Eingabe
Switch
Switch
Ausgabe
Dimmer
Dimmer
Ausgabe
HSVHue
HSV-Farbton
Ausgabe
HSVSaturation
HSV-Sättigung
Ausgabe
HSVValue
HSV-Wert
Ausgabe
ColorTemperature
Farbtemperatur
Ausgabe
RTC: Raumtemperaturregler.
SwitchState
Schalterzustand
Eingabe
CurrentTemp
Aktuelle Temperatur
Eingabe
SetTempState
Solltemperatur-Status
Eingabe
Switch
Switch
Ausgabe
SetTemp
Solltemperatur
Ausgabe
RadiatorThermostat: Thermostat für einen Heizkörper.
SwitchState
Schalterzustand
Eingabe
CurrentTemp
Aktuelle Temperatur
Eingabe
SetTempState
Solltemperatur-Status
Eingabe
StatusIndication
Statusanzeige
Eingabe
HeatingActive
Heizung aktiv
Eingabe
HeatingValue
Heizwert
Eingabe
Switch
Switch
Ausgabe
SetTemp
Solltemperatur
Ausgabe
HeatingActuator: Heizungssteuereinheit.
InfoFlow
Informationsfluss
Eingabe
ActuatorFlow
Aktuatorfluss
Eingabe
WindowSensor: Sensor zur Erkennung der Fensterposition.
Position
Position
Eingabe
DoorSensor: Sensor zur Erkennung der Türposition.
Position
Position
Eingabe
MovementSensor: Sensor zur Erkennung von Bewegung.
Bewegung
Bewegung
Eingabe
Scene: Repräsentiert eine Szene.
SwitchState
Schalterzustand
Eingabe
Konfiguration
Die ABB Free@home-App wird durch die Definition von einem oder mehreren Zugangsdaten konfiguriert. Für jede Konfiguration werden die folgenden Daten benötigt:
abbConnectionType
Verbindungstyp. Derzeit wird nur „ProService“ unterstützt.
apiKey
Von ABB bereitgestellter API-Schlüssel
orgUUID
UUID der ProService-Organisation
enable
Kennzeichen zum Aktivieren oder Deaktivieren des Abrufs über diese API
refreshInterval
Intervall in Sekunden für die Geräteerkennung. Dies ist eine aufwendige Operation und sollte nicht unter 3600 s liegen
requestTimeout
Zeitüberschreitung für die API-Abfrage in Sekunden
assetFilter
Filter für die Asset-Erstellung, weitere Details finden Sie in der README-Datei der App
tenantIDs
Liste der BuildingPro Suites-Mandanten-IDs, für die dieses Gerät Daten erfassen soll. Für jede Mandanten-ID werden in BuildingPro Suites automatisch alle Assets erstellt.
Die Konfiguration erfolgt über eine entsprechende JSON-Struktur. Beispielsweise kann die folgende JSON-Struktur verwendet werden, um einen Endpunkt für App-Berechtigungen zu definieren:
Konfigurationen können in BuildingPro Suites mit dieser Struktur unter Apps > ABB Free@home > Einstellungen. Wählen Sie dazu den Endpunkt /configs mit der POST-Methode aus.
Nach Abschluss der Konfiguration beginnt die App mit der fortlaufenden Erstellung der Assets. Wenn alle erkannten Geräte erstellt wurden, wird der Benutzer darüber über das Benachrichtigungssystem von BuildingPro Suites informiert.
Nach der Konfiguration
Nachdem die Anwendung konfiguriert wurde, sucht sie nach Systemen, die mit dem konfigurierten ProService-Konto verbunden sind. Auf all diesen Systemen wird automatisch ein Benutzer mit dem Namen „BuildingPro Suites_ProService“ erstellt, der später zur Steuerung der Geräte verwendet wird. Dieses Konto muss lokal auf diesen Systemen aktiviert werden.
Um das Konto zu aktivieren, melden Sie sich bei den SysAPs an, suchen Sie unter „Benutzereinstellungen“ nach einem Benutzer namens „BuildingPro Suites_ProService“. Aktivieren Sie diesen Benutzer und stellen Sie sicher, dass er über die richtigen Zugriffsrechte zur Steuerung der Geräte verfügt.
Fehlersuche
Fehlermeldung „Defektes Gerät“
Bei einigen Geräten gibt es einen Fehler, durch den das System das Gerät beim Schreiben von Datenpunkten als „defekt“ einstuft. Das System sendet dann keine Daten mehr an diese Geräte und macht sie unsteuerbar.
Die Geräte sind jedoch nicht defekt; der SysAP muss lediglich neu gestartet werden, und die Geräte reagieren wieder.
ABB ist sich dieses Fehlers bewusst und arbeitet an einer Lösung. Wenn dieses Problem wiederholt auftritt, lassen Sie es uns bitte wissen, damit wir es beheben können.
Fehlersuche mit GraphQL
ABB bietet eine GraphQL-Playground-Umgebung für seine Smart-Home-API an: https://apim.eu.mybuildings.abb.com/adtg-api/v1/graphiql
Sie können sich im Playground entweder mit Ihrem MyBuildings-Konto oder Ihrem ProService-Konto anmelden.
Um zu prüfen, welche Beziehung Sie zu den Systemen haben, können Sie diese Abfrage verwenden:
Bitte beachten Sie, dass ABB derzeit nicht empfiehlt, für die ProService- und MyBuildings-Portale dasselbe Benutzerkonto zu verwenden. Dies führt zu einigen Problemen, die umgangen werden können, aber nicht wünschenswert sind.
Anfragen optimieren
ABB hat eine Möglichkeit implementiert, den Ressourcenverbrauch durch den aktuellen Benutzer zu analysieren:
Wir haben große Anstrengungen unternommen, um den Ressourcenverbrauch zu reduzieren. Dennoch ist das Abfragen nach neuen Geräten durch die App ein sehr ressourcenintensiver Prozess, der bei Bedarf weiter optimiert werden kann.
Zuletzt aktualisiert
War das hilfreich?