damsma / rest980-domoticz

Domoticz plugin to control your iRobot Roomba 980 with koalazak/rest980

rest980-domoticz

Domoticz plugin to control your iRobot Roomba with koalazak/rest980 (https://github.com/koalazak/rest980)

Instructiuons:

1. Install rest980

apt-get install npm nodejs
git clone https://github.com/koalazak/rest980.git
cd rest980
npm install
nano config/default.json

Type in the right values for your Roomba, should look something like this:

  ...
  "blid": "1234567890123456",
  "password": ":1:1234567890:abcDEFghiJKMnopR",
  "robotIP": "192.168.100.90",
  "firmwareVersion": 2,
  ...

and save the config file

see dorita980 for more information and instructions for obtaining blid and password.

Start rest980 forever with with PM2

npm i -g pm2
pm2 startup
pm2 start npm --name "rest980-roomba" -- start
pm2 save

check if everything works fine

wget http://127.0.0.1:3000/api/local/action/start > /dev/null

if your roomba started cleanig, you can install the plugin now.

2. Install this plugin

cd domoticz/plugins
git clone https://github.com/damsma/rest980-domoticz.git
systemctl restart domoticz

3. Configure the plugin

You can now add "iRobot Roomba (rest980-domoticz)" on the hardware page in domoticz. The device will be created automatically.

If you installed rest980 on the same machnie as domoticz, you can leave the default plugin settings, otherwise, type in the IP adress of the machnie you installed rest980 on.