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

Changelog for package husarion_components_description

0.1.0 (2025-12-12)

• Add tf_prefix arg and fix depthai reference frame for camera (#14)
• Add meshes (#13)
  • Add Ouster mesh
  • Add wibotic meshes and fixes
  • Make wibotic station more universal (change root_link, edit height of elements)
  • apriltag_height -> apriltag_mount_height
• Fixed teltonika antenna link (#12)
• Replace / with _ in bridge node name ([#11 <https://github.com/husarion/husarion_components_description/issues/11>]{.title-ref}
• Big clean up + frame standarization (#9)
• Fix default device_name
• Add missing lidar
• Fix ouster visual (#6)
• Contributors: Dawid Kmak, Jakub Delicat, Rafal Gorecki, husarafal

0.0.2 (2025-08-06)

• Fix stereolabs zed origin (#7)
• Zed add CAM05 and update ZED urdf (#5)
• fix rplidar visual (#4)
• Add visuals (#2)
• Move code from ros_components_description (#1)
• Initial commit
• Contributors: Dawid Kmak, Dominik Nowak, Rafal Gorecki