husarion_components_description

URDF models of sensors and other components offered alongside Husarion robots.

Overview

Components (cameras, lidars, frames, manipulators, …) are attached to a robot from a single YAML config: a list of entries, each picking a component by its type code and placing it on a parent link. Husarion robot packages (e.g. rosbot_description) read this config and build the URDF for you; you can also instantiate a component’s xacro macro directly (see Advanced).

Build

# create workspace folder and clone husarion_components_description
mkdir -p ros2_ws/src
cd ros2_ws
git clone https://github.com/husarion/husarion_components_description.git src/husarion_components_description

# in case the package will be used within simulation
export HUSARION_ROS_BUILD_TYPE=simulation

rosdep update --rosdistro $ROS_DISTRO
rosdep install -i --from-path src --rosdistro $ROS_DISTRO -y
colcon build

Usage via config

List the components you want under components:. Each entry selects a type (see Available components) and where to mount it:

components:
  - type: LDR06
    parent_link: cover_link
    xyz: 0.0 0.0 0.2
    rpy: 0.0 0.0 0.0

  - type: CAM06
    name: front
    parent_link: camera_mount_link
    xyz: -0.01 0.0 0.02
    rpy: 0.0 0.0 0.0

Config schema

Some types accept extra fields (e.g. RCK takes elements, custom takes package/file).

Available components

Frames & mounts

Cameras

Lidars

File truncated at 100 lines see the full file