Time to complete: 10 minutes
In this section, we'll set up video feeds, command shortcuts, and key metrics. These are the minimal features most users need to monitor their robot and intervene if something goes wrong. For example, you could:
- Monitor a coffee-making robot, observe a spill, and request it run a robotic cleaning sequence
- Actuate a recovery behavior after a human identifies a problem on a mobile robot
- Remotely monitor camera feeds on an inspection robot
To get started controlling your robot, we'll walk through setting up the following:
You can stream video feeds with low latency to allow you to safely control and operate your robot. If you haven't already, we strongly recommend that you enable WebRTC before moving on to the next step, to get the lowest latency connection possible to the robot.
Launch a node which publishes camera images of type
sensor_msgs/Image. The Freedom Agent will detect the node and upload the data for you. That's it! There's nothing else you need to do.
We recommend setting your video feed to upload to the cloud at 1 Hz (WebRTC will separately upload the feed at 10 Hz). You can set the upload rate by navigating to SETTINGS → BANDWIDTH.
You can launch multiple camera image nodes, and Freedom will allow you to switch between them when piloting your robot.
Freedom allows you to send a pre-defined message payload to a topic. You can think of these as memorized commands that can be replayed. Undock a robot. Reset an arm. Initiate a script to brew coffee.
When you're piloting a robot, the available commands are shown in the footer of the pilot view. Here's what this looks like for our fetch device looks like:
To create a new command, go to SETTINGS → PILOT → CONTROLS → ADD NEW COMMAND. You'll need to specify a nickname, topic name, topic type, and payload.
Here are example commands for
Display name for the command.
Topic to publish on.
Type of message to publish.
The lifetime where the command is valid.
Payload to publish when the command is sent.
Think of key metrics as the most important pieces of information that an operator needs to see at a glance to determine a robot's state. When you're piloting a robot, the key metrics are shown in the bottom left corner of the screen.
A key metric should be set up to define the "good" or "normal" state for your robot. If your robot doesn't meet this condition while being piloted, Freedom will call attention to this by highlighting the key metric in red on the Pilot user interface.
To add a new key metric, navigate to your device and select SETTINGS → METRICS → ADD.
Here's an example of a key metric for the bumper of a robot:
Name of the key metric.
Topic associated with the key metric.
Relevant key in the message (JSON object) published on the topic.
Type of comparison.
Value used in the comparison.
If the key metric condition is met (in this case,
is_left_pressed = FALSE), all is well with the robot. If not, something is wrong.
It's time for the fun part: controlling your robot! Click PILOT on the left sidebar, then click TAKE OVER.
If you have multiple video feeds, you can switch between them by clicking on the feed you'd like to view in the top left corner of the screen.
You can send a command by clicking on an option in the bottom right corner.
The key metrics you've added will appear in the bottom left corner of the screen. Pay special attention to any that appear in red - this means a value is not in a "normal" state, and something has gone wrong!
Updated about 1 month ago