ARI hardware APIs¶

Cameras¶

The following Figure illustrates the cameras mounted on the robot:

Torso front camera¶

Stereo RGB-D camera: This camera is mounted on the frontal side of the torso below the touchscreen and provides RGB images along with a depth image obtained by using an IR projector and an IR camera. The depth image is used to obtain a point cloud of the scene.

Torso front camera-related topics:

Torso back camera¶

Stereo-fisheye camera: This camera is mounted on the back side of the torso, right below the emergency button, and provides stereo, fisheye and black and white images.

Torso back camera-related topics:

Head camera¶

Either one of these cameras is located inside ARI’s head.

RGB camera: provides RGB images

RGB-D camera: provides RGB-D images

Head camera-related topics:

Optional cameras¶

The touchscreen can include up to three more cameras:

thermal camera
RGB camera
RGB-D camera

In order to learn how to access the cameras, please refer to Accessing your robot’s sensors.

LEDs¶

See LEDs API.

Animated eyes¶

ARI has LCD eyes which provide a collection of eyes expressions. These can be use to support engaging interactions, along with head and arms movements.

See Robot face and expressions for the list of available expression, API, and code samples.

Speakers and microphones¶

ARI has an array of four microphones that can be used to record audio and process it in order to perform tasks such as speech recognition. The microphone is located on the circular gap of the torso. There are two HIFI full-range speakers just below it.

The ReSpeaker Mic Array V2.0 consists of 4 microphones (https://www.seeedstudio.com/ReSpeaker-Mic-Array-v2-0.html). See Microphone array and audio recording for details.

To learn more about how to process speech in ARI, refer to [‼️ROS 1] Dialogue management.

ReSpeaker topics:

Joints¶

Base¶

The base joints of ARI are the front and back wheels of the robot. Take care when wheeling ARI, especially with the smaller back wheels.

The wheels can be controlled using a ros topic, specifying the desired linear and angular velocity of the robot. These velocities are specified in meters per second and are translated to wheel angular velocities internally.

Drive wheels topics:

To get more information on how to move around ARI, please refer to 🧭 Navigation.

Arms¶

ARI’s joints and arm movements are illustrated below:

Head joints¶

The joint movements for ARI’s head are shown below:

Please refer to the following entries to to learn how to move ARI’s upper body:

LIDAR¶

LIDAR topics: