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
  • Sensor: reports on the device’s detected temperature and uptime
  • Switch: allows the user to open and close the valve

Configuration

Adding Elexa Guardian to your Home Assistant instance can be done via the user interface, by taking the following steps:

  • Browse to your Home Assistant instance.
  • In the sidebar click on Configuration.
  • From the configuration menu select: Integrations.

Elexa Guardian can be auto-discovered by Home Assistant. If an instance was found, it will be shown in the top of the list of integrations as “Discovered”. If that is the case click on the Configure button to start setting up the discovered instance.

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

  • In the bottom right, click on the Add Integration button.
  • From the list, search and select “Elexa Guardian”.
  • Follow the instruction on screen to complete the set up.

After completing, the Elexa Guardian integration will be immediately available for use.

Services

guardian.disable_ap

Disable the device’s onboard access point.

guardian.enable_ap

Enable the device’s onboard access point.

guardian.pair_sensor

Add a new paired sensor to the valve controller.

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

guardian.reboot

Reboot the device.

guardian.reset_valve_diagnostics

Fully (and irrecoverably) reset all valve diagnostics.

guardian.unpair_sensor

Remove a paired sensor from the valve controller.

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

guardian.upgrade_firmware

Upgrade the device firmware.

Service 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 service calls 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 service calls.

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).