<img src="https://github.com/geertmeersman/robonect/raw/main/images/brand/logo.png" alt="Robonect" align="right" style="width: 200px;margin-right: 10px;" />

Robonect for Home Assistant

A Home Assistant integration to monitor Robonect

Features

• MQTT listener
• REST API client
• All Robonect sensors (if MQTT enabled priority to MQTT sensors over REST)
• Automower lawn mower entity
• Automower vacuum entity (remains until the lawn mower entity, introduced in 2023.9 will be fully developed)
• Buttons (change mode, start, stop, return home, ...)
• Service calls to Robonect actions, like scheduling a job, modifying a timer

MQTT sensors (when enabled) are enabled prior to the REST sensors, as they update faster.

The REST sensors, are updated on a configurable scan interval. When the mower is sleeping, only the status sensors are being updated (since the others have no activity and updating them would wake up the mower, resuling in a beep every time a scan happens). Example here: Rest sensor and the REST category

Table of contents

• Robonect for Home Assistant
  • Features
  • Table of contents
  • Installation
  • Using HACS (recommended)
  • Manual
  • Contributions are welcome
  • Troubleshooting
  • Frequently asked questions
  • Enable debug logging
  • Disable debug logging and download logs
  • Extra sensor for daily mowing time
  • Extra sensors templates, used for lovelace card
  • Lovelace examples
  • Mower card with some nice buttons
  • Screenshots
  • Integration page
  • Mowing job
  • Timer
  • Config flow
  • REST sensor and the REST category

Installation

Using HACS (recommended)

Click on this button:

or follow these steps:

1. Simply search for Robonect in HACS and install it easily.
2. Restart Home Assistant
3. Add the 'Robonect' integration via HA Settings > 'Devices and Services' > 'Integrations'
4. Provide your Robonect configuration details

Manual

1. Copy the custom_components/robonect directory of this repository as config/custom_components/robonect in your Home Assistant instalation.
2. Restart Home Assistant
3. Add the 'robonect' integration via HA Settings > 'Devices and Services' > 'Integrations'
4. Provide your Robonect configuration details

This integration will set up the following platforms.

Contributions are welcome

If you want to contribute to this please read the Contribution guidelines

Troubleshooting

Frequently asked questions

• I am missing a lot of sensors: please check that the MQTT topic you have entered in the HA config flow equals the MQTT topic in Robonect

Enable debug logging

To enable debug logging, go to Settings -> Devices & Services and then click the triple dots for the Robonect integration and click Enable Debug Logging.

Disable debug logging and download logs

Once you enable debug logging, you ideally need to make the error happen. Run your automation, change up your device or whatever was giving you an error and then come back and disable Debug Logging. Disabling debug logging is the same as enabling, but now you will see Disable Debug Logging. After you disable debug logging, it will automatically prompt you to download your log file. Please provide this logfile.

Extra sensor for daily mowing time

Define a daily mowing time sensor by adding the followinng lines to your configuration.yaml:

sensor:
  - platform: history_stats
    name: Daily mowing time
    entity_id: sensor.automower_mower_status
    state: 2
    type: time
    start: "{{ now().replace(hour=0, minute=0, second=0) }}"
    end: "{{ now() }}"

Extra sensors templates, used for lovelace card

In template.yaml, add the following:

- sensor:
    - name: "Automower Battery Current"
      unique_id: "sensor.automower_battery_current"
      unit_of_measurement: "mA"
      state: "{{ state_attr('sensor.automower_battery_0', 'current') | replace(' mA', '') | int(0) }}"
      icon: "mdi:current-dc"
    - name: "Automower Battery Voltage"
      unique_id: "sensor.automower_battery_voltage"
      unit_of_measurement: "V"
      state: "{{ state_attr('sensor.automower_battery_0', 'voltage') | replace(' V', '') | float(0) }}"
      icon: "mdi:sine-wave"
    - name: "Automower Battery Temperature"
      unique_id: "sensor.automower_battery_temperature"
      unit_of_measurement: "°C"
      state: "{{ state_attr('sensor.automower_battery_0', 'temperature') | replace(' °C', '') | float(0) }}"
      icon: "mdi:temperature-celsius"
    - name: "Automower Battery Capacity"
      unique_id: "sensor.automower_battery_capacity"
      unit_of_measurement: "mAh"
      state: "{{ state_attr('sensor.automower_battery_0', 'capacity').remaining | replace(' mAh', '') | int(0) }}"
      icon: "mdi:battery-charging-medium"

Lovelace examples

Mower card with some nice buttons

Screenshots

Integration page

Mowing job

Timer

Config flow

Options

REST sensor and the REST category

Note: if the sensor is a REST sensor and the category does not equal 'status', the sensor will only be updated during the non-sleeping phase of the mower