ReefManager DIY Community

Hier sammeln wir alle Anleitungen, sowie Baupläne und 3D-Druck Dateien der ReefManager DIY-Community. Egal ob Du ein geniales Gehäuse gedruckt, eine Halterung entworfen oder ein ganzes Add-on gebaut hast: Ich möchte dir hier eine Plattform bieten!

Transparenz zur Open-Source-Frage

Warum ist ReefManager aktuell (noch) nicht Open Source? Ein offenes Statement zu Sicherheit, Verantwortung und Qualitätskontrolle.

ReefManager greift tief in sicherheitsrelevante Bereiche der Aquarientechnik ein: Dosierung, Pumpensteuerung und zeitkritische Abläufe. Fehlerhafte Änderungen am Code können – selbst wenn sie gut gemeint sind – zu realen Schäden an Tierbestand und Technik führen.

Meine zentrale Verantwortung:
Ich möchte sicherstellen, dass sich nur getestete und von mir verantwortete Software-Versionen im Umlauf befinden. Eine unkontrollierte Verbreitung modifizierter Firmware-Varianten würde dieses Ziel in der aktuellen Phase untergraben.

Eine teilweise oder vollständige Öffnung des Quellcodes zu einem späteren Zeitpunkt wird nicht grundsätzlich ausgeschlossen, sobald Architektur und Rahmenbedingungen dies sicher zulassen und die Finanzierung des Projekts über z.B. Affiliate Links auch ohne Lizenzgebühren auskommt.

Haftungsausschluss & Nutzungshinweise

Wichtig: Grenzen der Software-Sicherheit, Eigenverantwortung im DIY-Bereich und rechtliche Hinweise.

Grenzen der Software:
Die Schutzmechanismen wirken nur auf Signalebene. Physikalische Defekte (z.B. klebende Relais, defekte Mosfets) können durch Software nicht verhindert werden.

Experimenteller Status:
ReefManager ist ein DIY-Projekt im Beta-Status. Die Nutzung erfolgt ausschließlich auf eigene Verantwortung. Eine Haftung für Schäden an Tieren, Hardware oder Daten ist ausgeschlossen.

Mitwirkung des Anwenders:
1. Konfigurationen vor dem Einsatz testen.
2. Externe Schutzmaßnahmen (z.B. Überlaufschutz) nutzen.
3. Bei Fehlfunktionen das System sofort abschalten.

Lizenz-Gebühr: 50€

Die Gebühr für das Flashen der Firmware inklusive Deiner persönlichen Lizenz (1 Gerät, 1 Lizenzschlüssel) beträgt 50€. Dieser Beitrag sichert die Weiterentwicklung der App und Cloud sowie die Deckung fixer Unkosten (Rechtliches, Absicherung etc.).

Warum 50€? Die Lizenz deckt nun das gesamte Ökosystem mit drei spezialisierten Firmwares ab: Neben dem ReefManager sind nun auch der FlowManager (Steuerung von bis zu fünf 2-Achs-Dreheinheiten mit Motoren) sowie KHFix4U (KH- & pH-Messung) enthalten.

Hinweis: Aufgrund der Speicherbegrenzung des ESP32 kann jeweils nur eine dieser drei Firmwares zeitgleich auf einem Gerät genutzt werden.

Eine Lizenz – Drei Möglichkeiten

Aktuell erwirbst Du eine universelle ReefManager Lizenz. Diese deckt alle drei Firmware-Varianten ab:

• ReefManager Firmware: Für Dosierpumpen, Licht, Sensoren, etc.
  Hardware Teile Fertige Gehäuse STL Dateien Montage-Hilfe Anleitungen
• FlowManager Firmware: Spezialisiert auf Strömung.
  (Servos: Vollständig implementiert & debugged. Stepper: Implementiert, aber noch Beta-Test).
  Passende STLs & Hardware kaufen
• KHFix4U Firmware: Spezialisiert auf KH- & pH-Messung.
  (Automatisierte Titration und Überwachung deiner Wasserwerte).
  PhotoManager (KHFix4U) Details

Downloader über das Lizensierungstool, wähle die Firmware aus, schicke mir die Daten und warte auf die Mail, mit welcher Du die Lizenz erhältst und aufspielen kannst.

SCHRITT 1: Der richtige ESP32

ACHTUNG: Bitte nutze ausschließlich den ESP32, den ich im Abschnitt "DIY Hardware" verlinkt habe!

Es ist essenziell, dass der ESP32 einen CP2102 Chipsatz besitzt. Andere Varianten (z.B. mit CH340 Chip) sind nicht mit meinen Flash-Skripten und Partitionstabellen kompatibel.
Ich kann und werde keine anderen ESP-Modelle flashen!

Ein offenes Wort zum Support

Ich habe neben diesem Projekt noch einen Hauptjob. Derzeit verbringe ich täglich ca. 5 Stunden damit, Support-Anfragen zu beantworten, deren Lösungen bereits hier stehen. Die Einnahmen decken aktuell nicht einmal die Kosten, geschweige denn meine Zeit.

Die Weiterentwicklung steht deshalb still. Bitte helft mir (und euch), indem ihr diese Anleitungen lest und Probleme zunächst selbst eingrenzt. Wenn ihr die Schritte unten befolgt, funktioniert es zu 100%. Danke!

Wichtiger Hinweis zur Unterscheidung

Um Verwechslungen zu vermeiden, bitte ich darum, für Selbstbauten nicht das originale ReefManager-Logo (ohne Zusatz) zu verwenden. Damit stellen wir sicher, dass man originale Hardware (geprüft, CE-zertifiziert) auf den ersten Blick von DIY-Projekten unterscheiden kann.

Stattdessen: Nutze gerne das extra dafür entworfene "ReefManager DIY Edition" Logo!

Alleinstellungsmerkmal: Hinterleuchtung & 3D-Druck

Diese Grafiken sind dafür optimiert, hinterleuchtet zu werden (siehe Animation unten). So erzielst Du den besten Effekt:

• Schwarz auf Transparent: Drucke die Frontblende in Schwarz auf einer Schicht transparentem PETG. Das Licht der LEDs scheint dann nur durch das Logo.
• Zweiteiliger Druck: Wenn Du das Logo separat drucken/ausschneiden möchtest, wähle bitte die Variante, bei der keine Buchstaben-Teile herausfallen (Stencil-Style).

Meine Druck-Empfehlung

Gute Qualität, fair & schnell liefert Shirtinator. Ich trage selbst das Männer Bio T-Shirt EarthPositive 72000 in Schwarz (am besten ihr auch!).

Größen-Hinweis: Bei 1,85m & 96kg ist Größe L schon sehr körperbetont (fast zu klein). Im Zweifel lieber eine Nummer größer.

ReefManager ist eine hochgradig konfigurierbare DIY-Softwareplattform. Im Gegensatz zu vorkonfigurierten kommerziellen Systemen werden Funktionen wie GPIO-Zuweisungen, Hardware-Timer, PWM-Kanäle und Interrupts (ISR) dynamisch durch den Anwender konfiguriert.

Diese Architektur ermöglicht ein hohes Maß an Flexibilität, führt jedoch zwangsläufig zu einer erhöhten Systemkomplexität. Abhängig von Konfiguration, Hardware, angeschlossenen Aktoren und externen Einflüssen können sich Systemzustände ergeben, die nicht vollständig vorhersehbar oder testbar sind.

Die Software wurde über einen längeren Zeitraum in zahlreichen realen Aquarien-Setups erprobt und zeigt dort ein stabiles und präzises Verhalten. Aufgrund der hohen Konfigurierbarkeit des Systems ist es dennoch nicht möglich, jede theoretisch denkbare Kombination aus Hardware, Konfiguration und Ausnahmesituation vollständig vorab zu testen oder eine Funktionsgarantie zu übernehmen. Die Entwicklung und Bereitstellung erfolgen daher ausschließlich nach bestem Wissen und mit größtmöglicher Sorgfalt.

Wichtige Hinweise zur sicheren Nutzung:

• Tests vor dem Einsatz:
  Jede neue oder geänderte Konfiguration sollte vor dem produktiven Einsatz unter sicheren Bedingungen getestet werden (z. B. ohne angeschlossene Verbraucher, mit leeren Dosierbehältern oder unter manueller Beobachtung).
• Eigenverantwortliche Nutzung:
  Die Verantwortung für die korrekte Konfiguration, den sicheren Betrieb sowie die Eignung der angeschlossenen Hardware liegt vollständig beim Anwender.
• Physikalische Sicherheitsmaßnahmen:
  Softwarebasierte Schutzmechanismen können physikalische Defekte (z. B. defekte MOSFETs, kaputte Relais, mechanische Blockaden, Undichtigkeiten oder Stromausfälle) nicht verhindern. Der Einsatz externer, physikalischer Schutzmaßnahmen (z. B. begrenzte Vorratsmengen, mechanische Sperren, zusätzliche Abschaltungen) wird daher ausdrücklich empfohlen.
• Verhalten bei Fehlfunktionen:
  Bei ungewöhnlichem Verhalten, Fehlfunktionen oder unerwarteten Reaktionen sollte das System unverzüglich außer Betrieb genommen und vom Stromnetz getrennt werden.

Hinweise auf Fehler, ungewöhnliches Verhalten oder sicherheitsrelevante Auffälligkeiten sind ausdrücklich erwünscht und können an info@reefmanager.eu gemeldet werden.