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.

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

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

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

Kanäle

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

• Schalter: Ein normaler Lichtschalter.

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

• HueActuator: Ein Kanal zur Steuerung farbiger Beleuchtung.

• RTC: Raumtemperaturregler.

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

• HeatingActuator: Heizungssteuergerät.

• WindowSensor: Sensor zur Erkennung der Fensterposition.

• DoorSensor: Sensor zur Erkennung der Türposition.

• MovementSensor: Sensor zur Erkennung von Bewegung.

• Szene: Repräsentiert eine Szene.

Konfiguration

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

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.