Handwise-HA is a Home Assistant custom integration for Handwise robotic lawn mowers.
It connects your mower to Home Assistant and provides status information, mower controls, diagnostics, battery data, mowing progress, rain detection and more through the Handwise / Anthbot cloud platform.
Currently tested with the Handwise MGC01 500.
Other Handwise mower models using the same cloud platform may also work.
Handwise-HA currently supports:
- 🌿 Native Home Assistant lawn mower entity
▶️ Start mowing- ⏸️ Pause mowing
- 🏠 Return to charging station
- 🔋 Battery level
- 📡 Connection status
- 🔌 Charging status
- 📊 Mowing progress
- 📐 Mowed area
- ✂️ Cutting height
- 📶 Wi-Fi signal strength
⚠️ Error code reporting- 🌧️ Rain detection
- 🔐 PIN / lock status
- 🧪 Diagnostic sensors
- 🗺️ Current path diagnostic data
| Brand | Model | Status |
|---|---|---|
| Handwise | MGC01 500 | ✅ Tested |
This integration may also work with other Handwise robotic lawn mowers using the same Handwise / Anthbot cloud platform.
Possible candidates:
- Other Handwise robotic mower models
- Anthbot Genie based mower models
- Future Handwise cloud-connected mower models
If your mower works with the Handwise or Anthbot mobile app, there is a chance that it can work with this integration.
Please open an issue if you successfully test another model.
- Open HACS
- Go to Integrations
- Open the menu in the top right corner
- Select Custom repositories
- Add this repository URL:
https://github.com/MTTPoll/handwise-ha
- Select category:
Integration
- Install Handwise-HA
- Restart Home Assistant
Copy this folder:
custom_components/handwise_ha
to your Home Assistant configuration directory:
config/custom_components/handwise_ha
Then restart Home Assistant.
After installation:
- Open Home Assistant
- Go to:
Settings → Devices & services → Add integration
- Search for:
Handwise-HA
- Enter your Handwise account credentials
- Select your mower
- Complete setup
The exact entities can differ depending on the mower model and firmware.
- Lawn mower control entity
- Start mowing
- Pause mowing
- Return to charging station
- Battery level
- Mower status
- Mowing progress
- Mowed area
- Cutting height
- Wi-Fi signal
- Error code
- Event code
- IP address
- PIN status
- Rain effect
- Rain wait time
- Firmware information
- Current path diagnostic data
- Connection
- Charging
- Rain detection
- Error state
- Safety trigger
- Cutting height
- Rain detection
- Rain wait time
Handwise-HA includes diagnostic entities that can help with troubleshooting and future development.
Examples:
- Error code
- Event code
- Wi-Fi signal
- Firmware versions
- Current path data
- Internal mower status
The current path data is currently exposed for diagnostics only. Map or route visualization may be added later.
Handwise-HA works with normal Home Assistant dashboard cards.
Recommended cards:
- Tile Card
- Entities Card
- Mushroom Cards
- Custom dashboard cards
Example dashboard values:
Status: Charging
Battery: 100 %
Mowing progress: 74 %
Mowed area: 160 m²
Cutting height: 40 mm
Wi-Fi signal: -74 dBm
Planned or possible improvements:
- Better error code descriptions
- Improved diagnostics
- More confirmed Handwise models
- Optional path / route visualization
- Better translations
- More automation examples
- Enhanced HACS release structure
Contributions are welcome.
You can help by:
- Testing additional Handwise mower models
- Reporting bugs
- Sharing diagnostic data
- Improving translations
- Creating pull requests
- Opening feature requests
If you test another model, please include:
- Mower model
- Firmware version if available
- Working entities
- Non-working entities
- Relevant Home Assistant logs
Handwise-HA is an independent community project.
This project is not affiliated with, endorsed by, maintained by, or supported by Handwise or Anthbot.
Use this integration at your own risk.
Handwise-HA unterstützt aktuell:
- 🌿 Native Home-Assistant-Mähroboter-Entität
▶️ Mähen starten- ⏸️ Mähen pausieren
- 🏠 Zur Ladestation zurückkehren
- 🔋 Akkustand
- 📡 Verbindungsstatus
- 🔌 Ladezustand
- 📊 Mähfortschritt
- 📐 Gemähte Fläche
- ✂️ Schnitthöhe
- 📶 WLAN-Signalstärke
⚠️ Fehlercode- 🌧️ Regenerkennung
- 🔐 PIN-/Sperrstatus
- 🧪 Diagnose-Sensoren
- 🗺️ Aktuelle Pfaddaten als Diagnosewert
| Marke | Modell | Status |
|---|---|---|
| Handwise | MGC01 500 | ✅ Getestet |
Diese Integration könnte auch mit weiteren Handwise-Mährobotern funktionieren, die dieselbe Handwise-/Anthbot-Cloud-Plattform verwenden.
Mögliche Kandidaten:
- Weitere Handwise-Mähroboter
- Anthbot-Genie-basierte Mähroboter
- Zukünftige cloudfähige Handwise-Modelle
Wenn dein Mähroboter mit der Handwise- oder Anthbot-App funktioniert, besteht eine Chance, dass er auch mit dieser Integration funktioniert.
Bitte erstelle ein Issue, wenn du ein weiteres Modell erfolgreich getestet hast.
- HACS öffnen
- Zu Integrationen wechseln
- Oben rechts das Menü öffnen
- Benutzerdefinierte Repositories auswählen
- Diese Repository-URL eintragen:
https://github.com/MTTPoll/handwise-ha
- Kategorie auswählen:
Integration
- Handwise-HA installieren
- Home Assistant neu starten
Diesen Ordner kopieren:
custom_components/handwise_ha
nach:
config/custom_components/handwise_ha
Danach Home Assistant neu starten.
Nach der Installation:
- Home Assistant öffnen
- Zu folgendem Menü wechseln:
Einstellungen → Geräte & Dienste → Integration hinzufügen
- Nach folgender Integration suchen:
Handwise-HA
- Handwise-Zugangsdaten eingeben
- Mähroboter auswählen
- Einrichtung abschließen
Die tatsächlich verfügbaren Entitäten können je nach Modell und Firmware abweichen.
- Mähroboter-Steuerung
- Mähen starten
- Mähen pausieren
- Zur Ladestation zurückkehren
- Akkustand
- Mäherstatus
- Mähfortschritt
- Gemähte Fläche
- Schnitthöhe
- WLAN-Signal
- Fehlercode
- Ereigniscode
- IP-Adresse
- PIN-Status
- Regenstatus
- Regen-Wartezeit
- Firmware-Informationen
- Aktuelle Pfaddaten als Diagnosewert
- Verbindung
- Ladevorgang
- Regenerkennung
- Fehlerstatus
- Sicherheitsauslösung
- Schnitthöhe
- Regenerkennung
- Regen-Wartezeit
Handwise-HA enthält zusätzliche Diagnose-Entitäten, die bei Fehlersuche und Weiterentwicklung helfen können.
Beispiele:
- Fehlercode
- Ereigniscode
- WLAN-Signal
- Firmware-Versionen
- Aktuelle Pfaddaten
- Interner Mäherstatus
Die aktuellen Pfaddaten werden momentan nur als Diagnosewert bereitgestellt. Eine Karten- oder Routenanzeige kann später ergänzt werden.
Handwise-HA funktioniert mit normalen Home-Assistant-Dashboard-Karten.
Empfohlene Karten:
- Kachelkarte
- Entitäten-Karte
- Mushroom Cards
- Eigene Dashboard-Karten
Beispielwerte im Dashboard:
Status: Laden
Akku: 100 %
Mähfortschritt: 74 %
Gemähte Fläche: 160 m²
Schnitthöhe: 40 mm
WLAN-Signal: -74 dBm
Geplante oder mögliche Verbesserungen:
- Bessere Beschreibung der Fehlercodes
- Erweiterte Diagnosefunktionen
- Weitere bestätigte Handwise-Modelle
- Optionale Pfad-/Routenanzeige
- Bessere Übersetzungen
- Mehr Automationsbeispiele
- Verbesserte HACS-Release-Struktur
Beiträge sind willkommen.
Du kannst helfen durch:
- Tests mit weiteren Handwise-Modellen
- Fehlermeldungen
- Teilen von Diagnoseinformationen
- Verbesserung von Übersetzungen
- Pull Requests
- Feature-Wünsche
Wenn du ein weiteres Modell testest, gib bitte möglichst Folgendes an:
- Mähermodell
- Firmware-Version, falls verfügbar
- Funktionierende Entitäten
- Nicht funktionierende Entitäten
- Relevante Home-Assistant-Logs
Handwise-HA ist ein unabhängiges Community-Projekt.
Dieses Projekt steht in keiner Verbindung zu Handwise oder Anthbot und wird weder von Handwise noch von Anthbot unterstützt, gepflegt oder empfohlen.
Die Nutzung erfolgt auf eigene Verantwortung.