mirror of
https://git.ti.com/git/mmwave_radar/mmwave_ti_ros.git
synced 2026-05-21 09:22:15 +00:00
Changed to folder structure
Signed-off-by: Yogesh Siraswar <yogeshs@ti.com>
This commit is contained in:
Yogesh Siraswar
@@ -0,0 +1,91 @@
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<title>Safety Bubble with ROS for mmWave Release Notes - Version 1.1</title>
|
||||
</head>
|
||||
|
||||
<!-- START PRE -->
|
||||
<link rel="stylesheet" href="../../../../.metadata/.html/scripts/strapdown/v/0.2/fonts/ubuntu-regular-woff.css"/>
|
||||
<link rel="stylesheet" href="../../../../.metadata/.html/scripts/strapdown/v/0.2/fonts/glyphicons-halflings-regular.css"/>
|
||||
<link rel="stylesheet" href="../../../../.metadata/.html/scripts/strapdown/v/0.2/themes/united2.min.css"/>
|
||||
<link rel="stylesheet" href="../../../../.metadata/.html/scripts/strapdown/v/0.2/themes/bootstrap-responsive.min.css"/>
|
||||
<link rel="stylesheet" href="../../../../.metadata/.html/scripts/strapdown/v/0.2/strapdown.css"/>
|
||||
<link rel="stylesheet" href="../../../../.metadata/.html/styles/link.css"/>
|
||||
<!-- END PRE -->
|
||||
|
||||
<xmp style="display:none;" class="col-xs-6">
|
||||
|
||||
|
||||
Safety Bubble with ROS for mmWave Release Notes
|
||||
=============
|
||||
|
||||
|
||||
Overview
|
||||
========
|
||||
|
||||
This lab allows for four TI mmWave sensors and a Turtlebot2 to be used with popular mapping and libraries in the Robot Operating System (ROS) environment, familiar to many robotics engineers.
|
||||
The lab uses the move_base libraries with TI’s mmWave ROS Driver Package software to interface to the TI mmWave sensor. The lab supports use of IWR6843ISK ES2.0 Evaluation Module.
|
||||
With the TI ROS driver and packages from the ROS community (ros.org) engineers may evaluate robot bubble sensing quickly and easily.
|
||||
|
||||
In this lab, the robot will move forward at a defined maximum speed. When an object come within a certain distance
|
||||
to the robot, the robot will first slow down. If the same object continues to approach the robot, the robot will then stop moving forward.
|
||||
Once the robot has cleared the object, the robot will speed up again to its maximum speed. It is assumed that the slow zone bubble is larger than the stop zone bubble.
|
||||
|
||||
|
||||
Features
|
||||
========
|
||||
|
||||
* Integrates the TI mmWave ROS driver into the ROS Turtlebot2 platform to allow
|
||||
the TI mmWave sensor IWR6843ISK EVM to be used as a 3-D sensor
|
||||
* Allows the driver to be compatible with multiple mmWave sensors.
|
||||
* Demonstrates mapping using the the TI mmWave sensor with the ROS Octomap
|
||||
package
|
||||
* Demonstrates navigation with collision-avoidance using the TI mmWave sensor
|
||||
with the ROS move_base package
|
||||
* Creates bubbles around the robot and performs different behavior depending on object distance.
|
||||
|
||||
|
||||
Resolved Incident Reports
|
||||
=========================
|
||||
|
||||
The following are Incident Reports resolved in this release:
|
||||
* N/A
|
||||
|
||||
|
||||
Known Limitations
|
||||
============
|
||||
|
||||
The following are Known Limitations in this release:
|
||||
* Currently supported/tested for IWR6843ISK ES2.0 EVM only
|
||||
* The mmWave EVM must be flashed with:
|
||||
* The mmWave SDK version 3.5 out-of-box demo firmware for IWR6843ISK ES2.0
|
||||
* The fake_localization ROS navigation package is used to allow direct setting of
|
||||
the robot’s initial pose (position/orientation) and goal pose. Therefore, the
|
||||
gmapping and amcl ROS navigation packages are not used.
|
||||
* The robot only moves forward.
|
||||
* When the robot stops, and after the costmaps are cleared, if an object is still in the stop zone, the robot will suddenly move forward and immediately stop.
|
||||
|
||||
|
||||
Work Arounds for Major Known Issues
|
||||
===================================
|
||||
|
||||
The following are workarounds for each known issue with a major severity that exists in this release:
|
||||
* N/A
|
||||
|
||||
Changes in Version 1.1
|
||||
========================
|
||||
The following is a list of changes compared to the previous release.
|
||||
- Changed instructions to download code from git.ti.com
|
||||
- Merged source code to Autonomous Robotics Lab.
|
||||
|
||||
</xmp>
|
||||
|
||||
<link rel="stylesheet" href="../../../../.metadata/.html/scripts/highlight/styles/zenburn.css"/>
|
||||
<script src="../../../../.metadata/.html/scripts/strapdown/vendor/jquery-1.11.2.min.js"></script>
|
||||
<script src="../../../../.metadata/.html/scripts/strapdown/vendor/bootstrap.min.js"></script>
|
||||
<script src="../../../../.metadata/.html/scripts/highlight/highlight.pack.js"></script>
|
||||
<script src="../../../../.metadata/.html/scripts/strapdown/v/0.2/strapdown.js"></script>
|
||||
<script src="../../../../.metadata/.html/scripts/toolbox.js"></script>
|
||||
<script src="../../../../.metadata/.html/scripts/toolbox_fixes.js"></script>
|
||||
</html>
|
||||
Binary file not shown.
@@ -0,0 +1,158 @@
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<title>Safety Bubble with ROS for mmWave User's Guide - Version 1.1 </title>
|
||||
</head>
|
||||
|
||||
<!-- START PRE -->
|
||||
<link rel="stylesheet" href="../../../../.metadata/.html/scripts/strapdown/v/0.2/fonts/ubuntu-regular-woff.css"/>
|
||||
<link rel="stylesheet" href="../../../../.metadata/.html/scripts/strapdown/v/0.2/fonts/glyphicons-halflings-regular.css"/>
|
||||
<link rel="stylesheet" href="../../../../.metadata/.html/scripts/strapdown/v/0.2/themes/united2.min.css"/>
|
||||
<link rel="stylesheet" href="../../../../.metadata/.html/scripts/strapdown/v/0.2/themes/bootstrap-responsive.min.css"/>
|
||||
<link rel="stylesheet" href="../../../../.metadata/.html/scripts/strapdown/v/0.2/strapdown.css"/>
|
||||
<link rel="stylesheet" href="../../../../.metadata/.html/styles/link.css"/>
|
||||
<!-- END PRE -->
|
||||
|
||||
<xmp style="display:none;" class="col-xs-6">
|
||||
|
||||
|
||||
360° Safety Bubble with ROS for mmWave
|
||||
===========
|
||||
|
||||
This lab allows for four TI mmWave sensors and a Turtlebot2 to be used with popular mapping and libraries in the Robot Operating System ([ROS](http://wiki.ros.org/)) environment.
|
||||
The lab uses the move_base libraries with TI’s mmWave ROS Driver Package software to interface to the TI mmWave sensors. The lab supports use of IWR6843ISK ES2.0 Evaluation Module.
|
||||
With the TI ROS driver and packages from the ROS community (ros.org) engineers may evaluate robot bubble sensing quickly and easily.
|
||||
|
||||
In this lab, the robot will move forward at a defined maximum speed. When an object come within a certain distance
|
||||
to the robot, the robot will first slow down. If the same object continues to approach the robot, the robot will then stop moving forward.
|
||||
Once the robot has cleared the object, the robot will speed up again to its maximum speed. It is assumed that the slow zone bubble is larger than the stop zone bubble.
|
||||
|
||||
Visit this link for an example demonstration: [http://www.ti.com/mmWaveROSsafetybubblevideo](http://www.ti.com/mmWaveROSsafetybubblevideo)
|
||||
|
||||
Below is an image depicting how the bubble demonstration functions. Note that the numbers shown in the image are configurable: <img src="images/DemoDesc.PNG" class="img-responsive"/>
|
||||
|
||||
To enable a full 360° field of view, four TI mmWave sensors are used. Should users not have access to four sensors, the lab also functions with one sensor. However, a fully surrounding field of view will not be possible.
|
||||
|
||||
## Hardware and Software Setup
|
||||
|
||||
Before starting the safety bubble demo, please follow the directions described in the [ROS Setup Guide with TI mmWave](../../common/docs/Turtlebot_HWSW_setup.html).
|
||||
This guide will explain which hardware is necessary, how to setup the hardware, and the software installation process.
|
||||
|
||||
|
||||
## 1. Sensor Bubble Demo
|
||||
---------------
|
||||
|
||||
Here are the steps to run the sensor bubble demo.
|
||||
1. Close all previous terminal windows if any were open.
|
||||
|
||||
1. Open a new terminal and change directory to the autonomous_robotics_ros folder provided in the mmwave_ti_ros git repository.
|
||||
```
|
||||
cd mmwave_ti_ros/autonomous_robotics_ros
|
||||
```
|
||||
|
||||
2. SSH into the remote laptop, and run the following. If the EVM was not in a good state the roslaunch command will fail. Try resetting the EVM by
|
||||
pressing the ‘NRST’ button on the EVM and then run the desired roslaunch command again. The `<device>` tag noted below can be one of the following: `6843ISK` or `6843AOP`.
|
||||
|
||||
```
|
||||
$ roslaunch ti_mmwave_rospkg bubble_sensor_north.launch config:=3d device:=<device>
|
||||
```
|
||||
|
||||
3. If there are no errors, then the north sensor has been configured correctly. Now stop the process by pressing 'Ctrl+C'. Single sensor users can now continue to the next step. For use with four sensors, repeat step 2 three more times but replacing 'bubble_sensor_north.launch'
|
||||
with 'bubble_sensor_east.launch', 'bubble_sensor_west.launch', and 'bubble_sensor_south.launch', stopping the process with 'Ctrl+C' after each command. This process ensures that each sensor is configured correctly. Skipping this step is not recommended.
|
||||
|
||||
4. Open a new terminal window on the remote machine, ssh into the TurtleBot laptop and bring up the
|
||||
TurtleBot and mmWave EVM with the command below. The `<device>` tag noted below can be one of the following: `6843ISK` or `6843AOP`.
|
||||
|
||||
* For setups running a single sensor:
|
||||
```
|
||||
$ roslaunch turtlebot_bringup minimal_single_sensor.launch mmwave_device:=<device>
|
||||
```
|
||||
|
||||
* For setups running four sensors:
|
||||
```
|
||||
$ roslaunch turtlebot_bringup minimal_quad_sensor.launch mmwave_device:=<device>
|
||||
```
|
||||
|
||||
5. To bring up the move_base and fake_localization nodes, open a new terminal window on the remote machine, ssh into the TurtleBot
|
||||
laptop and run the following command.
|
||||
* For single sensor:
|
||||
```
|
||||
$ roslaunch turtlebot_mmwave_launchers radar_navigation_single.launch
|
||||
```
|
||||
|
||||
* For quad sensors use:
|
||||
```
|
||||
$ roslaunch turtlebot_mmwave_launchers radar_navigation_quad.launch
|
||||
```
|
||||
|
||||
**Note**: You may see “octree is empty” warnings when there are no objects detected in front of the mmWave sensors.
|
||||
|
||||
5. At this point, the point clouds for all sensors and the global costmap should be alive. Open a new terminal window on
|
||||
the remote machine and run the following command which will open a pre-defined Rviz configuration customized for the navigation demo.
|
||||
* To show the inflation layer which is used for motion control (the command is all one line):
|
||||
```
|
||||
$ rosrun rviz rviz -d mmwave_ti_ros/autonomous_robotics_ros/src/turtlebot_mmwave_launchers/launch/bubble_visualization.rviz
|
||||
```
|
||||
* To hide the inflation layer and only show the point cloud data:
|
||||
```
|
||||
$ rosrun rviz rviz -d mmwave_ti_ros/autonomous_robotics_ros/src/turtlebot_mmwave_launchers/launch/bubble_visualization_2.rviz
|
||||
```
|
||||
|
||||
**Note**: Both options show the point cloud from all four sensors, while each color represents a sensor direction. Specifically, points seen by the north sensor are displayed in purple, east sensor in red, south sensor in blue, and west sensor in orange.
|
||||
|
||||
6. Running the following will start the robot moving forward and either slow down or stop for a certain time
|
||||
depending on whether or not objects are within the slow and stop zones. Both single and quad sensor users can execute:
|
||||
|
||||
```
|
||||
$ roslaunch ti_safety_bubble controller.launch
|
||||
```
|
||||
|
||||
[[r! The robot will now move forward
|
||||
The robot will stop when an object in front of the north sensor is detected. However, it will continue to move
|
||||
forward after some time, and then stop again. This process of moving forward and stopping continues until the
|
||||
program has stopped. Always be ready to terminate the program by pressing Ctrl+C.
|
||||
]]
|
||||
|
||||
# How It Works
|
||||
---------------
|
||||
|
||||
This section will describe how the 360° safety bubble demo works. This lab uses a large portion of the open sourced
|
||||
[ROS navigation stack](https://http://wiki.ros.org/navigation), and primarily uses the global costmap. The navigation
|
||||
stack has been setup to input the point cloud from all 4 mmWave sensors into the global and local costmaps.
|
||||
The navigation stack does not take control and navigate around the obstacles. Instead, by launching controller.launch,
|
||||
the odomListener node takes the obstacle information from the global costmap and calculates the distance to the robot.
|
||||
If the distance is within the slow zone threshold, the node then sends a velocity command to slow down the robot. If the
|
||||
distance is within the stop zone threshold, a stop velocity is published. Information in the global costmap is always saved,
|
||||
which is not suitable for moving objects as a history of where the objects has previously been will be stored. Thus is the
|
||||
need to periodically clear the global costmap. This way only the recent obstacle layer history will be used.
|
||||
|
||||
## Configurable Parameters
|
||||
---------------
|
||||
|
||||
1. The size, position, and resolution of the global costmap can be adjusted. To do this, edit the file 'global_costmap_params.yaml' in the path 'turtlebot/turtlebot_apps/turtlebot_navigation/param/'.
|
||||
2. The size of zone bubbles and the time to clear costmaps are configurable. Zone bubbles are defined as radius from the center of the robot. Edit the parameters "slow_radius", "stop_radius", and "clear_costmap_period_secs" in controller.launch in the path 'ti_safety_bubble/launch/'.
|
||||
|
||||
Need More Help?
|
||||
===========
|
||||
* Fort Turtlebot2 issues and questions: <http://wiki.ros.org/Robots/TurtleBot#Robots.2BAC8-TurtleBot.2BAC8-kinetic.TurtleBot2>
|
||||
* For ROS related questions: <https://answers.ros.org/questions/>
|
||||
|
||||
* Additional resources in the documentation of the mmWave SDK (note hyperlinks will only work if the mmWave SDK has been installed on PC):
|
||||
* [mmWave SDK Module Doc located at `<mmwave_sdk_install_dir>/docs/mmwave_sdk_module_documentation.html`](file:///C:/ti/mmwave_sdk_03_04_00_03/docs/mmwave_sdk_module_documentation.html)
|
||||
* [mmWave SDK User's Guide located at `<mmwave_sdk_install_dir>/docs/mmwave_sdk_user_guide.pdf`](file:///C:/ti/mmwave_sdk_03_04_00_03/docs/mmwave_sdk_user_guide.pdf)
|
||||
* [mmWave SDK Release Notes located at `<mmwave_sdk_install_dir>/docs/mmwave_sdk_release_notes.pdf`](file:///C:/ti/mmwave_sdk_03_04_00_03/docs/mmwave_sdk_release_notes.pdf)
|
||||
|
||||
* Find answers to common questions on [mmWave E2E FAQ](https://e2e.ti.com/support/sensors/f/1023/t/595725)
|
||||
* Search for your issue or post a new question on the [mmWave E2E forum](https://e2e.ti.com/support/sensor/mmwave_sensors/f/1023)
|
||||
|
||||
</xmp>
|
||||
|
||||
<link rel="stylesheet" href="../../../../.metadata/.html/scripts/highlight/styles/zenburn.css"/>
|
||||
<script src="../../../../.metadata/.html/scripts/strapdown/vendor/jquery-1.11.2.min.js"></script>
|
||||
<script src="../../../../.metadata/.html/scripts/strapdown/vendor/bootstrap.min.js"></script>
|
||||
<script src="../../../../.metadata/.html/scripts/highlight/highlight.pack.js"></script>
|
||||
<script src="../../../../.metadata/.html/scripts/strapdown/v/0.2/strapdown.js"></script>
|
||||
<script src="../../../../.metadata/.html/scripts/toolbox.js"></script>
|
||||
<script src="../../../../.metadata/.html/scripts/toolbox_fixes.js"></script>
|
||||
</html>
|
||||
Binary file not shown.
BIN
autonomous_robotics_ros/docs/safety_bubble/images/DemoDesc.PNG
Normal file
BIN
autonomous_robotics_ros/docs/safety_bubble/images/DemoDesc.PNG
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 459 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 7.4 MiB |
Binary file not shown.
|
After Width: | Height: | Size: 88 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 179 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 267 B |
Binary file not shown.
|
After Width: | Height: | Size: 56 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 147 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 137 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 496 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 360 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 333 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 61 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 52 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 87 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 41 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 50 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 51 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 190 KiB |
Reference in New Issue
Block a user