homebridge-neato

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

Feel free to leave any feedback here.

If you update from a previous version 0.3.x you have to adapt your config.

Features

Start and pause cleaning
Return to dock*
Enable and disable schedule
Enable and disable eco mode
Get battery info
Get dock info
Periodic refresh of robot state
Support for multiple robots
Extra care navigation

* Available after some seconds of cleaning.

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 name, email and password.

Simple

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

Advanced

The following config contains optional settings that are disabled when not specified.

The parameter refresh adjusts in what interval (seconds) changes of the robot state will be pushed to homekit. The minimum refresh time is 60 seconds. You need this only when you set up rules based on the robot state and start him outside of homekit (e.g. with the Neato app).

The parameter extraCareNavigation determines if supporting models (currently Neato D3 and D5) take extra care of your furniture while cleaning.

"platforms": [
	{
		"platform": "NeatoVacuumRobot",
		"email": "YourEmail",
		"password": "YourPassword",
		"refresh": "120",
		"extraCareNavigation": true
	}
]

Tested robots

BotVac Connected (Firmware 2.2.0)
BotVac D5 Connected

If you have another connected neato robot, please tell me about your experience with this plugin.

2.2 KiB Raw Blame History