A Kobold vacuum robot plugin for homebridge.
Go to file
Arne fbec31602f NoGo Lines and options sync
ADDED
- NoGo lines button
- Extra care navigation button
- Syncing cleaning options from last run

CHANGED
- Goto dock button is now always off
- Better error handling
- More detailed debug messages
- Updated node-botvac dependency to 0.1.6

REMOVED
- Extra care navigation option parameter (is now a button)
2018-11-11 15:53:50 +01:00
_config.yml Set theme jekyll-theme-cayman 2017-04-30 18:06:45 +02:00
CHANGELOG.md Version 0.4.7 2018-03-26 19:14:54 +02:00
index.js NoGo Lines and options sync 2018-11-11 15:53:50 +01:00
LICENSE Initial commit 2017-04-17 16:07:21 +02:00
package.json NoGo Lines and options sync 2018-11-11 15:53:50 +01:00
README.md Version 0.4.7 2018-03-26 19:14:54 +02:00

homebridge-neato

npm npm GitHub last commit

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 (plugin is now a platform).

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

  1. Install homebridge using: npm install -g homebridge
  2. Install this plugin using: npm install -g homebridge-neato
  3. If you don't have a Neato account yet create one here.
  4. 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 that are off when not specified.

The parameter refresh sets 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 sets if supporting models (currently Neato D3 and D5) should take extra care of your furniture while cleaning.

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

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

Tested robots

  • BotVac Connected (Firmware 2.2.0)
  • BotVac D3 Connected
  • BotVac D5 Connected (Firmware 4.0.0-1632)

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

Contributors

Many thanks go to

  • ghulands for finding and fixing a bug when no robot is associated with the neato account