Skip to main content

Robot Control

The Robot Control app is where users can control the robot directly by queuing either programs or separate SaviScript.

Depending on your authorization level, you may see robots for multiple sites. This article will be discussing Robot Control for a selected robot.

note

In order to use this app, you will need authorization enabled on the Cloud Portal. If you cannot see Robot Control and believe you should have access, contact your administrator.

Features​

Within the Robot Control app, there are three main features:

Robot Status​

Robot Status

The top section of the app shows the robot's status and up-to-date information:

  • Synced Site: Displays the synced abbreviated site name.
  • ROC: Displays current ROC link.
  • Docked: Displays whether or not the robot is currently docked. Green checkmark icon indicates docked, and red X icon indicates not docked.
  • Connectivity: Displays whether or not the robot is currently connected to the Cloud.
  • Battery: Displays robot's current battery level percentage.
  • Status: Displays robot's current action (includes programs, syncs, exceptions, etc.) - the above example shows that the robot is currently running the Base program.

This information is constantly updated every second (needs review).

Robot Control​

There are two methods to communicate SaviScript to the robot, using Queue Program or Queue SaviScript.

Either can be used and accessed on this app, and each method is independent of the other (i.e. if the Program Name field is filled out but instead the Queue SaviScript method is used, the app will not run the Queue Program method, and it will only run the manually inputted code).

Queue Program​

Queue Program

In the Program Name field, a saved and synced program name can be entered. Pressing the Queue Program button will queue the program, and if it exists, the robot will run the program.

Programs must be referenced by both its namespace and name, or "Namespace/ProgramName".

Queue SaviScript​

Queue Program

This method allows for manual command input in the provided field to send SaviScript code snippets to run on the robot. Entering valid SaviScript code in the box and pressing Queue SaviScript will queue just those lines of code as the very next action, even if the robot is currently running a different program.

For example, the robot is currently running the Mingle program. The following code is queued via SaviScript:

OPEN_LID

The robot will finish its current command, then immediately run the queued code- the OPEN_LID command.

caution

Requires testing to observe specific behavior.

General Commands​

Example of the Program Viewer interface

On the right sidebar, the general commands have logging, syncing, and resetting options for the robot:

  • Log "Hello World": Sends a test log of "Hello World". (needs review)
  • Sync: Syncs the robot with updated assets and programs. Whenever a program is added, editted, or deleted in Program Control, make sure the robot is synced! Default syncing method is Standard.
  • CANCEL ALL: Clears all programs running and queued.
  • Restart: Power cycles the robot. (needs review)