AWS DeepRacer interfaces package for the Follow the Leader (FTL) sample project

Overview

The AWS DeepRacer interfaces ROS package is a foundational package that creates the custom service and message types that are used in the core AWS DeepRacer application. The package is extended and modified to support the Follow the Leader (FTL) sample project. These services and messages are shared across the packages that are part of the AWS DeepRacer application and the FTL sample project. For more information about the FTL sample project, see the AWS DeepRacer Follow the Leader (FTL) sample project.

License

The source code is released under Apache 2.0.

Installation

Follow these steps to install the AWS DeepRacer interfaces package for the Follow the Leader (FTL) sample project.

Prerequisites

The AWS DeepRacer device comes with all the prerequisite packages and libraries installed to run the FTL sample project. For more information about the preinstalled set of packages and libraries on the AWS DeepRacer, and about installing the required build systems, see Getting started.

The deepracer_inferfaces_pkg specifically depends on the following ROS 2 packages as build and run dependencies:

1. rosidl_default_generators: The custom-built interfaces rely on rosidl_default_generators for generating language-specific code.
2. rosidl_default_runtime: The custom-built interfaces rely on rosidl_default_runtime for using the language-specific code.
3. sensor_msgs: This package defines messages for commonly used sensors, including cameras and scanning laser rangefinders.
4. std_msgs: Standard ROS Messages including common message types representing primitive data types and other basic message constructs, such as multiarrays.

Downloading and building

Open a terminal on the AWS DeepRacer device and run the following commands as the root user.

1. Switch to the root user before you source the ROS 2 installation:

    sudo su
   

2. Source the RO S2 Foxy setup script:

    source /opt/ros/foxy/setup.bash
   

3. Create a workspace directory for the package:

    mkdir -p ~/deepracer_ws
    cd ~/deepracer_ws
   

4. Clone the entire FTL sample project on the AWS DeepRacer device:

    git clone https://github.com/aws-deepracer/aws-deepracer-follow-the-leader-sample-project.git
    cd ~/deepracer_ws/aws-deepracer-follow-the-leader-sample-project/deepracer_follow_the_leader_ws/
   

5. Resolve the dependencies:

    cd ~/deepracer_ws/aws-deepracer-follow-the-leader-sample-project/deepracer_follow_the_leader_ws/ && rosdep install -i --from-path . --rosdistro foxy -y
   

6. Build the deepracer_interfaces_pkg:

    cd ~/deepracer_ws/aws-deepracer-follow-the-leader-sample-project/deepracer_follow_the_leader_ws/ && colcon build --packages-select deepracer_interfaces_pkg
   

Resources

• Getting started with AWS DeepRacer OpenSource
• Getting started with the Follow the Leader (FTL) sample project