From 4a7acc62bcdc43151b4b44e2f65ab96eb9696b44 Mon Sep 17 00:00:00 2001 From: Michael Arthur Date: Tue, 22 Aug 2023 22:37:39 +1200 Subject: [PATCH] Add lawn mower entity (#28546) Co-authored-by: Franck Nijhof --- source/_integrations/lawn_mower.markdown | 46 ++++++++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 source/_integrations/lawn_mower.markdown diff --git a/source/_integrations/lawn_mower.markdown b/source/_integrations/lawn_mower.markdown new file mode 100644 index 00000000000..bb4c531949c --- /dev/null +++ b/source/_integrations/lawn_mower.markdown @@ -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. |