From 22c48bab11de81990a513c5c40535e1b7508bc19 Mon Sep 17 00:00:00 2001 From: Sungho Woo Date: Fri, 24 Jan 2025 17:53:10 +0900 Subject: [PATCH 1/2] Updated tb3 manual Signed-off-by: Sungho Woo --- _data/navigation.yml | 2 - .../basic_examples_intro_kinetic.md | 4 +- .../autonomous_driving/autonomous_driving.md | 148 +----------------- docs/en/platform/turtlebot3/basic_examples.md | 52 +++--- .../platform/turtlebot3/machine_learning.md | 94 ++--------- .../platform/turtlebot3/overview/overview.md | 4 + .../turtlebot3/quick_start/quick_start.md | 36 ++--- 7 files changed, 67 insertions(+), 273 deletions(-) diff --git a/_data/navigation.yml b/_data/navigation.yml index 6e45f7e70..187e3bad3 100644 --- a/_data/navigation.yml +++ b/_data/navigation.yml @@ -26048,8 +26048,6 @@ turtlebot3: url: /platform/turtlebot3/autonomous_driving/#level-crossing - title: "Tunnel" url: /platform/turtlebot3/autonomous_driving/#tunnel - - title: "TurtleBot3 AutoRace 2019" - url: /platform/turtlebot3/autonomous_driving_autorace/ - title: "Machine Learning" url: /platform/turtlebot3/machine_learning/#machine-learning children: diff --git a/_includes/en/platform/turtlebot3/basic_examples/basic_examples_intro_kinetic.md b/_includes/en/platform/turtlebot3/basic_examples/basic_examples_intro_kinetic.md index 665178afc..19c384185 100644 --- a/_includes/en/platform/turtlebot3/basic_examples/basic_examples_intro_kinetic.md +++ b/_includes/en/platform/turtlebot3/basic_examples/basic_examples_intro_kinetic.md @@ -1,5 +1,7 @@ +**WARNING**: This version is a temporarily uploaded manual that was originally supported in **Kinetic**. It needs to be ported to Noetic examples and is planned to be supported with **Humble** examples soon. +{: .notice--danger} -**WARNING**: Make sure to run the [Bringup][bringup] instruction before performing this examples, and be careful when testing the robot on the table as the robot might fall. + Make sure to run the [Bringup][bringup] instruction before performing this examples, and be careful when testing the robot on the table as the robot might fall. {: .notice--warning} {% capture notice_01 %} diff --git a/docs/en/platform/turtlebot3/autonomous_driving/autonomous_driving.md b/docs/en/platform/turtlebot3/autonomous_driving/autonomous_driving.md index 29ea1b463..a9ea4f089 100644 --- a/docs/en/platform/turtlebot3/autonomous_driving/autonomous_driving.md +++ b/docs/en/platform/turtlebot3/autonomous_driving/autonomous_driving.md @@ -7,8 +7,8 @@ share: true author_profile: false permalink: /docs/en/platform/turtlebot3/autonomous_driving/ tabs: "ROS" -tab_title3: Noetic -tab_title6: Humble +tab_title2: Noetic +tab_title5: Humble sidebar: title: TurtleBot3 nav: "turtlebot3" @@ -25,116 +25,31 @@ page_number: 19 # [Autonomous Driving](#autonomous-driving)
-**NOTE**: TurtleBot3 Autorace is only officially supported in ROS Kinetic and Noetic -{: .notice--warning} -
- -
-**NOTE**: TurtleBot3 Autorace is only officially supported in ROS Kinetic and Noetic -{: .notice--warning} -
-
-**NOTE**: TurtleBot3 Autorace is only officially supported in ROS Kinetic and Noetic -{: .notice--warning} -
- -
-**NOTE**: TurtleBot3 Autorace is only officially supported in ROS Kinetic and Noetic -{: .notice--warning} -
- -
-**NOTE**: TurtleBot3 Autorace is only officially supported in ROS Kinetic and Noetic -{: .notice--warning} -
- -
-## Getting Started -{% include en/platform/turtlebot3/autonomous_driving/kinetic/autonomous_driving_getting_started_kinetic.md %} -
- -
## Getting Started {% include en/platform/turtlebot3/autonomous_driving/noetic/autonomous_driving_sim_getting_started_noetic.md %} -
- - - -
## [Camera Calibration](#camera-calibration) Calibrating the camera is very important for autonomous driving. The following describes how to simply calibrate the camera step by step. -
- -
-## [Camera Calibration](#camera-calibration) -Calibrating the camera is very important for autonomous driving. The following describes how to simply calibrate the camera step by step. -
- -
-### [Camera Imaging Calibration](#camera-imaging-calibration) -{% include en/platform/turtlebot3/autonomous_driving/kinetic/autonomous_driving_camera_imaging_calibration_kinetic.md %} -
- -
### [Camera Imaging Calibration](#camera-imaging-calibration) {% include en/platform/turtlebot3/autonomous_driving/noetic/autonomous_driving_sim_camera_imaging_calibration_noetic.md %} -
-
-### [Intrinsic Camera Calibration](#intrinsic-camera-calibration) -{% include en/platform/turtlebot3/autonomous_driving/kinetic/autonomous_driving_intrinsic_camera_calibration_kinetic.md %} -
- -
### [Intrinsic Camera Calibration](#intrinsic-camera-calibration) {% include en/platform/turtlebot3/autonomous_driving/noetic/autonomous_driving_sim_intrinsic_camera_calibration_noetic.md %} -
- - -
-### [Extrinsic Camera Calibration](#extrinsic-camera-calibration) -{% include en/platform/turtlebot3/autonomous_driving/kinetic/autonomous_driving_extrinsic_camera_calibration_kinetic.md %} -
-
### [Extrinsic Camera Calibration](#extrinsic-camera-calibration) {% include en/platform/turtlebot3/autonomous_driving/noetic/autonomous_driving_sim_extrinsic_camera_calibration_noetic.md %} -
- -
-### [Check Calibration Result](#check-calibration-result) -{% include en/platform/turtlebot3/autonomous_driving/kinetic/autonomous_driving_check_calibration_result_kinetic.md %} -
-
### [Check Calibration Result](#check-calibration-result) {% include en/platform/turtlebot3/autonomous_driving/noetic/autonomous_driving_sim_check_calibration_result_noetic.md %} -
- -
-## [Lane Detection](#lane-detection) -{% include en/platform/turtlebot3/autonomous_driving/kinetic/autonomous_driving_lane_detection_kinetic.md %} -
-
## [Lane Detection](#lane-detection) {% include en/platform/turtlebot3/autonomous_driving/noetic/autonomous_driving_sim_lane_detection_noetic.md %} -
-
-## [Traffic Sign Detection](#traffic-sign-detection) -{% include en/platform/turtlebot3/autonomous_driving/kinetic/autonomous_driving_traffic_sign_detection_kinetic.md %} -
- -
## [Traffic Sign Detection](#traffic-sign-detection) {% include en/platform/turtlebot3/autonomous_driving/noetic/autonomous_driving_sim_traffic_sign_detection_noetic.md %} -
-
## [Missions](#missions) The AutoRace is a competition for autonomous driving robot platforms. @@ -143,74 +58,27 @@ To provide various conditions for a robot application development, the game prov **WARNING**: Be sure to read [Autonomous Driving](#autonomous-driving) in order to start missions. {: .notice--warning} -
- -
-## [Missions](#missions) - -The AutoRace is a competition for autonomous driving robot platforms. -To provide various conditions for a robot application development, the game provide structural regulation as less as possible. Provided open sources are based on ROS, and can be applied to this competition. The contents can be continually updated. Join the competition and show your skill. - -**WARNING**: Be sure to read [Autonomous Driving](#autonomous-driving) in order to start missions. -{: .notice--warning} -
- -
-### [Traffic Lights](#traffic-lights) -{% include en/platform/turtlebot3/autonomous_driving/kinetic/autonomous_driving_traffic_lights_kinetic.md %} -
- -
### [Traffic Lights](#traffic-lights) {% include en/platform/turtlebot3/autonomous_driving/noetic/autonomous_driving_sim_traffic_lights_noetic.md %} -
- -
-### [Intersection](#intersection) -{% include en/platform/turtlebot3/autonomous_driving/kinetic/autonomous_driving_intersection_kinetic.md %} -
-
### [Intersection](#intersection) {% include en/platform/turtlebot3/autonomous_driving/noetic/autonomous_driving_sim_intersection_noetic.md %} -
-
-### [Construction](#construction) -{% include en/platform/turtlebot3/autonomous_driving/kinetic/autonomous_driving_construction_kinetic.md %} -
- -
### [Construction](#construction) {% include en/platform/turtlebot3/autonomous_driving/noetic/autonomous_driving_sim_construction_noetic.md %} -
-
-### [Parking](#parking) -{% include en/platform/turtlebot3/autonomous_driving/kinetic/autonomous_driving_parking_kinetic.md %} -
- -
### [Parking](#parking) {% include en/platform/turtlebot3/autonomous_driving/noetic/autonomous_driving_sim_parking_noetic.md %} -
-
-### [Level Crossing](#level-crossing) -{% include en/platform/turtlebot3/autonomous_driving/kinetic/autonomous_driving_level_crossing_kinetic.md %} -
- -
### [Level Crossing](#level-crossing) {% include en/platform/turtlebot3/autonomous_driving/noetic/autonomous_driving_sim_level_crossing_noetic.md %} -
- -
-### [Tunnel](#tunnel) -{% include en/platform/turtlebot3/autonomous_driving/kinetic/autonomous_driving_tunnel_kinetic.md %} -
-
### [Tunnel](#tunnel) {% include en/platform/turtlebot3/autonomous_driving/noetic/autonomous_driving_sim_tunnel_noetic.md %}
+ +
+**NOTE**: The TurtleBot3 Autorace Humble version is scheduled to be released soon +{: .notice--warning} +
+ diff --git a/docs/en/platform/turtlebot3/basic_examples.md b/docs/en/platform/turtlebot3/basic_examples.md index 4c628bcad..d58ef84a5 100644 --- a/docs/en/platform/turtlebot3/basic_examples.md +++ b/docs/en/platform/turtlebot3/basic_examples.md @@ -22,9 +22,9 @@ page_number: 22 # [Examples](#examples) - +
-**NOTE**: This feature is available for ROS Kinetic and ROS2 Dashing. -{: .notice} +**NOTE**: The examples will be added as quickly as possible based on **Humble**. We appreciate your interest and support. +{: .notice--danger}
- ## [Move using Interactive Markers](#move-using-interactive-markers) - + + + + + + + + + +
@@ -70,34 +49,19 @@ page_number: 21
-
+
{% include en/platform/turtlebot3/machine_learning/machine_learning_software_setup_dashing.md %}
- - - - - ## [Set parameters](#set-parameters) -
+
@@ -107,34 +71,21 @@ page_number: 21
-
+
{% include en/platform/turtlebot3/machine_learning/machine_learning_set_parameter_dashing.md %}
- - - ## [Run Machine Learning](#run-machine-learning) -
+
@@ -144,23 +95,10 @@ page_number: 21
-
+
{% include en/platform/turtlebot3/machine_learning/machine_learning_run_machine_learning_dashing.md %}
- - - diff --git a/docs/en/platform/turtlebot3/overview/overview.md b/docs/en/platform/turtlebot3/overview/overview.md index 2d2292746..c1a18558e 100644 --- a/docs/en/platform/turtlebot3/overview/overview.md +++ b/docs/en/platform/turtlebot3/overview/overview.md @@ -19,6 +19,9 @@ page_number: 1 # [Overview](#overview) +**Notice**: With the establishment of the Platform Team at ROBOTIS in 2025, significant resources will be allocated to the management and development of the open platform. As a priority, TurtleBot3 will receive dedicated support for **ROS 2 Humble**, with full example support planned for Q1. In Q2, we will extend support to the **ROS 2 Jazzy** version. We appreciate your continued interest and support. +{: .notice--danger} + ![](/assets/images/platform/turtlebot3/overview/turtlebot3_with_logo.png) {% capture info_00 %} @@ -82,6 +85,7 @@ If you are interested in partnership with us to continue to further the developm ![](/assets/images/icon_unfold.png) Check out these ROS and TurtleBot3 Publications: +- 23/01/2025 Official resumption of TurtleBot3 maintenance and development! - 09/06/2021 TurtleBot3 has been upgraded with Raspberry Pi 4!!! - 05/28/2021 [TurtleBot3 Autorace 2020 now runs with ROS Noetic](https://www.youtube.com/playlist?list=PLRG6WP3c31_WsNjwmYID2ulX5g4WcjKbI) - 05/24/2021 [ROS 2 Galactic Geochelone Release](https://discourse.ros.org/t/ros-2-galactic-geochelone-released/20559) diff --git a/docs/en/platform/turtlebot3/quick_start/quick_start.md b/docs/en/platform/turtlebot3/quick_start/quick_start.md index 77c0ccfc0..9368665d0 100644 --- a/docs/en/platform/turtlebot3/quick_start/quick_start.md +++ b/docs/en/platform/turtlebot3/quick_start/quick_start.md @@ -21,35 +21,23 @@ page_number: 4 {::options parse_block_html="true" /} -**Only ROS1 Noetic and ROS2 Humble are officially supported by ROBOTIS at this time. However, development of TurtleBot features for other ROS distributions is ongoing. The following chart provides an overview of the features supported by each ROS Distribution** +**Currently, ROS 1 Noetic and ROS 2 Humble are officially supported by ROBOTIS. In 2025, additional resources will be allocated for managing the open platform, with plans to complete example support for Humble in Q1 and extend support to Jazzy by Q2. The following chart provides an overview of the features supported by each ROS distribution.** ✓ : Available
? : Unverified
X : Unavailable
-| Features | Kinetic | Melodic | Noetic | Dashing | Foxy | Galactic | Humble | -|:----------------------:|:-------:|:-------:|:------:|:-------:|:----:|:--------:|:------:| -| Teleop | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | -| SLAM | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | -| Navigation | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | -| Simulation | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | -| Manipulation | ✓ | ✓ | ✓ | ✓ | ✓ | ? | ✓ | -| Home Service Challenge | ✓ | ✓ | ✓ | X | X | X | X | -| Autonomous Driving | ✓ | X | ✓ | X | X | X | X | -| Machine Learning | ✓ | ✓ | X | ✓ | X | X | X | - -| Examples | Kinetic | Melodic | Noetic | Dashing | Foxy | Galactic | Humble | -|:--------------------:|:-------:|:-------:|:------:|:-------:|:----:|:--------:|:------:| -| Interactive Markers | ✓ | X | X | X | X | X | X | -| Obstacle Detection | ✓ | X | X | ✓ | X | X | X | -| Position Control | ✓ | X | X | ✓ | X | X | X | -| Point Operation | ✓ | X | X | ✓ | X | X | X | -| Patrol | ✓ | X | X | ✓ | X | X | X | -| Follower | ✓ | X | X | X | X | X | X | -| Panorama | ✓ | X | X | X | X | X | X | -| Auto Parking | ✓ | X | X | ✓ | X | X | X | -| Auto Parking (Vision)| ✓ | X | X | X | X | X | X | -| Multi TurtleBot3 | ✓ | X | X | X | X | X | X | +| Features | Noetic | Humble | Jazzy(soon)| +|:----------------------:|:------:|:--------:|:--------:| +| Teleop | ✓ | ✓ | X | +| SLAM | ✓ | ✓ | X | +| Navigation | ✓ | ✓ | X | +| Simulation | ✓ | ✓ | X | +| Manipulation | ✓ | ✓ | X | +| Home Service Challenge | ✓ | X | X | +| Autonomous Driving | ✓ | X | X | +| Machine Learning | X | X | X | +
{% include en/platform/turtlebot3/quickstart_noetic.md %} From 8cce399ffa9b737dc25f074aee9a15050b894117 Mon Sep 17 00:00:00 2001 From: Sungho Woo Date: Fri, 31 Jan 2025 12:29:17 +0900 Subject: [PATCH 2/2] Updated overview and quick_start parts --- docs/en/platform/turtlebot3/overview/overview.md | 2 +- docs/en/platform/turtlebot3/quick_start/quick_start.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/en/platform/turtlebot3/overview/overview.md b/docs/en/platform/turtlebot3/overview/overview.md index c1a18558e..143e1509e 100644 --- a/docs/en/platform/turtlebot3/overview/overview.md +++ b/docs/en/platform/turtlebot3/overview/overview.md @@ -19,7 +19,7 @@ page_number: 1 # [Overview](#overview) -**Notice**: With the establishment of the Platform Team at ROBOTIS in 2025, significant resources will be allocated to the management and development of the open platform. As a priority, TurtleBot3 will receive dedicated support for **ROS 2 Humble**, with full example support planned for Q1. In Q2, we will extend support to the **ROS 2 Jazzy** version. We appreciate your continued interest and support. +**Notice**: With the formation of the Platform Team in 2025, substantial resources will be dedicated to advancing the open platform. As a priority, **TurtleBot3** will receive full support for ROS 2 Humble, with **comprehensive example implementations** set for release in Q1 2025. In Q2, support will expand to **ROS 2 Jazzy** and **Gazebo Sim**, ensuring seamless integration with the latest advancements in the ROS ecosystem and simulation environments. {: .notice--danger} ![](/assets/images/platform/turtlebot3/overview/turtlebot3_with_logo.png) diff --git a/docs/en/platform/turtlebot3/quick_start/quick_start.md b/docs/en/platform/turtlebot3/quick_start/quick_start.md index 9368665d0..610362c2e 100644 --- a/docs/en/platform/turtlebot3/quick_start/quick_start.md +++ b/docs/en/platform/turtlebot3/quick_start/quick_start.md @@ -21,7 +21,7 @@ page_number: 4 {::options parse_block_html="true" /} -**Currently, ROS 1 Noetic and ROS 2 Humble are officially supported by ROBOTIS. In 2025, additional resources will be allocated for managing the open platform, with plans to complete example support for Humble in Q1 and extend support to Jazzy by Q2. The following chart provides an overview of the features supported by each ROS distribution.** +**Currently, ROS 1 Noetic and ROS 2 Humble are officially supported. In 2025, additional resources will be allocated for managing the open platform, with plans to complete example support for Humble in Q1 and extend support to Jazzy by Q2. The following chart provides an overview of the features supported by each ROS distribution.** ✓ : Available
? : Unverified