Home Assistant Integration

Aqua-Scope WiFi devices can be integrated directly into Home Assistant. The integration is based on MQTT and uses Home Assistant's MQTT Discovery feature.

Prerequisites

• Home Assistant with an installed MQTT broker (e.g., Mosquitto add-on)
• Aqua-Scope device with WiFi connection
• MQTT enabled and configured to use the Home Assistant broker

Enabling Home Assistant Support

1. Open the Aqua-Scope App
2. Select the desired device
3. Navigate to Settings / Configuration
4. Enable "Home Assistant Support"

After activation, the device automatically registers with the MQTT broker using the appropriate discovery messages.

Automatic Detection

Once Home Assistant Support is active, the following entities are automatically displayed in the dashboard:

Sensors

Depending on the device type, various sensors are detected:

Sensor	Devices
Temperature	All devices
Water pressure	AQS, AQX, PRE
Water consumption	AQM, AQX
Rainfall	RAN
Humidity	FLO, CLP
Battery status	All devices

Actuators

Actuator	Devices
Valve Open/Close	BVS, KFR (via monitor)

Alarm Messages

All alarm messages from the device (leak, overpressure, frost, etc.) are available as Events in Home Assistant and can be used for automations.

Alarm messages include a source field that identifies the origin:

• source: 0 — Alarm from the main device
• source: 1 or higher — Alarm from a sub-device (e.g., paired flood sensor or motor)

Example automation: On flood alarm → send notification + turn on light:

automation:
  - alias: "Aqua-Scope Flood Alarm"
    trigger:
      - platform: mqtt
        topic: "/AQS/12345678/alarm"
    condition:
      - condition: template
        value_template: "{{ trigger.payload_json.alarm == 'flood' }}"
    action:
      - service: notify.mobile_app
        data:
          message: >
            Water alarm! Flood sensor has detected water.
            (Source: {{ trigger.payload_json.source }})
      - service: light.turn_on
        target:
          entity_id: light.keller

Tips

MQTT Broker Configuration

Make sure the MQTT broker in Home Assistant does not require authentication or that you have entered the credentials correctly during the MQTT setup.

Multiple Devices

Each Aqua-Scope device has a unique device ID. All devices can be connected to the same MQTT broker simultaneously and appear as separate devices in Home Assistant.