I’ll be slowly putting together proper documentation for reef-pi.
One of the biggest challenges reef-pi has always faced is the lack of clear, straightforward documentation—especially when it comes to wiring, schematics, and understanding how everything fits together. While the software itself is incredibly powerful, getting started (and even scaling up) can be difficult without good reference material.
Alongside this, I’ll also be working on schematics and hardware examples, including DIY circuits and layouts. This will take some time, but the goal is to create something that’s easy to follow and actually useful for both beginners and more advanced users.
Current reef-pi Driver Landscape
Before going too far down this path, I wanted to get a feel for what people are currently using.
From what I’ve seen so far, most setups tend to fall into a few common categories:
Core Drivers (Most Common)
- Temperature (DS18B20)
- pH (typically Atlas Scientific EZO circuits)
- ORP
- ATO (float switches / optical sensors)
- Equipment control (relays)
- Lighting (PWM / basic dimming)
These form the backbone of most reef-pi systems and are generally well understood.
I2C / Expansion
As systems grow, people tend to move into expanders and external controllers:
- PCA9685 (PWM expansion)
- PCF8575 (GPIO expansion)
- ADS1115 (analog inputs for DIY sensors)
These are widely used but often lack consistent documentation or standard approaches.
Chemistry & Advanced Monitoring
This is where things start to get less consistent:
- Salinity / Conductivity (often Atlas, sometimes DIY)
- Custom pH circuits
- ORP via analog or EZO
- Experimental probes and circuits
Many users attempt DIY solutions here but run into issues with drift, noise, and calibration.
Dosing & Automation
- Dosing pumps (relay, PWM, or stepper-driven)
- Timed or rule-based automation
- Increasing interest in more precise control systems
Experimental / Less Common
There are also a number of one-off or custom implementations:
- Flow meters
- Leak detection
- Pressure-based level sensing
- Ultrasonic sensors
- Custom Arduino/I2C bridge devices
Gaps & Opportunities
From what I can see, there are a few key areas where reef-pi could really benefit from improvement:
1. Clear Documentation
- Wiring diagrams
- Setup guides
- Calibration walkthroughs
- Troubleshooting
2. Standardised DIY Hardware
- Known working circuits
- Repeatable builds
- BOMs and schematics
3. Reliable Chemistry Monitoring
- Stable pH implementations
- Accurate salinity measurement
- Proper temperature compensation
- Calibration standards
4. Closed-Loop Control
- Systems that don’t just monitor, but actively maintain parameters
(e.g. salinity up/down control with safeguards)
Goal
The goal here is to build:
- Clear, practical documentation
- Working, repeatable hardware designs
- Improved drivers (especially around chemistry and ADC-based inputs)
Everything will be open source, and designed so people can build and extend it themselves.
Community Input
Before I go too far, I’d love to hear from others:
Are there any other drivers or setups people are currently using?
- Custom drivers
- Forks
- DIY circuits
- Anything that isn’t part of the “standard” setup
Even if it’s experimental or unfinished, it would be great to see what’s out there.