Dein eigenes BoilerBuddy bauen

Baust du lieber selbst etwas, mit einem Raspberry Pi, einem ESP32 oder anderer Hardware? Dann schickst du deine Messwerte an dasselbe Portal wie die BoilerBuddy Alpo, mit denselben Diagrammen und Meldungen. Hier steht, wie du das einrichtest und was noch nicht geht.

Was du brauchst#

• Hardware, die HTTPS mit Zertifikatsprüfung und JSON beherrscht, mit einer Uhr, die per NTP synchron gehalten wird. Jeder Messwert braucht einen Zeitstempel.
• Ein Abonnement. Ein selbst gebautes Gerät kostet so viel wie jedes andere: 3,95 € pro Monat, inklusive MwSt., nach der Testphase deines Kontos (30 Tage). Ohne Abonnement lädt es weiter hoch, aber seine Diagramme und Meldungen sind gesperrt. Siehe Abonnement.

Schritt 1: Gerät anlegen#

1. Geh im Portal zu Geräte und wähle Neues Gerät.
2. Gib ihm einen Namen und wähle Eigene Hardware als Gerätetyp.
3. Lass Kopplungscode (optional) leer, es sei denn, dein Gerät kann sich selbst koppeln: siehe Koppeln mit hello.
4. Wähle Gerät hinzufügen. Der API-Schlüssel des Geräts steht oben auf der nächsten Seite. Du siehst ihn nur einmal: Kopiere ihn jetzt.

Mit einem persönlichen Konto kannst du höchstens 5 Geräte haben.

Schritt 2: Regelkreis wählen#

Der Regelkreis bestimmt, welche Sensorcodes der Server kennt und wie er sie anzeigt. Zu jedem Regelkreis siehst du seine Sensoren mit ihren Codes (siehe auch Regelkreis und Anlagendaten). Was du wissen musst:

• Alle Regelkreise sind Schemas der KSW-Regler von OEG. Andere Marken und eigene Sensoren gibt es noch nicht. Wähle, was zu dem passt, was du misst; 201 ist die einfachste Solaranlage: T1 Kollektor, T2 Speicher unten, T3 Speicher oben, R2 Pumpe.
• Die Codes sind T1 bis T6 für Temperaturen und R1 bis R3 für Ausgänge wie Pumpen, Ventile und Heizstäbe. Welche es gibt, hängt vom Regelkreis ab; jeder andere Code landet in Quarantäne.
• Sende jeden Sensor des Regelkreises. Fehlt einer, folgt die Meldung Sensor liefert keinen Messwert. Du kannst diese Regel beim Gerät unter Meldungen, bei Regeln, ausschalten, aber dann ist sie für alle seine Sensoren aus.
• Sende Ausgänge so, wie der KSW-Regler sie meldet. Eine Pumpe oder ein anderer Ausgang ist über 0,5 an, und der Wert geteilt durch 10 ist ihre Drehzahl: 0 ist aus, 10 ist 100 %. Ein Ventil: 0 ist Stellung A, 128 ist Stellung B.
• Wähle, bevor du mit dem Hochladen beginnst. Nach einem Wechsel bleibt der Verlauf bei den alten Sensoren und erscheint nicht mehr in deinen Diagrammen.

Liest du den Regler nicht selbst aus, ignoriere controller und address in der Konfiguration.

Schritt 3: Token auf dein Gerät bringen#

Nimm den Schlüssel aus Schritt 1. Einen neuen erstellst du auf der Geräteseite, unter Einstellungen bei Verbindung, mit Schlüssel erstellen oder Neuer Schlüssel; der alte funktioniert dann sofort nicht mehr.

Halte den Schlüssel geheim, denn wer ihn hat, kann als dein Gerät hochladen. Lies ihn aus einer Datei oder einer Umgebungsvariablen, nicht aus einem öffentlichen Repository.

Schritt 4: Erst testen, dann bauen#

1. Hol die Konfiguration mit curl ab und prüfe die Sensorcodes. Siehe Beispiel: curl.
2. Sende einen Messwert. Prüfe, ob sich Zuletzt gesehen ändert und der Messwert im Diagramm auf dem Dashboard erscheint.
3. Bau dann den Rest: einen Puffer, Wiederholversuche und alle paar Minuten einen Status. Siehe Puffern und die Uhr.

Welche Hardware passt#

• Raspberry Pi oder ein anderer Linux-Rechner: Mit Python und einem SQLite-Puffer überstehen deine Messwerte einen Neustart und einen Ausfall von mehreren Tagen. Siehe Beispiel: Python.
• ESP32: WLAN, TLS und genug Speicher für kleine Pakete, aber ein Puffer im RAM ist nach einem Neustart weg, es sei denn, du schreibst in den Flash. Siehe Beispiel: ESP32.
• Etwas anderes geht auch, aber kleine Mikrocontroller ohne TLS oder Uhr machen viel Arbeit.

Ein DS18B20-Sensor ist günstig, misst aber nur bis 125 °C, und ein Kollektor kann bei Stillstand heißer werden. Dort ist ein PT1000 mit einem Wandler wie dem MAX31865 üblicher.

Kommst du nicht weiter, oder willst du einen Regler anschließen, der noch nicht unterstützt wird? Melde dich bei uns.