Browse Source

Provided an addtional guide for creating a workspace

galactic
Alan G. Sanchez 2 years ago
parent
commit
4b2ab2b542
1 changed files with 16 additions and 10 deletions
  1. +16
    -10
      getting_started.md

+ 16
- 10
getting_started.md View File

@ -2,10 +2,10 @@
## Ubuntu ## Ubuntu
Hello Robot utilizes Ubuntu, an open source Linux operating system, for the Stretch RE1 platform. If you are unfamiliar with the operating system, we encourage you to review a [tutorial](https://ubuntu.com/tutorials/command-line-for-beginners#1-overview) provided by Ubuntu. Additionally, the Linux command line, BASH, is used to execute commands and is needed to run ROS on the Stretch robot. Here is a [tutorial](https://ryanstutorials.net/linuxtutorial/) on getting started with BASH.
Hello Robot utilizes Ubuntu, an open-source Linux operating system, for the Stretch RE1 platform. If you are unfamiliar with the operating system, we encourage you to review a [tutorial](https://ubuntu.com/tutorials/command-line-for-beginners#1-overview) provided by Ubuntu. Additionally, the Linux command line, BASH, is used to execute commands and is needed to run ROS on the Stretch robot. Here is a [tutorial](https://ryanstutorials.net/linuxtutorial/) on getting started with BASH.
## Installing Noetic on Stretch ## Installing Noetic on Stretch
Instructions on installing Noetic can be found in our open source [installation guide](https://github.com/hello-robot/stretch_ros/blob/dev/noetic/install_noetic.md). Once your system is setup, clone the [stretch_ros_tutorials](https://github.com/hello-sanchez/stretch_ros_tutorials.git) to your workspace. Then build the packages in your workspace.
Instructions on installing Noetic can be found in our open-source [installation guide](https://github.com/hello-robot/stretch_ros/blob/dev/noetic/install_noetic.md). Then create a catkin workspace for your ROS packages. Here is an [installation guide for creating a workspace](http://wiki.ros.org/catkin/Tutorials/create_a_workspace). Once your system is set up, clone the [stretch_ros_tutorials](https://github.com/hello-sanchez/stretch_ros_tutorials.git) to your workspace and build the package in your workspace. This can be done by copying the commands below and pasting them into your terminal.
``` ```
cd ~/catkin_ws/src cd ~/catkin_ws/src
@ -16,29 +16,35 @@ catkin_make
## ROS Setup on Local Computer ## ROS Setup on Local Computer
Hello Robot is currently running Stretch on Ubuntu 20.04 and on ROS Noetic. To begin the setup, begin with [installing Ubnutu desktop](https://ubuntu.com/tutorials/install-ubuntu-desktop#1-overview) on your local machine. Then follow the [installation guide for ROS Noetic](http://wiki.ros.org/noetic/Installation/Ubuntu) on your system.
Hello Robot is currently running Stretch on Ubuntu 20.04 and ROS Noetic. To begin the setup, start with [installing Ubuntu desktop](https://ubuntu.com/tutorials/install-ubuntu-desktop#1-overview) on your local machine. Then follow the [installation guide for ROS Noetic](http://wiki.ros.org/noetic/Installation/Ubuntu) on your system.
Currently, the Realsense2_description package isn't installed by rosdep and requires a user to manually install the package. Run the following command in your terminal
Currently, the Realsense2_description package isn't installed by rosdep and requires a user to install the package manually. Run the following command in your terminal
```bash
```
sudo apt-get install ros-noetic-realsense2-camera sudo apt-get install ros-noetic-realsense2-camera
``` ```
After your system is setup, clone the [stretch_ros](https://github.com/hello-robot/stretch_ros.git), [stretch_ros_tutorials](https://github.com/hello-sanchez/stretch_ros_tutorials.git), and [realsense_gazebo_plugin packages]( https://github.com/pal-robotics/realsense_gazebo_plugin) to your preferred workspace. Then install dependencies and build the packages.
```bash
After your system is setup, clone the [stretch_ros](https://github.com/hello-robot/stretch_ros.git), [stretch_ros_tutorials](https://github.com/hello-sanchez/stretch_ros_tutorials.git), and [realsense_gazebo_plugin packages]( https://github.com/pal-robotics/realsense_gazebo_plugin) to your preferred workspace.
```
cd ~/catkin_ws/src cd ~/catkin_ws/src
git clone https://github.com/hello-robot/stretch_ros git clone https://github.com/hello-robot/stretch_ros
git clone https://github.com/pal-robotics/realsense_gazebo_plugin git clone https://github.com/pal-robotics/realsense_gazebo_plugin
git clone https://github.com/hello-sanchez/stretch_ros_tutorials.git git clone https://github.com/hello-sanchez/stretch_ros_tutorials.git
```
Change the directory to that of your catkin workspace and install system dependencies of the ROS packages. Then build your workspace. You can do all this by running the following commands in your terminal.
```
cd ~/catkin_ws cd ~/catkin_ws
rosdep install --from-paths src --ignore-src -r -y rosdep install --from-paths src --ignore-src -r -y
catkin_make catkin_make
``` ```
Then source your workspace with the following command
```bash
Then source your workspace and `.bashrc` file with the following command
```
echo "source /home/USER_NAME/catkin_ws/devel/setup.bash" echo "source /home/USER_NAME/catkin_ws/devel/setup.bash"
source ~/.bashrc
``` ```
## RoboMaker ## RoboMaker
@ -46,6 +52,6 @@ echo "source /home/USER_NAME/catkin_ws/devel/setup.bash"
![image](images/aws-robomaker.png) ![image](images/aws-robomaker.png)
If a you are unable to dual boot and install ubuntu on your local machine, an alternative is to use [AWS RoboMaker](https://aws.amazon.com/robomaker/). AWS RoboMaker extends the ROS framework with cloud services. The service provides a robotics simulation service, allowing for testing of the Stretch RE1 platform. If you are a first-time user of AWS RoboMaker, follow the [guide here](https://github.com/aws-robotics/aws-robomaker-robotics-curriculum/blob/main/getting-started-with-aws-robomaker/_modules/mod-2a-aws.md) to get up and running with the service.
If you cannot dual boot and install ubuntu on your local machine, an alternative is to use [AWS RoboMaker](https://aws.amazon.com/robomaker/). AWS RoboMaker extends the ROS framework with cloud services. The service provides a robotics simulation service, allowing for testing the Stretch RE1 platform. If you are a first-time user of AWS RoboMaker, follow the [guide here](https://github.com/aws-robotics/aws-robomaker-robotics-curriculum/blob/main/getting-started-with-aws-robomaker/_modules/mod-2a-aws.md) to get up and running with the service.
**Next Tutorial:** [Gazebo Basics](gazebo_basics.md) **Next Tutorial:** [Gazebo Basics](gazebo_basics.md)

Loading…
Cancel
Save