From 2b696d763f9b3d6aacff5438888a461fde5411e7 Mon Sep 17 00:00:00 2001
From:  <>
Date: Wed, 23 Oct 2024 19:55:27 +0000
Subject: [PATCH] Deployed 624246f with MkDocs version: 1.6.1

---
 index.html               | 62 ++++++++++++++++++++++++++++++++++------
 search/search_index.json |  2 +-
 2 files changed, 55 insertions(+), 9 deletions(-)

diff --git a/index.html b/index.html
index 6d4bec4f..49b68d3f 100644
--- a/index.html
+++ b/index.html
@@ -345,6 +345,15 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#cloning-the-repository" class="md-nav__link">
+    <span class="md-ellipsis">
+      Cloning the Repository
+    </span>
+  </a>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#pre-built-workspaces" class="md-nav__link">
     <span class="md-ellipsis">
@@ -361,6 +370,15 @@
     </span>
   </a>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#linking-the-readme" class="md-nav__link">
+    <span class="md-ellipsis">
+      Linking the README
+    </span>
+  </a>
+  
 </li>
       
         <li class="md-nav__item">
@@ -648,6 +666,15 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#cloning-the-repository" class="md-nav__link">
+    <span class="md-ellipsis">
+      Cloning the Repository
+    </span>
+  </a>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#pre-built-workspaces" class="md-nav__link">
     <span class="md-ellipsis">
@@ -664,6 +691,15 @@
     </span>
   </a>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#linking-the-readme" class="md-nav__link">
+    <span class="md-ellipsis">
+      Linking the README
+    </span>
+  </a>
+  
 </li>
       
         <li class="md-nav__item">
@@ -743,9 +779,13 @@ <h1 id="ros-2-essentials">ROS 2 Essentials<a class="headerlink" href="#ros-2-ess
 <p>Please note that this repo is under rapid development. The code is not guaranteed to be stable, and breaking changes may occur.</p>
 </blockquote>
 <p>The documentation is hosted on <a href="https://j3soon.github.io/ros2-essentials/">https://j3soon.github.io/ros2-essentials/</a>.</p>
+<h2 id="cloning-the-repository">Cloning the Repository<a class="headerlink" href="#cloning-the-repository" title="Permanent link">&para;</a></h2>
+<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/j3soon/ros2-essentials.git
+</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nb">cd</span><span class="w"> </span>ros2-essentials
+</span></code></pre></div>
 <h2 id="pre-built-workspaces">Pre-built Workspaces<a class="headerlink" href="#pre-built-workspaces" title="Permanent link">&para;</a></h2>
-<p>Pre-built Docker images for each workspace can be pulled by running <code>docker compose pull</code> in the corresponding workspace directory.</p>
-<p>Pulling the pre-built Docker images can bypass the time-consuming building process (for both docker compose &amp; devcontainers).</p>
+<p>Pre-built Docker images for each workspace can be pulled by running <code>docker compose pull</code> in the corresponding workspace directory. Pulling these images bypasses the time-consuming build process (for both Docker Compose and Dev Containers).</p>
+<p>Click on the following workspaces to navigate to their respective documentation.</p>
 <table>
 <thead>
 <tr>
@@ -830,12 +870,18 @@ <h2 id="pre-built-workspaces">Pre-built Workspaces<a class="headerlink" href="#p
 </tbody>
 </table>
 <h2 id="building-documentation">Building Documentation<a class="headerlink" href="#building-documentation" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>virtualenv<span class="w"> </span>venv<span class="w"> </span>-p<span class="w"> </span>python3
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nb">source</span><span class="w"> </span>venv/bin/activate
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nb">cd</span><span class="w"> </span>docs
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>pip<span class="w"> </span>install<span class="w"> </span>-r<span class="w"> </span>requirements.txt
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>mkdocs<span class="w"> </span>serve
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="c1"># Go to https://127.0.0.1:8000 to view the site.</span>
+<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="c1"># (Optional) Create and activate python virtual environment</span>
+</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>virtualenv<span class="w"> </span>venv<span class="w"> </span>-p<span class="w"> </span>python3
+</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nb">source</span><span class="w"> </span>venv/bin/activate
+</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="c1"># Install dependencies and start serving</span>
+</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="nb">cd</span><span class="w"> </span>docs
+</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a>pip<span class="w"> </span>install<span class="w"> </span>-r<span class="w"> </span>requirements.txt
+</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a>mkdocs<span class="w"> </span>serve
+</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="c1"># Go to https://127.0.0.1:8000 to view the site.</span>
+</span></code></pre></div>
+<h2 id="linking-the-readme">Linking the README<a class="headerlink" href="#linking-the-readme" title="Permanent link">&para;</a></h2>
+<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>rm<span class="w"> </span>docs/index.md
+</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>ln<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">PWD</span><span class="si">}</span><span class="s2">/README.md&quot;</span><span class="w"> </span>docs/index.md
 </span></code></pre></div>
 <h2 id="acknowledgement">Acknowledgement<a class="headerlink" href="#acknowledgement" title="Permanent link">&para;</a></h2>
 <p>The code is mainly contributed by <a href="https://github.com/j3soon">Johnson</a>, <a href="https://github.com/YuZhong-Chen">Yu-Zhong Chen</a>, <a href="https://github.com/Assume-Zhan">Assume Zhan</a>, <a href="https://github.com/ClassLongJoe1112">Lam Chon Hang</a>, and others. For a full list of contributors, please refer to the <a href="https://github.com/j3soon/ros2-essentials/graphs/contributors">contribution list</a>.</p>
diff --git a/search/search_index.json b/search/search_index.json
index 59294b15..c1e8f2f4 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"ROS 2 Essentials","text":"<p>A repo containing essential ROS2 Humble features for controlling Autonomous Mobile Robots (AMRs). Please setup an Ubuntu environment before using this repo.</p> <p>Please note that this repo is under rapid development. The code is not guaranteed to be stable, and breaking changes may occur.</p> <p>The documentation is hosted on https://j3soon.github.io/ros2-essentials/.</p>"},{"location":"#pre-built-workspaces","title":"Pre-built Workspaces","text":"<p>Pre-built Docker images for each workspace can be pulled by running <code>docker compose pull</code> in the corresponding workspace directory.</p> <p>Pulling the pre-built Docker images can bypass the time-consuming building process (for both docker compose &amp; devcontainers).</p> Workspace amd64 arm64 Notes Maintainer Template \u2714\ufe0f \u2714\ufe0f Yu-Zhong Chen ORB-SLAM3 \u2714\ufe0f \u274c Assume Zhan RTAB-Map \u2714\ufe0f \u274c Assume Zhan ROS1 Bridge \u2714\ufe0f \u2714\ufe0f Skip linting Yu-Zhong Chen Cartographer \u2714\ufe0f \u2714\ufe0f Assume Zhan Clearpath Husky \u2714\ufe0f \u2714\ufe0f Real-world support Yu-Zhong Chen Yujin Robot Kobuki \u2714\ufe0f \u2714\ufe0f Real-world support Yu-Zhong Chen Velodyne VLP-16 \u2714\ufe0f \u2714\ufe0f Real-world support Assume Zhan Gazebo World \u2714\ufe0f \u274c\ufe0f Yu-Zhong Chen ALOHA \u2714\ufe0f \u2714\ufe0f Simulation only"},{"location":"#building-documentation","title":"Building Documentation","text":"<pre><code>virtualenv venv -p python3\nsource venv/bin/activate\ncd docs\npip install -r requirements.txt\nmkdocs serve\n# Go to https://127.0.0.1:8000 to view the site.\n</code></pre>"},{"location":"#acknowledgement","title":"Acknowledgement","text":"<p>The code is mainly contributed by Johnson, Yu-Zhong Chen, Assume Zhan, Lam Chon Hang, and others. For a full list of contributors, please refer to the contribution list.</p> <p>We extend our gratitude to ElsaLab and NVIDIA AI Technology Center (NVAITC) for their support in making this project possible.</p> <p>Disclaimer: this is not an official NVIDIA product.</p>"},{"location":"#license","title":"License","text":"<p>All modifications are licensed under Apache License 2.0.</p> <p>However, this repository includes many dependencies released under different licenses. For information on these licenses, please check the commit history. Make sure to review the license of each dependency before using this repository.</p> <p>The licenses for dependencies will be clearly documented in the workspace README in the future.</p>"},{"location":"#supplementary","title":"Supplementary","text":""},{"location":"#installing-docker","title":"Installing Docker","text":"<p>Follow this post for the installation instructions.</p>"},{"location":"#installing-nvidia-container-toolkit","title":"Installing NVIDIA Container Toolkit","text":"<p>Follow this post for the installation instructions.</p>"},{"location":"aloha-ws/","title":"ALOHA","text":""},{"location":"aloha-ws/#start-container","title":"Start Container","text":"<pre><code>cd ~/ros2-essentials/aloha_ws/docker\nxhost +local:docker\ndocker compose up\n# The first build will take a while (~10 mins), please wait patiently.\n</code></pre> <p>The commands in the following sections assume that you are inside the Docker container:</p> <pre><code># in a new terminal\ndocker exec -it ros2-aloha-ws bash\n</code></pre>"},{"location":"aloha-ws/#view-robot-model-in-rviz","title":"View Robot Model in RViz","text":"<pre><code>ros2 launch interbotix_xsarm_descriptions xsarm_description.launch.py robot_model:=vx300s use_joint_pub_gui:=true\n</code></pre> <p>It is worth noting that <code>aloha_vx300s.urdf.xacro</code> and <code>vx300s.urdf.xacro</code> files are identical. We opt to use <code>vx300s</code> since <code>aloha_vx300s</code> seems to lack corresponding configs, such as those for MoveIt 2.</p> <p></p>"},{"location":"aloha-ws/#view-robot-model-in-gazebo","title":"View Robot Model in Gazebo","text":"<pre><code>ros2 launch interbotix_xsarm_sim xsarm_gz_classic.launch.py robot_model:=vx300s\n</code></pre>"},{"location":"aloha-ws/#ros-2-control","title":"ROS 2 Control","text":"<pre><code>ros2 launch interbotix_xsarm_control xsarm_control.launch.py robot_model:=vx300s use_sim:=true\n# and then use the `Interbotix Control Panel`.\n</code></pre>"},{"location":"aloha-ws/#moveit-2-with-rviz","title":"MoveIt 2 with RViz","text":"<pre><code>ros2 launch interbotix_xsarm_moveit xsarm_moveit.launch.py robot_model:=vx300s hardware_type:=fake\n</code></pre>"},{"location":"aloha-ws/#moveit-2-with-gazebo","title":"MoveIt 2 with Gazebo","text":"<pre><code>ros2 launch interbotix_xsarm_moveit xsarm_moveit.launch.py robot_model:=vx300s hardware_type:=gz_classic\n</code></pre>"},{"location":"aloha-ws/#moveit-2-with-isaac-sim","title":"MoveIt 2 with Isaac Sim","text":"<p>Prepare USD files:</p> <pre><code>cd /home/ros2-essentials/aloha_ws/isaacsim/scripts\n./create_urdf_from_xacro.sh\npython3 create_vx300s_from_urdf.py\npython3 create_vx300s_with_omnigraph.py\n</code></pre> <p>and run:</p> <pre><code>ros2 launch interbotix_xsarm_moveit xsarm_moveit.launch.py robot_model:=vx300s hardware_type:=isaac\n# and then move the target and use the `MotionPlanning` panel.\n</code></pre> <p></p>"},{"location":"aloha-ws/#debugging-with-isaac-sim","title":"Debugging with Isaac Sim","text":"<p>The Isaac Sim app can be launched with:</p> <pre><code>isaacsim omni.isaac.sim\n</code></pre> <p>Keep in mind that the standalone scripts can be easily debugged in Isaac Sim's <code>Script Editor</code>. Simply copy the code, omitting anything related to SimulationApp (remove the beginning and end), and paste to the <code>Script Editor</code> and run it.</p> <p>To open pre-configured USD file with OmniGraph:</p> <ul> <li><code>File &gt; Open</code> and click <code>My Computer</code>, then in <code>File name:</code> type:   <pre><code>/home/ros2-essentials/aloha_ws/isaacsim/assets/vx300s_og.usd\n</code></pre></li> <li>Click <code>Window &gt; Visual Scripting &gt; Action Graph</code></li> <li>In the <code>Action Graph</code> tab, click <code>Edit Action Graph</code> and select <code>/ActionGraph</code></li> <li>Click <code>Play (SPACE)</code></li> </ul> <p>View the current joint states:</p> <pre><code># in a new terminal\ndocker exec -it ros2-aloha-ws bash\nros2 topic echo /vx300s/joint_states\n</code></pre> <p>A specific world can also be directly launched and played with:</p> <pre><code>isaacsim omni.isaac.sim --exec '/home/ros2-essentials/aloha_ws/isaacsim/scripts/open_isaacsim_stage.py --path /home/ros2-essentials/aloha_ws/isaacsim/assets/vx300s_og.usd'\n</code></pre> <p>To access Nucleus from Isaac Sim, you should install Nucleus with default username/password <code>admin:admin</code> on your host machine or connect to an external Nucleus server.</p>"},{"location":"aloha-ws/#references","title":"References","text":"<ul> <li>Interbotix X-Series Arms | Trossen Robotics Documentation<ul> <li>ROS 2 Interface<ul> <li>ROS 2 Standard Software Setup</li> </ul> </li> <li>ROS 2 Open Source Packages</li> </ul> </li> <li>Stationary ALOHA Software Setup | Trossen Robotics Documentation</li> </ul>"},{"location":"cartographer-ws/","title":"Cartographer","text":""},{"location":"cartographer-ws/#run-with-docker","title":"Run with docker","text":"<pre><code>git clone https://github.com/j3soon/ros2-essentials.git\n</code></pre> <pre><code>cd ros2-essentials/cartographer_ws/docker\ndocker compose pull\ndocker compose up -d --build\n</code></pre>"},{"location":"cartographer-ws/#simple-test-with-turtlebot3","title":"Simple Test With Turtlebot3","text":"<ul> <li> <p>Attach to the container</p> <p><pre><code>docker attach ros2-cartographer-ws\ncd /home/ros2-essentials/cartographer_ws\n</code></pre> - Open the turtlebot simulation in <code>tmux</code></p> <p><pre><code>export TURTLEBOT3_MODEL=burger\nros2 launch turtlebot3_gazebo turtlebot3_world.launch.py\n</code></pre> - Run the SLAM node in new window of <code>tmux</code></p> <p><pre><code>ros2 launch turtlebot3_cartographer cartographer.launch.py is_sim:=True\n</code></pre> - Run the control tool in new window of <code>tmux</code></p> <pre><code>rqt_robot_steering\n</code></pre> </li> </ul>"},{"location":"cartographer-ws/#building-packages","title":"Building Packages","text":"<pre><code>docker attach ros2-cartographer-ws\ncd /home/ros2-essentials/cartographer_ws\nrosdep update\nrosdep install --from-paths src --ignore-src --rosdistro humble -y\ncolcon build\n</code></pre> <p>After the build process, make sure to source the <code>install/setup.bash</code> file. Otherwise, ROS2 will not locate the executable files. You can open a new terminal to accomplish this.</p>"},{"location":"cartographer-ws/#multi-lidar-single-robot-slam-test","title":"Multi LiDAR - Single Robot SLAM test","text":""},{"location":"cartographer-ws/#simulation","title":"Simulation","text":"<ul> <li>multi_lidar_desp package: Description of a robot with multiple LiDARs.</li> <li> <p>multi_lidar_gazebo package: Gazebo simulation of the robot with robot state publisher.</p> <pre><code>ros2 launch multi_lidar_gazebo multi_lidar_gazebo.launch.py\n</code></pre> </li> </ul>"},{"location":"cartographer-ws/#run-the-slam-node","title":"Run the SLAM node","text":"<ul> <li>Run the cartographer SLAM node in new window of <code>tmux</code> <pre><code>ros2 launch cartographer_demo cartographer_demo.launch.py is_sim:=True\n</code></pre></li> </ul> <ul> <li>Run the control tool in new window of <code>tmux</code> <pre><code>rqt_robot_steering\n</code></pre></li> </ul>"},{"location":"cartographer-ws/#references","title":"References","text":"<ul> <li>Cartographer Demo</li> </ul>"},{"location":"gazebo-world-ws/","title":"Gazebo World","text":"<p>This repository contains several Gazebo worlds, which are valuable for testing robots or agents in both indoor and outdoor environments.</p>"},{"location":"gazebo-world-ws/#structure","title":"\ud83c\udf31 Structure \ud83c\udf31","text":"<pre><code>ros2-essentials\n\u251c\u2500\u2500 gazebo_world_ws\n|   \u251c\u2500\u2500 .devcontainer\n|   \u251c\u2500\u2500 docker\n|   \u251c\u2500\u2500 figure\n|   \u251c\u2500\u2500 src\n|   |   \u251c\u2500\u2500 aws-robomaker-hospital-world\n|   |   \u251c\u2500\u2500 aws-robomaker-small-house-world\n|   |   \u251c\u2500\u2500 aws-robomaker-small-warehouse-world\n|   |   \u251c\u2500\u2500 citysim\n|   |   \u251c\u2500\u2500 clearpath_playpen\n|   |   \u251c\u2500\u2500 gazebo_launch\n|   |   \u2514\u2500\u2500 turtlebot3_gazebo\n|   \u251c\u2500\u2500 .gitignore\n|   \u2514\u2500\u2500 README.md\n\u2514\u2500\u2500 ...\n</code></pre>"},{"location":"gazebo-world-ws/#how-to-use","title":"\ud83d\udea9 How to use \ud83d\udea9","text":"<p>Available target worlds: - aws_hospital - aws_small_house - aws_warehouse - citysim - clearpath_playpen - turtlebot3</p> <p>The turtlebot3 offers multiple worlds to choose from. For more information, you can refer to the launch file located at <code>turtlebot3.launch.py</code> in the <code>gazebo_launch</code> package.</p>"},{"location":"gazebo-world-ws/#use-in-gazebo_world_ws-container","title":"Use in <code>gazebo_world_ws</code> container","text":"<p>Normally, you wouldn\u2019t want to use it inside the <code>gazebo_world_ws</code> container, since this workspace doesn\u2019t include any robots by default. However, we still provide the Dockerfile for this workspace, you can use it if you have specific requirements.</p> <pre><code># Build the workspace\ncd /home/ros2-essentials/gazebo_world_ws\ncolcon build --symlink-install\nsource /home/ros2-essentials/gazebo_world_ws/install/setup.bash\n\n# Launch the world\n# Replace &lt;target world&gt; with the name of the world you wish to launch.\nros2 launch gazebo_launch &lt;target world&gt;.launch.py\n# or launch turtlebot3 worlds, such as:\nros2 launch gazebo_launch turtlebot3.launch.py gazebo_world:=turtlebot3_dqn_stage3.world\n</code></pre>"},{"location":"gazebo-world-ws/#use-in-other-containerworkspace","title":"Use in other container/workspace","text":""},{"location":"gazebo-world-ws/#1-compile-packages","title":"1. Compile packages","text":"<p>To use it in other containers, remember to compile <code>gazebo_world_ws</code> first. Generally, you can compile it using other containers directly, as the required dependencies for these packages should already be installed in all workspaces. You should only use the Docker environment provided by <code>gazebo_world_ws</code> if you encounter issues with compilation or path settings.</p> <pre><code># Build the workspace\ncd /home/ros2-essentials/gazebo_world_ws\ncolcon build --symlink-install\n</code></pre>"},{"location":"gazebo-world-ws/#2-source-the-local_setupbash","title":"2. Source the <code>local_setup.bash</code>","text":"<p>Add the following lines into <code>.bashrc</code> file.</p> <pre><code># Source gazebo_world_ws environment\nGAZEBO_WORLD_WS_DIR=\"${ROS2_WS}/../gazebo_world_ws\"\nif [ ! -d \"${GAZEBO_WORLD_WS_DIR}/install\" ]; then\n    echo \"gazebo_world_ws has not been built yet. Building workspace...\"\n    cd ${GAZEBO_WORLD_WS_DIR}\n    colcon build --symlink-install\n    cd -\n    echo \"gazebo_world_ws built successfully!\"\nfi\nsource ${GAZEBO_WORLD_WS_DIR}/install/local_setup.bash\n</code></pre>"},{"location":"gazebo-world-ws/#3-launch-gazebo-in-the-launch-file","title":"3. Launch gazebo in the launch file","text":"<p>Add the code into your launch file.</p> <p>Remember to replace the <code>&lt;target world&gt;</code> with the one you want.</p> <pre><code>from launch import LaunchDescription\nfrom launch.actions import IncludeLaunchDescription, DeclareLaunchArgument\nfrom launch.substitutions import PathJoinSubstitution, LaunchConfiguration\nfrom launch_ros.substitutions import FindPackageShare\n\nARGUMENTS = [\n    DeclareLaunchArgument(\n        \"launch_gzclient\",\n        default_value=\"True\",\n        description=\"Launch gzclient, by default is True, which shows the gazebo GUI\",\n    ),\n]\n\n\ndef generate_launch_description():\n\n    ...\n\n    # Launch Gazebo\n    launch_gazebo = IncludeLaunchDescription(\n        PathJoinSubstitution(\n            [\n                FindPackageShare(\"gazebo_launch\"), \n                \"launch\",\n                \"&lt;target world&gt;.launch.py\",\n            ],\n        ),\n        launch_arguments={\n            \"launch_gzclient\": LaunchConfiguration(\"launch_gzclient\"),\n        }.items(),\n    )\n\n    ...\n\n    ld = LaunchDescription(ARGUMENTS)\n    ld.add_action(launch_gazebo)\n\n    ...\n\n    return ld\n</code></pre>"},{"location":"gazebo-world-ws/#snapshot","title":"\u2728 Snapshot \u2728","text":"World Snapshot aws_hospital aws_small_house aws_warehouse citysim turtlebot3_stage3 turtlebot3_house turtlebot3_world clearpath_playpen"},{"location":"gazebo-world-ws/#troubleshooting","title":"\ud83d\udd0d Troubleshooting \ud83d\udd0d","text":""},{"location":"gazebo-world-ws/#getting-stuck-when-launching-gazebo","title":"Getting stuck when launching Gazebo","text":"<p>The first time you launch a Gazebo world might take longer because Gazebo needs to download models from the cloud to your local machine. Please be patient while it downloads. If it takes too long, like more than an hour, you can check the <code>gzserver</code> logs in <code>~/.gazebo</code> to see where it\u2019s getting stuck. The most common issue is using a duplicate port, which prevents Gazebo from starting. You can use <code>lsof -i:11345</code> to identify which process is using the port and then use <code>kill -9</code> to terminate it.</p>"},{"location":"gazebo-world-ws/#unable-to-find-gazebo_launch","title":"Unable to find <code>gazebo_launch</code>","text":"<p>Please make sure you have sourced the <code>local_setup.bash</code> and compiled <code>gazebo_world_ws</code>. If you encounter a path issue, try removing the <code>install</code>, <code>build</code>, and <code>log</code> folders in <code>gazebo_world_ws</code> and compile the workspace in your container again.</p>"},{"location":"husky-ws/","title":"Clearpath Husky","text":"<p>This repository will help you configure the environment for Husky quickly.</p>"},{"location":"husky-ws/#structure","title":"\ud83c\udf31 Structure \ud83c\udf31","text":"<p>Here is the structure of this workspace:</p> <pre><code>husky_ws\n\u251c\u2500\u2500 .devcontainer\n\u251c\u2500\u2500 docker\n\u251c\u2500\u2500 figure\n\u251c\u2500\u2500 install\n\u251c\u2500\u2500 build\n\u251c\u2500\u2500 log\n\u251c\u2500\u2500 script\n|   \u251c\u2500\u2500 husky-bringup.sh\n|   \u251c\u2500\u2500 husky-generate.sh\n|   \u2514\u2500\u2500 husky-teleop.sh\n\u251c\u2500\u2500 src\n|   \u251c\u2500\u2500 husky\n|   |   \u251c\u2500\u2500 husky_base\n|   |   \u251c\u2500\u2500 husky_bringup\n|   |   \u251c\u2500\u2500 husky_control\n|   |   \u2514\u2500\u2500 ...\n\u251c\u2500\u2500 udev_rules\n|   \u251c\u2500\u2500 41-clearpath.rules\n|   \u2514\u2500\u2500 install_udev_rules.sh\n\u251c\u2500\u2500 .gitignore\n\u2514\u2500\u2500 README.md\n</code></pre> <p><code>build</code> / <code>install</code> / <code>log</code> folders will appear once you've built the packages.</p>"},{"location":"husky-ws/#introduction","title":"\u2728 Introduction \u2728","text":"<p>This repository has been derived from the Clearpath Husky's repository. Here is the original repository. However, the original repository was designed for ROS1, and it is in the process of being upgraded to ROS2.</p> <p>Below are the main packages for Husky:</p> <ul> <li>husky_base : Base configuration</li> <li>husky_control : Control configuration</li> <li>husky_description : Robot description (URDF)</li> <li>husky_navigation : Navigation configuration</li> <li>husky_gazebo : Simulate environment</li> <li>husky_viz : Visualize data</li> </ul>"},{"location":"husky-ws/#testing","title":"\ud83d\udea9 Testing \ud83d\udea9","text":""},{"location":"husky-ws/#building-packages","title":"Building packages","text":"<p>Before attempting any examples, please remember to build the packages first. If you encounter any dependency errors, please use rosdep to resolve them.</p> <pre><code>cd /home/ros2-essentials/husky_ws\nrosdep update\nrosdep install --from-paths src --ignore-src --rosdistro humble -y\ncolcon build\n</code></pre> <p>After the build process, make sure to source the <code>install/setup.bash</code> file. Otherwise, ROS2 will not locate the executable files. You can open a new terminal to accomplish this.</p>"},{"location":"husky-ws/#view-the-model","title":"View the model","text":"<pre><code>ros2 launch husky_viz view_model_launch.py\n</code></pre>"},{"location":"husky-ws/#demonstration-of-slam","title":"Demonstration of SLAM.","text":"<pre><code>ros2 launch husky_navigation slam_launch.py\n</code></pre> <p>Rendering the model may take some time, so please be patient !</p>"},{"location":"husky-ws/#control-real-robot","title":"Control real robot","text":"<p>Before you proceed, please ensure that you've plugged the USB adapter of the Husky into the computer and mounted it into the container. (plugging in the USB adapter before creating the container is preferred but not required)</p> <p>```bash=</p>"},{"location":"husky-ws/#move-to-the-workspace-source-bashrc-and-bringup-husky","title":"Move to the workspace, source .bashrc, and bringup husky.","text":"<p>cd /home/ros2-essentials/husky_ws source ~/.bashrc ./script/husky-bringup.sh</p>"},{"location":"husky-ws/#optional-open-a-new-terminal-control-the-robot-via-keyboard-teleoperation","title":"(Optional) Open a new terminal &amp; control the robot via keyboard teleoperation.","text":"<p>./script/husky-teleop.sh ```</p>"},{"location":"husky-ws/#license","title":"License","text":"<p>To maintain reproducibility, we have frozen the following packages at specific commits. The licenses of these packages are listed below:</p> <ul> <li>husky/husky (at commit 1e0b1d1, <code>humble-devel</code> branch) is released under the BSD-3-Clause License.</li> <li>clearpathrobotics/LMS1xx (at commit 90001ac, <code>humble-devel</code> branch) is released under the LGPL License.</li> <li>osrf/citysim (at commit 3928b08) is released under the Apache-2.0 License.</li> <li>clearpathrobotics/clearpath_computer_installer (at commit 7e7f415) is released under the BSD-3-Clause License.</li> <li>clearpathrobotics/clearpath_robot/clearpath_robot/debian/udev (at commit 17d55f1) is released under the BSD 3-Clause License.</li> </ul> <p>Further changes based on the packages above are release under the Apache-2.0 License, as stated in the repository.</p>"},{"location":"kobuki-ws/","title":"Yujin Robot Kobuki","text":"<p>This repository facilitates the quick configuration of the simulation environment and real robot driver for Kobuki.</p>"},{"location":"kobuki-ws/#introduction","title":"\u25fb\ufe0f Introduction \u25fb\ufe0f","text":"<p>This repository is primarily based on the kobuki-base. Below are the main packages for Kobuki:</p> Package Introduction kobuki_control The localization configuration of Kobuki kobuki_core Base configuration for Kobuki kobuki_gazebo Simulating Kobuki in Gazebo kobuki_launch Launch Kobuki in Gazebo or with a real robot kobuki_navigation SLAM setup for Kobuki kobuki_description Robot description (URDF) kobuki_node Kobuki Driver kobuki_rviz Visualizing data in RViz2 velodyne_simulator Simulating VLP-16 in Gazebo"},{"location":"kobuki-ws/#testing","title":"\ud83d\udea9 Testing \ud83d\udea9","text":""},{"location":"kobuki-ws/#building-packages","title":"Building packages","text":"<p>If you only need to bring up the real Kobuki robot, you don't need to compile the workspace. The Kobuki driver is already included in the Docker image. After the Docker image is built, you can directly bring up the robot.</p> <pre><code>cd /home/ros2-essentials/kobuki_ws\n\n# For x86_64 architecture\ncolcon build --symlink-install\n# For arm64 architecture\ncolcon build --symlink-install --packages-ignore velodyne_gazebo_plugins\n</code></pre> <ul> <li>The <code>--symlink-install</code> flag is optional, adding this flag may provide more convenience. See this post for more info.</li> <li>The <code>--packages-ignore</code> flag is used to ignore the <code>velodyne_gazebo_plugins</code> package. This package will use the <code>gazebo_ros_pkgs</code> package, which is not supported in the arm64 architecture.</li> <li>Please note that the building process for the embedded system may take a long time and could run out of memory. You can use the flag <code>--parallel-workers 1</code> to reduce the number of parallel workers, or you can build the packages on a more powerful machine and then transfer the executable files to the embedded system. For guidance on building the packages on a x86_64 architecture and then transferring the files to an arm64 architecture, refer to the <code>cross-compilation</code> section at the end of this README.</li> </ul> <p>After the build process, make sure to source the <code>install/setup.bash</code> file. Otherwise, ROS2 will not locate the executable files. You can open a new terminal to accomplish this.</p>"},{"location":"kobuki-ws/#visualize-the-model-in-rviz","title":"Visualize the model in RViz","text":"<pre><code>ros2 launch kobuki_rviz view_model_launch.py\n</code></pre> <p>You can view the published states under <code>TF &gt; Frames &gt; wheel_left_link</code> and <code>TF &gt; Frames &gt; wheel_right_link</code> in RViz.</p>"},{"location":"kobuki-ws/#launch-the-robot-in-gazebo","title":"Launch the robot in Gazebo","text":"<pre><code>ros2 launch kobuki_launch kobuki.launch.py is_sim:=true\n</code></pre>"},{"location":"kobuki-ws/#launch-the-robot-in-the-real-world","title":"Launch the robot in the real world","text":"<pre><code># Inside the container\ncd /home/ros2-essentials/kobuki_ws\n./script/kobuki-bringup.sh\n\n# or Outside the container\ncd /path/to/kobuki_ws/docker\ndocker compose run kobuki-ws /home/ros2-essentials/kobuki_ws/script/kobuki-bringup.sh\n</code></pre> <p>If you have successfully connected to the Kobuki, you should hear a sound from it. Otherwise, there may be errors. You can try re-plugging the USB cable, restarting the Kobuki, or even restarting the container.</p> <p>If you encounter an error message like the one below or a similar error in the terminal, please ensure that your USB cable is properly connected to the Kobuki and that the connection is stable. Additionally, if the Kobuki's battery is low, communication failures are more likely to occur. Please charge the Kobuki fully before trying again.</p> <p>To control the Kobuki with a keyboard, you can use the <code>teleop_twist_keyboard</code> package.</p> <pre><code># Recommend speed: \n# - Linear 0.1\n# - Angular 0.3\n\n# Inside the container\ncd /home/ros2-essentials/kobuki_ws\n./script/kobuki-teleop.sh\n\n# or Outside the container\ncd /path/to/kobuki_ws/docker\ndocker compose run kobuki-ws /home/ros2-essentials/kobuki_ws/script/kobuki-teleop.sh\n</code></pre>"},{"location":"kobuki-ws/#launch-the-demo-of-slam","title":"Launch the demo of SLAM","text":"<p>This demo is based on the slam_toolbox package and only supports the simulation environment.</p> <pre><code>ros2 launch kobuki_navigation slam.launch.py\n</code></pre>"},{"location":"kobuki-ws/#cross-compilation","title":"Cross-compilation","text":"<p>Since the embedded system may not have enough memory to build the packages, or it may take a long time to build them, you can build the packages on a x86_64 machine and then copy the executable files to the arm64 machine.</p> <p>First, you need to set up the Docker cross-compilation environment. See this repo and this website for more info.</p> <pre><code># Install the QEMU packages\nsudo apt-get install qemu binfmt-support qemu-user-static\n# This step will execute the registering scripts\ndocker run --rm --privileged multiarch/qemu-user-static --reset -p yes --credential yes\n# Testing the emulation environment\ndocker run --rm -t arm64v8/ros:humble uname -m\n</code></pre> <p>Secondly, modify the target platform for the Docker image in <code>docker/compose.yaml</code> by uncommenting the two lines below.</p> <pre><code>platforms:\n    - \"linux/arm64\"\n</code></pre> <p>Next, navigate to the <code>docker</code> folder and use the command <code>docker compose build</code> to build the Docker image.</p> <p>Note that the arm64 architecture is emulated by the QEMU, so it may consume a lot of CPU and memory resources. You should not use the <code>devcontainer</code> when building the packages for the arm64 architecture on x86_64 architecture, Otherwise, you may encounter some problems such as running out of memory. If you really want to use <code>devcontainer</code>, remove all vscode extensions in the <code>.devcontainer/devcontainer.json</code> file first.</p> <p>When the building process ends, use <code>docker compose up -d</code> and attach to the container by running <code>docker attach ros2-kobuki-ws</code>. After that, we can start building the ROS packages. If you have built the packages for the x86_64 architecture before, remember to delete the <code>build</code>, <code>install</code>, and <code>log</code> folders.</p> <pre><code>cd /home/ros2-essentials/kobuki_ws\ncolcon build --symlink-install --packages-ignore velodyne_gazebo_plugins\n</code></pre> <p>Once everything is built, we can start copying the files to the target machine (arm64 architecture). Please modify the command below to match your settings, such as the IP address.</p> <pre><code># (On Host) \ncd /path/to/kobuki_ws\n# Save the Docker image to the file.\ndocker save j3soon/ros2-kobuki-ws | gzip &gt; kobuki_image.tar.gz\n# Copy the file to the target machine.\nscp -C kobuki_image.tar ubuntu@192.168.50.100:~/\n# Copy the kobuki_ws to the target machine. \n# If the workspace exists on the target machine, you can simply copy the `build` and `install` folders to it.\nrsync -aP kobuki_ws ubuntu@192.168.50.100:~/\n</code></pre> <pre><code># (On Remote)\ncd ~/\n# Decompress the file.\ngunzip kobuki_image.tar.gz\n# Load the Docker image from the file.\ndocker load &lt; kobuki_image.tar\n# Verify that the Docker image has loaded successfully.\ndocker images | grep ros2-kobuki-ws\n</code></pre> <p>If you have completed all the commands above without encountering any errors, you can proceed to launch the robot. Refer to the steps above for more information.</p>"},{"location":"orbslam3-ws/","title":"ORB-SLAM3","text":""},{"location":"orbslam3-ws/#run-with-docker","title":"Run with docker","text":"<pre><code>git clone https://github.com/j3soon/ros2-essentials.git\n</code></pre> <pre><code>cd ros2-essentials/orbslam3_ws/docker\ndocker compose pull\ndocker compose up -d --build\n</code></pre>"},{"location":"orbslam3-ws/#simple-test-with-dataset","title":"Simple Test With Dataset","text":"<ul> <li>Attach to the container   <pre><code>docker attach ros2-orbslam3-ws\ncd /home/ros2-essentials/orbslam3_ws\n</code></pre></li> <li>Prepare data, only need to be done once<ul> <li>Download dataset (~1.2G)   <pre><code>wget -P . http://robotics.ethz.ch/~asl-datasets/ijrr_euroc_mav_dataset/vicon_room1/V1_02_medium/V1_02_medium.bag\n</code></pre></li> <li>ROS1 bag and ROS2 bag conversion reference <pre><code>sudo pip3 install rosbags\nrosbags-convert ./V1_02_medium.bag\n</code></pre></li> </ul> </li> <li>Play the bag file in <code>tmux</code> <pre><code>ros2 bag play V1_02_medium/V1_02_medium.db3 --remap /cam0/image_raw:=/camera\n</code></pre></li> <li>Run the ORB-SLAM3 in a new <code>tmux</code> window   <pre><code>source ~/test_ws/install/local_setup.bash\nros2 run orbslam3 mono ~/ORB_SLAM3/Vocabulary/ORBvoc.txt ~/ORB_SLAM3/Examples_old/Monocular/EuRoC.yaml false\n</code></pre>   2 windows will pop up, showing the results.</li> </ul>"},{"location":"orbslam3-ws/#reference-repo-or-issues","title":"Reference repo or issues","text":"<ul> <li>Solve build failure</li> <li>ORB-SLAM3</li> <li>SLAM2 and Foxy docker</li> <li>Error when using humble</li> </ul>"},{"location":"ros1-bridge-ws/","title":"ROS1 Bridge","text":"<p>This workspace is utilized to create a bridge between ROS1 and ROS2-humble.</p>"},{"location":"ros1-bridge-ws/#introduction","title":"\u25fb\ufe0f Introduction \u25fb\ufe0f","text":"<p><code>ros1_bridge</code> provides a network bridge that enables the exchange of messages between ROS 1 and ROS 2. You can locate the original repository here.</p> <p>Within this workspace, you'll find a Dockerfile specifically crafted to build both ros-humble and ros1_bridge from their source code. This necessity arises due to a version conflict between the <code>catkin-pkg-modules</code> available in the Ubuntu repository and the one in the ROS.</p> <p>The official explanation</p> <p>Assuming you are already familiar with the ROS network architecture. If not, I recommend reading the tutorial provided below first.  </p> <ul> <li>https://wiki.ros.org/Master</li> <li>https://docs.ros.org/en/humble/Concepts/Basic/About-Discovery.html</li> </ul>"},{"location":"ros1-bridge-ws/#structure","title":"\ud83c\udf31 Structure \ud83c\udf31","text":"<p>Here is the structure of this repo:</p> <pre><code>ros1_bridge_ws\n\u251c\u2500\u2500 .devcontainer\n|   \u2514\u2500\u2500 devcontainer.json\n\u251c\u2500\u2500 docker\n|   \u251c\u2500\u2500 .dockerignore\n|   \u251c\u2500\u2500 .env\n|   \u251c\u2500\u2500 compose.yaml\n|   \u251c\u2500\u2500 compose.debug.yaml\n|   \u251c\u2500\u2500 Dockerfile\n|   \u2514\u2500\u2500 start-bridge.sh\n\u2514\u2500\u2500 README.md\n</code></pre>"},{"location":"ros1-bridge-ws/#how-to-use","title":"\ud83d\udea9 How to use \ud83d\udea9","text":"<p>The docker compose includes two services: <code>ros1-bridge</code> and <code>ros1-bridge-build</code>. The <code>ros1-bridge</code> service is typically sufficient for regular use, while <code>ros1-bridge-build</code> is intended for debugging, as it retains all the necessary build tools in the docker image.</p> <p>If you are not debugging <code>ros1-bridge</code>, it is recommended to use the terminal rather than VScode-devcontainer. By default, the VScode-devcontainer uses the <code>ros1-bridge-build</code> service.</p>"},{"location":"ros1-bridge-ws/#1-build-the-docker-image","title":"1. Build the docker image","text":"<p>While building the image directly from the Dockerfile is possible, it may not be the most efficient choice. To save time, you can pull the image from Dockerhub instead of compiling it from the source.</p> <p>If you still prefer to build the image yourself, please follow the instructions below:</p> <ul> <li>VScode user<ul> <li>Open the workspace in VScode, press <code>F1</code>, and enter <code>&gt; Dev Containers: Rebuild Container</code>.</li> </ul> </li> <li>Terminal user<ul> <li>Open a terminal, change the directory to the docker folder, and type <code>docker compose build</code>.</li> </ul> </li> </ul> <p>Please note that the build process may take approximately 1 hour to complete, with potential delays depending on your computer's performance and network conditions.</p>"},{"location":"ros1-bridge-ws/#2-adjust-the-parameters-in-the-env-file","title":"2. Adjust the parameters in the <code>.env</code> file","text":"<p>We've placed all ROS-related parameters in the <code>.env</code> file. Please adjust these parameters according to your environment. By default, we set the <code>ROS1</code> master at <code>127.0.0.1</code>, and the <code>ROS2</code> domain ID to <code>0</code>. These settings should work for most scenarios. </p> <p>Please note that if these parameters are not configured correctly, the <code>ros1_bridge</code> will not function properly!</p>"},{"location":"ros1-bridge-ws/#3-start-the-container","title":"3. Start the container","text":"<ul> <li>VScode user<ul> <li>If you build the image through the devcontainer, it will automatically start the container.   After you get into the container, type <code>./start-bridge.sh</code> in the terminal.</li> </ul> </li> <li>Terminal user<ul> <li>Open a terminal, change the directory to the docker folder, and type <code>docker compose up</code>.</li> </ul> </li> </ul>"},{"location":"ros1-bridge-ws/#4-launch-rosmaster-in-ros1","title":"4. Launch rosmaster in ROS1","text":"<p>This step is automatically executed when you run <code>docker compose up</code>.</p> <p>As mentioned in https://github.com/ros2/ros1_bridge/issues/391, you should avoid using <code>roscore</code> in ROS1 to prevent the issue of not bridging <code>/rosout</code>. Instead, use <code>rosmaster --core</code> as an alternative.</p>"},{"location":"ros1-bridge-ws/#5-begin-communication","title":"5. Begin communication","text":"<p>You have successfully executed all the instructions. Now, you can proceed to initiate communication between ROS1 and ROS2-humble.</p> <p>Please keep in mind that the bridge will be established only when there are matching publisher-subscriber pairs active for a topic on either side of the bridge.</p>"},{"location":"ros1-bridge-ws/#example","title":"\u2728 Example \u2728","text":""},{"location":"ros1-bridge-ws/#run-the-bridge-and-the-example-talker-and-listener","title":"Run the bridge and the example talker and listener","text":"<p>Before beginning the example, ensure you have four containers ready:</p> <ul> <li><code>ros-core</code></li> <li><code>ros2-ros1-bridge-ws</code></li> <li><code>ros1</code></li> <li><code>ros2</code></li> </ul> <p>When using <code>ros1-bridge</code> in your application scenarios, you only need the <code>ros-core</code> and <code>ros2-ros1-bridge-ws</code> containers. Please replace the <code>ros1</code> and <code>ros2</code> containers with your application containers, as those are only included for demonstration purposes and are not required for using <code>ros1-bridge</code>.  </p> <p>Furthermore, ensure that you mount <code>/dev/shm</code> into both the <code>ros2-ros1-bridge-ws</code> and <code>ros2</code> containers, and that all containers share the host network.</p>"},{"location":"ros1-bridge-ws/#1-start-the-ros1_bridge-and-other-container","title":"1. Start the <code>ros1_bridge</code> and other container","text":"<pre><code># In docker folder\ndocker compose up\n</code></pre> <p>This command will start the four containers mentioned above.</p>"},{"location":"ros1-bridge-ws/#2-run-the-talker-and-listener-node","title":"2. Run the talker and listener node","text":"<p>We run the listener node in the <code>ros1</code> container and the talker node in the <code>ros2</code> container. You can run the talker node in <code>ros1</code> and the listener node in <code>ros2</code> if you'd like. To achieve this, modify the command provided below.</p>"},{"location":"ros1-bridge-ws/#ros1","title":"ROS1","text":"<pre><code>docker exec -it ros1 /ros_entrypoint.sh bash\n# Inside ros1 container\nrosrun roscpp_tutorials listener\n# or\n# rosrun roscpp_tutorials talker\n</code></pre>"},{"location":"ros1-bridge-ws/#ros2","title":"ROS2","text":"<pre><code>docker exec -it ros2 /ros_entrypoint.sh bash\n# Inside ros2 container\n# Use the same UID as ros1_bridge to prevent Fast-DDS shared memory permission issues.\n# Ref: https://github.com/j3soon/ros2-essentials/pull/9#issuecomment-1795743063\nuseradd -ms /bin/bash user\nsu user\nsource /opt/ros/humble/setup.bash\nros2 run demo_nodes_cpp talker\n# or\n# ros2 run demo_nodes_cpp listener\n</code></pre> <p>Certainly, you can try the example provided by <code>ros1_bridge</code>. However, there's no need to source the setup script within the <code>ros2-ros1-bridge-ws</code> container, simply starting the container will suffice.</p>"},{"location":"ros1-bridge-ws/#troubleshooting","title":"\ud83d\udd0d Troubleshooting \ud83d\udd0d","text":"<p>If you are trying to debug <code>ros1_bridge</code>, it is recommended to use the <code>ros1-bridge-build</code> service in docker compose. It contains all the necessary build tools, which should be helpful for you.</p>"},{"location":"ros1-bridge-ws/#failed-to-contact-ros-master","title":"Failed to contact ros master","text":"<p>Before launching <code>ros-core</code>, make sure to adjust the <code>ROS_MASTER_URI</code> correctly. For more information, please check the <code>.env</code> file and this section.</p> <p>You can replace <code>127.0.0.1</code> with the actual IP address or hostname of your ros master. This configuration ensures that your ros nodes know where to find the ros master for communication. Remember, in addition to modifying the parameters for <code>ros1_bridge</code>, you also need to adjust the parameters for your own container!</p>"},{"location":"ros1-bridge-ws/#ros2-cant-receive-the-topic","title":"ROS2 can't receive the topic","text":"<p>The latest releases of Fast-DDS come with the shared memory transport enabled by default. Therefore, you need to mount shared memory, also known as <code>/dev/shm</code>, into every container you intend to communicate with when using Fast-DDS. This ensures proper communication between containers. Ensure that you use the same UID as <code>ros2-ros1-bridge-ws</code> to avoid Fast-DDS shared memory permission issues.</p> <p>Reference: https://github.com/eProsima/Fast-DDS/issues/1698#issuecomment-778039676</p>"},{"location":"rtabmap-ws/","title":"RTAB-Map","text":""},{"location":"rtabmap-ws/#run-with-docker","title":"Run with docker","text":"<pre><code>git clone https://github.com/j3soon/ros2-essentials.git\n</code></pre> <pre><code>cd ros2-essentials/rtabmap_ws/docker\ndocker compose pull\ndocker compose up -d --build\n</code></pre> <ul> <li>Attach to the container   <pre><code>docker attach ros2-rtabmap-ws\ncd /home/ros2-essentials/rtabmap_ws\ncolcon build --symlink-install\n</code></pre></li> </ul>"},{"location":"rtabmap-ws/#lidar-test-with-gazebo","title":"LiDAR test with gazebo","text":"<ul> <li>Launch Gazebo with turtlebot3 in <code>tmux</code> <pre><code>ros2 launch rtabmap_sim sim_robot.launch.py\n</code></pre></li> <li>Run rtabmap LiDAR demo in a new <code>tmux</code> window   <pre><code>ros2 launch rtabmap_demos turtlebot3_scan.launch.py\n</code></pre></li> </ul>"},{"location":"rtabmap-ws/#rgbd-test-with-gazebo","title":"RGBD test with gazebo","text":"<ul> <li>Launch Gazebo with turtlebot3 in <code>tmux</code> <pre><code>ros2 launch rtabmap_sim sim_robot.launch.py\n</code></pre></li> <li>Run rtabmap LiDAR demo in a new <code>tmux</code> window   <pre><code>ros2 launch rtabmap_demos turtlebot3_rgbd.launch.py\n</code></pre></li> </ul>"},{"location":"rtabmap-ws/#dual-sensor-test-with-gazebo","title":"Dual sensor test with gazebo","text":"<ul> <li>Launch Gazebo with turtlebot3 in <code>tmux</code> <pre><code>ros2 launch rtabmap_sim sim_robot.launch.py\n</code></pre></li> <li>Run dual sensor demo in a new <code>tmux</code> window   <pre><code>ros2 launch rtabmap_sim dual_sensor.launch.py\n</code></pre></li> </ul>"},{"location":"rtabmap-ws/#run-with-rqt","title":"Run with rqt","text":"<ul> <li>Running in a new <code>tmux</code> window   <pre><code>rqt_robot_steering\n</code></pre></li> </ul>"},{"location":"rtabmap-ws/#result","title":"Result","text":"<ul> <li>After you've run the demo, you could find the following result directly.</li> </ul> <ol> <li>LiDAR test  </li> <li>RGBD test  </li> <li>Dual sensor test  </li> </ol>"},{"location":"rtabmap-ws/#reference","title":"Reference","text":"<ul> <li>RTAB-Map wiki</li> </ul>"},{"location":"rtabmap-ws/#existing-issues","title":"Existing issues","text":"<ul> <li><code>VTK</code> warning   <pre><code>QVTKOpenGLWidget: Warning: In /build/vtk6-6.3.0+dfsg1/Rendering/OpenGL2/vtkOpenGLRenderWindow.cxx, line 781\n...\n</code></pre><ul> <li>It seems that the warning isn't a big deal. But it will interrupt debugging in the future.</li> <li>Possible solution : set <code>VTK_LEGACY_REMOVE</code>, but it required to build from source.     - Still not tested yet.</li> <li>Issue Reference</li> </ul> </li> </ul>"},{"location":"template-ws/","title":"Template","text":"<p>This template will help you set up a ROS-Humble environment quickly.</p>"},{"location":"template-ws/#structure","title":"\ud83c\udf31 Structure \ud83c\udf31","text":"<p>Here is the structure of this template:</p> <pre><code>ros2-essentials\n\u251c\u2500\u2500 scripts\n|   \u2514\u2500\u2500 create_workspace.sh\n\u251c\u2500\u2500 template_ws\n|   \u251c\u2500\u2500 .devcontainer\n|   |   \u2514\u2500\u2500 devcontainer.json\n|   \u251c\u2500\u2500 docker\n|   |   \u251c\u2500\u2500 .bashrc\n|   |   \u251c\u2500\u2500 .dockerignore\n|   |   \u251c\u2500\u2500 compose.yaml\n|   |   \u2514\u2500\u2500 Dockerfile\n|   \u251c\u2500\u2500 install\n|   \u251c\u2500\u2500 build\n|   \u251c\u2500\u2500 log\n|   \u251c\u2500\u2500 src\n|   |   \u251c\u2500\u2500 minimal_pkg\n|   |   |   \u251c\u2500\u2500 include\n|   |   |   \u251c\u2500\u2500 minimal_pkg\n|   |   |   \u251c\u2500\u2500 scripts\n|   |   |   \u2514\u2500\u2500 ...\n|   |   \u2514\u2500\u2500 ...\n|   \u2514\u2500\u2500 README.md\n</code></pre> <ul> <li><code>build</code> / <code>install</code> / <code>log</code> folders will appear once you've built the packages.</li> </ul>"},{"location":"template-ws/#how-to-use-this-template","title":"\ud83d\udea9 How to use this template \ud83d\udea9","text":""},{"location":"template-ws/#1-use-the-script-to-copy-the-template-workspace","title":"1. Use the script to copy the template workspace.","text":"<p>We have provided a script to create a new workspace. Please use it to avoid potential issues.  </p> <pre><code># Open a terminal, and change the directory to ros2-essentials.\n./scripts/create_workspace.sh &lt;new_workspace_name&gt;\n</code></pre> <p>To unify the naming style, we will modify the string <code>&lt;new_workspace_name&gt;</code> in some files.</p>"},{"location":"template-ws/#2-configure-settings","title":"2. Configure settings.","text":"<p>To help you easily find where changes are needed, we have marked most of the areas you need to adjust with <code># TODO:</code>. Usually, you only need to modify the configurations without removing anything. If you really need to remove something, make sure you clearly understand your goal and proceed with caution.</p> <ul> <li><code>docker/Dockerfile</code>     - Add the packages you need according to the comments inside.</li> <li><code>docker/compose.yaml</code>     - By default, the Docker image is built according to your current computer's architecture. If you need to cross-compile, please modify the <code>platforms</code> parameter to your desired architecture and set up the basic environment.     - If you want to access the GPU in the container, please uncomment the lines accordingly.     - If you want to add any environment variables in the container, you can include them in the <code>environment</code> section, or you can use <code>export VARIABLE=/the/value</code> in <code>docker/.bashrc</code>.</li> <li><code>docker/.bashrc</code>     - We will automatically compile the workspace in .bashrc. If you don't want this to happen, feel free to remove it. If you\u2019re okay with it, remember to adjust the compilation commands according to your packages.</li> <li><code>src</code>     - Add the ros packages you need here.     - <code>minimal_pkg</code> is the ROS2 package used to create a publisher and subscriber in both Python and C++. You can remove it if you don't need it.</li> </ul>"},{"location":"template-ws/#3-open-the-workspace-folder-using-visual-studio-code","title":"3. Open the workspace folder using Visual Studio Code.","text":"<p>Haven't set up the devcontainer yet ?</p> <p>Please refer to the tutorial provided by Visual Studio Code first. You can find it here:  https://code.visualstudio.com/docs/devcontainers/containers</p> <p>We recommend using <code>VScode</code> + <code>devcontainer</code> for development. This plugin can significantly reduce development costs and can be used on local computers, remote servers, and even embedded systems. If you don't want to use <code>devcontainer</code>, you can still use Docker commands for development, such as <code>docker compose up</code> and <code>docker exec</code>.</p> <p>Open the workspace folder using Visual Studio Code, spotting the workspace folder within your Explorer indicates that you've selected the wrong folder. You should only observe the <code>.devcontainer</code>, <code>docker</code> and <code>src</code> folders there.</p>"},{"location":"template-ws/#4-build-the-container","title":"4. Build the container.","text":"<p>We have pre-built some Docker images on Docker Hub. If the building time is too long, you might consider downloading them from Docker Hub instead. For more information, please refer to the <code>README.md</code> on the repository's main page.</p> <p>Press <code>F1</code> and enter <code>&gt; Dev Containers: Rebuild Container</code>. Building the images and container will take some time. Please be patient.</p> <p>You should see the output below.</p> <pre><code>Done. Press any key to close the terminal.\n</code></pre> <p>For non-devcontainer users, please navigate to the <code>docker</code> folder and use <code>docker compose build</code> to build the container. We have moved all commands that need to be executed into the <code>.bashrc</code> file. No further action is needed after creating the Docker container.</p>"},{"location":"template-ws/#5-start-to-develop-with-ros","title":"5. Start to develop with ROS.","text":"<p>You've successfully completed all the instructions. Wishing you a productive and successful journey in your ROS development !</p>"},{"location":"template-ws/#warning","title":"\u26a0\ufe0f Warning \u26a0\ufe0f","text":"<ul> <li>Do not place your files in any folder named <code>build</code>, <code>install</code>, or <code>log</code>. These folders will not be tracked by Git.</li> <li>If you encounter an error when opening Gazebo, consider closing the container and reopen it. Alternatively, you can check the log output in <code>~/.gazebo</code>, which may contain relevant error messages. The most common issue is using a duplicate port, which prevents Gazebo from starting. You can use <code>lsof -i:11345</code> to identify which process is using the port and then use <code>kill -9</code> to terminate it.</li> <li><code>xhost +local:docker</code> is required if the container is not in privileged mode.</li> </ul>"},{"location":"vlp-ws/","title":"Velodyne VLP-16","text":""},{"location":"vlp-ws/#simulation-setup","title":"Simulation Setup","text":""},{"location":"vlp-ws/#add-description-in-defined-robot","title":"Add description in defined robot","text":"<ol> <li> <p>Declared necessary argument and  your own <code>robot_gazebo.urdf.xacro</code></p> <pre><code>&lt;xacro:arg name=\"gpu\" default=\"false\"/&gt;\n&lt;xacro:arg name=\"organize_cloud\" default=\"false\"/&gt;\n&lt;xacro:property name=\"gpu\" value=\"$(arg gpu)\" /&gt;\n&lt;xacro:property name=\"organize_cloud\" value=\"$(arg organize_cloud)\" /&gt;\n</code></pre> </li> <li> <p>Include the <code>velodyne_description</code> package</p> <pre><code>&lt;xacro:include filename=\"$(find velodyne_description)/urdf/VLP16.urdf.xacro\" /&gt;\n</code></pre> </li> <li> <p>Add LiDAR in the robot</p> <pre><code>&lt;xacro:VLP-16 parent=\"base_footprint\" name=\"velodyne\" topic=\"/velodyne_points\" organize_cloud=\"${organize_cloud}\" hz=\"10\" samples=\"440\" gpu=\"${gpu}\"&gt;\n    &lt;origin xyz=\"0 0 0.1\" rpy=\"0 0 0\" /&gt;\n&lt;/xacro:VLP-16&gt;\n</code></pre> </li> </ol> <ul> <li>You could refer to more information from <code>veloyne_simulator/velodyne_description/urdf/template.urdf.xacro</code></li> </ul>"},{"location":"vlp-ws/#launch-lidar-driver-with-simulated-lidar","title":"Launch LiDAR driver with simulated LiDAR","text":"<ul> <li>Launch example robot with LiDAR<pre><code>ros2 launch velodyne_description example.launch.py\n</code></pre> </li> </ul> <ul> <li>Launch the LiDAR data process without driver in another terminal<pre><code>ros2 launch vlp_cartographer vlp_driver.launch.py is_sim:=True\n</code></pre> </li> </ul>"},{"location":"vlp-ws/#sample-robot","title":"Sample Robot","text":"<ul> <li>A given turtlebot waffle model with VLP-16 is provided in <code>velodyne_simulator/velodyne_simulator/urdf/sample_robot.urdf.xacro</code></li> <li>Launch the sample robot<pre><code>ros2 launch velodyne_description example.launch.py robot:=1\n</code></pre> </li> </ul>"},{"location":"vlp-ws/#lidar-setup","title":"LiDAR setup","text":""},{"location":"vlp-ws/#hardware-setup","title":"Hardware Setup","text":"<ul> <li>Connect the LiDAR to power.</li> <li>Connect the LiDAR to the computer or router using the provided ethernet cable.</li> </ul>"},{"location":"vlp-ws/#directly-using-computer","title":"Directly Using Computer","text":"<ul> <li>Connect the LiDAR to the computer using the ethernet cable.</li> <li>Open the computer settings and navigate to Network &gt; Wired.</li> </ul> <ul> <li>Set the IPv4 configuration to 'manual' and configure the settings as shown in the image below:</li> </ul>"},{"location":"vlp-ws/#launch-the-driver","title":"Launch the Driver","text":""},{"location":"vlp-ws/#pipeline","title":"Pipeline","text":"<ul> <li>Data process as following:   raw data -&gt; pointcloud -&gt; laser scan -&gt; slam method</li> </ul> <ul> <li>Velodyne driver: <code>velodyne_driver</code> get the raw data from LiDAR.</li> <li>Transform the raw data to pointcloud: <code>velodyne_pointcloud</code></li> <li>Transform the pointcloud to laser scan: <code>velodyne_laserscan</code></li> </ul>"},{"location":"vlp-ws/#operating-in-a-single-launch-file","title":"Operating in a single launch file","text":"<pre><code>ros2 launch vlp_cartographer vlp_driver.launch.py\n</code></pre> <ul> <li>By the above command, the driver, pointcloud and laserscan will be launched.</li> </ul>"},{"location":"vlp-ws/#published-topics","title":"Published topics","text":"Topic Type Description <code>/velodyne_packets</code> <code>velodyne_msgs/VelodyneScan</code> raw data <code>/velodyne_points</code> <code>sensor_msgs/PointCloud2</code> Point cloud message <code>/scan</code> <code>sensor_msgs/LaserScan</code> laser scan message"},{"location":"vlp-ws/#test-with-cartographer","title":"Test with cartographer","text":"<ul> <li>In another terminal, launch the cartographer node:<pre><code>ros2 launch vlp_cartographer cartographer_demo.launch.py\n</code></pre> </li> </ul>"},{"location":"vlp-ws/#bringup","title":"Bringup","text":"<ul> <li>Build the docker image and workspace<pre><code>docker compose up --build\n</code></pre> </li> </ul> <ul> <li>LiDAR driver<pre><code>docker exec -it ros2-vlp-ws /home/ros2-essentials/vlp_ws/scripts/lidar-driver-bringup.sh\n</code></pre> </li> </ul> <ul> <li>After launching the driver, launch the cartographer in another terminal<pre><code>docker exec -it ros2-vlp-ws /home/ros2-essentials/vlp_ws/scripts/lidar-slam-bringup.sh\n</code></pre> </li> </ul>"},{"location":"vlp-ws/#reference","title":"Reference","text":"<ul> <li>Velodyne_driver with ROS2 Humble</li> <li>Cartographer ROS</li> <li>Turtlebot3 with Cartographer</li> </ul>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"ROS 2 Essentials","text":"<p>A repo containing essential ROS2 Humble features for controlling Autonomous Mobile Robots (AMRs). Please setup an Ubuntu environment before using this repo.</p> <p>Please note that this repo is under rapid development. The code is not guaranteed to be stable, and breaking changes may occur.</p> <p>The documentation is hosted on https://j3soon.github.io/ros2-essentials/.</p>"},{"location":"#cloning-the-repository","title":"Cloning the Repository","text":"<pre><code>git clone https://github.com/j3soon/ros2-essentials.git\ncd ros2-essentials\n</code></pre>"},{"location":"#pre-built-workspaces","title":"Pre-built Workspaces","text":"<p>Pre-built Docker images for each workspace can be pulled by running <code>docker compose pull</code> in the corresponding workspace directory. Pulling these images bypasses the time-consuming build process (for both Docker Compose and Dev Containers).</p> <p>Click on the following workspaces to navigate to their respective documentation.</p> Workspace amd64 arm64 Notes Maintainer Template \u2714\ufe0f \u2714\ufe0f Yu-Zhong Chen ORB-SLAM3 \u2714\ufe0f \u274c Assume Zhan RTAB-Map \u2714\ufe0f \u274c Assume Zhan ROS1 Bridge \u2714\ufe0f \u2714\ufe0f Skip linting Yu-Zhong Chen Cartographer \u2714\ufe0f \u2714\ufe0f Assume Zhan Clearpath Husky \u2714\ufe0f \u2714\ufe0f Real-world support Yu-Zhong Chen Yujin Robot Kobuki \u2714\ufe0f \u2714\ufe0f Real-world support Yu-Zhong Chen Velodyne VLP-16 \u2714\ufe0f \u2714\ufe0f Real-world support Assume Zhan Gazebo World \u2714\ufe0f \u274c\ufe0f Yu-Zhong Chen ALOHA \u2714\ufe0f \u2714\ufe0f Simulation only"},{"location":"#building-documentation","title":"Building Documentation","text":"<pre><code># (Optional) Create and activate python virtual environment\nvirtualenv venv -p python3\nsource venv/bin/activate\n# Install dependencies and start serving\ncd docs\npip install -r requirements.txt\nmkdocs serve\n# Go to https://127.0.0.1:8000 to view the site.\n</code></pre>"},{"location":"#linking-the-readme","title":"Linking the README","text":"<pre><code>rm docs/index.md\nln \"${PWD}/README.md\" docs/index.md\n</code></pre>"},{"location":"#acknowledgement","title":"Acknowledgement","text":"<p>The code is mainly contributed by Johnson, Yu-Zhong Chen, Assume Zhan, Lam Chon Hang, and others. For a full list of contributors, please refer to the contribution list.</p> <p>We extend our gratitude to ElsaLab and NVIDIA AI Technology Center (NVAITC) for their support in making this project possible.</p> <p>Disclaimer: this is not an official NVIDIA product.</p>"},{"location":"#license","title":"License","text":"<p>All modifications are licensed under Apache License 2.0.</p> <p>However, this repository includes many dependencies released under different licenses. For information on these licenses, please check the commit history. Make sure to review the license of each dependency before using this repository.</p> <p>The licenses for dependencies will be clearly documented in the workspace README in the future.</p>"},{"location":"#supplementary","title":"Supplementary","text":""},{"location":"#installing-docker","title":"Installing Docker","text":"<p>Follow this post for the installation instructions.</p>"},{"location":"#installing-nvidia-container-toolkit","title":"Installing NVIDIA Container Toolkit","text":"<p>Follow this post for the installation instructions.</p>"},{"location":"aloha-ws/","title":"ALOHA","text":""},{"location":"aloha-ws/#start-container","title":"Start Container","text":"<pre><code>cd ~/ros2-essentials/aloha_ws/docker\nxhost +local:docker\ndocker compose up\n# The first build will take a while (~10 mins), please wait patiently.\n</code></pre> <p>The commands in the following sections assume that you are inside the Docker container:</p> <pre><code># in a new terminal\ndocker exec -it ros2-aloha-ws bash\n</code></pre>"},{"location":"aloha-ws/#view-robot-model-in-rviz","title":"View Robot Model in RViz","text":"<pre><code>ros2 launch interbotix_xsarm_descriptions xsarm_description.launch.py robot_model:=vx300s use_joint_pub_gui:=true\n</code></pre> <p>It is worth noting that <code>aloha_vx300s.urdf.xacro</code> and <code>vx300s.urdf.xacro</code> files are identical. We opt to use <code>vx300s</code> since <code>aloha_vx300s</code> seems to lack corresponding configs, such as those for MoveIt 2.</p> <p></p>"},{"location":"aloha-ws/#view-robot-model-in-gazebo","title":"View Robot Model in Gazebo","text":"<pre><code>ros2 launch interbotix_xsarm_sim xsarm_gz_classic.launch.py robot_model:=vx300s\n</code></pre>"},{"location":"aloha-ws/#ros-2-control","title":"ROS 2 Control","text":"<pre><code>ros2 launch interbotix_xsarm_control xsarm_control.launch.py robot_model:=vx300s use_sim:=true\n# and then use the `Interbotix Control Panel`.\n</code></pre>"},{"location":"aloha-ws/#moveit-2-with-rviz","title":"MoveIt 2 with RViz","text":"<pre><code>ros2 launch interbotix_xsarm_moveit xsarm_moveit.launch.py robot_model:=vx300s hardware_type:=fake\n</code></pre>"},{"location":"aloha-ws/#moveit-2-with-gazebo","title":"MoveIt 2 with Gazebo","text":"<pre><code>ros2 launch interbotix_xsarm_moveit xsarm_moveit.launch.py robot_model:=vx300s hardware_type:=gz_classic\n</code></pre>"},{"location":"aloha-ws/#moveit-2-with-isaac-sim","title":"MoveIt 2 with Isaac Sim","text":"<p>Prepare USD files:</p> <pre><code>cd /home/ros2-essentials/aloha_ws/isaacsim/scripts\n./create_urdf_from_xacro.sh\npython3 create_vx300s_from_urdf.py\npython3 create_vx300s_with_omnigraph.py\n</code></pre> <p>and run:</p> <pre><code>ros2 launch interbotix_xsarm_moveit xsarm_moveit.launch.py robot_model:=vx300s hardware_type:=isaac\n# and then move the target and use the `MotionPlanning` panel.\n</code></pre> <p></p>"},{"location":"aloha-ws/#debugging-with-isaac-sim","title":"Debugging with Isaac Sim","text":"<p>The Isaac Sim app can be launched with:</p> <pre><code>isaacsim omni.isaac.sim\n</code></pre> <p>Keep in mind that the standalone scripts can be easily debugged in Isaac Sim's <code>Script Editor</code>. Simply copy the code, omitting anything related to SimulationApp (remove the beginning and end), and paste to the <code>Script Editor</code> and run it.</p> <p>To open pre-configured USD file with OmniGraph:</p> <ul> <li><code>File &gt; Open</code> and click <code>My Computer</code>, then in <code>File name:</code> type:   <pre><code>/home/ros2-essentials/aloha_ws/isaacsim/assets/vx300s_og.usd\n</code></pre></li> <li>Click <code>Window &gt; Visual Scripting &gt; Action Graph</code></li> <li>In the <code>Action Graph</code> tab, click <code>Edit Action Graph</code> and select <code>/ActionGraph</code></li> <li>Click <code>Play (SPACE)</code></li> </ul> <p>View the current joint states:</p> <pre><code># in a new terminal\ndocker exec -it ros2-aloha-ws bash\nros2 topic echo /vx300s/joint_states\n</code></pre> <p>A specific world can also be directly launched and played with:</p> <pre><code>isaacsim omni.isaac.sim --exec '/home/ros2-essentials/aloha_ws/isaacsim/scripts/open_isaacsim_stage.py --path /home/ros2-essentials/aloha_ws/isaacsim/assets/vx300s_og.usd'\n</code></pre> <p>To access Nucleus from Isaac Sim, you should install Nucleus with default username/password <code>admin:admin</code> on your host machine or connect to an external Nucleus server.</p>"},{"location":"aloha-ws/#references","title":"References","text":"<ul> <li>Interbotix X-Series Arms | Trossen Robotics Documentation<ul> <li>ROS 2 Interface<ul> <li>ROS 2 Standard Software Setup</li> </ul> </li> <li>ROS 2 Open Source Packages</li> </ul> </li> <li>Stationary ALOHA Software Setup | Trossen Robotics Documentation</li> </ul>"},{"location":"cartographer-ws/","title":"Cartographer","text":""},{"location":"cartographer-ws/#run-with-docker","title":"Run with docker","text":"<pre><code>git clone https://github.com/j3soon/ros2-essentials.git\n</code></pre> <pre><code>cd ros2-essentials/cartographer_ws/docker\ndocker compose pull\ndocker compose up -d --build\n</code></pre>"},{"location":"cartographer-ws/#simple-test-with-turtlebot3","title":"Simple Test With Turtlebot3","text":"<ul> <li> <p>Attach to the container</p> <p><pre><code>docker attach ros2-cartographer-ws\ncd /home/ros2-essentials/cartographer_ws\n</code></pre> - Open the turtlebot simulation in <code>tmux</code></p> <p><pre><code>export TURTLEBOT3_MODEL=burger\nros2 launch turtlebot3_gazebo turtlebot3_world.launch.py\n</code></pre> - Run the SLAM node in new window of <code>tmux</code></p> <p><pre><code>ros2 launch turtlebot3_cartographer cartographer.launch.py is_sim:=True\n</code></pre> - Run the control tool in new window of <code>tmux</code></p> <pre><code>rqt_robot_steering\n</code></pre> </li> </ul>"},{"location":"cartographer-ws/#building-packages","title":"Building Packages","text":"<pre><code>docker attach ros2-cartographer-ws\ncd /home/ros2-essentials/cartographer_ws\nrosdep update\nrosdep install --from-paths src --ignore-src --rosdistro humble -y\ncolcon build\n</code></pre> <p>After the build process, make sure to source the <code>install/setup.bash</code> file. Otherwise, ROS2 will not locate the executable files. You can open a new terminal to accomplish this.</p>"},{"location":"cartographer-ws/#multi-lidar-single-robot-slam-test","title":"Multi LiDAR - Single Robot SLAM test","text":""},{"location":"cartographer-ws/#simulation","title":"Simulation","text":"<ul> <li>multi_lidar_desp package: Description of a robot with multiple LiDARs.</li> <li> <p>multi_lidar_gazebo package: Gazebo simulation of the robot with robot state publisher.</p> <pre><code>ros2 launch multi_lidar_gazebo multi_lidar_gazebo.launch.py\n</code></pre> </li> </ul>"},{"location":"cartographer-ws/#run-the-slam-node","title":"Run the SLAM node","text":"<ul> <li>Run the cartographer SLAM node in new window of <code>tmux</code> <pre><code>ros2 launch cartographer_demo cartographer_demo.launch.py is_sim:=True\n</code></pre></li> </ul> <ul> <li>Run the control tool in new window of <code>tmux</code> <pre><code>rqt_robot_steering\n</code></pre></li> </ul>"},{"location":"cartographer-ws/#references","title":"References","text":"<ul> <li>Cartographer Demo</li> </ul>"},{"location":"gazebo-world-ws/","title":"Gazebo World","text":"<p>This repository contains several Gazebo worlds, which are valuable for testing robots or agents in both indoor and outdoor environments.</p>"},{"location":"gazebo-world-ws/#structure","title":"\ud83c\udf31 Structure \ud83c\udf31","text":"<pre><code>ros2-essentials\n\u251c\u2500\u2500 gazebo_world_ws\n|   \u251c\u2500\u2500 .devcontainer\n|   \u251c\u2500\u2500 docker\n|   \u251c\u2500\u2500 figure\n|   \u251c\u2500\u2500 src\n|   |   \u251c\u2500\u2500 aws-robomaker-hospital-world\n|   |   \u251c\u2500\u2500 aws-robomaker-small-house-world\n|   |   \u251c\u2500\u2500 aws-robomaker-small-warehouse-world\n|   |   \u251c\u2500\u2500 citysim\n|   |   \u251c\u2500\u2500 clearpath_playpen\n|   |   \u251c\u2500\u2500 gazebo_launch\n|   |   \u2514\u2500\u2500 turtlebot3_gazebo\n|   \u251c\u2500\u2500 .gitignore\n|   \u2514\u2500\u2500 README.md\n\u2514\u2500\u2500 ...\n</code></pre>"},{"location":"gazebo-world-ws/#how-to-use","title":"\ud83d\udea9 How to use \ud83d\udea9","text":"<p>Available target worlds: - aws_hospital - aws_small_house - aws_warehouse - citysim - clearpath_playpen - turtlebot3</p> <p>The turtlebot3 offers multiple worlds to choose from. For more information, you can refer to the launch file located at <code>turtlebot3.launch.py</code> in the <code>gazebo_launch</code> package.</p>"},{"location":"gazebo-world-ws/#use-in-gazebo_world_ws-container","title":"Use in <code>gazebo_world_ws</code> container","text":"<p>Normally, you wouldn\u2019t want to use it inside the <code>gazebo_world_ws</code> container, since this workspace doesn\u2019t include any robots by default. However, we still provide the Dockerfile for this workspace, you can use it if you have specific requirements.</p> <pre><code># Build the workspace\ncd /home/ros2-essentials/gazebo_world_ws\ncolcon build --symlink-install\nsource /home/ros2-essentials/gazebo_world_ws/install/setup.bash\n\n# Launch the world\n# Replace &lt;target world&gt; with the name of the world you wish to launch.\nros2 launch gazebo_launch &lt;target world&gt;.launch.py\n# or launch turtlebot3 worlds, such as:\nros2 launch gazebo_launch turtlebot3.launch.py gazebo_world:=turtlebot3_dqn_stage3.world\n</code></pre>"},{"location":"gazebo-world-ws/#use-in-other-containerworkspace","title":"Use in other container/workspace","text":""},{"location":"gazebo-world-ws/#1-compile-packages","title":"1. Compile packages","text":"<p>To use it in other containers, remember to compile <code>gazebo_world_ws</code> first. Generally, you can compile it using other containers directly, as the required dependencies for these packages should already be installed in all workspaces. You should only use the Docker environment provided by <code>gazebo_world_ws</code> if you encounter issues with compilation or path settings.</p> <pre><code># Build the workspace\ncd /home/ros2-essentials/gazebo_world_ws\ncolcon build --symlink-install\n</code></pre>"},{"location":"gazebo-world-ws/#2-source-the-local_setupbash","title":"2. Source the <code>local_setup.bash</code>","text":"<p>Add the following lines into <code>.bashrc</code> file.</p> <pre><code># Source gazebo_world_ws environment\nGAZEBO_WORLD_WS_DIR=\"${ROS2_WS}/../gazebo_world_ws\"\nif [ ! -d \"${GAZEBO_WORLD_WS_DIR}/install\" ]; then\n    echo \"gazebo_world_ws has not been built yet. Building workspace...\"\n    cd ${GAZEBO_WORLD_WS_DIR}\n    colcon build --symlink-install\n    cd -\n    echo \"gazebo_world_ws built successfully!\"\nfi\nsource ${GAZEBO_WORLD_WS_DIR}/install/local_setup.bash\n</code></pre>"},{"location":"gazebo-world-ws/#3-launch-gazebo-in-the-launch-file","title":"3. Launch gazebo in the launch file","text":"<p>Add the code into your launch file.</p> <p>Remember to replace the <code>&lt;target world&gt;</code> with the one you want.</p> <pre><code>from launch import LaunchDescription\nfrom launch.actions import IncludeLaunchDescription, DeclareLaunchArgument\nfrom launch.substitutions import PathJoinSubstitution, LaunchConfiguration\nfrom launch_ros.substitutions import FindPackageShare\n\nARGUMENTS = [\n    DeclareLaunchArgument(\n        \"launch_gzclient\",\n        default_value=\"True\",\n        description=\"Launch gzclient, by default is True, which shows the gazebo GUI\",\n    ),\n]\n\n\ndef generate_launch_description():\n\n    ...\n\n    # Launch Gazebo\n    launch_gazebo = IncludeLaunchDescription(\n        PathJoinSubstitution(\n            [\n                FindPackageShare(\"gazebo_launch\"), \n                \"launch\",\n                \"&lt;target world&gt;.launch.py\",\n            ],\n        ),\n        launch_arguments={\n            \"launch_gzclient\": LaunchConfiguration(\"launch_gzclient\"),\n        }.items(),\n    )\n\n    ...\n\n    ld = LaunchDescription(ARGUMENTS)\n    ld.add_action(launch_gazebo)\n\n    ...\n\n    return ld\n</code></pre>"},{"location":"gazebo-world-ws/#snapshot","title":"\u2728 Snapshot \u2728","text":"World Snapshot aws_hospital aws_small_house aws_warehouse citysim turtlebot3_stage3 turtlebot3_house turtlebot3_world clearpath_playpen"},{"location":"gazebo-world-ws/#troubleshooting","title":"\ud83d\udd0d Troubleshooting \ud83d\udd0d","text":""},{"location":"gazebo-world-ws/#getting-stuck-when-launching-gazebo","title":"Getting stuck when launching Gazebo","text":"<p>The first time you launch a Gazebo world might take longer because Gazebo needs to download models from the cloud to your local machine. Please be patient while it downloads. If it takes too long, like more than an hour, you can check the <code>gzserver</code> logs in <code>~/.gazebo</code> to see where it\u2019s getting stuck. The most common issue is using a duplicate port, which prevents Gazebo from starting. You can use <code>lsof -i:11345</code> to identify which process is using the port and then use <code>kill -9</code> to terminate it.</p>"},{"location":"gazebo-world-ws/#unable-to-find-gazebo_launch","title":"Unable to find <code>gazebo_launch</code>","text":"<p>Please make sure you have sourced the <code>local_setup.bash</code> and compiled <code>gazebo_world_ws</code>. If you encounter a path issue, try removing the <code>install</code>, <code>build</code>, and <code>log</code> folders in <code>gazebo_world_ws</code> and compile the workspace in your container again.</p>"},{"location":"husky-ws/","title":"Clearpath Husky","text":"<p>This repository will help you configure the environment for Husky quickly.</p>"},{"location":"husky-ws/#structure","title":"\ud83c\udf31 Structure \ud83c\udf31","text":"<p>Here is the structure of this workspace:</p> <pre><code>husky_ws\n\u251c\u2500\u2500 .devcontainer\n\u251c\u2500\u2500 docker\n\u251c\u2500\u2500 figure\n\u251c\u2500\u2500 install\n\u251c\u2500\u2500 build\n\u251c\u2500\u2500 log\n\u251c\u2500\u2500 script\n|   \u251c\u2500\u2500 husky-bringup.sh\n|   \u251c\u2500\u2500 husky-generate.sh\n|   \u2514\u2500\u2500 husky-teleop.sh\n\u251c\u2500\u2500 src\n|   \u251c\u2500\u2500 husky\n|   |   \u251c\u2500\u2500 husky_base\n|   |   \u251c\u2500\u2500 husky_bringup\n|   |   \u251c\u2500\u2500 husky_control\n|   |   \u2514\u2500\u2500 ...\n\u251c\u2500\u2500 udev_rules\n|   \u251c\u2500\u2500 41-clearpath.rules\n|   \u2514\u2500\u2500 install_udev_rules.sh\n\u251c\u2500\u2500 .gitignore\n\u2514\u2500\u2500 README.md\n</code></pre> <p><code>build</code> / <code>install</code> / <code>log</code> folders will appear once you've built the packages.</p>"},{"location":"husky-ws/#introduction","title":"\u2728 Introduction \u2728","text":"<p>This repository has been derived from the Clearpath Husky's repository. Here is the original repository. However, the original repository was designed for ROS1, and it is in the process of being upgraded to ROS2.</p> <p>Below are the main packages for Husky:</p> <ul> <li>husky_base : Base configuration</li> <li>husky_control : Control configuration</li> <li>husky_description : Robot description (URDF)</li> <li>husky_navigation : Navigation configuration</li> <li>husky_gazebo : Simulate environment</li> <li>husky_viz : Visualize data</li> </ul>"},{"location":"husky-ws/#testing","title":"\ud83d\udea9 Testing \ud83d\udea9","text":""},{"location":"husky-ws/#building-packages","title":"Building packages","text":"<p>Before attempting any examples, please remember to build the packages first. If you encounter any dependency errors, please use rosdep to resolve them.</p> <pre><code>cd /home/ros2-essentials/husky_ws\nrosdep update\nrosdep install --from-paths src --ignore-src --rosdistro humble -y\ncolcon build\n</code></pre> <p>After the build process, make sure to source the <code>install/setup.bash</code> file. Otherwise, ROS2 will not locate the executable files. You can open a new terminal to accomplish this.</p>"},{"location":"husky-ws/#view-the-model","title":"View the model","text":"<pre><code>ros2 launch husky_viz view_model_launch.py\n</code></pre>"},{"location":"husky-ws/#demonstration-of-slam","title":"Demonstration of SLAM.","text":"<pre><code>ros2 launch husky_navigation slam_launch.py\n</code></pre> <p>Rendering the model may take some time, so please be patient !</p>"},{"location":"husky-ws/#control-real-robot","title":"Control real robot","text":"<p>Before you proceed, please ensure that you've plugged the USB adapter of the Husky into the computer and mounted it into the container. (plugging in the USB adapter before creating the container is preferred but not required)</p> <p>```bash=</p>"},{"location":"husky-ws/#move-to-the-workspace-source-bashrc-and-bringup-husky","title":"Move to the workspace, source .bashrc, and bringup husky.","text":"<p>cd /home/ros2-essentials/husky_ws source ~/.bashrc ./script/husky-bringup.sh</p>"},{"location":"husky-ws/#optional-open-a-new-terminal-control-the-robot-via-keyboard-teleoperation","title":"(Optional) Open a new terminal &amp; control the robot via keyboard teleoperation.","text":"<p>./script/husky-teleop.sh ```</p>"},{"location":"husky-ws/#license","title":"License","text":"<p>To maintain reproducibility, we have frozen the following packages at specific commits. The licenses of these packages are listed below:</p> <ul> <li>husky/husky (at commit 1e0b1d1, <code>humble-devel</code> branch) is released under the BSD-3-Clause License.</li> <li>clearpathrobotics/LMS1xx (at commit 90001ac, <code>humble-devel</code> branch) is released under the LGPL License.</li> <li>osrf/citysim (at commit 3928b08) is released under the Apache-2.0 License.</li> <li>clearpathrobotics/clearpath_computer_installer (at commit 7e7f415) is released under the BSD-3-Clause License.</li> <li>clearpathrobotics/clearpath_robot/clearpath_robot/debian/udev (at commit 17d55f1) is released under the BSD 3-Clause License.</li> </ul> <p>Further changes based on the packages above are release under the Apache-2.0 License, as stated in the repository.</p>"},{"location":"kobuki-ws/","title":"Yujin Robot Kobuki","text":"<p>This repository facilitates the quick configuration of the simulation environment and real robot driver for Kobuki.</p>"},{"location":"kobuki-ws/#introduction","title":"\u25fb\ufe0f Introduction \u25fb\ufe0f","text":"<p>This repository is primarily based on the kobuki-base. Below are the main packages for Kobuki:</p> Package Introduction kobuki_control The localization configuration of Kobuki kobuki_core Base configuration for Kobuki kobuki_gazebo Simulating Kobuki in Gazebo kobuki_launch Launch Kobuki in Gazebo or with a real robot kobuki_navigation SLAM setup for Kobuki kobuki_description Robot description (URDF) kobuki_node Kobuki Driver kobuki_rviz Visualizing data in RViz2 velodyne_simulator Simulating VLP-16 in Gazebo"},{"location":"kobuki-ws/#testing","title":"\ud83d\udea9 Testing \ud83d\udea9","text":""},{"location":"kobuki-ws/#building-packages","title":"Building packages","text":"<p>If you only need to bring up the real Kobuki robot, you don't need to compile the workspace. The Kobuki driver is already included in the Docker image. After the Docker image is built, you can directly bring up the robot.</p> <pre><code>cd /home/ros2-essentials/kobuki_ws\n\n# For x86_64 architecture\ncolcon build --symlink-install\n# For arm64 architecture\ncolcon build --symlink-install --packages-ignore velodyne_gazebo_plugins\n</code></pre> <ul> <li>The <code>--symlink-install</code> flag is optional, adding this flag may provide more convenience. See this post for more info.</li> <li>The <code>--packages-ignore</code> flag is used to ignore the <code>velodyne_gazebo_plugins</code> package. This package will use the <code>gazebo_ros_pkgs</code> package, which is not supported in the arm64 architecture.</li> <li>Please note that the building process for the embedded system may take a long time and could run out of memory. You can use the flag <code>--parallel-workers 1</code> to reduce the number of parallel workers, or you can build the packages on a more powerful machine and then transfer the executable files to the embedded system. For guidance on building the packages on a x86_64 architecture and then transferring the files to an arm64 architecture, refer to the <code>cross-compilation</code> section at the end of this README.</li> </ul> <p>After the build process, make sure to source the <code>install/setup.bash</code> file. Otherwise, ROS2 will not locate the executable files. You can open a new terminal to accomplish this.</p>"},{"location":"kobuki-ws/#visualize-the-model-in-rviz","title":"Visualize the model in RViz","text":"<pre><code>ros2 launch kobuki_rviz view_model_launch.py\n</code></pre> <p>You can view the published states under <code>TF &gt; Frames &gt; wheel_left_link</code> and <code>TF &gt; Frames &gt; wheel_right_link</code> in RViz.</p>"},{"location":"kobuki-ws/#launch-the-robot-in-gazebo","title":"Launch the robot in Gazebo","text":"<pre><code>ros2 launch kobuki_launch kobuki.launch.py is_sim:=true\n</code></pre>"},{"location":"kobuki-ws/#launch-the-robot-in-the-real-world","title":"Launch the robot in the real world","text":"<pre><code># Inside the container\ncd /home/ros2-essentials/kobuki_ws\n./script/kobuki-bringup.sh\n\n# or Outside the container\ncd /path/to/kobuki_ws/docker\ndocker compose run kobuki-ws /home/ros2-essentials/kobuki_ws/script/kobuki-bringup.sh\n</code></pre> <p>If you have successfully connected to the Kobuki, you should hear a sound from it. Otherwise, there may be errors. You can try re-plugging the USB cable, restarting the Kobuki, or even restarting the container.</p> <p>If you encounter an error message like the one below or a similar error in the terminal, please ensure that your USB cable is properly connected to the Kobuki and that the connection is stable. Additionally, if the Kobuki's battery is low, communication failures are more likely to occur. Please charge the Kobuki fully before trying again.</p> <p>To control the Kobuki with a keyboard, you can use the <code>teleop_twist_keyboard</code> package.</p> <pre><code># Recommend speed: \n# - Linear 0.1\n# - Angular 0.3\n\n# Inside the container\ncd /home/ros2-essentials/kobuki_ws\n./script/kobuki-teleop.sh\n\n# or Outside the container\ncd /path/to/kobuki_ws/docker\ndocker compose run kobuki-ws /home/ros2-essentials/kobuki_ws/script/kobuki-teleop.sh\n</code></pre>"},{"location":"kobuki-ws/#launch-the-demo-of-slam","title":"Launch the demo of SLAM","text":"<p>This demo is based on the slam_toolbox package and only supports the simulation environment.</p> <pre><code>ros2 launch kobuki_navigation slam.launch.py\n</code></pre>"},{"location":"kobuki-ws/#cross-compilation","title":"Cross-compilation","text":"<p>Since the embedded system may not have enough memory to build the packages, or it may take a long time to build them, you can build the packages on a x86_64 machine and then copy the executable files to the arm64 machine.</p> <p>First, you need to set up the Docker cross-compilation environment. See this repo and this website for more info.</p> <pre><code># Install the QEMU packages\nsudo apt-get install qemu binfmt-support qemu-user-static\n# This step will execute the registering scripts\ndocker run --rm --privileged multiarch/qemu-user-static --reset -p yes --credential yes\n# Testing the emulation environment\ndocker run --rm -t arm64v8/ros:humble uname -m\n</code></pre> <p>Secondly, modify the target platform for the Docker image in <code>docker/compose.yaml</code> by uncommenting the two lines below.</p> <pre><code>platforms:\n    - \"linux/arm64\"\n</code></pre> <p>Next, navigate to the <code>docker</code> folder and use the command <code>docker compose build</code> to build the Docker image.</p> <p>Note that the arm64 architecture is emulated by the QEMU, so it may consume a lot of CPU and memory resources. You should not use the <code>devcontainer</code> when building the packages for the arm64 architecture on x86_64 architecture, Otherwise, you may encounter some problems such as running out of memory. If you really want to use <code>devcontainer</code>, remove all vscode extensions in the <code>.devcontainer/devcontainer.json</code> file first.</p> <p>When the building process ends, use <code>docker compose up -d</code> and attach to the container by running <code>docker attach ros2-kobuki-ws</code>. After that, we can start building the ROS packages. If you have built the packages for the x86_64 architecture before, remember to delete the <code>build</code>, <code>install</code>, and <code>log</code> folders.</p> <pre><code>cd /home/ros2-essentials/kobuki_ws\ncolcon build --symlink-install --packages-ignore velodyne_gazebo_plugins\n</code></pre> <p>Once everything is built, we can start copying the files to the target machine (arm64 architecture). Please modify the command below to match your settings, such as the IP address.</p> <pre><code># (On Host) \ncd /path/to/kobuki_ws\n# Save the Docker image to the file.\ndocker save j3soon/ros2-kobuki-ws | gzip &gt; kobuki_image.tar.gz\n# Copy the file to the target machine.\nscp -C kobuki_image.tar ubuntu@192.168.50.100:~/\n# Copy the kobuki_ws to the target machine. \n# If the workspace exists on the target machine, you can simply copy the `build` and `install` folders to it.\nrsync -aP kobuki_ws ubuntu@192.168.50.100:~/\n</code></pre> <pre><code># (On Remote)\ncd ~/\n# Decompress the file.\ngunzip kobuki_image.tar.gz\n# Load the Docker image from the file.\ndocker load &lt; kobuki_image.tar\n# Verify that the Docker image has loaded successfully.\ndocker images | grep ros2-kobuki-ws\n</code></pre> <p>If you have completed all the commands above without encountering any errors, you can proceed to launch the robot. Refer to the steps above for more information.</p>"},{"location":"orbslam3-ws/","title":"ORB-SLAM3","text":""},{"location":"orbslam3-ws/#run-with-docker","title":"Run with docker","text":"<pre><code>git clone https://github.com/j3soon/ros2-essentials.git\n</code></pre> <pre><code>cd ros2-essentials/orbslam3_ws/docker\ndocker compose pull\ndocker compose up -d --build\n</code></pre>"},{"location":"orbslam3-ws/#simple-test-with-dataset","title":"Simple Test With Dataset","text":"<ul> <li>Attach to the container   <pre><code>docker attach ros2-orbslam3-ws\ncd /home/ros2-essentials/orbslam3_ws\n</code></pre></li> <li>Prepare data, only need to be done once<ul> <li>Download dataset (~1.2G)   <pre><code>wget -P . http://robotics.ethz.ch/~asl-datasets/ijrr_euroc_mav_dataset/vicon_room1/V1_02_medium/V1_02_medium.bag\n</code></pre></li> <li>ROS1 bag and ROS2 bag conversion reference <pre><code>sudo pip3 install rosbags\nrosbags-convert ./V1_02_medium.bag\n</code></pre></li> </ul> </li> <li>Play the bag file in <code>tmux</code> <pre><code>ros2 bag play V1_02_medium/V1_02_medium.db3 --remap /cam0/image_raw:=/camera\n</code></pre></li> <li>Run the ORB-SLAM3 in a new <code>tmux</code> window   <pre><code>source ~/test_ws/install/local_setup.bash\nros2 run orbslam3 mono ~/ORB_SLAM3/Vocabulary/ORBvoc.txt ~/ORB_SLAM3/Examples_old/Monocular/EuRoC.yaml false\n</code></pre>   2 windows will pop up, showing the results.</li> </ul>"},{"location":"orbslam3-ws/#reference-repo-or-issues","title":"Reference repo or issues","text":"<ul> <li>Solve build failure</li> <li>ORB-SLAM3</li> <li>SLAM2 and Foxy docker</li> <li>Error when using humble</li> </ul>"},{"location":"ros1-bridge-ws/","title":"ROS1 Bridge","text":"<p>This workspace is utilized to create a bridge between ROS1 and ROS2-humble.</p>"},{"location":"ros1-bridge-ws/#introduction","title":"\u25fb\ufe0f Introduction \u25fb\ufe0f","text":"<p><code>ros1_bridge</code> provides a network bridge that enables the exchange of messages between ROS 1 and ROS 2. You can locate the original repository here.</p> <p>Within this workspace, you'll find a Dockerfile specifically crafted to build both ros-humble and ros1_bridge from their source code. This necessity arises due to a version conflict between the <code>catkin-pkg-modules</code> available in the Ubuntu repository and the one in the ROS.</p> <p>The official explanation</p> <p>Assuming you are already familiar with the ROS network architecture. If not, I recommend reading the tutorial provided below first.  </p> <ul> <li>https://wiki.ros.org/Master</li> <li>https://docs.ros.org/en/humble/Concepts/Basic/About-Discovery.html</li> </ul>"},{"location":"ros1-bridge-ws/#structure","title":"\ud83c\udf31 Structure \ud83c\udf31","text":"<p>Here is the structure of this repo:</p> <pre><code>ros1_bridge_ws\n\u251c\u2500\u2500 .devcontainer\n|   \u2514\u2500\u2500 devcontainer.json\n\u251c\u2500\u2500 docker\n|   \u251c\u2500\u2500 .dockerignore\n|   \u251c\u2500\u2500 .env\n|   \u251c\u2500\u2500 compose.yaml\n|   \u251c\u2500\u2500 compose.debug.yaml\n|   \u251c\u2500\u2500 Dockerfile\n|   \u2514\u2500\u2500 start-bridge.sh\n\u2514\u2500\u2500 README.md\n</code></pre>"},{"location":"ros1-bridge-ws/#how-to-use","title":"\ud83d\udea9 How to use \ud83d\udea9","text":"<p>The docker compose includes two services: <code>ros1-bridge</code> and <code>ros1-bridge-build</code>. The <code>ros1-bridge</code> service is typically sufficient for regular use, while <code>ros1-bridge-build</code> is intended for debugging, as it retains all the necessary build tools in the docker image.</p> <p>If you are not debugging <code>ros1-bridge</code>, it is recommended to use the terminal rather than VScode-devcontainer. By default, the VScode-devcontainer uses the <code>ros1-bridge-build</code> service.</p>"},{"location":"ros1-bridge-ws/#1-build-the-docker-image","title":"1. Build the docker image","text":"<p>While building the image directly from the Dockerfile is possible, it may not be the most efficient choice. To save time, you can pull the image from Dockerhub instead of compiling it from the source.</p> <p>If you still prefer to build the image yourself, please follow the instructions below:</p> <ul> <li>VScode user<ul> <li>Open the workspace in VScode, press <code>F1</code>, and enter <code>&gt; Dev Containers: Rebuild Container</code>.</li> </ul> </li> <li>Terminal user<ul> <li>Open a terminal, change the directory to the docker folder, and type <code>docker compose build</code>.</li> </ul> </li> </ul> <p>Please note that the build process may take approximately 1 hour to complete, with potential delays depending on your computer's performance and network conditions.</p>"},{"location":"ros1-bridge-ws/#2-adjust-the-parameters-in-the-env-file","title":"2. Adjust the parameters in the <code>.env</code> file","text":"<p>We've placed all ROS-related parameters in the <code>.env</code> file. Please adjust these parameters according to your environment. By default, we set the <code>ROS1</code> master at <code>127.0.0.1</code>, and the <code>ROS2</code> domain ID to <code>0</code>. These settings should work for most scenarios. </p> <p>Please note that if these parameters are not configured correctly, the <code>ros1_bridge</code> will not function properly!</p>"},{"location":"ros1-bridge-ws/#3-start-the-container","title":"3. Start the container","text":"<ul> <li>VScode user<ul> <li>If you build the image through the devcontainer, it will automatically start the container.   After you get into the container, type <code>./start-bridge.sh</code> in the terminal.</li> </ul> </li> <li>Terminal user<ul> <li>Open a terminal, change the directory to the docker folder, and type <code>docker compose up</code>.</li> </ul> </li> </ul>"},{"location":"ros1-bridge-ws/#4-launch-rosmaster-in-ros1","title":"4. Launch rosmaster in ROS1","text":"<p>This step is automatically executed when you run <code>docker compose up</code>.</p> <p>As mentioned in https://github.com/ros2/ros1_bridge/issues/391, you should avoid using <code>roscore</code> in ROS1 to prevent the issue of not bridging <code>/rosout</code>. Instead, use <code>rosmaster --core</code> as an alternative.</p>"},{"location":"ros1-bridge-ws/#5-begin-communication","title":"5. Begin communication","text":"<p>You have successfully executed all the instructions. Now, you can proceed to initiate communication between ROS1 and ROS2-humble.</p> <p>Please keep in mind that the bridge will be established only when there are matching publisher-subscriber pairs active for a topic on either side of the bridge.</p>"},{"location":"ros1-bridge-ws/#example","title":"\u2728 Example \u2728","text":""},{"location":"ros1-bridge-ws/#run-the-bridge-and-the-example-talker-and-listener","title":"Run the bridge and the example talker and listener","text":"<p>Before beginning the example, ensure you have four containers ready:</p> <ul> <li><code>ros-core</code></li> <li><code>ros2-ros1-bridge-ws</code></li> <li><code>ros1</code></li> <li><code>ros2</code></li> </ul> <p>When using <code>ros1-bridge</code> in your application scenarios, you only need the <code>ros-core</code> and <code>ros2-ros1-bridge-ws</code> containers. Please replace the <code>ros1</code> and <code>ros2</code> containers with your application containers, as those are only included for demonstration purposes and are not required for using <code>ros1-bridge</code>.  </p> <p>Furthermore, ensure that you mount <code>/dev/shm</code> into both the <code>ros2-ros1-bridge-ws</code> and <code>ros2</code> containers, and that all containers share the host network.</p>"},{"location":"ros1-bridge-ws/#1-start-the-ros1_bridge-and-other-container","title":"1. Start the <code>ros1_bridge</code> and other container","text":"<pre><code># In docker folder\ndocker compose up\n</code></pre> <p>This command will start the four containers mentioned above.</p>"},{"location":"ros1-bridge-ws/#2-run-the-talker-and-listener-node","title":"2. Run the talker and listener node","text":"<p>We run the listener node in the <code>ros1</code> container and the talker node in the <code>ros2</code> container. You can run the talker node in <code>ros1</code> and the listener node in <code>ros2</code> if you'd like. To achieve this, modify the command provided below.</p>"},{"location":"ros1-bridge-ws/#ros1","title":"ROS1","text":"<pre><code>docker exec -it ros1 /ros_entrypoint.sh bash\n# Inside ros1 container\nrosrun roscpp_tutorials listener\n# or\n# rosrun roscpp_tutorials talker\n</code></pre>"},{"location":"ros1-bridge-ws/#ros2","title":"ROS2","text":"<pre><code>docker exec -it ros2 /ros_entrypoint.sh bash\n# Inside ros2 container\n# Use the same UID as ros1_bridge to prevent Fast-DDS shared memory permission issues.\n# Ref: https://github.com/j3soon/ros2-essentials/pull/9#issuecomment-1795743063\nuseradd -ms /bin/bash user\nsu user\nsource /opt/ros/humble/setup.bash\nros2 run demo_nodes_cpp talker\n# or\n# ros2 run demo_nodes_cpp listener\n</code></pre> <p>Certainly, you can try the example provided by <code>ros1_bridge</code>. However, there's no need to source the setup script within the <code>ros2-ros1-bridge-ws</code> container, simply starting the container will suffice.</p>"},{"location":"ros1-bridge-ws/#troubleshooting","title":"\ud83d\udd0d Troubleshooting \ud83d\udd0d","text":"<p>If you are trying to debug <code>ros1_bridge</code>, it is recommended to use the <code>ros1-bridge-build</code> service in docker compose. It contains all the necessary build tools, which should be helpful for you.</p>"},{"location":"ros1-bridge-ws/#failed-to-contact-ros-master","title":"Failed to contact ros master","text":"<p>Before launching <code>ros-core</code>, make sure to adjust the <code>ROS_MASTER_URI</code> correctly. For more information, please check the <code>.env</code> file and this section.</p> <p>You can replace <code>127.0.0.1</code> with the actual IP address or hostname of your ros master. This configuration ensures that your ros nodes know where to find the ros master for communication. Remember, in addition to modifying the parameters for <code>ros1_bridge</code>, you also need to adjust the parameters for your own container!</p>"},{"location":"ros1-bridge-ws/#ros2-cant-receive-the-topic","title":"ROS2 can't receive the topic","text":"<p>The latest releases of Fast-DDS come with the shared memory transport enabled by default. Therefore, you need to mount shared memory, also known as <code>/dev/shm</code>, into every container you intend to communicate with when using Fast-DDS. This ensures proper communication between containers. Ensure that you use the same UID as <code>ros2-ros1-bridge-ws</code> to avoid Fast-DDS shared memory permission issues.</p> <p>Reference: https://github.com/eProsima/Fast-DDS/issues/1698#issuecomment-778039676</p>"},{"location":"rtabmap-ws/","title":"RTAB-Map","text":""},{"location":"rtabmap-ws/#run-with-docker","title":"Run with docker","text":"<pre><code>git clone https://github.com/j3soon/ros2-essentials.git\n</code></pre> <pre><code>cd ros2-essentials/rtabmap_ws/docker\ndocker compose pull\ndocker compose up -d --build\n</code></pre> <ul> <li>Attach to the container   <pre><code>docker attach ros2-rtabmap-ws\ncd /home/ros2-essentials/rtabmap_ws\ncolcon build --symlink-install\n</code></pre></li> </ul>"},{"location":"rtabmap-ws/#lidar-test-with-gazebo","title":"LiDAR test with gazebo","text":"<ul> <li>Launch Gazebo with turtlebot3 in <code>tmux</code> <pre><code>ros2 launch rtabmap_sim sim_robot.launch.py\n</code></pre></li> <li>Run rtabmap LiDAR demo in a new <code>tmux</code> window   <pre><code>ros2 launch rtabmap_demos turtlebot3_scan.launch.py\n</code></pre></li> </ul>"},{"location":"rtabmap-ws/#rgbd-test-with-gazebo","title":"RGBD test with gazebo","text":"<ul> <li>Launch Gazebo with turtlebot3 in <code>tmux</code> <pre><code>ros2 launch rtabmap_sim sim_robot.launch.py\n</code></pre></li> <li>Run rtabmap LiDAR demo in a new <code>tmux</code> window   <pre><code>ros2 launch rtabmap_demos turtlebot3_rgbd.launch.py\n</code></pre></li> </ul>"},{"location":"rtabmap-ws/#dual-sensor-test-with-gazebo","title":"Dual sensor test with gazebo","text":"<ul> <li>Launch Gazebo with turtlebot3 in <code>tmux</code> <pre><code>ros2 launch rtabmap_sim sim_robot.launch.py\n</code></pre></li> <li>Run dual sensor demo in a new <code>tmux</code> window   <pre><code>ros2 launch rtabmap_sim dual_sensor.launch.py\n</code></pre></li> </ul>"},{"location":"rtabmap-ws/#run-with-rqt","title":"Run with rqt","text":"<ul> <li>Running in a new <code>tmux</code> window   <pre><code>rqt_robot_steering\n</code></pre></li> </ul>"},{"location":"rtabmap-ws/#result","title":"Result","text":"<ul> <li>After you've run the demo, you could find the following result directly.</li> </ul> <ol> <li>LiDAR test  </li> <li>RGBD test  </li> <li>Dual sensor test  </li> </ol>"},{"location":"rtabmap-ws/#reference","title":"Reference","text":"<ul> <li>RTAB-Map wiki</li> </ul>"},{"location":"rtabmap-ws/#existing-issues","title":"Existing issues","text":"<ul> <li><code>VTK</code> warning   <pre><code>QVTKOpenGLWidget: Warning: In /build/vtk6-6.3.0+dfsg1/Rendering/OpenGL2/vtkOpenGLRenderWindow.cxx, line 781\n...\n</code></pre><ul> <li>It seems that the warning isn't a big deal. But it will interrupt debugging in the future.</li> <li>Possible solution : set <code>VTK_LEGACY_REMOVE</code>, but it required to build from source.     - Still not tested yet.</li> <li>Issue Reference</li> </ul> </li> </ul>"},{"location":"template-ws/","title":"Template","text":"<p>This template will help you set up a ROS-Humble environment quickly.</p>"},{"location":"template-ws/#structure","title":"\ud83c\udf31 Structure \ud83c\udf31","text":"<p>Here is the structure of this template:</p> <pre><code>ros2-essentials\n\u251c\u2500\u2500 scripts\n|   \u2514\u2500\u2500 create_workspace.sh\n\u251c\u2500\u2500 template_ws\n|   \u251c\u2500\u2500 .devcontainer\n|   |   \u2514\u2500\u2500 devcontainer.json\n|   \u251c\u2500\u2500 docker\n|   |   \u251c\u2500\u2500 .bashrc\n|   |   \u251c\u2500\u2500 .dockerignore\n|   |   \u251c\u2500\u2500 compose.yaml\n|   |   \u2514\u2500\u2500 Dockerfile\n|   \u251c\u2500\u2500 install\n|   \u251c\u2500\u2500 build\n|   \u251c\u2500\u2500 log\n|   \u251c\u2500\u2500 src\n|   |   \u251c\u2500\u2500 minimal_pkg\n|   |   |   \u251c\u2500\u2500 include\n|   |   |   \u251c\u2500\u2500 minimal_pkg\n|   |   |   \u251c\u2500\u2500 scripts\n|   |   |   \u2514\u2500\u2500 ...\n|   |   \u2514\u2500\u2500 ...\n|   \u2514\u2500\u2500 README.md\n</code></pre> <ul> <li><code>build</code> / <code>install</code> / <code>log</code> folders will appear once you've built the packages.</li> </ul>"},{"location":"template-ws/#how-to-use-this-template","title":"\ud83d\udea9 How to use this template \ud83d\udea9","text":""},{"location":"template-ws/#1-use-the-script-to-copy-the-template-workspace","title":"1. Use the script to copy the template workspace.","text":"<p>We have provided a script to create a new workspace. Please use it to avoid potential issues.  </p> <pre><code># Open a terminal, and change the directory to ros2-essentials.\n./scripts/create_workspace.sh &lt;new_workspace_name&gt;\n</code></pre> <p>To unify the naming style, we will modify the string <code>&lt;new_workspace_name&gt;</code> in some files.</p>"},{"location":"template-ws/#2-configure-settings","title":"2. Configure settings.","text":"<p>To help you easily find where changes are needed, we have marked most of the areas you need to adjust with <code># TODO:</code>. Usually, you only need to modify the configurations without removing anything. If you really need to remove something, make sure you clearly understand your goal and proceed with caution.</p> <ul> <li><code>docker/Dockerfile</code>     - Add the packages you need according to the comments inside.</li> <li><code>docker/compose.yaml</code>     - By default, the Docker image is built according to your current computer's architecture. If you need to cross-compile, please modify the <code>platforms</code> parameter to your desired architecture and set up the basic environment.     - If you want to access the GPU in the container, please uncomment the lines accordingly.     - If you want to add any environment variables in the container, you can include them in the <code>environment</code> section, or you can use <code>export VARIABLE=/the/value</code> in <code>docker/.bashrc</code>.</li> <li><code>docker/.bashrc</code>     - We will automatically compile the workspace in .bashrc. If you don't want this to happen, feel free to remove it. If you\u2019re okay with it, remember to adjust the compilation commands according to your packages.</li> <li><code>src</code>     - Add the ros packages you need here.     - <code>minimal_pkg</code> is the ROS2 package used to create a publisher and subscriber in both Python and C++. You can remove it if you don't need it.</li> </ul>"},{"location":"template-ws/#3-open-the-workspace-folder-using-visual-studio-code","title":"3. Open the workspace folder using Visual Studio Code.","text":"<p>Haven't set up the devcontainer yet ?</p> <p>Please refer to the tutorial provided by Visual Studio Code first. You can find it here:  https://code.visualstudio.com/docs/devcontainers/containers</p> <p>We recommend using <code>VScode</code> + <code>devcontainer</code> for development. This plugin can significantly reduce development costs and can be used on local computers, remote servers, and even embedded systems. If you don't want to use <code>devcontainer</code>, you can still use Docker commands for development, such as <code>docker compose up</code> and <code>docker exec</code>.</p> <p>Open the workspace folder using Visual Studio Code, spotting the workspace folder within your Explorer indicates that you've selected the wrong folder. You should only observe the <code>.devcontainer</code>, <code>docker</code> and <code>src</code> folders there.</p>"},{"location":"template-ws/#4-build-the-container","title":"4. Build the container.","text":"<p>We have pre-built some Docker images on Docker Hub. If the building time is too long, you might consider downloading them from Docker Hub instead. For more information, please refer to the <code>README.md</code> on the repository's main page.</p> <p>Press <code>F1</code> and enter <code>&gt; Dev Containers: Rebuild Container</code>. Building the images and container will take some time. Please be patient.</p> <p>You should see the output below.</p> <pre><code>Done. Press any key to close the terminal.\n</code></pre> <p>For non-devcontainer users, please navigate to the <code>docker</code> folder and use <code>docker compose build</code> to build the container. We have moved all commands that need to be executed into the <code>.bashrc</code> file. No further action is needed after creating the Docker container.</p>"},{"location":"template-ws/#5-start-to-develop-with-ros","title":"5. Start to develop with ROS.","text":"<p>You've successfully completed all the instructions. Wishing you a productive and successful journey in your ROS development !</p>"},{"location":"template-ws/#warning","title":"\u26a0\ufe0f Warning \u26a0\ufe0f","text":"<ul> <li>Do not place your files in any folder named <code>build</code>, <code>install</code>, or <code>log</code>. These folders will not be tracked by Git.</li> <li>If you encounter an error when opening Gazebo, consider closing the container and reopen it. Alternatively, you can check the log output in <code>~/.gazebo</code>, which may contain relevant error messages. The most common issue is using a duplicate port, which prevents Gazebo from starting. You can use <code>lsof -i:11345</code> to identify which process is using the port and then use <code>kill -9</code> to terminate it.</li> <li><code>xhost +local:docker</code> is required if the container is not in privileged mode.</li> </ul>"},{"location":"vlp-ws/","title":"Velodyne VLP-16","text":""},{"location":"vlp-ws/#simulation-setup","title":"Simulation Setup","text":""},{"location":"vlp-ws/#add-description-in-defined-robot","title":"Add description in defined robot","text":"<ol> <li> <p>Declared necessary argument and  your own <code>robot_gazebo.urdf.xacro</code></p> <pre><code>&lt;xacro:arg name=\"gpu\" default=\"false\"/&gt;\n&lt;xacro:arg name=\"organize_cloud\" default=\"false\"/&gt;\n&lt;xacro:property name=\"gpu\" value=\"$(arg gpu)\" /&gt;\n&lt;xacro:property name=\"organize_cloud\" value=\"$(arg organize_cloud)\" /&gt;\n</code></pre> </li> <li> <p>Include the <code>velodyne_description</code> package</p> <pre><code>&lt;xacro:include filename=\"$(find velodyne_description)/urdf/VLP16.urdf.xacro\" /&gt;\n</code></pre> </li> <li> <p>Add LiDAR in the robot</p> <pre><code>&lt;xacro:VLP-16 parent=\"base_footprint\" name=\"velodyne\" topic=\"/velodyne_points\" organize_cloud=\"${organize_cloud}\" hz=\"10\" samples=\"440\" gpu=\"${gpu}\"&gt;\n    &lt;origin xyz=\"0 0 0.1\" rpy=\"0 0 0\" /&gt;\n&lt;/xacro:VLP-16&gt;\n</code></pre> </li> </ol> <ul> <li>You could refer to more information from <code>veloyne_simulator/velodyne_description/urdf/template.urdf.xacro</code></li> </ul>"},{"location":"vlp-ws/#launch-lidar-driver-with-simulated-lidar","title":"Launch LiDAR driver with simulated LiDAR","text":"<ul> <li>Launch example robot with LiDAR<pre><code>ros2 launch velodyne_description example.launch.py\n</code></pre> </li> </ul> <ul> <li>Launch the LiDAR data process without driver in another terminal<pre><code>ros2 launch vlp_cartographer vlp_driver.launch.py is_sim:=True\n</code></pre> </li> </ul>"},{"location":"vlp-ws/#sample-robot","title":"Sample Robot","text":"<ul> <li>A given turtlebot waffle model with VLP-16 is provided in <code>velodyne_simulator/velodyne_simulator/urdf/sample_robot.urdf.xacro</code></li> <li>Launch the sample robot<pre><code>ros2 launch velodyne_description example.launch.py robot:=1\n</code></pre> </li> </ul>"},{"location":"vlp-ws/#lidar-setup","title":"LiDAR setup","text":""},{"location":"vlp-ws/#hardware-setup","title":"Hardware Setup","text":"<ul> <li>Connect the LiDAR to power.</li> <li>Connect the LiDAR to the computer or router using the provided ethernet cable.</li> </ul>"},{"location":"vlp-ws/#directly-using-computer","title":"Directly Using Computer","text":"<ul> <li>Connect the LiDAR to the computer using the ethernet cable.</li> <li>Open the computer settings and navigate to Network &gt; Wired.</li> </ul> <ul> <li>Set the IPv4 configuration to 'manual' and configure the settings as shown in the image below:</li> </ul>"},{"location":"vlp-ws/#launch-the-driver","title":"Launch the Driver","text":""},{"location":"vlp-ws/#pipeline","title":"Pipeline","text":"<ul> <li>Data process as following:   raw data -&gt; pointcloud -&gt; laser scan -&gt; slam method</li> </ul> <ul> <li>Velodyne driver: <code>velodyne_driver</code> get the raw data from LiDAR.</li> <li>Transform the raw data to pointcloud: <code>velodyne_pointcloud</code></li> <li>Transform the pointcloud to laser scan: <code>velodyne_laserscan</code></li> </ul>"},{"location":"vlp-ws/#operating-in-a-single-launch-file","title":"Operating in a single launch file","text":"<pre><code>ros2 launch vlp_cartographer vlp_driver.launch.py\n</code></pre> <ul> <li>By the above command, the driver, pointcloud and laserscan will be launched.</li> </ul>"},{"location":"vlp-ws/#published-topics","title":"Published topics","text":"Topic Type Description <code>/velodyne_packets</code> <code>velodyne_msgs/VelodyneScan</code> raw data <code>/velodyne_points</code> <code>sensor_msgs/PointCloud2</code> Point cloud message <code>/scan</code> <code>sensor_msgs/LaserScan</code> laser scan message"},{"location":"vlp-ws/#test-with-cartographer","title":"Test with cartographer","text":"<ul> <li>In another terminal, launch the cartographer node:<pre><code>ros2 launch vlp_cartographer cartographer_demo.launch.py\n</code></pre> </li> </ul>"},{"location":"vlp-ws/#bringup","title":"Bringup","text":"<ul> <li>Build the docker image and workspace<pre><code>docker compose up --build\n</code></pre> </li> </ul> <ul> <li>LiDAR driver<pre><code>docker exec -it ros2-vlp-ws /home/ros2-essentials/vlp_ws/scripts/lidar-driver-bringup.sh\n</code></pre> </li> </ul> <ul> <li>After launching the driver, launch the cartographer in another terminal<pre><code>docker exec -it ros2-vlp-ws /home/ros2-essentials/vlp_ws/scripts/lidar-slam-bringup.sh\n</code></pre> </li> </ul>"},{"location":"vlp-ws/#reference","title":"Reference","text":"<ul> <li>Velodyne_driver with ROS2 Humble</li> <li>Cartographer ROS</li> <li>Turtlebot3 with Cartographer</li> </ul>"}]}
\ No newline at end of file