SDK Installation
Xvisio SDK Documentation Home Page

ROS1 Installation User Guide


Note:This installation user guide is created for version ROS 1. Version ROS 2 is under development.

Prerequisite

  • Ubuntu18.04 and Ubuntu20.04 OS

ROS1 Environment Installation

  1. Set your "sources.list":
    sudo rm /etc/apt/sources.list.dros-latest.list
    //skip to next setp if it prompted no file can be deleted.
    sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list'

  2. Set key:
    sudo apt-key adv --keyserver 'hkp://keyserver.ubuntu.com:80' --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654

  3. Install ROS system:
    3.1 Update system software package:
    sudo apt update

    3.2 Install ROS system:

    • Ubuntu18.04
      sudo apt -y install ros-melodic-desktop-full ros-melodic-ddynamic-reconfigure
    • Ubuntu20.04
      sudo apt -y install ros-noetic-desktop-full ros-noetic-ddynamic-reconfigure

    3.3 Related installation dependencies:
    sudo apt install -y python3-rosdep python3-rosinstall python3-rosinstall-generator python3-wstool build-essential
    3.4 Environment configuration

    • Ubuntu18.04
      Bash
      echo "source /opt/ros/melodic/setup.bash" >> ~/.bashrc
      source ~/.bashrc
      zsh
      echo "source /opt/ros/melodic/setup.zsh" >> ~/.zshrc
      source ~/.zshrc
    • Ubuntu20.04
      Bash
      echo "source /opt/ros/noetic/setup.bash" >> ~/.bashrc
      source ~/.bashrc
      zsh
      echo "source /opt/ros/noetic/setup.zsh" >> ~/.zshrc
      source ~/.zshrc

    3.5 Initial "rosdep"
    sudo rosdep init
    rosdep update

Xvisio SDK Installation

Please click here to refer to the website for SDK installation.

ROS Wrapper Code Compile

  1. Initialize workspace
    1.1 creat catalogue
    mkdir -p ~/catkin_ws/src
    1.2 enter into workspace
    cd ~/catkin_ws/
    1.3 Initialize workspace environment
    catkin_make
    source ${HOME}/catkin_ws/devel/setup.bash
    echo "source ${HOME}/catkin_ws/devel/setup.bash" >> ~/.bashrc
  2. "xv_sdk" compile
    2.1 open the terminal in Ubuntu xvisio SDK installation catalogue (default installation patch: /usr/share/ros-wrapper)
    2.2 copy "xv_sdk" to workspace
    cp -r xv_sdk ~/catkin_ws/src/
    2.3 Install the dependency of ROS package in workspace.
    rosdep install --from-paths src --ignore-src -r -y
    2.4 compile
    catkin_make -DXVSDK_INCLUDE_DIRS="/usr/include/xvsdk" -DXVSDK_LIBRARIES="/usr/lib/libxvsdk.so"

Start "xv_sdk" Node

  1. start ROS system
    roscore
  2. start "xv_sdk" node
    cd ~/catkin_ws/
    roslaunch xv_sdk xv_sdk.launch

SDK Installation
Xvisio SDK Documentation Home Page