Browse Source

Update stretch body and stretch ros instructions

pull/3/head
hello-chintan 2 years ago
parent
commit
dae398b368
2 changed files with 38 additions and 6 deletions
  1. +1
    -1
      getting_started/README.md
  2. +37
    -5
      getting_started/updating_software.md

+ 1
- 1
getting_started/README.md View File

@ -6,7 +6,7 @@ Please take the time to get to know your robot by going through these tutorials
## What Version of Robot Do I Have? ## What Version of Robot Do I Have?
Stretch RE1 and RE2 are very similar. One quick way to tell the difference is look at the robot's hostame:
Stretch RE1 and RE2 are very similar. One quick way to tell the difference is to look at the robot's hostame:
```bash ```bash
>>$ hostname >>$ hostname

+ 37
- 5
getting_started/updating_software.md View File

@ -12,17 +12,41 @@ Each Stretch is shipped with firmware, a Python SDK, and ROS packages developed
### Stretch ROS ### Stretch ROS
Stretch ROS is the [Robot Operating System](https://www.ros.org/about-ros/) (ROS) interface to the robot. Many robotics developers find ROS useful to bootstrap their robotics software developments. You may update it using the following commands:
Stretch ROS is the [Robot Operating System](https://www.ros.org/about-ros/) (ROS) interface to the robot. Many robotics developers find ROS useful to bootstrap their robotics software developments. Depending on whether you want to setup a ROS or ROS 2 workspace, the easiest way to download the most recent updates in the stretch_ros and stretch_ros2 repos, while resolving all source built dependencies at the same time, is by following the instructions in the [Creating a New ROS Workspace](https://github.com/hello-robot/stretch_install/blob/master/docs/ros_workspace.md) section in the stretch_install repo.
**Warning**: Before you proceed, please ensure that all your personal files in the catkin or ament workspace have been backed up safely. This is important because executing the following set of commands deletes your existing workspace and replaces it with a fresh one.
To download the stretch_install repo, execute:
```console ```console
$ roscd stretch_core
$ git pull
cd ~/
git clone https://github.com/hello-robot/stretch_install.git
cd stretch_install
git pull
``` ```
### Stretch Body
To replace the ROS Melodic catkin_ws in Ubuntu 18.04, execute:
```console
# Create a ROS workspace
./factory/18.04/stretch_create_catkin_workspace.sh -w <optional-path-to-ws>
```
Stretch Body is the Python SDK to the robot. It abstracts away the low level details of communication with the embedded devices and provides an intuitive API to working with the robot. You may update it using the following commands:
To replace the ROS Noetic catkin_ws in Ubuntu 20.04, execute:
```console
# Create a ROS workspace
./factory/20.04/stretch_create_catkin_workspace.sh -w <optional-path-to-ws>
```
To replace the ROS 2 Galactic ament_ws in Ubuntu 20.04, execute:
```console
# Create a ROS2 workspace
./factory/20.04/stretch_create_ament_workspace.sh -w <optional-path-to-ws>
```
### Stretch Body Python SDK
Stretch Body is the Python SDK to the robot. It abstracts away the low level details of communication with the embedded devices and provides an intuitive API to working with the robot. You may update it using the following commands depending on the Python version.
If you are using Python2, execute:
```console ```console
$ pip install -U hello-robot-stretch-body $ pip install -U hello-robot-stretch-body
$ pip install -U hello-robot-stretch-body-tools $ pip install -U hello-robot-stretch-body-tools
@ -30,6 +54,14 @@ $ pip install -U hello-robot-stretch-factory
$ pip3 install -U hello_robot_stretch_body_tools_py3 $ pip3 install -U hello_robot_stretch_body_tools_py3
``` ```
For Python3, execute:
```console
python3 -m pip -q install --no-warn-script-location hello-robot-stretch-body
python3 -m pip -q install --no-warn-script-location hello-robot-stretch-body-tools
python3 -m pip -q install --no-warn-script-location hello-robot-stretch-factory
python3 -m pip -q install --no-warn-script-location hello-robot-stretch-tool-share
```
### Stretch Firmware ### Stretch Firmware
The firmware and the Python SDK (called Stretch Body) communicate on an established protocol. Therefore, it is important to maintain a protocol match between the different firmware and Stretch Body versions. Fortunately, there is a script that handles this automatically. In the command line, run the following command: The firmware and the Python SDK (called Stretch Body) communicate on an established protocol. Therefore, it is important to maintain a protocol match between the different firmware and Stretch Body versions. Fortunately, there is a script that handles this automatically. In the command line, run the following command:

Loading…
Cancel
Save