https://github.com/klintan/ros2_usb_camera

ROS2 USB Camera node
https://github.com/klintan/ros2_usb_camera

camera ros2

Last synced: 2 months ago
JSON representation

ROS2 USB Camera node

• Host: GitHub
• URL: https://github.com/klintan/ros2_usb_camera
• Owner: klintan
• License: apache-2.0
• Created: 2018-11-18T08:31:18.000Z (over 5 years ago)
• Default Branch: foxy-devel
• Last Pushed: 2021-04-13T01:35:31.000Z (about 3 years ago)
• Last Synced: 2024-01-08T07:09:56.409Z (6 months ago)
• Topics: camera, ros2
• Language: C++
• Size: 67.4 KB
• Stars: 70
• Watchers: 6
• Forks: 44
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.rst
  • License: LICENSE

Lists

• awesome-ros2 - ros2_usb_camera - ROS2 General USB camera driver.  (Packages / Driver layer)
• Awesome-Autonomous-Driving - ros2_usb_camera - all most ros2 usb camera driver you can buy from Taobao/Aliexpress. (2. Sensor and Calibration Tools / 2.1 Sensor Hardware)

README

        
# ROS2 USB Camera Node

Its based on both the image_tools cam2image demos for ROS2 as well as the libuvc and usb_cam project for ROS1.

Features

- CameraInfo available

- CompressedImage topic (see compressed images for republishing using image_transport)

- Image topic

- Select camera (running the node for each camera connected)

There might be major changes to the code as it is a WIP. This is a simple camera driver using OpenCV. With this comes less flexibility for custom camera settings etc but simple to setup and use. If you have more complex requirements I've listed some alternate packages in the Alternate packages section.

### Topics

- `/camera_info` - topic for camera info

- `/image_raw` - topic for raw image data

## Installation

Make sure to run setup.bash and local_setup.bash for all dependencies or symlink them into the repo.

Run

`colcon build`

## Usage

`ros2 run usb_camera_driver usb_camera_driver_node __ns:=/ __params:=config.yaml`

Available parameters:

- `frame_id` -> transform frame_id of the camera, defaults to "camera"

- `image_width` -> image width (1280 default)

- `image_height` -> image height (720 default)

- `fps` -> video fps (10 default)

- `camera_id` -> id of camera to capture (0 - 100, 0 default)

### Calibration files

To use the camera info functionality you need to load a file from the camera_calibration (https://github.com/ros-perception/image_pipeline/tree/ros2/camera_calibration) library and put it in/name it `file:///Users//.ros/camera_info/camera.yaml`

### Compressed images

To get compressed images (works seamlessly with web streaming) republish the topic using image_transport which is available for ROS2.

`ros2 run image_transport republish raw in:=image_raw compressed out:=image_raw_compressed`

Make sure to link/install https://github.com/ros-perception/image_transport_plugins/tree/ros2 before to enable compressed image republishing using image_transport since its not included in the base package. More information here http://wiki.ros.org/image_transport, here http://wiki.ros.org/compressed_image_transport and here https://answers.ros.org/question/35183/compressed-image-to-image/

## Alternate packages

Other camera packages in ROS2 now available: 

- https://github.com/ros-drivers/usb_cam/tree/ros2

## References

https://github.com/ros-perception/vision_opencv/tree/ros2