Node Red Node for Neato Botvac robots
npm install node-red-contrib-neato-botvacjson
{
"payload":
{
"version":1,
"reqId":"77",
"result":"ok",
"data":{},
"error":null,
"alert":"nav_floorplan_load_fail",
"state":1,
"action":0,
"cleaning":
{
"category":2,
"mode":2,
"modifier":1,
"navigationMode":1,
"spotWidth":0,
"spotHeight":0
},
"details":
{
"isCharging":false,
"isDocked":true,
"isScheduleEnabled":true,
"dockHasBeenSeen":false,
"charge":95
},
"availableCommands":
{
"start":true,
"stop":false,
"pause":false,
"resume":false,
"goToBase":false
},
"availableServices":
{
"findMe":"basic-1",
"generalInfo":"basic-1",
"houseCleaning":"basic-3",
"IECTest":"advanced-1",
"logCopy":"basic-1",
"maps":"macro-1",
"preferences":"basic-2",
"schedule":"minimal-1",
"softwareUpdate":"basic-1",
"spotCleaning":"minimal-2",
"wifi":"basic-1"
},
"meta":
{
"modelName":"BotVacD5Connected",
"firmware":"4.5.0-179"
}
},
"topic":"result",
"_msgid":"f407cae1.707da8"
}
`
For more information about the possible output visit Neato Robot Remote Protocol
or Neato Nucleo Api
$3
The following commands are available at the moment:
#### start
All parameters which are not given will be preset with the internal settings of robot!
Parameters are only examples here...
`json
{"command":"start","eco":true,"navigationmode":1,"nogolines":false}
`
#### pause
`json
{"command":"pause"}
`
#### resume
`json
{"command":"resume"}
`
#### stop
`json
{"command":"stop"}
`
#### sendtobase
Available only on some models!
`json
{"command":"sendtobase"}
`
#### findme
`json
{"command":"findme"}
`
#### dismissCurrentAlert
`json
{"command":"dismissCurrentAlert"}
`
#### enableSchedule
`json
{"command":"enableSchedule"}
`
#### disableSchedule
`json
{"command":"disableSchedule"}
`
#### getSchedule
`json
{"command":"getSchedule"}
`
#### startSpotCleaning
All parameters which are not given will be preset with the internal settings of robot!
Parameters are only examples here...
`json
{"command":"startSpotCleaning","eco":true,"width":50, "height": 20, "repeat":false, "navigationmode":1}
`
#### startManualCleaning
All parameters which are not given will be preset with the internal settings of robot!
Parameters are only examples here...
`json
{"command":"startManualCleaning","eco":true,"navigationmode":1}
`
#### startCleaningBoundary
All parameters (except boundaryId) which are not given will be preset with the internal settings of robot!
To execute the command you have to set a boundaryId of a map!
Parameters are only examples here...
`json
{"command":"startCleaningBoundary","eco":true, "extraCare":false, "boundaryId":"XXXXX"}
`
Getting map information
To get map information place the neato-maps node and configure the neato config as described above.
Any command on the input side will cause to get the actual map data from your configured robot.
Example of the output data of the node:
`json
{
"payload":
{
"stats": {},
"maps":[
{
"id":"2019-10-16T07:00:01Z",
"url":"https://neatorobotics.s3.amazonaws.com/....",
"url_valid_for_seconds":300,
"version":1,
"generated_at":"2019-10-16T07:42:55Z",
"status":"complete",
"launched_from":"schedule",
"error":null,
"modifier":1,
"start_at":"2019-10-16T07:00:01Z",
"end_at":"2019-10-16T07:42:55Z",
"end_orientation_relative_degrees":4,
"run_charge_at_start":98,
"run_charge_at_end":67,
"persistent_map_id":null,
"cleaned_with_persistent_map_id":null,
"suspended_cleaning_charging_count":0,
"time_in_suspended_cleaning":0,
"time_in_error":0,
"time_in_pause":0,
"cleaned_area":36.4224,
"base_count":1,
"is_docked":true,
"delocalized":false,
"valid_as_persistent_map":false,
"category":2,
"mode":2,
"navigation_mode":1
},
//... Up to 20 entries
]
}
}
`
Getting boundary information
To get boundary information place the neato-boundary node and configure the neato config as described above.
There are two commands to execute in this node:
#### getMapBoundaries
To get a mapID you have to look for it with the neato-map node!
Parameters are only examples here...
`json
{"command":"startSpotCleaning","mapid":"-->Get this with the map node!"}
`
#### setMapBoundaries
To get a mapID you have to look for it with the neato-map node!
Boundaries are given as array with the following data:
* {string} color - color hex code for a type polygone or '#000000' for a type polyline
* {bool} enabled - always true, unknown usage
* {string} id - boundary id (uuid-v4)
* {string} name - polygone name or empty string for a type polyline
* {number[]} [relevancy] - array of 2 number, center of a type polygone
* {string} type - either polyline (for a no go lines) or polygon (for a zone)
* {number[][]} vertices - array of array of two points, coordinates of the points
Parameters are only examples here...
`json
{"command":"startSpotCleaning","mapid":"-->Get this with the map node!", "boundaries":"-->see object definition above"}
``