homebridge-neato

This is a plugin for homebridge to control your Neato vacuum robot. You can download it via npm.

If you like this plugin and find it useful, I would be very grateful for your support:

Feel free to leave any feedback here.

Features

House Cleaning
- Eco mode
- Extra care navigation
- Nogo lines
Zone cleaning
Spot cleaning
- Individual spot size (only D7)
- Clean twice
Return to dock
Find the robot
Schedule (de)activation
Robot information
- Battery level
- Charging state
- Dock occupancy
- Model and firmware version
Automatic or periodic refresh of robot state
Multiple robots

Installation

Install homebridge using: npm install -g homebridge
Install this plugin using: npm install -g homebridge-neato
If you don't have a Neato account yet create one here.
Update your configuration file. See the sample below.

Configuration

Add the following information to your config file. Change the values for email and password.

Simple

"platforms": [
	{
		"platform": "NeatoVacuumRobot",
		"email": "YourEmail",
		"password": "YourPassword"
	}
]

Advanced

The following config contains advanced optional settings.

The parameter refresh is default set to auto and updates the robot state when the cleaning was started via homekit so that you can activate automations after the cleaning is done. If you want to get robot state updates after starting the cleaning from the neato app or a schedule, you have to set refresh to a static value in seconds e.g. 120. You can disable background updates completely by setting this to 0.

The parameter disabled accepts a list of switches/sensors that can be disabled in the neato homekit plugin (e.g. dock, dockstate, eco, schedule, findme, spot).

"platforms": [
	{
		"platform": "NeatoVacuumRobot",
		"email": "YourEmail",
		"password": "YourPassword",
		"refresh": "120",
		"disabled": ["dock", "dockstate", "eco", "nogolines", "extracare", "schedule", "findme", "spot"]
	}
]

Tested robots

BotVac Connected
BotVac D3 Connected
BotVac D4 Connected
BotVac D5 Connected
BotVac D6 Connected
BotVac D7 Connected

Contributors

Many thanks go to

ghulands for finding and fixing a bug when no robot is associated with the neato account
Berkay for adding the schema file to use the plugin with homebridge-config-ui-x
Antoine de Maleprade for adding the zone cleaning feature
DJay for testing out tons of new beta versions

3.4 KiB Raw Blame History