homebridge-eufy-robovac

A Homebridge Plugin for eufy RoboVac devices.

Plugin Information

This Plugin enables you to control your eufy RoboVac using the Home App on your Apple devices via HomeKit.

Features

• Switch On & Off: When switching on, this performs that same action as tapping "Clean" in the eufy Clean app. When switching off, this performs the same action as tapping "Recharge" in the eufy Clean app, this stops any in progress cleaning and your eufy RoboVac will return to its charging base.
• Displays Battery Charging State & Level: You will also receive low battery notifications.
• Allows you to use Find My Robot: This performs the same action as tapping "Find My Robot" in the eufy Clean app.

Prerequisites

To install and use this plugin you must:

• Homebridge installed (version 1.7.0 and later).
• The latest version of supported Node.js LTS is installed, this is either LTS v18 or LTS v20.
• For configuration, Homebridge UI is recommended.

Configuration

Getting the "device ID" & "local key"

Configuration of your eufy RoboVac device requires you to find your eufy RoboVac's device ID and local key. To find out what your eufy RoboVacs device ID and local key are, you must use the "eufy Clean device ID & local key grabber".

Download the eufy-clean-local-key-grabber.

Using Python 3.9 (other versions are untested), execute the following commands in the directory that the "eufy Clean device ID & local key grabber" was extracted to:

pip install -r requirements.txt
python -m eufy_local_id_grabber "<EUFY ACCOUNT EMAIL>" "<EUFY ACCOUNT PASSWORD>"

It will return the following outputs:

Home: <home ID>
Device: RoboVac, device ID <device ID>, local key <local key>

There may be more than one device returned if you have multiple devices in your eufy Clean "Home". Make note of all the Devices (and their associated device ID & local Key) that you want to configure with this plugin.

Installing & Configuring the Plugin Using the Homebridge UI

The easiest way to install & configure this plugin is to use the Homebridge UI.

Using the Homebridge UI, simply enter the required information to add your eufy RoboVac:

• RoboVac Name
• RoboVac IP Address
• device ID
• local key

The plugin will then discover & add your RoboVac.

It is recommended you then configure the plugin as a Child Bridge for optimal performance of Homebridge and the plugin.

Installing & Configuring the Plugin Manually

To install the plugin manually, run the below command:

npm install -g homebridge-eufy-robovac

You can configure the plugin manually by modifying your Homebridge's config.json file and adding to below to the accessories section:

  {
    "accessoryType": "Eufy RoboVac",
    "accessoryName": "<The name of your eufy RoboVac>",
    "accessoryIp": "<The IP address of your eufy RoboVac>",
    "deviceId": "<deviceId>",
    "localKey": "<localKey>",
    "useSwitchService": "<switch | fan, defaults to switch>",
    "disableDebugLog": "<true | false, defaults to true>"
  }

Home App Configuration

Since HomeKit does not natively support vacuums, your eufy RoboVac will be displayed in the Home app as either a Switch or Fan. This depends on what choice you make when configuring the plugin. For Homebridge UI users, this is the "eufy RoboVac Accessory Type" dropdown menu, for manual configuration users, this is the "useSwitchService".

Advanced Configuration

If Find My Robot is disabled, the find functionality with not be present in the Home app. Find My Robot can be disabled by adding the below into the JSON configuration:

    "hideFindButton": true

Your eufy RoboVac can report errors via the Home app using a "Motion Sensor". The Motion Sensor is activated when an error is reported. You can use this to configure alerts and other automations in the Home app. This can be disabled by adding the below into the JSON configuration:

    "hideErrorSensor": true

The plugin can output additional logging into the Homebridge log output. This can be useful for troubleshooting purposes or to report issues with the plugin. THis can be enabled by adding the below into the JSON configuration:

    "debugLog": true

Thank You

• mitchellrj - Did most of the legwork in figuring out how to talk to the Eufy
• seikan - Provided a great example for how to expose a vacuum cleaner in homebridge/homekit

Development

This plugin is written in TypeScript. You should just need to run npm run build after making changes in the src/ directory.

Also this plugin is dependent on eufy-robovac so you will probably want to fork that repo as well.