ROS Index
Repository Summary
| Checkout URI | https://github.com/intel/ros2_intel_realsense.git |
| VCS Type | git |
| VCS Version | master |
| Last Updated | 2023-01-07 |
| Dev Status | MAINTAINED |
| CI status | No Continuous Integration |
| Released | RELEASED |
| Tags | No category tags. |
| Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Packages
| Name | Version |
|---|---|
| realsense_camera_msgs | 2.0.4 |
| realsense_ros2_camera | 2.0.4 |
README
DISCONTINUATION OF PROJECT
This project will no longer be maintained by Intel.
Intel has ceased development and contributions including, but not limited to, maintenance, bug fixes, new releases, or updates, to this project.
Intel no longer accepts patches to this project.
If you have an ongoing need to use this project, are interested in independently developing it, or would like to maintain patches for the open source software community, please create your own fork of this project.
Contact: webadmin@linux.intel.com
ROS2 Wrapper for Intel® RealSense™ Devices
These are packages for using Intel RealSense cameras (D400 series) with ROS2.
Note: If you want T265 supported, please check out this branch
Installation Instructions
The following instructions were verified with ROS2 Dashing on Ubutnu 18.04.
Dependencies
Install ROS2 packages ros-dashing-desktop
Install ROS2 dependences
sudo apt-get install ros-dashing-cv-bridge ros-dashing-librealsense2 ros-dashing-message-filters ros-dashing-image-transport
Or you may install from sources:
- cv_bridge
- Intel® RealSense™ SDK 2.0 Currently, we support librealsense master branch.
- ros2_message_filters
- ros2 image_transport
Install Other non-ROS debian packages
sudo apt-get install -y libssl-dev libusb-1.0-0-dev pkg-config libgtk-3-dev
sudo apt-get install -y libglfw3-dev libgl1-mesa-dev libglu1-mesa-dev
- libssl-dev
- libusb-1.0-0-dev
- pkg-config
- libgtk-3-dev
- libglfw3-dev
- libgl1-mesa-dev
- libglu1-mesa-dev
Install ros2_intel_realsense binary packages
sudo apt-get install ros-dashing-realsense-camera-msgs ros-dashing-realsense-ros2-camera
The ros2_intel_realsense packages installation have been completed. You could jump to Usage Instructions for executing, you could also install ros2_intel_realsense from source for more features.
Install ros2_intel_realsense from source
#get code
mkdir -p ~/ros2_ws/src
cd ~/ros2_ws/src
git clone https://github.com/intel/ros2_intel_realsense.git
#build
cd ~/ros2_ws
source /opt/ros/dashing/setup.bash
colcon build --base-paths src/ros2_intel_realsense
Usage Instructions
Start the camera node
To start the camera node in ROS2, plug in the camera, then type the following command:
source /opt/ros/dashing/setup.bash
source ~/ros2_ws/install/local_setup.bash
# To launch with "ros2 run"
ros2 run realsense_ros2_camera realsense_ros2_camera
# OR, to invoke the executable directly
realsense_ros2_camera
This will stream all camera sensors and publish on the appropriate ROS2 topics. PointCloud2 is enabled by default, till we provide ROS2 python launch options.
Published Topics
Rectified depth image: /camera/depth/image_rect_raw
Color image: /camera/color/image_raw
Rectified infra1 image: /camera/infra1/image_rect_raw
Rectified infra2 image: /camera/infra2/image_rect_raw
Depth registered point cloud: /camera/aligned_depth_to_color/color/points
Visualize Depth Aligned (i.e. Depth Registered) Point Cloud
To start the camera node in ROS2 and view the depth aligned pointcloud in rviz:
```bash source /opt/ros/dashing/setup.bash source ~/ros2_ws/install/local_setup.bash
console #1 launch rviz2
ros2 run rviz2 rviz2 -d realsense_ros2_camera/rviz/ros2.rviz
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/intel/ros2_intel_realsense.git |
| VCS Type | git |
| VCS Version | master |
| Last Updated | 2023-01-07 |
| Dev Status | MAINTAINED |
| CI status | No Continuous Integration |
| Released | RELEASED |
| Tags | No category tags. |
| Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Packages
| Name | Version |
|---|---|
| realsense_camera_msgs | 2.0.4 |
| realsense_ros2_camera | 2.0.4 |
README
DISCONTINUATION OF PROJECT
This project will no longer be maintained by Intel.
Intel has ceased development and contributions including, but not limited to, maintenance, bug fixes, new releases, or updates, to this project.
Intel no longer accepts patches to this project.
If you have an ongoing need to use this project, are interested in independently developing it, or would like to maintain patches for the open source software community, please create your own fork of this project.
Contact: webadmin@linux.intel.com
ROS2 Wrapper for Intel® RealSense™ Devices
These are packages for using Intel RealSense cameras (D400 series) with ROS2.
Note: If you want T265 supported, please check out this branch
Installation Instructions
The following instructions were verified with ROS2 Dashing on Ubutnu 18.04.
Dependencies
Install ROS2 packages ros-dashing-desktop
Install ROS2 dependences
sudo apt-get install ros-dashing-cv-bridge ros-dashing-librealsense2 ros-dashing-message-filters ros-dashing-image-transport
Or you may install from sources:
- cv_bridge
- Intel® RealSense™ SDK 2.0 Currently, we support librealsense master branch.
- ros2_message_filters
- ros2 image_transport
Install Other non-ROS debian packages
sudo apt-get install -y libssl-dev libusb-1.0-0-dev pkg-config libgtk-3-dev
sudo apt-get install -y libglfw3-dev libgl1-mesa-dev libglu1-mesa-dev
- libssl-dev
- libusb-1.0-0-dev
- pkg-config
- libgtk-3-dev
- libglfw3-dev
- libgl1-mesa-dev
- libglu1-mesa-dev
Install ros2_intel_realsense binary packages
sudo apt-get install ros-dashing-realsense-camera-msgs ros-dashing-realsense-ros2-camera
The ros2_intel_realsense packages installation have been completed. You could jump to Usage Instructions for executing, you could also install ros2_intel_realsense from source for more features.
Install ros2_intel_realsense from source
#get code
mkdir -p ~/ros2_ws/src
cd ~/ros2_ws/src
git clone https://github.com/intel/ros2_intel_realsense.git
#build
cd ~/ros2_ws
source /opt/ros/dashing/setup.bash
colcon build --base-paths src/ros2_intel_realsense
Usage Instructions
Start the camera node
To start the camera node in ROS2, plug in the camera, then type the following command:
source /opt/ros/dashing/setup.bash
source ~/ros2_ws/install/local_setup.bash
# To launch with "ros2 run"
ros2 run realsense_ros2_camera realsense_ros2_camera
# OR, to invoke the executable directly
realsense_ros2_camera
This will stream all camera sensors and publish on the appropriate ROS2 topics. PointCloud2 is enabled by default, till we provide ROS2 python launch options.
Published Topics
Rectified depth image: /camera/depth/image_rect_raw
Color image: /camera/color/image_raw
Rectified infra1 image: /camera/infra1/image_rect_raw
Rectified infra2 image: /camera/infra2/image_rect_raw
Depth registered point cloud: /camera/aligned_depth_to_color/color/points
Visualize Depth Aligned (i.e. Depth Registered) Point Cloud
To start the camera node in ROS2 and view the depth aligned pointcloud in rviz:
```bash source /opt/ros/dashing/setup.bash source ~/ros2_ws/install/local_setup.bash
console #1 launch rviz2
ros2 run rviz2 rviz2 -d realsense_ros2_camera/rviz/ros2.rviz
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/intel/ros2_intel_realsense.git |
| VCS Type | git |
| VCS Version | refactor |
| Last Updated | 2020-05-09 |
| Dev Status | MAINTAINED |
| CI status | No Continuous Integration |
| Released | RELEASED |
| Tags | No category tags. |
| Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Packages
| Name | Version |
|---|---|
| realsense_examples | 2.0.8 |
| realsense_msgs | 2.0.8 |
| realsense_node | 2.0.8 |
| realsense_ros | 2.0.8 |
README
ROS2 Package for Intel® RealSense™ Devices
Supported Devices
- Intel® RealSense™ Camera D400-Series
- Intel® RealSense™ Depth Cameras D415, D435 and D435i
- Intel® RealSense™ Tracking Camera T265
Installation Instructions
The following instructions were verified with ROS2 Foxy on Ubuntu 20.04. The software is verified with ROS2 Dashing on Ubuntu 18.04 also, with the same instructions replacing “foxy” with “dashing”.
Install Dependencies
1. Install ROS2 packages ros-foxy-desktop
2. Install ROS2 dependences
Currently, we support librealsense master branch.
sudo apt-get install ros-foxy-librealsense2
3. Install other non-ROS debian packages
sudo apt-get install -y libssl-dev libusb-1.0-0-dev pkg-config libgtk-3-dev
sudo apt-get install -y libglfw3-dev libgl1-mesa-dev libglu1-mesa-dev
Install ros2_intel_realsense From Source
# fetch code
mkdir -p ~/ros2_ws/src
cd ~/ros2_ws/src
git clone https://github.com/intel/ros2_intel_realsense.git
cd ros2_intel_realsense
git checkout refactor
# build
source /opt/ros/foxy/setup.bash
cd ~/ros2_ws
colcon build --symlink-install
Usage Instructions
Start Camera Node
Obtain the serial number of your device
rs-enumerate-devices
Change the corresponding yaml file with the specific serial number, e.g. for d435.yaml in line3:
serial_no:
# d435
To start the camera node in ROS2, plug in the camera, then type the following command:
Single camera, taking d435 for example:
source /opt/ros/foxy/setup.bash
source ~/ros2_ws/install/local_setup.bash
## using ros2 run
cd ~/ros2_ws
ros2 run realsense_node realsense_node __params:=`ros2 pkg prefix realsense_examples`/share/realsense_ros/config/d435.yaml __ns:=/d435
## using ros2 launch
ros2 launch realsense_examples rs_camera.launch.py
Multi camera, taking d435 and t265 for example:
- Terminal 1:
source /opt/ros/foxy/setup.bash
source ~/ros2_ws/install/local_setup.bash
cd ~/ros2_ws
ros2 run realsense_node realsense_node __params:=`ros2 pkg prefix realsense_examples`/share/realsense_examples/config/d435.yaml __ns:=/d435
- Terminal 2:
source /opt/ros/foxy/setup.bash
source ~/ros2_ws/install/local_setup.bash
cd ~/ros2_ws
ros2 run realsense_node realsense_node __params:=`ros2 pkg prefix realsense_examples`/share/realsense_examples/config/t265.yaml __ns:=/t265
- Or using ros2 launch :
```bash source /opt/ros/foxy/setup.bash source ~/ros2_ws/install/local_setup.bash
File truncated at 100 lines see the full file