Unofficial iRobot Roomba 980 library (SDK).
With this library you can send commands to your Roomba 980 through the iRobot cloud API and integrate with your own Home automation project.
$ npm install dorita980var Dorita980 = require('dorita980');
var myRobot = new Dorita980('robotID', 'password');
// start to clean!
myRobot.start().then((response) => {
console.log(response);
}).catch((err) => {
conole.log(err);
});Get robot status example:
var Dorita980 = require('dorita980');
var myRobot = new Dorita980('robotID', 'password');
myRobot.getStatus().then(function(data){
console.log(data);
}).catch(function(err){
console.error(err);
});Dock the robot:
var Dorita980 = require('dorita980');
var myRobot = new Dorita980('robotID', 'password');
// go home!
myRobot.dock().then((response) => {
console.log(response);
}).catch((err) => {
conole.log(err);
});When you connect your roomba to your wifi network, the robot starting to receive remote commands from the iRobot Cloud Service and from the mobile app. iRobot Cloud Service has a public HTTP API to send commands to your robot if you known your user and password.
With a clasical MITM atack with ssl split! You need:
- Roomba 980 configured and connected to internet
- Computer
- Charles Proxy installed in your pc/mac https://www.charlesproxy.com/
- A phone with the iRobot app
-
Install and run Charles Proxy in your pc/mac. Enable ssl proxy on port 8888.
-
Configure your mobile to use HTTP Proxy (iphone instructions here and andriod instructions here) using the IP of your computer and port 8888.
-
Install CA cert visiting http://charlesproxy.com/getssl from your phone.
-
Open iRobot app on your phone.
-
Now on Charles, accept the incomming connection from your phone, then you can see all the trafic between the app and the Cloud.
-
Find a request to
irobot.axeda.comwith the valuesblid=(user) androbotpwd=(password) -
Copy that and use in this lib ;)
(Full Documentation pending...)
myRobot.getStatus()myRobot.accumulatedHistorical()myRobot.missionHistory()myRobot.clean()myRobot.quick()myRobot.spot()myRobot.dock()myRobot.start()myRobot.pause()myRobot.resume()myRobot.stop()myRobot.wake()myRobot.reset()myRobot.find()myRobot.wipe()(untested)myRobot.patch()(untested)myRobot.dlpkg()(untested)myRobot.rechrg()(untested)myRobot.wlapon()(untested)myRobot.wlapoff()(untested)myRobot.wlston()(untested)myRobot.wlstoff()(untested)myRobot.wifiscan()(untested)myRobot.ipdone()(untested)myRobot.provdone()(untested)myRobot.bye()(untested)myRobot.wllogflush()(untested)myRobot.sleep()myRobot.off()myRobot.fbeep()
We need:
- A way (algorithm) to obtain the
robotIDfrom the Serial Number or something. - A way (algorithm) to obtain the
passwordwithout MITM atack. (maybe derivative from wifi Access Point name/password or Serial Number?) - Research to handle all the API commands