Add lawn mower entity (#28546)

Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
Michael Arthur 2023-08-22 22:37:39 +12:00 committed by GitHub
parent 8ead6f494e
commit 4a7acc62bc
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -0,0 +1,46 @@
---
title: Lawn Mower
description: Instructions on how to setup and use lawn mowers in Home Assistant.
ha_release: 2023.9
ha_domain: lawn_mower
ha_quality_scale: internal
ha_category:
- Lawn Mower
ha_codeowners:
- '@home-assistant/core'
ha_integration_type: entity
---
The lawn mower integration allows the control of robotic lawn mowers to be reflected within Home Assistant.
Please note, the lawn mower integration cannot be directly used; you cannot create your own lawn mower entities using this integration. This integration is a building block for other integrations to use, enabling them to create lawn mower entities for you.
## Services
Available services: `start_mowing`, `pause` and `dock`.
Before calling one of these services, make sure your lawn_mower platform supports it.
### Service `lawn_mower.start_mowing`
Start or resume a mowing task.
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ---------------------------------------------------------------- |
| `entity_id` | yes | Only act on specific lawn_mower. Use `entity_id: all` to target all. |
### Service `lawn_mower.pause`
Pause a mowing task.
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ---------------------------------------------------------------- |
| `entity_id` | yes | Only act on specific lawn_mower. Use `entity_id: all` to target all. |
### Service `lawn_mower.dock`
Tell the lawn_mower to return to dock.
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ---------------------------------------------------------------- |
| `entity_id` | yes | Only act on specific lawn_mower. Use `entity_id: all` to target all. |