Da ich sehr oft in der free@home Usergruppe gefragt wurde wie ich es realisiert habe Drittsystem in free@home zu integrieren, möchte ich euch am Beispiel "Netatmo" einmal zeigen, wie man sie reinbekommt und diese dann aussehen und benutzbar sind, als wenn sie free@home eigene Geräte wären.

Ich habe meine Aussenstation, Regenmesser und Windmesser von Netatmo auf eine virtuelle Wetterstation in free@home gelegt, um sie zum Großteil mit den gleichen Daten zu beschicken.

Voraussetzung für dieses Tutorial

• den IoT Hub aufgesetzt und am Laufen haben -> LINK
• einen free@home System Access Point 2.0
• die lokale API aktiviert -> Anleitung

Teil 1: Netatmo in Openhab einbinden

Ihr müsst als erstes Netatmo in Openhab online bringen. Ich binde alle Systeme erstmal in Openhab ein damit sie direkt harmonisiert sind. Wenn man Sie in NodeRed direkt einbindet muss man viel händisch transformieren

1. Unter https://dev.netatmo.com/myaccount/createanapp eine Application anlegen, Name beliebig
2. Openhab auf dem PI öffnen mit <IP des PI>:8080 in eurem Browser, dann auf PaperUI klicken
3. Dort unter Addons -> Bindings nach Netatmo suchen und das Binding installieren
4. Danach auf Inbox und dann auf das + klicken, dann auf Netatmo Binding und unten auf Add manually
5. Hier wählt ihr Netatmo API und füllt die Maske mit den Daten aus die ihr auf der Netatmo Seite bekommen habt. Bestätigen und Netatmo sollte als Online angezeigt werden.
6. Wenn ihr nun erneut die Inbox aufruft sollten alle eure Netatmo Module automatisch auftauchen und ihr könnt sie hinzufügen durch klicken auf +.
7. Als nächstes Geht ihr unter Configuration -> Things und sucht die Netatmo Things. Klickt diese an.
8. Verseht die Datenpunkte jeweils mit neu erstellten "Items" indem ihr auf das + bei add item klickt und dann auf "create new item"
9. Hier müsst ihr nichts ändern sondern nur von "Number: Temperaturen" auf "Number" umstellen und bestätigen indem ihr "Link" drückt.
   1. Hier sind wir erstmal fertig.

Teil 2: Virtuelle Wetterstation in free@home anlegen

1. Geht in eurem Browser auf <IP eures System Access Point>/swagger
2. Klickt auf Authorize und gebt die Zugangsdaten an, die ihr in der free@home next app unter "Einstellungen -> lokale API" seht. Bestätigt mit "Login" und schließt das Popup.
3. Klickt auf den Punkt "Create virtual device", drückt try out und füllt die Maske entsprechend dem Bild aus
4. In free@home sollte nun eine virtuelle Wetterstation auftauchen, die ihr wie gewohnt im Gebäudeplan platzieren könnt. Hier sind wir erstmal fertig!

Teil 3: Netatmo und free@home per NodeRED verknüpfen

1. Geht in eurem Browser auf <IP eures Raspberry>:1880, NodeRED öffnet sich
2. Ladet euch folgende Datei herunter, die den nötigen Flow enthält LINK
3. Geht oben rechts auf das Symbol mit den drei Strichen und drückt "Importieren"
4. Wähle die gerade runtergeladen Json aus und importier diese in den aktuellen Flow
5. Klicke alle grünen Knoten auf der linken Seite an und Wähle die entsprechenden Datenpunkte von Openhab aus der Liste aus
6. Klicke alle gelben Knoten auf der rechten Seite an und ergänze die IP deines System Access Point und die Seriennummer der virtuellen Wetterstation in Pfad. Die Seriennummer kannst du zB im Webinterface von free@home und Gerätekonfiguration sehen, sie beginnt mit 6000xxxxxx. Ergänze auch bei Basic Auth Username und Passwort. Diese entsprechen den Zugangsdaten aus der next app -> Einstellungen -> lokale API
7. Nun nur noch oben in der rechten Ecke auf Deploy drücken

FERTIG, ihr solltet nun eure Wetterstation mit Netatmo Daten in free@home sehen!