Skip to content

README.md

Latest commit

 

History

History
147 lines (90 loc) · 7.16 KB

README.md

File metadata and controls

147 lines (90 loc) · 7.16 KB
Raw

Mammotion - Home Assistant Integration Discord

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

💬 Join us on Discord

This integration allows you to control and monitor Mammotion products, e.g robot lawn mowers using Home Assistant.

⚠️ Please note: This integration is still a work in progress. You may encounter unfinished features or bugs. If you come across any issues, please open an issue on the GitHub repository. 🐛

Roadmap 🗺️

  • Bluetooth (BLE) support
  • Wi-Fi support (Including SIM 3G/4G)
  • Camera stream
  • Scheduling
  • Mapping and zone management
  • Maps
  • Firmware updates
  • Automations
  • More...

Features ✨

  • Start, stop, pause, and dock the mower

  • Monitor the mower's status (e.g., mowing, charging, idle)

  • View the mower's battery level

  • Start a mow based on configuration

  • Start an existing scheduled task/s

  • More features being added all the time!

  • Supports Spino pool cleaners

Prerequisites 📋

Warning

Home Assistant Minimum Version 2026.1.0

  • A second account with your mower/s shared to it for using Wi-Fi (If you use your primary accouunt it will log you out of your mobile app)
  • (Optional)Bluetooth proxy for Home Assistant

Troubleshooting

Installation 🛠️

This integration can be installed using HACS

hacs_badge

This integration is not available in the default HACS store. You will need to add it as a custom repository.

  1. Go to HACS > Integrations and click on the 3 dots in the top right corner.
  2. Select "Custom repositories".
  3. In the "Repository" field, paste this URL: https://github.com/mikey0000/Mammotion-HA
  4. For "Category", select "Integration".
  5. Click "Add".
  6. You can now search for "Mammotion" within HACS and install it.
  7. After installation, restart Home Assistant.
  8. Go to Settings > Devices & Services and click + Add Integration to configure Mammotion.

Usage 🎮

Getting Started

See the wiki for how to get started

Once the integration is set up, you can control and monitor your Mammotion mower using Home Assistant. 🎉

Map Position Offset

Satellite map tiles (Google Maps, OpenStreetMap, etc.) are sometimes misaligned relative to RTK GPS coordinates by several metres. Each mower exposes two number entities to correct this:

  • Map offset latitude — shifts the mower pin north (positive) or south (negative), in metres
  • Map offset longitude — shifts the mower pin east (positive) or west (negative), in metres

How to calibrate:

  1. Add a Map card and both offset entities to a Lovelace dashboard.
  2. Start the mower so it is moving at a known location you can identify on satellite imagery.
  3. Adjust Map offset latitude and Map offset longitude until the pin aligns with the mower's real position on the satellite layer.
  4. Values are saved automatically and survive restarts.

Typical offsets are within ±20 m. Positive latitude = north, positive longitude = east.

Dashboard Plugins

Companion HACS dashboard plugins that extend the Mammotion integration with visual tools.

Mammotion Assets

Images and scripts for displaying Mammotion mowers on a map in Home Assistant — mower card backgrounds, side-profile images, map icons, RTK/dock assets, and the geojson.js script that renders mowing areas with labels.

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Mammotion GeoJSON Map Plugin

A Lovelace resource that renders GeoJSON mowing areas on the map with area names and zone labels.

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Mammotion SVG Pick and Place

An interactive Lovelace card for placing, editing, and deleting SVG pattern tiles on your mower's map directly from the dashboard. Load an SVG, drag it into position, scale and rotate it, then send it to the device in one click via the mammotion.svg_add service.

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Troubleshooting 🔧

If you encounter any issues with the Mammotion integration, please check the Home Assistant logs for error messages. You can also try the following troubleshooting steps:

  • Verify that you have Bluetooth proxy setup with Home Assistant.
  • Ensure that your mower is connected to your home network and accessible from Home Assistant.
  • Restart Home Assistant and check if the issue persists.
  • Make sure your not blocking China (Connection timeout to host https://api.link.aliyun.com/living/account/region/get)

Contributing to Translations

We use Crowdin to manage our translations. If you'd like to contribute:

  1. Visit our Crowdin project page
  2. Select the language you'd like to translate to
  3. Start translating!

Your contributions will be automatically submitted as pull requests to this repository.

PyMammotion Library 📚

This integration uses the PyMammotion library to communicate with Mammotion mowers. PyMammotion provides a Python API for controlling and monitoring Mammotion robot mowers via MQTT, Cloud, and Bluetooth.

If the problem continues, please file an issue on the GitHub repository for further assistance. 🙏

Support me

Buy Me a Coffee at ko-fi.com

Referral Links

Buy a Mammotion Lawn Mower (Amazon) Buy a Mammotion Lawn Mower (Mammotion)

Credits 👥

Contributors