Part of the ReefTech Project Ecosystem
Control your Aqua Medic pumps from Home Assistant via the Gizwits cloud API.
Your device is not supported? Please contact me.
✅ Supported | 🧪 Untested (may work) | ❌ Not yet supported
| Device | Internal Name | Product Key | Status | |
|---|---|---|---|---|
| Aqua Medic EcoDrift / SmartDrift x.1 / x.3 |  |
Current_Pump |
63632f4902094055ab3fd994c0d612fa |
✅ |
| Aqua Medic DC Runner x.1 / x.2 / x.3 (return pump) |  |
DC_Runner |
8879684725d14066922374e50889f893 |
🧪 |
| Aqua Medic Reefdoser EVO |  |
Dosing_Pump |
a1f9488390b4458f9676677f51664324 |
❌ |
| Aqua Medic T-Controller Twin | Temp_Ctrl |
f6a8e5d2c1b04a9e8d7c6b5a4f3e2d1c |
❌ | |
| Aqua Medic Aquarius / Spectrus | Light_Ctrl |
7d2e9b8a1c3f4e5d6a7b8c9d0e1f2a3b |
❌ |
All these devices use the Gizwits IoT platform (same backend as the official Aqua Medic app). Support for additional devices may be added in future releases.
- In HACS, go to Integrations → ⋮ → Custom repositories
- Add
https://github.com/Elwinmage/ha-aquamedic-componentas an Integration - Search for Aqua Medic and install
- Restart Home Assistant
| Entity | Description |
|---|---|
| Power | Main on/off |
| Wave type | Pulse mode (off) / Tide mode (on) |
| Feeding mode | Activates feeding pause |
| Timer | Enables program mode |
| 0-10V control mode | When on, disables the Flow rate slider (pump driven by external 0-10V signal) |
| Entity | Options |
|---|---|
| Wave mode | Classic wave · Sine wave · Random wave · Constant flow |
| Linkage | Independent · Master · Slave |
| Entity | Range | Description |
|---|---|---|
| Flow rate | 0–100 % | Motor flow (disabled in 0-10V mode) |
| Frequency | 0–100 % | Wave frequency |
| Feeding duration | 1–60 min | Duration of feeding pause |
| Entity | Description |
|---|---|
| Overcurrent fault | Motor overcurrent / short circuit |
| Overvoltage fault | Motor overvoltage |
| Overtemperature fault | Motor temperature too high |
| Undervoltage fault | Motor undervoltage |
| Locked rotor fault | Motor jammed / blocked |
| No load fault | Pump running dry |
| UART communication fault | Module ↔ mainboard communication error |
| Entity | Description |
|---|---|
| Refresh | Forces an immediate data refresh without waiting for the next poll interval |
🧪 Support is implemented but not yet tested on real hardware. Feedback welcome.
| Entity | Description |
|---|---|
| Power | Main on/off |
| Feeding mode | Pauses pump output for 10 minutes |
| 0-10V control mode | When on, flow is driven by external 0-10V signal |
| Entity | Range | Description |
|---|---|---|
| Flow rate | 30–100 % | Pump speed (minimum 30 % — below this the motor may stall) |
| Entity | Description |
|---|---|
| Dry run fault | Automatic shut-off if no water detected for 2 min |
| Locked rotor fault | Mechanical obstruction detected |
| Voltage fault | Input voltage out of range |
Go to Settings → Devices & Services → Add Integration → Aqua Medic.
| Field | Description |
|---|---|
| Your Aqua Medic app account e-mail | |
| Password | Your Aqua Medic app password |
| Gizwits server | Region server — select Europe for EU users |
| Refresh interval | How often device state is polled (5–300 s, default 30 s) |
The correct server is pre-selected automatically based on your Home Assistant language.
After setup, options (refresh interval) can be changed via Settings → Devices & Services → Aqua Medic → Configure.
MIT – see LICENSE.