roomba

Node module for controlling a Roomba vacuum cleaner. Tested with a Roomba 960 but is expected to work with the entire 900 series.

Installation

Install using npm install --save git+ssh://git@github.com/simonbs/roomba.git

Finding your blid, robotpwd and asset ID

The blid, robotpwd and asset ID are used to identify your Roomba and authorize API calls. In order to find these values, you must inspect the HTTP requests made by the Roomba iOS app. I recommend using Charles for this. The following will assume you are comfortable with Charles.

1. Open up Charles and configure the proxy on your iOS device in the WiFi settings.
2. Open the Roomba iOS app and make sure you have recorded some calls to https://irobot.axeda.com in Charles. In particular, you should have recorded requests to https://irobot.axeda.com/services/v1/rest/Scripto/execute/AspenApiRequest.
3. Find one of the requests and browse the contents of the request, e.g. in the raw format. The body of the request will contain your blid and robotpwd. There will be a header named ASSET-ID containing your asset ID.