Inhaltsverzeichnis
| Plugin-Daten | |
|---|---|
| Autor | Jörg Siedhof |
| Logo |  |
| Status | STABLE |
| Version | 0.0.1 |
| Min. LB Version | 1.0 |
| Release Download | https://github.com/joesie/Loxberry-Nibe-Uplink-Bridge/archive/0.0.1.zip |
| Beschreibung | Gateway für den Miniserver zu NibeUplink. Hiermit ist es möglich, relevante Werte der Anlage zu lesen und zu visualisieren. Auch das schreiben von Werten ist (Premium Zugang bei Nibe vorausgesetzt) möglich. |
| Sprachen | DE |
Nibe Uplink Bridge
Beschreibung
Das Plugin basiert auf dem Skript vom User f4ed7. Siehe auch Nibe Gateway.
Für die Funktion muss ein Zugang bei Nibe Uplink vorhanden sein. Die Wärmepumpemanlage muss über das Internet an die Nibe Cloud angebunden sein.
Für schreibenden Zugriff ist ein Premium Abo bei Nibe erforderlich.
Download
Das Plugin findet ihr auf GitHub unter: https://github.com/joesie/Loxberry-Nibe-Uplink-Bridge
Konfiguration
Die Einrichtung des Plugins erfolgt in 2 Schritten:
Einrichtung der Nibe Application
- Wenn du noch einen Nibe Uplink Account hast, erstelle einen auf https:%%//%%www.nibeuplink.com
- Log dich damit dann auf https://api.nibeuplink.com/Account/LogIn ein
- Erstelle eine neue Application auf https://api.nibeuplink.com/Applications/Create
Als Callback URL gibst du dabei die (lokale) Adresse zum Loxberry mit dem Plugin Pfad an ein (Beispiel http://loxberry.fritz.box/plugins/nibeuplink/)
PS: Die Uplink-API muss NICHT von außen darauf zugreifen können!
- Wenn Du die Application angelegt hast, kannst Du dir diese unter "MyApplication" anzeigen lassen.
Dies sollte dann folgendermaßen aussehen:
- Nun hast Du die Nibe Uplink konfiguriert.
Übernehmen der Nibe Applikationsinformationen in das Plugin
- Geh auf die Plugin Verwaltung und wähle dieses Plugin
- Aktuell bekommen wir die Meldung, dass wir nicht angemeldet sind. Das ist so korrekt. Nun auf Einstellungen klicken und die in der Nibe Application (siehe oben) eintragen.
Das sollte dann etwa so aussehen (mit korrekten Werten verseht sich ):
- Nun noch die Werte speichern und nun können wir wieder auf "Nibe API" klicken.
Nun folgen wir dem Link zu Nibe:
- Bestätigt dort das Recaptcha und klickt auf "accept".
- Nun werdet ihr zurück geleitet und könnt Euch die Statusseite anzeigen lassen. Wenn Ihr alles richtig gemacht habt, sollte es etwa so aussehen:
- Das Plugin ist vollständig eingerichtet und kann nun verwendet werden.
Funktion des Plugins
Das Plugin übernimmt die verschlüsselte Kommunikation und Authentifizierung zu NibeUplink. Über GET Parameter werden werden bestimmte "Categories" angesprochen. Das Plugin liefert als HTTP Response ein JSON mit den Werten von der Anlage. Diese können dann in den virtuellen Eingängen verwendet werden.
Nibe hat eine sehr gute, technische Dokumentation zur Verfügung gestellt.
Einrichtung in der Loxone Config Software
User f4ed7 hat auf der Seite Nibe Gateway die Einbindung sehr gut beschrieben und auch Templates für die Loxone Config bereit gestellt. Daher gehe ich an dieser Stelle nicht weiter darauf ein.
Roadmap
Das Plugin ist aktuell im experimentellen Status. Folgende Arbeiten stehen als nächstes an. Mitarbeit ist sehr gerne gesehen
- Die fest in die Templates kodierten Texte auslagern und entsprechend internationalisieren.
- Icon entwerfen (lassen)
- Die Einstellungsspeicherseite sollte verschwinden.
- Die Redirects zwischen dem Login und freiem Bereich sind nicht schön
- Die Konfig Datei wird aktuell bei einer Aktualisierung des Plugins überschrieben. Persönliche Einstellungen gehen dabei verloren
- Refactoring (ein paar Stellen kann man besser lösen)
Fragen stellen und Fehler melden
Bei Fragen, Hinweisen, Tipps und Tricks, schreibt mich einfach an. Könnt auch die im Plugin hinterlegte E-Mail Adresse verwenden.