docs: update docs
This commit is contained in:
parent
21c4dda654
commit
f709515778
3 changed files with 20 additions and 12 deletions
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
Important! Install only with Ubuntu 22.04 operating system
|
Important! Install only with Ubuntu 22.04 operating system
|
||||||
|
|
||||||
First, you need to install [ROS2 Humble](https://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debs.html). A minimal installation is recommended.
|
First, you need to install [ROS2 Humble](https://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debs.html). A minimal installation is recommended with `ros-dev-tools`.
|
||||||
|
|
||||||
As the second step, you need to build [`ros2_control`](https://github.com/ros-controls/ros2_control) from source using this [fork](https://github.com/solid-sinusoid/ros2_control/tree/gz-ros2-cartesian-controllers). Alternatively, you can use the [`vcstool`](https://github.com/dirk-thomas/vcstool) method, which is included with the basic ROS2 packages.
|
As the second step, you need to build [`ros2_control`](https://github.com/ros-controls/ros2_control) from source using this [fork](https://github.com/solid-sinusoid/ros2_control/tree/gz-ros2-cartesian-controllers). Alternatively, you can use the [`vcstool`](https://github.com/dirk-thomas/vcstool) method, which is included with the basic ROS2 packages.
|
||||||
|
|
||||||
|
|
|
@ -1,9 +1,11 @@
|
||||||
# Инструкция по добавлению нового робота в фреймворк Robossembler ROS 2
|
# Инструкция по добавлению нового робота в фреймворк Robossembler ROS 2
|
||||||
|
|
||||||
Прежде всего необходимо скачать пакет робота, содержащий файлы `xacro` или `urdf`, а также файлы геометрии робота в формате `.stl`, `.dae`, `.obj` и других.
|
Прежде всего, необходимо скачать пакет робота, содержащий файлы `xacro` или `urdf`, а также файлы геометрии робота в формате `.stl`, `.dae`, `.obj` и других.
|
||||||
|
|
||||||
Перед началом работы важно ознакомиться с основными аспектами формата [xacro](https://github.com/ros/xacro/wiki). Этот формат позволяет переиспользовать существующие фрагменты URDF-описания робота, что упрощает создание и модификацию описания.
|
Перед началом работы важно ознакомиться с основными аспектами формата [xacro](https://github.com/ros/xacro/wiki). Этот формат позволяет переиспользовать существующие фрагменты URDF-описания робота, что упрощает создание и модификацию описания.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
### Шаги по добавлению нового робота:
|
### Шаги по добавлению нового робота:
|
||||||
|
|
||||||
1. **Установка пакета робота**
|
1. **Установка пакета робота**
|
||||||
|
@ -24,7 +26,6 @@
|
||||||
),
|
),
|
||||||
launch_arguments={
|
launch_arguments={
|
||||||
"with_gripper": "true",
|
"with_gripper": "true",
|
||||||
"gripper_name": "rbs_gripper",
|
|
||||||
"robot_type": "rbs_arm",
|
"robot_type": "rbs_arm",
|
||||||
"description_package": "rbs_arm",
|
"description_package": "rbs_arm",
|
||||||
"description_file": "rbs_arm_modular.xacro",
|
"description_file": "rbs_arm_modular.xacro",
|
||||||
|
@ -33,26 +34,27 @@
|
||||||
"moveit_config_package": "rbs_arm",
|
"moveit_config_package": "rbs_arm",
|
||||||
"moveit_config_file": "rbs_arm.srdf.xacro",
|
"moveit_config_file": "rbs_arm.srdf.xacro",
|
||||||
"use_sim_time": "true",
|
"use_sim_time": "true",
|
||||||
"hardware": "gazebo",
|
|
||||||
"use_controllers": "true",
|
"use_controllers": "true",
|
||||||
"scene_config_file": "",
|
"scene_config_file": "",
|
||||||
"base_link_name": "base_link",
|
"base_link_name": "base_link",
|
||||||
"ee_link_name": "gripper_grasp_point",
|
"ee_link_name": "gripper_grasp_point",
|
||||||
"control_space": "task",
|
"control_space": "task",
|
||||||
"control_strategy": "position",
|
"control_strategy": "position",
|
||||||
|
"interactive": "false",
|
||||||
|
"use_rbs_utils": "true",
|
||||||
|
"assembly_config_name": "board_pick_and_place"
|
||||||
}.items(),
|
}.items(),
|
||||||
)
|
)
|
||||||
```
|
```
|
||||||
Здесь выполняется запуск другого launch-файла с указанными аргументами. Ниже приводится описание каждого аргумента.
|
Здесь выполняется запуск другого launch-файла с указанными аргументами. Ниже приводится описание каждого аргумента.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
### Описание параметров:
|
### Описание параметров:
|
||||||
|
|
||||||
- **`with_gripper`**
|
- **`with_gripper`**
|
||||||
Указывает, есть ли на роботе захватное устройство (гриппер). Если значение `true`, будет настроен и запущен `gripper_controller`.
|
Указывает, есть ли на роботе захватное устройство (гриппер). Если значение `true`, будет настроен и запущен `gripper_controller`.
|
||||||
|
|
||||||
- **`gripper_name`**
|
|
||||||
Используется как ключевое слово для указания линков и джоинтов, относящихся к грипперу. Также применяется в xacro-аргументах.
|
|
||||||
|
|
||||||
- **`robot_type`**
|
- **`robot_type`**
|
||||||
Обозначает группу роботов одного типа. Например, все роботы с разными именами, но одинаковой конструкцией.
|
Обозначает группу роботов одного типа. Например, все роботы с разными именами, но одинаковой конструкцией.
|
||||||
|
|
||||||
|
@ -77,9 +79,6 @@
|
||||||
- **`use_sim_time`**
|
- **`use_sim_time`**
|
||||||
Обязательный параметр при работе в симуляции. Обеспечивает синхронизацию времени с симулятором.
|
Обязательный параметр при работе в симуляции. Обеспечивает синхронизацию времени с симулятором.
|
||||||
|
|
||||||
- **`hardware`**
|
|
||||||
Указывает интерфейс для управления роботом. Например, `gazebo`. Используется в основном в xacro-файлах.
|
|
||||||
|
|
||||||
- **`use_controllers`**
|
- **`use_controllers`**
|
||||||
Указывает, нужно ли использовать стандартные контроллеры. Если значение `false`, робот не сможет двигаться. Влияет на запуск файла [control.launch.py](../../rbs_bringup/launch/control.launch.py).
|
Указывает, нужно ли использовать стандартные контроллеры. Если значение `false`, робот не сможет двигаться. Влияет на запуск файла [control.launch.py](../../rbs_bringup/launch/control.launch.py).
|
||||||
|
|
||||||
|
@ -109,4 +108,13 @@
|
||||||
|
|
||||||
- **`interactive`**
|
- **`interactive`**
|
||||||
Указывает, нужно ли запускать контроллер `motion_control_handle`.
|
Указывает, нужно ли запускать контроллер `motion_control_handle`.
|
||||||
|
Значение по умолчанию: `false`.
|
||||||
|
|
||||||
|
- **`use_rbs_utils`**
|
||||||
|
Указывает, нужно ли использовать вспомогательные модули фреймворка Robossembler.
|
||||||
Значение по умолчанию: `true`.
|
Значение по умолчанию: `true`.
|
||||||
|
|
||||||
|
- **`assembly_config_name`**
|
||||||
|
Имя конфигурации сборки для выполнения заданий.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
Важно! Устанавливаться только с операционной системой Ubuntu 22.04
|
Важно! Устанавливаться только с операционной системой Ubuntu 22.04
|
||||||
|
|
||||||
Первым делом необходимо установить [ROS2 Humble](https://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debs.html). Рекомендуется минимальная установка.
|
Первым делом необходимо установить [ROS2 Humble](https://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debs.html). Рекомендуется минимальная установка `ros-humble-base`, а также `ros-dev-tools` пакеты.
|
||||||
|
|
||||||
Вторым шагом надо собрать [`ros2_control`](https://github.com/ros-controls/ros2_control) из исходников из этого [форка](https://github.com/solid-sinusoid/ros2_control/tree/gz-ros2-cartesian-controllers) стоит отметить, что также существует альтернативная установка с использованием [`vsctool`](https://github.com/dirk-thomas/vcstool) который поставляется с базовыми пакетами ROS2.
|
Вторым шагом надо собрать [`ros2_control`](https://github.com/ros-controls/ros2_control) из исходников из этого [форка](https://github.com/solid-sinusoid/ros2_control/tree/gz-ros2-cartesian-controllers) стоит отметить, что также существует альтернативная установка с использованием [`vsctool`](https://github.com/dirk-thomas/vcstool) который поставляется с базовыми пакетами ROS2.
|
||||||
|
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue