Integration von Flexopus Home Assistant

Schaffen Sie ein intelligentes Büro, indem Sie IoT- und Smart-Home-Geräte über die Automatisierungsplattform Home Assistant mit Flexopus verbinden

Haftungsausschluss

Über Home Assistant

Home Assistant ist eine der beliebtesten Open-Source-Plattformen für die Heimautomatisierung. Sie unterstützt mehr als  2500 Platformen, darunter proprietäre Lösungen (Google Assistant, Google Cast, Apple HomeKit) sowie andere bekannte IoT-Protokolle (MQTT, Z-Wave, ZigBee, Matter). Zusätzlich zu den offiziellen Integrationen gibt es eine große Anzahl von Community-Integrationen, die von Heimautomatisierungs-Enthusiasten entwickelt und getestet wurden.

Obwohl der Hauptfokus von Home Assistant auf der Automatisierung von privaten Smart Homes liegt, finden wir, dass es eine ausgezeichnete Wahl für die Automatisierung von Büros ist. Die Stärke der Plattform liegt in der Verbindung eines breiten Spektrums von Smart-Home-Lösungen, sogar von Marken, die auf Büroumgebungen spezialisiert sind.

Home Assistant ist eine selbst gehostete Plattform und erfordert daher einige technische Kenntnisse zur Einrichtung und zum Betrieb. Bitte lesen Sie die Dokumentation unter  https://www.home-assistant.io/installation , um die verschiedenen Einrichtungsoptionen zu erkunden.

Die Flexopus Integration

Wir haben die Flexopus-Integration entwickelt, um grundlegende Belegungsinformationen über den Status von buchbaren Objekten an Ihren Standorten bereitzustellen. Über diese Konnektorschnittstelle kann sich Ihre Home Assistant-Instanz mit den Flexopus-Servern verbinden und diese in einem vordefinierten Intervall nach Informationen abfragen. Unsere Server antworten dann mit dem aktuellen und erwarteten Belegungsstatus der buchbaren Objekte.

Sobald Sie diese Verbindung hergestellt haben, können Sie Ihr Büro nach Belieben automatisieren. Einige Beispielszenarien:

1. Schalten Sie die Schreibtischlampe oder das Deckenlicht im Zimmer nur ein, wenn eine Buchung läuft oder ansteht.
2. Passen Sie die Raumtemperatur mit Ihrem intelligenten Thermostat entsprechend der Belegung des jeweiligen Bereichs an. Sie können viel Energie sparen, indem Sie leere Räume nicht aufheizen oder abkühlen.
3. Mit konfigurierbaren intelligenten Schlössern können Sie den Zugang zu den Räumen auf den Zeitraum der Buchungen beschränken.
4. Richten Sie Belegungsanzeigen ein (z. B. farbige LEDs), um den Status der einzelnen Schreibtische, Parkplätze oder sogar Sitzungsräume zu kennzeichnen.
5. Alarme automatisch aktivieren oder deaktivieren

Mit solchen Automatisierungen können Sie Flexopus nutzen, um Energie zu sparen und den täglichen Buchungsprozess zu erleichtern.

Installieren Sie die Integration

Voraussetzungen

Wir gehen davon aus, dass Sie über eine laufende Home Assistant-Instanz verfügen. Um loszulegen, können Sie der Anleitung unter https://www.home-assistant.io/installation, folgen, oder sich bei speziellen Fragen an die Community wenden.

Code

Der Code der Integration befindet sich unter https://github.com/flexopus/flexopus-hass-sensor.

Installation mit HACS (empfohlen)

Der Home Assistant Community Store (HACS, https://hacs.xyz)  ist der bequemste Weg, um individuelle Integrationen in Home Assistant zu installieren und zu aktualisieren.

1. Um HACS zu installieren, gehen Sie zu https://hacs.xyz/docs/setup/download, und wählen Sie die Installationsmethode, die Ihrer Home Assistant-Installation entspricht. Nach der Installation fügen Sie es als Integration hinzu: https://hacs.xyz/docs/configuration/basic.  Für die Konfiguration benötigen Sie ein GitHub-Konto.
2. Sobald Sie HACS installiert haben, navigieren Sie zu /hacs/entry
   

3. Klicken Sie auf die drei Punkte und wählen Sie Benutzerdefinierte Repositories, und fügen Sie das Flexopus GitHub Repository (https://github.com/flexopus/flexopus-hass-sensor) als Integration
   
   

4. Nach dem Hinzufügen suchen Sie in der Liste nach Flexopus
   
5. Wählen Sie es aus der Liste aus, klicken Sie auf Download, wählen Sie die Version und bestätigen Sie Download
   
6. Starten Sie Home Assistant neu

Manuelle Installation

1. Laden Sie die neueste Version des Codes aus dem Repository herunter: https://github.com/flexopus/flexopus-hass-sensor/releases/latest
2. Wechseln Sie in das Konfigurationsverzeichnis Ihres Home Assistant und erstellen Sie den Ordner custom_components, falls er noch nicht existiert
3. Extrahieren Sie den Code und kopieren Sie den Ordner custom_components/flexopus in den Ordner custom_components Ihrer Installation. Die resultierende Struktur sollte sein:

<home assistant root>
└─ config
   └─ custom_components
      ├─ flexopus
      └─ <other custom integration>

Starten Sie Ihren Home Assistant neu, nachdem Sie die obigen Schritte ausgeführt haben.

Konfigurieren Sie die Integration

Um Ihre Integration zu konfigurieren, benötigen Sie zwei Dinge:

1. Mieter-URL: die Domäne, die Sie für den Zugriff auf Flexopus verwenden  (https://mycompany.flexopus.com)
2. Zugriffstoken: das Token für den Zugriff auf die Flexopus-API. Um mehr zu erfahren, lesen Sie How can I use the Flexopus REST API?

Schritte:

1. Gehen sie zu Settings/Integrations, klicken Sie auf Add integration und suchen Sie Flexopus
   
2. Geben Sie Ihre Anmeldedaten ein
   
3. Sobald Sie sich authentifiziert haben, wird Flexopus auf Ihrer Integrations-Seite angezeigt. Wählen Sie es aus und klicken Sie auf Konfigurieren bei Ihrem neu erstellten Integrationseintrag. Wählen Sie die Standorte aus, die Sie abrufen möchten, und klicken Sie auf Senden.
   
4. Die Anwesenheitssensoren für jedes buchbare Objekt werden zu Ihrem Home Assistant hinzugefügt.
   

Nächste Schritte

Sie haben die Flexopus-Integration konfiguriert und werden weiterhin Updates von den ausgewählten Standorten erhalten. In einem nächsten Schritt können Sie Automatisierungen definieren, die bei jeder Änderung der Flexopus-Sensoren ausgelöst werden. Gehen Sie dazu zu Einstellungen/Automatisierungen & Szenen und klicken Sie auf Automatisierung erstellen. Sie können Ihre Automatisierung in der Benutzeroberfläche konfigurieren oder in den yaml-Modus wechseln. Eine Beispiel-Automatisierung kann wie folgt aussehen:

alias: Meeting 1
description: "Turn on lights for meeting room 1 when booked"
trigger:
  platform: state
  entity_id: sensor.ground_floor_meeting_1_occupancy
action:
  service: |
    
      light.turn_off
    
  target:
    entity_id: light.light_1

Um mehr über Automatisierungen zu erfahren, lesen Sie   https://www.home-assistant.io/docs/automation/basics. Wenn Sie viele Automatisierungen haben, die auf die gleiche Weise funktionieren, empfehlen wir Ihnen, eine Vorlage (einen sogenannten Blueprint) dafür zu konfigurieren: https://www.home-assistant.io/docs/blueprint/tutorial.

Die Möglichkeiten sind endlos. Schauen Sie sich die Dokumentation zum Home Assistant an, oder wenden Sie sich im Zweifelsfall an den Flexopus-Support.

R0102