Skip to content

Commit

Permalink
husarion_ugv_description -> husarion_ugv_descriptions
Browse files Browse the repository at this point in the history
  • Loading branch information
rafal-gorecki committed Dec 9, 2024
1 parent 4e090f4 commit 4eb1aba
Show file tree
Hide file tree
Showing 27 changed files with 53 additions and 53 deletions.
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ Launch arguments are largely common to both simulation and physical robot. Howev
||| `add_world_transform` | Adds a world frame that connects the tf trees of individual robots (useful when running multiple robots). <br/> ***bool:*** `False` |
||| `animations_config_path` | Path to a YAML file with a description of led configuration. This file includes definition of robot panels, virtual segments and default animations. <br/> ***string:*** [`{robot_model}_animations.yaml`](./husarion_ugv_lights/config) |
||| `battery_config_path` | Path to the Ignition LinearBatteryPlugin configuration file. This configuration is intended for use in simulations only. <br/> ***string:*** `None` |
||| `components_config_path` | Additional components configuration file. Components described in this file are dynamically included in robot's URDF. Available options are described in [the manual](https://husarion.com/manuals/panther/panther-options). <br/> ***string:*** [`components.yaml`](./husarion_ugv_description/config/components.yaml) |
||| `components_config_path` | Additional components configuration file. Components described in this file are dynamically included in robot's URDF. Available options are described in [the manual](https://husarion.com/manuals/panther/panther-options). <br/> ***string:*** [`components.yaml`](./husarion_ugv_descriptions/config/components.yaml) |
||| `controller_config_path` | Path to controller configuration file. A path to custom configuration can be specified here. <br/> ***string:*** [`{wheel_type}_controller.yaml`](./husarion_ugv_controller/config/) |
||| `disable_manager` | Enable or disable manager_bt_node. <br/> ***bool:*** `False` |
||| `fuse_gps` | Include GPS for data fusion. <br/> ***bool:*** `False` |
Expand All @@ -111,7 +111,7 @@ Launch arguments are largely common to both simulation and physical robot. Howev
||| `use_rviz` | Run RViz simultaneously. <br/> ***bool:*** `True` |
||| `use_sim` | Whether simulation is used. <br/> ***bool:*** `False` |
||| `user_led_animations_path` | Path to a YAML file with a description of the user-defined animations. <br/> ***string:*** `''` |
||| `wheel_config_path` | Path to wheel configuration file. <br/> ***string:*** [`{wheel_type}.yaml`](./husarion_ugv_description/config) |
||| `wheel_config_path` | Path to wheel configuration file. <br/> ***string:*** [`{wheel_type}.yaml`](./husarion_ugv_descriptions/config) |
||| `wheel_type` | Specify the wheel type. If the selected wheel type is not 'custom', the wheel_config_path and controller_config_path arguments will be automatically adjusted and can be omitted. <br/> ***string:*** `WH01` (for Panther), `WH05` (for Lynx) (choices: `WH01`, `WH02`, `WH04`, `WH05`, `custom`) |
||| `x` | Initial robot position in the global 'x' axis. <br/> ***float:*** `0.0` |
||| `y` | Initial robot position in the global 'y' axis. <br/> ***float:***` -2.0` |
Expand Down
2 changes: 1 addition & 1 deletion husarion_ugv_controller/CONFIGURATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,4 @@ The default drive controller is based on [diff_drive_controller](https://control

## Changing Wheel Type

Changing wheel types is possible and can be done for both the real robot and the simulation. By default, three types of wheels are supported using the launch argument `wheel_type`. If you want to use custom wheels, all you need to do is point to the new wheel and controller configuration files using the `wheel_config_path` and `controller_config_path` parameters. These files should be based on the default files, i.e. [WH01_controller.yaml](./config/WH01_controller.yaml) and [WH01.yaml](../husarion_ugv_description/config/WH01.yaml).
Changing wheel types is possible and can be done for both the real robot and the simulation. By default, three types of wheels are supported using the launch argument `wheel_type`. If you want to use custom wheels, all you need to do is point to the new wheel and controller configuration files using the `wheel_config_path` and `controller_config_path` parameters. These files should be based on the default files, i.e. [WH01_controller.yaml](./config/WH01_controller.yaml) and [WH01.yaml](../husarion_ugv_descriptions/config/WH01.yaml).
6 changes: 3 additions & 3 deletions husarion_ugv_controller/launch/controller.launch.py
Original file line number Diff line number Diff line change
Expand Up @@ -122,14 +122,14 @@ def generate_launch_description():
"wheel_config_path",
default_value=PathJoinSubstitution(
[
FindPackageShare("husarion_ugv_description"),
FindPackageShare("husarion_ugv_descriptions"),
"config",
PythonExpression(["'", wheel_type, ".yaml'"]),
]
),
description=(
"Path to wheel configuration file. By default, it is located in "
"'husarion_ugv_description/config/{wheel_type}.yaml'. You can also specify the path "
"'husarion_ugv_descriptions/config/{wheel_type}.yaml'. You can also specify the path "
"to your custom wheel configuration file here. "
),
)
Expand Down Expand Up @@ -159,7 +159,7 @@ def generate_launch_description():
PathJoinSubstitution([FindExecutable(name="xacro")]),
" ",
PathJoinSubstitution(
[FindPackageShare("husarion_ugv_description"), "urdf", urdf_file]
[FindPackageShare("husarion_ugv_descriptions"), "urdf", urdf_file]
),
" use_sim:=",
use_sim,
Expand Down
2 changes: 1 addition & 1 deletion husarion_ugv_controller/package.xml
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@

<exec_depend>controller_manager</exec_depend>
<exec_depend>diff_drive_controller</exec_depend>
<exec_depend>husarion_ugv_description</exec_depend>
<exec_depend>husarion_ugv_descriptions</exec_depend>
<exec_depend condition="$HUSARION_ROS_BUILD_TYPE == hardware">husarion_ugv_hardware_interfaces</exec_depend>
<exec_depend>imu_sensor_broadcaster</exec_depend>
<exec_depend>joint_state_broadcaster</exec_depend>
Expand Down
2 changes: 1 addition & 1 deletion husarion_ugv_description/CMakeLists.txt
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
cmake_minimum_required(VERSION 3.10.2)
project(husarion_ugv_description)
project(husarion_ugv_descriptions)

find_package(ament_cmake REQUIRED)

Expand Down
2 changes: 1 addition & 1 deletion husarion_ugv_description/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# husarion_ugv_description
# husarion_ugv_descriptions

The package contains URDF files responsible for creating a representation of the robot by specifying the relationships and types of connections (joints) between individual links. It also contains information about the robot's mesh.

Expand Down
2 changes: 1 addition & 1 deletion husarion_ugv_description/config/WH01.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,6 @@ wheel_separation: 0.697
mass: 3.0
inertia: { ixx: 0.022510, iyy: 0.034850, izz: 0.022510 }
inertia_y_offset: 0.0
mesh_package: husarion_ugv_description
mesh_package: husarion_ugv_descriptions
folder_path: meshes/WH01
mecanum: False
2 changes: 1 addition & 1 deletion husarion_ugv_description/config/WH02.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,6 @@ wheel_separation: 0.6785
mass: 2.4
inertia: { ixx: 0.010050, iyy: 0.016496, izz: 0.010068 }
inertia_y_offset: 0.0
mesh_package: husarion_ugv_description
mesh_package: husarion_ugv_descriptions
folder_path: meshes/WH02
mecanum: True
2 changes: 1 addition & 1 deletion husarion_ugv_description/config/WH04.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,6 @@ wheel_separation: 0.616
mass: 0.85
inertia: { ixx: 0.003099, iyy: 0.005849, izz: 0.003101 }
inertia_y_offset: 0.0
mesh_package: husarion_ugv_description
mesh_package: husarion_ugv_descriptions
folder_path: meshes/WH04
mecanum: False
2 changes: 1 addition & 1 deletion husarion_ugv_description/config/WH05.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,6 @@ wheel_separation: 0.45
mass: 2.5
inertia: { ixx: 0.014738, iyy: 0.0261, izz: 0.014738 }
inertia_y_offset: 0.0
mesh_package: husarion_ugv_description
mesh_package: husarion_ugv_descriptions
folder_path: meshes/WH05
mecanum: False
8 changes: 4 additions & 4 deletions husarion_ugv_description/launch/load_urdf.launch.py
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ def generate_launch_description():
declare_components_config_path_arg = DeclareLaunchArgument(
"components_config_path",
default_value=PathJoinSubstitution(
[FindPackageShare("husarion_ugv_description"), "config", "components.yaml"]
[FindPackageShare("husarion_ugv_descriptions"), "config", "components.yaml"]
),
description=(
"Specify file which contains components. These components will be included in URDF."
Expand Down Expand Up @@ -112,14 +112,14 @@ def generate_launch_description():
"wheel_config_path",
default_value=PathJoinSubstitution(
[
FindPackageShare("husarion_ugv_description"),
FindPackageShare("husarion_ugv_descriptions"),
"config",
PythonExpression(["'", wheel_type, ".yaml'"]),
]
),
description=(
"Path to wheel configuration file. By default, it is located in "
"'husarion_ugv_description/config/{wheel_type}.yaml'. You can also specify the path "
"'husarion_ugv_descriptions/config/{wheel_type}.yaml'. You can also specify the path "
"to your custom wheel configuration file here. "
),
)
Expand Down Expand Up @@ -149,7 +149,7 @@ def generate_launch_description():
PathJoinSubstitution([FindExecutable(name="xacro")]),
" ",
PathJoinSubstitution(
[FindPackageShare("husarion_ugv_description"), "urdf", urdf_file]
[FindPackageShare("husarion_ugv_descriptions"), "urdf", urdf_file]
),
" use_sim:=",
use_sim,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ def generate_launch_description():
declare_components_config_path_arg = DeclareLaunchArgument(
"components_config_path",
default_value=PathJoinSubstitution(
[FindPackageShare("husarion_ugv_description"), "config", "components.yaml"]
[FindPackageShare("husarion_ugv_descriptions"), "config", "components.yaml"]
),
description=(
"Specify file which contains components. These components will be included in URDF."
Expand Down Expand Up @@ -103,14 +103,14 @@ def generate_launch_description():
"wheel_config_path",
default_value=PathJoinSubstitution(
[
FindPackageShare("husarion_ugv_description"),
FindPackageShare("husarion_ugv_descriptions"),
"config",
PythonExpression(["'", wheel_type, ".yaml'"]),
]
),
description=(
"Path to wheel configuration file. By default, it is located in "
"'husarion_ugv_description/config/{wheel_type}.yaml'. You can also specify the path "
"'husarion_ugv_descriptions/config/{wheel_type}.yaml'. You can also specify the path "
"to your custom wheel configuration file here. "
),
)
Expand Down Expand Up @@ -140,7 +140,7 @@ def generate_launch_description():
PathJoinSubstitution([FindExecutable(name="xacro")]),
" ",
PathJoinSubstitution(
[FindPackageShare("husarion_ugv_description"), "urdf", urdf_file]
[FindPackageShare("husarion_ugv_descriptions"), "urdf", urdf_file]
),
" use_sim:=",
use_sim,
Expand Down
2 changes: 1 addition & 1 deletion husarion_ugv_description/launch/rviz.launch.py
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ def generate_launch_description():
declare_rviz_config_arg = DeclareLaunchArgument(
"rviz_config",
default_value=PathJoinSubstitution(
[FindPackageShare("husarion_ugv_description"), "rviz", "husarion_ugv.rviz"]
[FindPackageShare("husarion_ugv_descriptions"), "rviz", "husarion_ugv.rviz"]
),
description="RViz configuration file.",
)
Expand Down
2 changes: 1 addition & 1 deletion husarion_ugv_description/package.xml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<?xml-model href="http://download.ros.org/schema/package_format3.xsd" schematypens="http://www.w3.org/2001/XMLSchema"?>
<package format="3">
<name>husarion_ugv_description</name>
<name>husarion_ugv_descriptions</name>
<version>2.1.2</version>
<description>The package contains URDF and mesh files for Husarion UGV</description>
<maintainer email="support@husarion.com">Husarion</maintainer>
Expand Down
6 changes: 3 additions & 3 deletions husarion_ugv_description/urdf/lynx.urdf.xacro
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,15 @@
<xacro:arg name="imu_xyz" default="0.169 0.025 0.092" />
<xacro:arg name="imu_rpy" default="0.0 0.0 -1.57" />
<xacro:arg name="wheel_config_file"
default="$(find husarion_ugv_description)/config/WH05.yaml" />
default="$(find husarion_ugv_descriptions)/config/WH05.yaml" />
<xacro:arg name="controller_config_file"
default="$(find husarion_ugv_controller)/config/WH05_controller.yaml" />
<xacro:arg name="battery_config_file"
default="" />
<xacro:arg name="namespace" default="" />


<xacro:include filename="$(find husarion_ugv_description)/urdf/lynx/lynx_macro.urdf.xacro" ns="husarion" />
<xacro:include filename="$(find husarion_ugv_descriptions)/urdf/lynx/lynx_macro.urdf.xacro" ns="husarion" />
<xacro:husarion.lynx_robot
use_sim="$(arg use_sim)"
imu_xyz="$(arg imu_xyz)"
Expand All @@ -24,7 +24,7 @@
battery_config_file="$(arg battery_config_file)"
namespace="$(arg namespace)" />

<xacro:arg name="components_config_path" default="$(find husarion_ugv_description)/config/components.yaml" />
<xacro:arg name="components_config_path" default="$(find husarion_ugv_descriptions)/config/components.yaml" />
<xacro:property name="components_config_path_property" value="$(arg components_config_path)" />

<xacro:unless value="${components_config_path_property == 'None'}">
Expand Down
12 changes: 6 additions & 6 deletions husarion_ugv_description/urdf/lynx/body.urdf.xacro
Original file line number Diff line number Diff line change
Expand Up @@ -16,15 +16,15 @@
<link name="base_link">
<visual>
<geometry>
<mesh filename="package://husarion_ugv_description/meshes/lynx/base.dae" />
<mesh filename="package://husarion_ugv_descriptions/meshes/lynx/base.dae" />
</geometry>
</visual>

<collision>
<origin xyz="0.0 0.0 0.0745" rpy="0.0 0.0 0.0" />
<geometry>
<!-- TODO change when models ready -->
<!-- <mesh filename="package://husarion_ugv_description/meshes/panther/body_collision.stl" /> -->
<!-- <mesh filename="package://husarion_ugv_descriptions/meshes/panther/body_collision.stl" /> -->
<box size="0.646 0.34 0.268" />
</geometry>
</collision>
Expand All @@ -48,14 +48,14 @@
<link name="user_compartment_link">
<visual>
<geometry>
<mesh filename="package://husarion_ugv_description/meshes/lynx/user_compartment.dae" />
<mesh filename="package://husarion_ugv_descriptions/meshes/lynx/user_compartment.dae" />
</geometry>
</visual>

<!-- TODO change when models ready -->
<!-- <collision>
<geometry>
<mesh filename="package://husarion_ugv_description/meshes/panther/user_compartment_collision.stl" />
<mesh filename="package://husarion_ugv_descriptions/meshes/panther/user_compartment_collision.stl" />
</geometry>
</collision> -->

Expand All @@ -77,14 +77,14 @@
<link name="battery_link">
<visual>
<geometry>
<mesh filename="package://husarion_ugv_description/meshes/lynx/battery.dae" />
<mesh filename="package://husarion_ugv_descriptions/meshes/lynx/battery.dae" />
</geometry>
</visual>

<!-- TODO change when models ready -->
<!-- <collision>
<geometry>
<mesh filename="package://husarion_ugv_description/meshes/panther/battery_collision.stl" />
<mesh filename="package://husarion_ugv_descriptions/meshes/panther/battery_collision.stl" />
</geometry>
</collision> -->

Expand Down
6 changes: 3 additions & 3 deletions husarion_ugv_description/urdf/lynx/lynx_macro.urdf.xacro
Original file line number Diff line number Diff line change
Expand Up @@ -17,9 +17,9 @@
<xacro:property name="wheel_separation_x" value="0.35" />

<!-- INCLUDE ROBOT PARTS DEFINITIONS -->
<xacro:include filename="$(find husarion_ugv_description)/urdf/lynx/body.urdf.xacro" ns="body" />
<xacro:include filename="$(find husarion_ugv_description)/urdf/common/gazebo.urdf.xacro" ns="gazebo" />
<xacro:include filename="$(find husarion_ugv_description)/urdf/common/wheel.urdf.xacro" ns="wheel" />
<xacro:include filename="$(find husarion_ugv_descriptions)/urdf/lynx/body.urdf.xacro" ns="body" />
<xacro:include filename="$(find husarion_ugv_descriptions)/urdf/common/gazebo.urdf.xacro" ns="gazebo" />
<xacro:include filename="$(find husarion_ugv_descriptions)/urdf/common/wheel.urdf.xacro" ns="wheel" />

<!-- BODY DECLARATION -->
<xacro:body.body
Expand Down
6 changes: 3 additions & 3 deletions husarion_ugv_description/urdf/panther.urdf.xacro
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,15 @@
<xacro:arg name="imu_xyz" default="0.169 0.025 0.092" />
<xacro:arg name="imu_rpy" default="0.0 0.0 -1.57" />
<xacro:arg name="wheel_config_file"
default="$(find husarion_ugv_description)/config/WH01.yaml" />
default="$(find husarion_ugv_descriptions)/config/WH01.yaml" />
<xacro:arg name="controller_config_file"
default="$(find husarion_ugv_controller)/config/WH01_controller.yaml" />
<xacro:arg name="battery_config_file"
default="" />
<xacro:arg name="namespace" default="" />


<xacro:include filename="$(find husarion_ugv_description)/urdf/panther/panther_macro.urdf.xacro" ns="husarion" />
<xacro:include filename="$(find husarion_ugv_descriptions)/urdf/panther/panther_macro.urdf.xacro" ns="husarion" />
<xacro:husarion.panther_robot
use_sim="$(arg use_sim)"
imu_xyz="$(arg imu_xyz)"
Expand All @@ -23,7 +23,7 @@
battery_config_file="$(arg battery_config_file)"
namespace="$(arg namespace)" />

<xacro:arg name="components_config_path" default="$(find husarion_ugv_description)/config/components.yaml" />
<xacro:arg name="components_config_path" default="$(find husarion_ugv_descriptions)/config/components.yaml" />
<xacro:property name="components_config_path_property" value="$(arg components_config_path)" />

<xacro:unless value="${components_config_path_property == 'None'}">
Expand Down
Loading

0 comments on commit 4eb1aba

Please sign in to comment.