Installation
Introduction
vizionsdk_ros2 is a ROS 2 wrapper for VizionSDK cameras. It provides a camera node, a device-list utility, RViz configurations, and helper nodes for working with VizionSDK camera streams in ROS 2.
The source repository is hosted at TechNexion-Vision/vizionsdk-ros2. If the repository is still private, make sure your GitHub account has access before cloning it.
Install ROS 2 and VizionSDK before building this wrapper. Camera support follows the installed VizionSDK release.
Supported Platforms
| Platform | Architecture | ROS 2 Distribution |
|---|---|---|
| Ubuntu 22.04 | AMD64 / ARM64 | Humble |
| Ubuntu 24.04 | AMD64 / ARM64 | Jazzy |
| NVIDIA Jetson | ARM64 | Distribution-dependent |
| NXP i.MX | ARM64 | Distribution-dependent |
| Raspberry Pi | ARM64 | Distribution-dependent |
| TI TDA4VM | ARM64 | Distribution-dependent |
Prerequisites
Replace <distro> with your ROS 2 distribution, such as humble or jazzy.
ROS 2 Environment
Source the ROS 2 environment:
source /opt/ros/<distro>/setup.bash
Install ROS 2 build dependencies:
sudo apt update
sudo apt install \
build-essential \
cmake \
pkg-config \
python3-colcon-common-extensions \
ros-<distro>-ament-cmake \
ros-<distro>-diagnostic-msgs \
ros-<distro>-launch \
ros-<distro>-launch-ros \
ros-<distro>-rcl-interfaces \
ros-<distro>-rclcpp \
ros-<distro>-sensor-msgs
VizionSDK
Install VizionSDK for your platform before building vizionsdk_ros2.
If VizionSDK is installed to a custom prefix, expose it before building:
export CMAKE_PREFIX_PATH=/opt/vizionsdk:$CMAKE_PREFIX_PATH
export PKG_CONFIG_PATH=/opt/vizionsdk/lib/pkgconfig:$PKG_CONFIG_PATH
export LD_LIBRARY_PATH=/opt/vizionsdk/lib:$LD_LIBRARY_PATH
Optional Viewing Tools
Install RViz to view IMU and camera topics:
sudo apt install ros-<distro>-rviz2
Install image viewing tools and the compressed image transport plugin to view MJPG streams:
sudo apt install \
ros-<distro>-rqt-image-view \
ros-<distro>-compressed-image-transport