diff --git a/source/_integrations/lawn_mower.markdown b/source/_integrations/lawn_mower.markdown index 4a60c8da879..47241235aee 100644 --- a/source/_integrations/lawn_mower.markdown +++ b/source/_integrations/lawn_mower.markdown @@ -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. |