mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-21 16:27:19 +00:00
Lawn mower: add states (#34688)
This commit is contained in:
parent
8f3a461421
commit
39ccceabfc
@ -11,10 +11,20 @@ ha_codeowners:
|
||||
ha_integration_type: entity
|
||||
---
|
||||
|
||||
The lawn mower integration allows the control of robotic lawn mowers to be reflected within Home Assistant.
|
||||
The **Lawn mower** {% term integration %} allows the control of robotic lawn mowers to be reflected within Home Assistant.
|
||||
|
||||
{% include integrations/building_block_integration.md %}
|
||||
|
||||
## The state of a lawn mower entity
|
||||
|
||||
A lawn mower entity can have the following states:
|
||||
|
||||
- **Mowing**: The lawn mower is currently mowing.
|
||||
- **Docked**: The lawn mower is done mowing and is currently docked.
|
||||
- **Paused**: The lawn mower was active and is now paused.
|
||||
- **Returning**: The lawn mower is returning to the dock.
|
||||
- **Error**: The lawn mower encountered an error while active and needs assistance.
|
||||
|
||||
## Actions
|
||||
|
||||
Available actions: `start_mowing`, `pause` and `dock`.
|
||||
@ -25,22 +35,22 @@ Before calling one of these actions, make sure your lawn_mower platform supports
|
||||
|
||||
Start or resume a mowing task.
|
||||
|
||||
| Data attribute | Optional | Description |
|
||||
| ---------------------- | -------- | ---------------------------------------------------------------- |
|
||||
| `entity_id` | yes | Only act on specific lawn_mower. Use `entity_id: all` to target all. |
|
||||
| Data attribute | Optional | Description |
|
||||
| -------------- | -------- | -------------------------------------------------------------------- |
|
||||
| `entity_id` | yes | Only act on specific lawn_mower. Use `entity_id: all` to target all. |
|
||||
|
||||
### Action `lawn_mower.pause`
|
||||
|
||||
Pause a mowing task.
|
||||
|
||||
| Data attribute | Optional | Description |
|
||||
| ---------------------- | -------- | ---------------------------------------------------------------- |
|
||||
| `entity_id` | yes | Only act on specific lawn_mower. Use `entity_id: all` to target all. |
|
||||
| Data attribute | Optional | Description |
|
||||
| -------------- | -------- | -------------------------------------------------------------------- |
|
||||
| `entity_id` | yes | Only act on specific lawn_mower. Use `entity_id: all` to target all. |
|
||||
|
||||
### Action `lawn_mower.dock`
|
||||
|
||||
Tell the lawn_mower to return to dock.
|
||||
|
||||
| Data attribute | Optional | Description |
|
||||
| ---------------------- | -------- | ---------------------------------------------------------------- |
|
||||
| `entity_id` | yes | Only act on specific lawn_mower. Use `entity_id: all` to target all. |
|
||||
| Data attribute | Optional | Description |
|
||||
| -------------- | -------- | -------------------------------------------------------------------- |
|
||||
| `entity_id` | yes | Only act on specific lawn_mower. Use `entity_id: all` to target all. |
|
||||
|
Loading…
x
Reference in New Issue
Block a user