Overview

HomeAssitant RedSea Reefbeat devices Local Management (no cloud): ReefATO+, ReefDose, ReefLed, ReefMat, ReefRun and ReefWave

Tip

To edit advanced schedule for ReefDose, ReefLed, ReefRun and ReefWave, you need to use the ha-reef-card (currently under development)

Tip

The list of future implementations can be found here
The list of bugs can be found here

If you need other sensors or actuators let me know here.

Important

If your devices are not on the same subnet as your Home Assistant please read this.

Caution

⚠️ This is not an official RedSea repository. Use at your own risk.⚠️

Compatibility

✅ Tested ☑️ Must Work (If you have one, can you confirm it's working here )

	Model		Status		Issues 📆(Planned) 🐛(Bugs)
ReefATO+	RSATO+		✅		📆 🐛
ReefDose	RSDOSE2		✅		📆 🐛
	RSDOSE4		✅
ReefLed	G1	RSLED50	☑️		📆 🐛
		RSLED90	✅
		RSLED160	✅
	G2	RSLED60	✅
		RSLED115	✅
		RSLED170	☑️
ReefMat	RSMAT250		✅		📆 🐛
	RSMAT500		✅
	RSMAT1200		✅
ReefRun & DC Skimmer	RSRUN		✅		📆 🐛
ReefWave (*)	RSWAVE25		☑️		📆 🐛
	RSWAVE45		✅

(*) ReefWave user please read this

Summary

• Installation via hacs
• Common functions
• ReefATO+
• ReefDose
• LED
• Virtual LED
• ReefMat
• ReefRun
• ReefWave
• Cloud API
• FAQ

Installation via hacs

Direct installation

Just click here to directly go to the repository in HACS and click "Download":

Find in HACS

Or search for "redsea" or "reefbeat" in hacs

Common functions

Add device

When adding a new device you have 4 choices:

Add Cloud API

Mandatory for ReefWave (Read this).

• Get user informations
• Get aquariums
  • Get Waves library
  • Get Led library

Auto detect on private network

If not on same network read this and use the "Manual Mode")

Manual Mode

You can put your device IP or the network address to have auto detection.

Set scan interval for device

Live update

Note

It is possible to choose whether to enable live_update_config or not. In this mode (old default), configuration data is continuously retrieved along with normal data. For RSDOSE or RSLED, these large http requests can take a long time (7-9 seconds). Sometimes the device does not respond to the request, so I had to code a retry function. When live_update_config is disabled, configuration data is only retrieved at startup and when requested via the "fetch configuration" button. This new mode is activated by default. You can change it in the device configuration.

ReefATO:

• Auto_fill enable/disable
• Manual fill

ReefDose:

• Edit daily dose
• Manual dose
• Change and control container volume. Container Volume settigns is automaticaly enabled or disabled according to volume controleur switch.
• Enable/disable schedule per pump
• Stock alert configuration
• Dosing delay between supplements

Main

Heads

LED:

• Get and Set White, Blue and Moon values (only for G1: RSLED50,RSLED90,RSLED160)
• Get and Set Color Temperature, Intensity and Moon (all LEDS)
• Manage acclimation. Acclimation settings are automaticaly enabled or disabled according to acclimation switch.
• Manage moonphase. Moonphase settings are automaticaly enabled or disabled according to moonphase switch.
• Set Manual Color Mode with or without duration
• Get Fan and Temperature
• Get name and value for progams (with clouds support) Only for G1 LEDS.

---

The support of Color Temperature for G1 LEDS take into account the specificity of each of the three models.

---

IMPORTANT THINGS for G1 and G2 LIGHTS

The Kelvin/intensity interface of G2 lamps does not allow for full LED power.

G2 LIGHTS

Because this method ensures constant intensity across the entire color range, your LEDs do not utilize their full capacity in the middle. At 8.000K, the white channel is at 100% and the blue channel at 0% (the opposite at 23.000K). At 14.000K and with 100% intensity for G2 lights, the power of the white and blue channels is approximately 85%. Here is the loss curve for the G2s.

G1 LIGHTS

G1 LEDS use white and blue channels control, which allows for full power across the entire range, but not constant intensity without compensation. That's why I implent intensity compensation. Because I only have RESL160, you can enable this option only for this kind of LEDS.

If you want this option for RSLED50 or RSLED90 let me known but be aware that you have to make some measures.

If you want to use the full power of your LED then disable intensity compensation (default).

In other words, an intensity of x% for 9.000K is not the same than at 23.000K or 15,000K.

Here is the power curve for the RSLED160 (0 is for full blue to full white 200).

If you enable intentisty compensation, the intensity of your light will be constant accross all kelvin values but in the middle of the range you will not use the full capacity of your LED (like G2 models). For RSL160, that's more than a 50% loss.

Also, don't be surprised to see the intensity factor exceed 100% for the G1s in White/Blue mode if you enable compensation. This is because you can harness the full power of your LEDs!

---

Virtual Led

• Group and manage LED with a virtual device (Create a vitual device from the integration panel, then use the configure button to link the leds).
• You can only use Kelvin and intensity to control your leds if you have G2 or a mix of G1 and G2.
• You can use both Kelvin/Intensity and White&Blue if you have only G1

ReefMat:

• Auto advance switch (enable/disable)
• Schedule advance
• Custom advance value: let you select the value of roll advance
• Manual Advance
• Change the roll.

Tip

For a new full roll please set "roll diameter" to min (4.0cm). It will adjust the size according to your RSMAT version. For a started roll enter the value in cm.

• Two hidden parameters: model and position if you need to reconfigure your RSMAT

ReefRun:

• Set pump speed
• Manage overskimming
• Manage full cup detection
• Can change skimmer model

Main

Pumps

ReefWave:

Important

ReefWave devices are different from other ReefBeat devices. They are the only devices that are slaves to the ReefBeat cloud.
When you launch the ReefBeat mobile app, the status of all devices is queried and data from the ReefBeat app is retrieved from device state.
For ReefWave, it's the opposite: there is no local control point (as you can see in the ReefBeat app, you can't add a ReefWave to a disconnected aquarium).

Waves are stored in the cloud user library. When you change a wave's value, it is changed in the cloud library and applied to the new schedule.
So there's no local mode? Not so simple. There's a hidden local API to control ReefWave, but the ReefBeat app won't detect the changes, so the device and HomeAssistant on one side and the ReefBeat mobile App on the other side will be out of sync. Device and HomeAssisant will always be synchronized.
Now that you know, make your choice!

Note

ReefWave waves have many linked parameters, and the range of some parameters depends on other parameters. I was not able to test all possible combinations. If you find a bug, you can create an issue here.

ReefWave Modes

As explain before, ReefWave devices are the only devices that can be unsychronize with reefbeat App if you use local API. Three modes are availabled: Cloud, Local, Hybride. You can change the mode settings "Connect To Cloud" and "Use Cloud API" switches as described in the table below.

Mode name	Connect To Cloud Switch	Use Cloud API Switch	Behavior	ReefBeat and HA are synchronized
Cloud (Default)	✅	✅	Data are fetch via the local api. Commands are sent via the cloud api	✅
Local	❌	❌	Data are fetch via the local api. Commands are sent via the local api. (Except on/off that are always sent via local API) Device is seen as 'off' in ReefBeat App.	❌
Hybride	✅	❌	Data are fetch via the local api. Commands are sent via the local api. The ReefBeat mobile APP does not represent the good waves values. Home Assitant always represent the good waves values. You can change values from ReefBeat APP and Home Assistant.	❌

For Cloud and Hybride mode you must link your ReefBeat cloud account. First create a "cloud api" device with your credential, and that's all! The "Linked to account" sensor will updated with the name of your reefbeat account if connection is established.

Changing current values

To load current wave values in preview fields, use the "Set Prev. From Current" Button.

To change current wave values, set preview values and use the "Save Preview" Button.

The behavior is the same as of ReefBeat mobile App. All waves with the same id in the current schedule will be updated.

Cloud API

The cloud API permits to get user informations, waves, supplements and leds libraries and to send commands to ReefWave when "Cloud" mode is selected. Waves and Leds parameters ares sorted by Tanks.

---

FAQ

My device is not detected

• try to relaunch the auto-detection with the "add entry" button. Sometimes devices do not respond because they are busy.
• If your redsea devices are not on the same subnetwork than your Home Assistant, auto-detection will first fail and propose you to enter the ip of your device or the address of the subnetwork where your devices are. For subnetwork detection please use the format IP/MASK like this example : 192.168.14.0/255.255.255.0.
• You can also use the manual mode

Some data are refreshed well but others are not

Datas are divided in three parts: data, config and device-info:

• Data are regulary updated
• Config datas are only updated at startup and when you press the fecth-config button
• Device-info datas are only updated at boot

To ensure that the Config datas are updated regularly, please enable the "Live configuration Update"

---