ABB free@home

ABB Free@home

Eliona App für die ABB Free@home Integration

Einfach smart. ABB-free@home® verwandelt das Haus oder die Wohnung in ein intelligentes Zuhause. Ob Jalousien, Licht, Heizung, Klimatisierung, Türkommunikation oder Szenen. Einfach fernbedienbar über einen Schalter an der Wand, mit dem Laptop oder mit dem Smartphone. Sehr bequem. Äußerst komfortabel. Sehr energieeffizient. Besonders attraktiv: Im Vergleich zu herkömmlichen Elektroinstallationen fallen nur minimale Kosten an.

Diese App ermöglicht den Zugriff auf ABB Free@home Systeme direkt in Eliona über das ABB ProService Portal. Der Benutzer kann Werte überwachen, in Statistiken blättern, 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 Eliona installiert.

Assets

Die ABB Free@home App erstellt selbstständig alle nötigen Assets und Asset Typen.

Struktur Assets

Die folgenden Asset-Typen werden nur erstellt, um eine Struktur in Eliona zu erstellen:

• Stockwerk: Repräsentiert eine bestimmte Ebene in einem Gebäude.

Attribut	Beschreibung
Id	Stockwerk-Identifikator
Name	Stockwerk Name
Level	Stockwerk Level

• Raum: Repräsentiert einen bestimmten Raum auf einer Etage.

Attribut	Beschreibung
Id	Raum-Identifikator
Name	Raum-Name

• System: Repräsentiert ein zentrales System, das mehrere Geräte steuert.

Attribut	Beschreibung	Filterbar
ID	System ID	x
GAI	GAI	x
Name	System Name	x

• Gerät: Repräsentiert ein bestimmtes Gerät im System. Geräte sind mit ihren jeweiligen Systemen und Standorten im Eliona-Assetbaum verknüpft.

Attribut	Beschreibung	Filterbar
ID	Gerätekennzeichen	x
GAI	GAI
Name	Gerätename	x
Standort	Gerätestandort

Kanäle

Kanäle sind mit Geräten verknüpft. Diese Kanäle bieten die eigentliche Funktionalität:

• Schalter: Ein normaler Lichtschalter.

Attribut	Beschreibung	Subtyp
SwitchState	Schalterzustand	Eingabe
Switch	Schalter	Ausgabe

• Dimmer: Ein Kanal zur Steuerung der Beleuchtungsintensität.

Attribut	Beschreibung	Subtyp
SwitchState	Schaltzustand	Eingabe
DimmerState	Dimmer State	Eingabe
Switch	Schalter	Ausgabe
Dimmer	Dimmer	Ausgabe

• HueActuator: Ein Kanal zur Steuerung farbiger Beleuchtung.

Attribut	Beschreibung	Subtyp
SwitchState	Schaltzustand	Eingabe
DimmerState	Dimmerzustand	Eingabe
HSVState	HSV-Zustand	Eingabe
ColorModeState	Farbmodus-Status	Eingabe
ColorTemperatureState	Farbtemperaturstatus	Eingabe
Switch	Schalter	Ausgabe
Dimmer	Dimmer	Ausgabe
HSVHue	HSV-Farbton	Ausgabe
HSVSaturation	HSV-Sättigung	Ausgabe
HSVValue	HSV-Wert	Ausgabe
ColorTemperature	Farbtemperatur	Ausgabe

• RTC: Raumtemperaturregler.

Attribut	Beschreibung	Subtyp
SwitchState	Schaltzustand	Eingabe
CurrentTemp	Aktuelle Temperatur	Eingabe
SetTempState	Temperaturzustand einstellen	Eingabe
Switch	Schalter	Ausgabe
SetTemp	Temperatur einstellen	Ausgabe

• RadiatorThermostat: Thermostat für einen Heizkörper.

Attribut	Beschreibung	Subtyp
SwitchState	Schaltzustand	Eingabe
CurrentTemp	Aktuelle Temperatur	Eingabe
SetTempState	Temperaturzustand einstellen	Eingabe
StatusIndication	Status-Anzeige	Eingabe
HeatingActive	Heizung aktiv	Eingabe
HeatingValue	Heizwert	Eingabe
Switch	Schalter	Ausgabe
SetTemp	Temperatur einstellen	Ausgabe

• HeatingActuator: Heizungssteuergerät.

Attribut	Beschreibung	Untertyp
InfoFlow	Info Flow	Eingabe
ActuatorFlow	Actuator Flow	input

• WindowSensor: Sensor zur Erkennung der Fensterposition.

Attribut	Beschreibung	Subtyp
Position	Position	Eingabe

• DoorSensor: Sensor zur Erkennung der Türposition.

Attribut	Beschreibung	Subtyp
Position	Position	Eingabe

• MovementSensor: Sensor zur Erkennung von Bewegung.

Attribut	Beschreibung	Subtyp
Bewegung	Bewegung	Eingabe

• Szene: Repräsentiert eine Szene.

Attribut	Beschreibung	Subtyp
SwitchState	Schaltzustand	Eingabe

Konfiguration

Mehr Informationen zur Konfiguration von Apps finden Sie ↗ hier.

Die ABB Free@home App wird durch die Definition eines oder mehrerer Authentifizierungsnachweise konfiguriert. Für jede Konfiguration sind die folgenden Daten erforderlich:

Attribut	Beschreibung
abbConnectionType	Art der Verbindung. Derzeit wird nur „ProService“ unterstützt.
apiKey	Von ABB bereitgestellter API-Schlüssel
orgUUID	UUID der ProService-Organisation
enable	Flag zum Aktivieren oder Deaktivieren des Abrufs von dieser API
refreshInterval	Intervall in Sekunden für die Geräteerkennung. Dies ist eine teure Operation, die nicht unter 3600 s liegen sollte
requestTimeout	API-Abfrage-Timeout in Sekunden
assetFilter	Filter für die Asset-Erstellung, weitere Details können in der README der App gefunden werden
projectIDs	Liste der Eliona-Projekt-IDs, für die dieses Gerät Daten sammeln soll. Für jede Projekt-ID werden automatisch alle Assets in Eliona erstellt.

Die Konfiguration erfolgt über eine entsprechende JSON-Struktur. Als Beispiel kann die folgende JSON-Struktur verwendet werden, um einen Endpunkt für App-Berechtigungen zu definieren:

{
  „abbConnectionType“: „ProService“,
  „apiKey“: „api.key“,
  „orgUUID“: „org-uuid“,
  „enable“: wahr,
  „refreshInterval“: 3600,
  „requestTimeout“: 120,
  „assetFilter“: [],
  „projectIDs“: [
    „10“
  ]
}

Konfigurationen können mit dieser Struktur in Eliona unter Apps > ABB Free@home > Einstellungen erstellt werden. Wählen Sie dazu den Endpunkt /configs mit der Methode POST.

Nach Abschluss der Konfiguration startet die App die kontinuierliche Asset-Erstellung. Wenn alle erkannten Geräte erstellt sind, wird der Benutzer über das Benachrichtigungssystem von Eliona darüber informiert.

Nach der Konfiguration

Nachdem die Anwendung konfiguriert ist, sucht sie nach Systemen, die mit dem konfigurierten ProService-Konto verbunden sind. Auf all diesen Systemen wird automatisch ein Benutzer namens „eliona_ProService“ angelegt, der später bei der 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“ einen Benutzer namens „eliona_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 liegt ein Fehler vor, der dazu führt, dass das System das Gerät als „defekt“ einstuft, wenn es Datenpunkte schreibt. Das System sendet dann keine Daten mehr an diese Geräte und macht sie unkontrollierbar.

Die Geräte sind jedoch nicht defekt, der sysAP muss nur neu gestartet werden und die Geräte reagieren wieder.

ABB ist sich dieses Fehlers bewusst und arbeitet an einem Weg, ihn zu beheben. Wenn Sie wiederholt auf dieses Problem stoßen, teilen Sie uns dies bitte mit, damit wir es beheben können.

Fehlersuche mit GraphQL

ABB hat einen GraphQL-Spielplatz für seine Smart Home API: https://apim.eu.mybuildings.abb.com/adtg-api/v1/graphiql

Sie können sich entweder mit Ihrem MyBuildings-Konto oder mit Ihrem ProService-Konto in die Spielwiese einloggen.

{
  PSOrganization{dtId} # sollte für einen normalen Benutzer nicht funktionieren
}
{
  User{userName} # sollte den Benutzernamen des Benutzers zurückgeben, der das Token erstellt hat
}

Um zu überprüfen, welche Beziehung Sie zu den Systemen haben, können Sie diese Abfrage verwenden:

{
  UserDevice {dtId} #die dtId sollte hier erscheinen - für den Fall, dass der Benutzer der Besitzer des sysap ist
  CustomerDevice {dtId} #die dtId sollte hier erscheinen - für den Fall, dass der Benutzer der Installateur ist, der den Benutzer als Kunden eingeladen hat
}

Bitte beachten Sie, dass ABB derzeit nicht empfiehlt, dasselbe Benutzerkonto für ProService- und MyBuildings-Portale zu verwenden. Dies führt zu einigen Problemen, die umgangen werden können, aber nicht erwünscht sind.

Optimierung von Anfragen

ABB hat eine Möglichkeit implementiert, die Ressourcennutzung durch den aktuellen Benutzer zu analysieren:

{
  ServerDescriptionService
  {
    consumedRequestCosts # gibt die Summe der von diesem Benutzer verursachten Kosten zurück (sollte in der Nacht auf 0 zurückgesetzt werden)
    requestCosts # gibt die Kosten durch diese Abfrage zurück (in Ihrem Fall hauptsächlich betroffen durch 1 pro geladenem Objekt + 1 pro DataPointRequest)
  }
# ... füge hier den Rest/die normale Abfrage hinzu
}

Wir haben uns viel Mühe gegeben, den Ressourcenverbrauch zu senken. Dennoch ist die Abfrage der App nach neuen Geräten ein sehr ressourcenintensiver Prozess, der weiter optimiert werden kann, wenn Bedarf dafür besteht.