Warning
Work in progress — not production ready. The MQTT connection and sensor data are functional, but the start/stop commands have not yet been validated on a live robot. Use at your own risk and expect breaking changes.
Custom integration for Home Assistant to control Maytronics One pool robots (Dolphin EON series) via the cloud API.
Not compatible with the MyDolphin Plus app. This integration targets the Maytronics One app exclusively.
Any robot managed through the Maytronics One app (Android/iOS), including:
- Dolphin EON series (EON 30, EON 50, EON 120...)
- Robots with WiFi connectivity (device_type 65)
Tested on: Dolphin EON 120d Europe
| Entity | Type | Description |
|---|---|---|
| Nettoyage | Switch | Start / stop a cleaning cycle |
| Batterie | Sensor | Battery level (%) |
| Mode nettoyage | Sensor | Current cleaning mode |
| Statut | Sensor | idle / cleaning / error |
| Cycles nettoyage | Sensor | Total cleaning cycle count |
| En nettoyage | Binary sensor | Robot actively cleaning |
| En charge | Binary sensor | Robot charging |
| MQTT connecté | Binary sensor | Cloud connection status |
| Robot connecté | Binary sensor | Robot online in the cloud |
- Home Assistant 2024.1+
- A Maytronics One account with at least one registered robot
- Robot connected to WiFi (not BLE-only mode)
- Python packages installed automatically:
awsiotsdk,cryptography
- In HACS, click ⋮ → Custom repositories
- Add
https://github.com/Jycreyn/maytronics-one-haas an Integration - Search for Maytronics One and install
- Restart Home Assistant
- Copy
custom_components/maytronics_one/into your HAconfig/custom_components/directory - Restart Home Assistant
- Go to Settings → Integrations → Add Integration
- Search for Maytronics One
- Enter your Maytronics One account email
- Check your inbox for the OTP code and enter it
- Select your robot from the list
No password needed — authentication uses a one-time code sent by email (same as the app).
- Authentication: AWS Cognito (CUSTOM_AUTH flow with OTP email)
- Real-time state: AWS IoT MQTT via WebSocket (named shadows:
Status,Config,Search) - Commands: Published to the
Statusnamed shadow desired state - Token refresh: Automatic, no re-authentication needed
Check that awsiotsdk and cryptography are installed in your HA environment:
docker exec homeassistant pip show awsiotsdk cryptographyEnable debug logging in configuration.yaml:
logger:
logs:
custom_components.maytronics_one: debugThe robot must be connected to WiFi and reachable from the Maytronics cloud. Verify it works in the Maytronics One app first.
- Start/stop command payload may need adjustment depending on robot firmware — if the switch has no effect, check HA logs for the MQTT response on
shadow/name/Status/update/accepted - BLE-only robots are not supported (WiFi required for cloud connectivity)
Pull requests welcome. When testing, enable debug logging and share the MQTT topic/payload logs to help map new robot models.