For anyone wanting to have remote control of their vacuum, we have worked out that you can send an app_rc_move API command with the following parameters duration, omega, seqnum, velocity.
Steps;
- First you must send an app_rc_start command.
Example - Remote Control (Start)
action: vacuum.send_command
metadata: {}
data:
command: app_rc_start
target:
device_id: #Your vacuum
- Then you can send move commands.
Note: Start the seqnum at 1 for the first command, then increment the seqnum value by (+1) for each command after that.
Example - Forward Motion
- action: vacuum.send_command
metadata: {}
data:
command: app_rc_move
params:
- duration: 0 #In milliseconds and defines how long the vacuum should perform the action.
omega: 0 #This refers to the angular velocity, which controls the turning speed of the vacuum.
seqnum: 1 #Start at 1 and increment (+1) each command.
velocity: 0.2 #This refers to the forward (positive values) or backward (negative values) speed of the vacuum.
target:
device_id: #Your vacuum
- When you are finished using the remote controls, send an app_rc_stop command and then an app_rc_end command. This will stop remote controls and reset the seqnum value back to 0.
Example - Remote Control (Stop)
action: vacuum.send_command
metadata: {}
data:
command: app_rc_stop
target:
device_id: #Your vacuum
Example - Remote Control (End)
action: vacuum.send_command
metadata: {}
data:
command: app_rc_end
target:
device_id: #Your vacuum
You can then create your own scripts and automations using the above actions to achieve remote control.
An example we have done uses custom button cards (example below) to trigger the scripts and automations.
Workings are in progress to mimic the joystick controls in the Roborock app.
Stay tuned…
Mike
