OilFox 2 in ioBroker integrieren
In diesem Artikel zeige ich Dir die Integration von OilFox in ioBroker.
OilFox 2 (nachfolgend nur OilFox genannt) ist der innovative Füllstandmesser für Deinen Heizöltank. Der OilFox Füllstandmesser misst per Ultraschall den Füllstand des Heizöltanks und übermittelt die Daten per WLAN oder mobile Connect (mobile Datenverbindung) an den OilFox-Server. Mit der kostenlosen OilFox-App siehst Du dann den aktuellen Füllstand sowie Verbrauchswerte und Prognoserechnungen. Im vorherigen Artikel habe ich Dir bereits den OilFox genauer vorgestellt. In diesem Artikel werden wir nun den Füllstandsensor in ioBroker integrieren.
Im ersten Schritt wechseln wir nun in ioBroker in den Bereich Adapter und suchen hier in der Adapterliste nach „oilfox“. Über die Plus-Schaltfläche können wir den Adapter dann zu unseren Instanzen hinzufügen.
Nach der Installation wird direkt die Konfiguration des Adapters gestartet. In den Haupteinstellungen müssen wir nur die in OilFox hinterlegte E-Mail-Adresse sowie das selber festgelegte Passwort eingeben. Nach dem Speichern wird der Adapter direkt gestartet.
Im nächsten Schritt wechseln wir dann in die ioBroker Objekte. Je nach CronJob-Einstellung kann das Laden der Daten hier einige Stunden dauern. Ich habe daher die CronJob-Einstellungen daher temporär auf alle 10 Minuten geändert. Bitte ändere diese Einstellung danach wieder, da nur ein täglicher Datenabgleich wirklich sinnvoll ist.
Die einzelnen Datenpunkte findest Du nun im Bereich „oilfox.0“. Solltest Du mehrere OilFox-Sensoren verbaut haben, tauchen hier nun unter dem Bereich devices mehrere Sensoren auf. In meinem Fall ist nur ein Sensor verbaut. Im Ordner „metering“ findest Du dann die ermittelten Liter- und Prozentangaben Deines Tanks. Zudem stehen, wie im folgenden Screenshot gezeigt, noch weitere Informationen des OilFox zur Verfügung. Der Adapter zeigt Dir hier nur den aktuellen Stand an, Auswertungen über Verbräuche müssen hier selber ermittelt werden.
Ich habe im ersten Schritt nur den Datenpunkt metering.liters zum History-Adapter hinzugefügt, so kann ich mir später den Verlauf des Füllstands ansehen. Alternativ werden wir uns in einem späteren Artikel auch noch den Adapter sourceanalytix genauer ansehen.
Für die Visualisierung habe ich nun noch den Adapter „Plumb Style Widgets“ installiert. In diesem Adapter sind einige sinnvolle Widgets zur Visualisierung von Heizungen (Pumpen, Tank, Leitungsbau, etc.) enthalten.
In meiner Visualisierung habe ich dann das Tank-Widget eingefügt. Für die bessere Anzeige habe ich dann noch die Prozent-Angabe sowie die Liter-Angabe hinzugefügt.
In der Konfiguration des Widgets habe ich den Datenpunkt „fillingPercentage“ als Object-ID des Tank-Widgets verwendet. zudem muss noch der Wert min auf 0 und der Wert max auf 100 gesetzt werden. Als Farbe habe ich dann noch für oben und unten einen roten Farbton gewählt. Die weiteren Informationen (Füllstand in Prozent sowie Liter-Angabe) habe ich einfach als Basic-Number Widget über das Tank-Widget gelegt.
Für die Visualisierung des aktuellen Stands verwende ich aktuell den Datenpunkt „serverDate“. Über das Basic Timestamp Widget habe ich dann noch das Datumsformat auf „DD.MM.YYYY hh:mm:ss“ gesetzt.
Ich hoffe ich konnte Dir damit weiterhelfen und freue mich wie immer über Deine Fragen, Anregungen oder Kommentare zum Thema 🙂
Wäre es möglich hierfür den export des Widgets und der Bilder anzubieten?
Hallo
Super Anleitung
Jedoch will es nicht klappen
Habe mich genau an deine Bauanleitung oder Installation gehalten aber ich bekomme immer Error 401 bei iobroker im state ….was mach ich falsch ?
Danke
Hallo Markus,
versuche mal bitte die neueste Version von OilFox von GitHub zu installieren.
LG Matthias
Hab alles so gemacht, bekomme aber immer noch nur Fehler.
Hab die neuste ver. 2.1.0 inst.
Hast du da noch eine Idee
Wer sehr Dankbar dafür
Hallo Thomas,
dann poste doch mal hier die Fehler, evtl. kann ich Dir dann weiterhelfen 🙂
LG Matthias
Hallo erstmal
Die Fehler
oilfox.0 2021-03-05 00:59:00.732 error at processTicksAndRejections (internal/process/task_queues.js:84:21)
oilfox.0 2021-03-05 00:59:00.732 error at endReadableNT (_stream_readable.js:1241:12)
oilfox.0 2021-03-05 00:59:00.732 error at IncomingMessage.emit (events.js:326:22)
oilfox.0 2021-03-05 00:59:00.732 error at IncomingMessage. (/opt/iobroker/node_modules/iobroker.oilfox/main.js:75:31)
oilfox.0 2021-03-05 00:59:00.732 error at JSON.parse ()
oilfox.0 2021-03-05 00:59:00.732 error (1941) SyntaxError: Unexpected token < in JSON at position 0
oilfox.0 2021-03-05 00:59:00.731 error (1941) uncaught exception: Unexpected token < in JSON at position 0
Sorry das es so lange gedauert hat, hoffe es hilft !!!
Hallo Nochmal !!!
Kannst du damit was anfangen….
oder stelle ich mich zu dumm an.
Gruß
Moin Thomas,
die Fehler haben mir leider nichts gesagt, poste den Fehler als Issue mal auf Github im Adapter Repository:
https://github.com/iobroker-community-adapters/ioBroker.oilfox/issues
LG Matthias
Das Problem liegt bei dem Anbieter der API. Er verändert und verhindert regelmässig alle public Zugriffe zu seiner API und hüllt sich in Schweigen über die Hintergründe. B2C, also Dienst an uns „normalen Kunden“ interessiert die Firma iVis (die jetzt Fox-Insights heisst und sich eine .ai Domain gesichert hat) nicht. Irgend etwas seltsames führt der Laden im Schilde, was mit einem besonderen Abrechnungs-System zu tun haben könnte. Man darf auch nicht unterschätzen, dass dieser Anbieter den Oilfox 2 ja eher so nebenbei an Default Consumer ausgibt und (so vermute ich nach eigener Recherche) sein Geld mit Industrieanlagen und Messwerten und Datenanalyse verdient. Vielleicht dürfen wir darum nicht an die eigenen Daten unserer geringfügig interessanten Tankinhalte kommen!? Stöbert man noch bissl rum, ist die API von denen wohl zum heutigen Stand mindestens auf v4.2 … Nicht „soooo“ üblich. Zwar auch nicht schlimm, aber es lässt sich eben keine API Reference auffinden, mit welcher man das ioBroker.oilfox verbessern und anpassen könnte.
So schade. Ich möchte doch nur wissen, wieviel cm/% ich in meinem popligen Tank habe.
Andere Idee: Hat schon jemand herausfinden können, welches Steuersignal die iOS App an den Hersteller abfeuert, wenn man „Verbrauchsdaten Herunteladen“ anklickt und darauf hin (wie in den 1990ern programmiert) eine eMail mit CSV nach Hause kommt? Dann braucht man das ja nur in einen Script-Workflow zu packen, der dann per .fetchmailrc die Antwort parst und in die eigene Influx oder Flot schreibt … Was denkt ihr?