-
Notifications
You must be signed in to change notification settings - Fork 18
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
bbcf498
commit 05dbcd2
Showing
7 changed files
with
4,951 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -59,3 +59,5 @@ typings/ | |
|
||
# next.js build output | ||
.next | ||
|
||
dist |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,51 @@ | ||
# homebridge-eufy-robovac | ||
Homebridge plugin for Eufy RoboVac | ||
|
||
### Features | ||
|
||
* Switch on / off. When off, it will returning to charging dock automatically. | ||
|
||
* Display battery level, and notify on low battery. | ||
|
||
* Display battery charging state. | ||
|
||
* Find robot | ||
|
||
### Installation | ||
|
||
1. Install required packages. | ||
|
||
``` | ||
npm install -g homebridge-eufy-robovac | ||
``` | ||
|
||
2. Add these values to `config.json`. | ||
|
||
``` | ||
"accessories": [ | ||
{ | ||
"accessory": "Eufy RoboVac", | ||
"name": "Vacuum Cleaner", | ||
"ip": "<optional ip address, this or deviceId must be set>", | ||
"deviceId": "<optional deviceId, this or ip must be set>", | ||
"localKey": "<localKey>" | ||
} | ||
] | ||
``` | ||
You can find out more about the `deviceId`/`localKey` [here](https://github.com/joshstrange/eufy-rob) | ||
3. Restart Homebridge, and your Eufy RoboVac will be added to Home app. | ||
### Thank You | ||
* [mitchellrj](https://github.com/mitchellrj) - Did most of the legwork in figuring out how to talk to the Eufy | ||
* [seikan](https://github.com/seikan) - Provided a [great example](https://github.com/seikan/homebridge-xiaomi-mi-robot-vacuum) 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 dependant on [eufy-robovac](https://github.com/joshstrange/eufy-robovac/) so you will probably want to fork that repo as well. |
Oops, something went wrong.