Whytey / moebot-hass-integration

A HomeAssistant integration for MoeBot (and compatible) TUYA mowers.
9 stars 0 forks source link

MoeBot Home Assistant Integration

Provides the following:

Installation

Easiest install is via HACS

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

  1. Add the repository to your HACS install by clicking the button below:
  2. Restart HA

For manual installation for advanced users, copy custom_components/moebot to your custom_components folder in Home Assistant then continue from step 2 above.

Configuration

Once you have installed the integration (per above)...

  1. Open the Home Assistant web interface.
  2. Navigate to "Configuration" > "Integrations".
  3. Click on the "+" button in the bottom right corner to add a new integration.
  4. Search for "MoeBot" and select it from the list.
  5. Enter the required details; Device ID, IP address and Local Key
  6. Click on "Submit" to complete the integration setup.

Documentation

Lawn Mower States

The Lawn Mower component as provided by Home Assistant only provides 3 states:

  1. ERROR - Device is in error state, needs assistance.
  2. PAUSED - Paused during activity.
  3. MOWING - Device is mowing.
  4. DOCKED - Device is docked.

The MoeBot however provides many more states:

  1. STANDBY - the MoeBot is not mowing; it is either sitting idle in the mowing area or sitting in the dock fully charged.
  2. MOWING - the MoeBot is mowing.
  3. FIXED_MOWING - the MoeBot is mowing in a spiral pattern.
  4. CHARGING - the MoeBot is in the dock charging.
  5. EMERGENCY - the MoeBot is in some non-normal state, perhaps lifted off the ground.
  6. LOCKED - the MoeBot UI is asking for the PIN to be entered.
  7. PAUSED - the MoeBot is currently mowing but the job has been paused.
  8. PARK - the MoeBot is following the boundary wire to return to the dock.
  9. CHARGING_WITH_TASK_SUSPEND - the MoeBot is in the dock charging but will return to mow.
  10. ERROR - the MoeBot is in some error state, perhaps it is outside of the boundary.
The MoeBot integration maps these states per the following table: Lawn Mower State MoeBot States
ERROR EMERGENCY, ERROR, LOCKED
PAUSED PAUSED
MOWING MOWING, FIXED_MOWING, PARK
DOCKED STANDBY, CHARGING, CHARGING_WITH_TASK_SUSPEND

Additional documentation is provided in the pymoebot repository.

Future

Unfortunately, 0.3.0 will probably be my last release of this integration since I have now purchased a new Luba 2 5000 and will be decommissioning my MoeBot.

Feel free to continue to log any issues you have an if possible, I may try and address these - though it will be difficult without a physical device to test against.

The following are a list of features I would like to have added if I continued with the MoeBot: