@@ -52,7 +52,6 @@ ROS2 Kortex is the official ROS2 package to interact with Kortex and its related
52
52
53
53
54
54
## Getting started
55
- <!-- TODO(moriarty) update this when binary package is released getting most users should use binary release -->
56
55
57
56
1 . Install ROS 2.
58
57
@@ -64,35 +63,58 @@ ROS2 Kortex is the official ROS2 package to interact with Kortex and its related
64
63
65
64
After installing a version of ROS, source the setup.bash, which will set the ` $ROS_DISTRO ` environment variable.
66
65
67
- 2 . Optional: install Cyclone DDS
66
+ 2 . Install this package from binary
67
+ ```
68
+ sudo apt install ros-$ROS_DISTRO-kortex-bringup
69
+ ```
70
+
71
+ 3 . Optional: install MoveIt Configuration and Cyclone DDS
72
+
73
+ If you have a 7dof arm:
74
+ ```
75
+ sudo apt install ros-$ROS_DISTRO-kinova-gen3-7dof-robotiq-2f-85-moveit-config
76
+ ```
77
+ If you have a 6dof arm:
78
+ ```
79
+ sudo apt install ros-$ROS_DISTRO-kinova-gen3-6dof-robotiq-2f-85-moveit-config
80
+ ```
68
81
If you plan to use MoveIt, it is recommended to install and use Cyclone DDS.
69
82
```
70
83
sudo apt install ros-$ROS_DISTRO-rmw-cyclonedds-cpp
71
84
export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp
72
85
```
73
86
74
- 3 . Make sure that ` colcon ` , its extensions, and ` vcs ` are installed:
87
+ 4 . Go to Usage section
88
+
89
+ ## Contributing to this repository or building from source
90
+
91
+ Note: It is recommended to use a released binary version of this package and apt install it.
92
+ If you want the latest version of this repository for testing latest fixes
93
+ check out testing with pre-released binaries: https://docs.ros.org/en/rolling/Installation/Testing.html
94
+
95
+ If the bug fix you need isn't in a released version or If you want to build this repository from source or contribute back to the repository read on.
96
+
97
+ 1 . Make sure that ` colcon ` , its extensions, and ` vcs ` are installed:
75
98
```
76
99
sudo apt install python3-colcon-common-extensions python3-vcstool
77
100
```
78
101
79
- 4 . Create a new ROS2 workspace:
102
+ 2 . Create a new ROS2 workspace:
80
103
```
81
104
export COLCON_WS=~/workspace/ros2_kortex_ws
82
105
mkdir -p $COLCON_WS/src
83
106
```
84
107
85
- 5 . Pull relevant packages, install dependencies, compile, and source the workspace by using:
108
+ 3 . Pull relevant packages, install dependencies, compile, and source the workspace by using:
86
109
```
87
110
cd $COLCON_WS
88
111
git clone https://github.com/PickNikRobotics/ros2_kortex.git src/ros2_kortex
89
- vcs import src --skip-existing --input src/ros2_kortex/ros2_kortex.repos
90
112
rosdep install --ignore-src --from-paths src -y -r
91
113
colcon build --cmake-args -DCMAKE_BUILD_TYPE=Release
92
114
source install/setup.bash
93
115
```
94
116
95
- 6 . To simulate the robot with ignition or gazebo make sure to pull and build additional packages:
117
+ 4 . To simulate the robot with ignition or gazebo make sure to pull and build additional packages:
96
118
```
97
119
vcs import src --skip-existing --input src/ros2_kortex/simulation.repos
98
120
rosdep install --ignore-src --from-paths src -y -r
0 commit comments