2024.11.0
Home ▸ Integrations ▸

Elexa Guardian

The guardian integration integrates Elexa Guardian water valve controllers into Home Assistant.

There is currently support for the following device types within Home Assistant:

  • Binary sensor: reports the status of the onboard leak detector and access point
  • Button: add various configuration controls
  • Sensor: reports on the device’s detected temperature and uptime
  • Switch: allows the user to enable and disable the onboard access point
  • Valve: allows the user to open and close the valve

Configuration

To add the Elexa Guardian device to your Home Assistant instance, use this My button:

Elexa Guardian can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Elexa Guardian.

  • Follow the instructions on screen to complete the setup.

Actions

guardian.pair_sensor

Add a new paired sensor to the valve controller.

Data attribute Optional Description
uid yes The unique device ID on the bottom of the sensor.

guardian.unpair_sensor

Remove a paired sensor from the valve controller.

Data attribute Optional Description
uid yes The unique device ID on the bottom of the sensor.

guardian.upgrade_firmware

Upgrade the device firmware.

Data attribute Optional Description
url yes The URL of the server hosting the firmware file.
port yes The port on which the firmware file is served.
filename yes The firmware filename.

Note

Not all actions are available on all Guardian valve controller firmwares. Please ensure you upgrade your valve controller to the latest firmware before opening bugs related to non-working actions.

Paired Sensor Notes

When a paired sensor is first added to the valve controller, it may return inaccurate or nonsensical values for several of its attributes, such as battery and temperature. This is due to the sensor never having communicated its data to the valve controller and can be fixed by moving the sensor around (so that it beeps, indicating that data has been sent to the valve controller).