MQTT Integration

All Aqua-Scope WiFi devices support MQTT for integration into smart home systems, custom dashboards, or automation platforms such as Home Assistant, Node-RED, or ioBroker.

Enabling MQTT

MQTT can be enabled in two ways:

During Initial Setup (Configuration Page)

During the WiFi setup, you can enter the MQTT connection details directly under "Advanced".

Later via the App

1. Open the Aqua-Scope App
2. Select the device
3. Navigate to Configuration → Communication Options
4. Enter the MQTT connection details

Configuration Parameters

Parameter	Description
server	Hostname or IP address of the MQTT broker
port	Broker port (default: 1883, TLS: 8883)
login	Username (optional)
password	Password (optional)
enable	Enable (1) or disable (0) the service

Example JSON downlink for MQTT configuration:

{
  "mqtt": {
    "enable": "1",
    "server": "my-broker.example.com",
    "port": 1883,
    "login": "username",
    "password": "password"
  }
}

MQTT over TLS

Aqua-Scope devices support MQTT over TLS for encrypted connections. Use port 8883 (or the TLS port configured on your broker). The devices validate the server certificate automatically.

MQTT Topics

All topics use the 8-character device ID (printed on the device). Example with device ID 12345678:

Topic	Direction	Description
/AQS/12345678/stat	Device → Broker	Regular status messages
/AQS/12345678/alarm	Device → Broker	Alarm messages
/AQS/12345678/cmnd	Broker → Device	Control commands to the device

Message Format

All MQTT messages use JSON. The values follow the same format as the JSON Webhook service.

Status Message (stat)

Example of a regular status message:

{
  "uptime": 12345,
  "temperature": 22.5,
  "pressure": 3200,
  "battery": 3.1
}

The included fields vary depending on the device type (e.g., rainlevel for the rain gauge, pressure for the pressure sensor).

Alarm Message (alarm)

{
  "alarm": "flood",
  "state": 1,
  "source": 0,
  "value": 0
}

Field	Description
alarm	Alarm type (e.g., flood, overpressure, underpressure, temperature)
state	1 = alarm active, 0 = alarm cleared
source	0 = main device, 1 or higher = sub-device (e.g., paired flood sensor or motor)
value	Current sensor value that triggered the alarm (e.g., pressure in mBar for underpressure alarm, temperature for frost alarm). Not present for all alarm types.

Control Commands (cmnd)

Example — close valve:

{"valve": "0"}

Example — open valve:

{"valve": "100"}

Supported Devices

MQTT is supported by all WiFi-enabled Aqua-Scope devices:

• AQMWIE01 – Ultrasonic Flow Meter
• AQSWIE02 / AQXWIE02 – Leak Protection Monitor
• RANWIE01 – Rain Gauge
• CLPWIE01 – Pipe Clip
• KFRWIE01 – KFR Motor (WiFi)
• PREWIE02 – Pressure Sensor
• MCLWIE01 – WiFi Connector