|
aubo_ros2_driver repositoryaubo_controllers aubo_dashboard_msgs aubo_gazebo aubo_moveit_config aubo_msgs aubo_ros2_driver ros_joints_plan |
ROS Distro
|
Repository Summary
| Description | |
| Checkout URI | https://github.com/auborobot/aubo_ros2_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-13 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| aubo_controllers | 0.1.0 |
| aubo_dashboard_msgs | 2.3.2 |
| aubo_gazebo | 0.0.0 |
| aubo_moveit_config | 0.3.0 |
| aubo_msgs | 2.0.0 |
| aubo_ros2_driver | 2.3.2 |
| ros_joints_plan | 0.0.0 |
README
aubo_ros2_driver
遨博机器人ROS2驱动
安装与编译(Ubuntu 22.04 / ROS 2 Humble)
先建立 ROS 工作区,再把本仓库克隆到 src 下。克隆完成后目录为 ~/ws_humble/src/aubo_ros2_driver,各个 ROS 包在该目录内。编译、校准和启动命令都在工作区根目录 ~/ws_humble 执行。模型由 Git 子模块提供,首次克隆后必须初始化:
mkdir -p ~/ws_humble/src
cd ~/ws_humble/src
git clone https://github.com/AuboRobot/aubo_ros2_driver.git
cd ~/ws_humble
git -C src/aubo_ros2_driver submodule update --init --recursive
python3 src/aubo_ros2_driver/scripts/prepare_description.py
source /opt/ros/humble/setup.bash
# 首次使用 rosdep 时按需执行 sudo rosdep init;已有配置无需重复初始化
rosdep update
rosdep install --from-paths src/aubo_ros2_driver --ignore-src -r -y --rosdistro humble \
--skip-keys="gazebo_ros gazebo_ros2_control docker.io"
CMAKE_BUILD_PARALLEL_LEVEL=4 colcon build --base-paths src/aubo_ros2_driver --packages-skip aubo_gazebo \
--parallel-workers 2 --cmake-args -DCMAKE_BUILD_TYPE=Release
source install/setup.bash
aubo_gazebo 依赖 Gazebo Classic;上述 Humble 编译流程跳过此包及其两项依赖,不代表已验证 Gazebo 仿真。
--base-paths src/aubo_ros2_driver 只构建这次克隆进来的仓库。之后若在 src 下再放入其他仓库,它们不会被这次命令编进去。
内存较少时可将 CMAKE_BUILD_PARALLEL_LEVEL 降为 2。Docker 仅为测试依赖,本次未安装;需要 Docker 测试时移除对应 skip key。
请以普通用户运行 rosdep,按提示使用 sudo 安装系统包;不要直接用 root 运行 rosdep,否则可能找不到用户的 rosdep 缓存。
本机依赖检查与排查记录(2026-10-29)
已执行实际 colcon 构建及 rosdep check --from-paths src/aubo_ros2_driver --ignore-src。
初始环境缺少以下系统依赖(安装操作需要 sudo):
sudo apt update
sudo apt install \
ros-humble-controller-manager ros-humble-controller-manager-msgs \
ros-humble-hardware-interface ros-humble-controller-interface ros-humble-realtime-tools \
ros-humble-joint-state-broadcaster ros-humble-joint-trajectory-controller \
ros-humble-position-controllers ros-humble-velocity-controllers \
ros-humble-force-torque-sensor-broadcaster ros-humble-ros2-controllers-test-nodes \
ros-humble-control-msgs ros-humble-moveit-msgs \
ros-humble-moveit-ros-move-group ros-humble-moveit-kinematics ros-humble-moveit-planners \
ros-humble-moveit-simple-controller-manager ros-humble-moveit-configs-utils \
ros-humble-moveit-ros-visualization ros-humble-moveit-ros-warehouse \
ros-humble-moveit-setup-assistant ros-humble-moveit-ros-planning-interface \
ros-humble-warehouse-ros ros-humble-joint-state-publisher \
ros-humble-joint-state-publisher-gui ros-humble-xacro nlohmann-json3-dev socat
以上为 Humble 依赖名;完整安装以初始化子模块后的 rosdep 结果为准。
此前环境安装时 apt 新增 101 个包,其中包括驱动运行依赖 socat。
docker.io 为驱动测试依赖,本次跳过。模型子模块已初始化,固定版本为 47fa5e02fa873f27f7e812d31f31e3f4cf5e56b1。
驱动启动时在生成的 robot description 中设置 hardware plugin 和 Servo 参数,以兼容公开模型版本;use_fake_hardware:=true 使用 mock_components/GenericSystem,不连接 SDK。
公开模型版本含 6 个未被 URDF 引用的悬空 aubo_i10HL/visual/link0..5.DAE 链接,会使 Humble 的 --symlink-install 失败。上面的准备脚本仅在确认目标不存在且未被模型引用时移除它们,可重复执行,不替换 mesh。每次重新初始化或重置子模块后重新执行;Git 会显示这 6 项本地删除,子模块提交指针仍为公开的 47fa5e0。
模型包构建会在子模块 urdf/ 下生成 .urdf.xacro 文件,因此 Git 可能显示该子模块含未跟踪文件。
常见问题:
-
Cannot locate rosdep definition for [aubo_description]:先初始化子模块,确认目录内存在package.xml。 -
tf/actionlib:这是 ROS 1 依赖;ros_joints_plan/package.xml已改为声明 ROS 2 的 tf2 和 MoveIt 规划接口依赖。 - 找不到
controller_manager、hardware_interface等 CMake 配置:安装上列包后重新构建。 - SDK 下载失败:驱动 CMake 会按 CPU 架构下载 AUBO SDK
0.27.0-rc.4,需可访问download.aubo-robotics.cn;不能拿 x86_64 SDK 用于 ARM64。
最终构建结果:7 packages finished,驱动、控制器、消息、模型与规划包全部编译通过;
aubo_gazebo 按上述流程跳过。构建日志:/tmp/aubo-build.log(临时文件)。
本次同步修正:
-
ros_joints_plan删除 ROS 1 的tf/actionlib,补齐 tf2、MoveIt 规划接口和 lint 测试依赖。 -
aubo_dashboard_msgs补齐builtin_interfaces;驱动补齐ament_index_python和 CMake 对ament_cmake_python的显式查找。 - 硬件接口移除未使用的
robot_mode消息头、serviceinterface.h和visibility_control.h引用,显式包含unordered_map。 - 已确认
serviceinterface.h和aubo/robot/robot_state.h均由下载的 AUBO SDK 提供;前者在本硬件接口中未使用,移除以减少无关 SDK 依赖,后者保留。 - SDK 安装规则同时包含 Release 与 Debug 动态库,修复 Release 构建安装后缺少
libaubo_sdk.so的问题。
验证:rosdep 检查通过(排除 Gazebo Classic 和 Docker);驱动可执行文件可被 ROS 2 发现;
aubo_control.launch.py --show-args 解析成功;硬件插件的 ldd 无缺失库,ctypes.CDLL 加载成功。上述为早期编译检查,当时未连接机器人。
旧式 on_init(HardwareInfo) 等接口可能给出弃用警告,不影响本次构建通过。
本小节仅记录早期编译和依赖检查。ES3 真机频率验收见 ES 控制柜与频率验收。Gazebo 仿真仍未验证。
ros2_control 内核实时性配置
控制器管理器会在主控制循环上申请优先级 50 的 SCHED_FIFO。普通用户默认不能设置该调度策略。文件 capability 让 aubo_ros2_control_node 在不开放通用 root 的前提下获得 CAP_SYS_NICE 和 CAP_SYS_RESOURCE。
配置实时权限
这是不依赖 file capability 的备选:把当前用户加入 realtime 组并放宽 rtprio。改完后必须重新登录。
步骤 1:创建 realtime 用户组
sudo addgroup realtime
sudo usermod -a -G realtime $(whoami)
步骤 2:配置系统限制
File truncated at 100 lines see the full file
CONTRIBUTING
|
aubo_ros2_driver repositoryaubo_controllers aubo_dashboard_msgs aubo_gazebo aubo_moveit_config aubo_msgs aubo_ros2_driver ros_joints_plan |
ROS Distro
|
Repository Summary
| Description | |
| Checkout URI | https://github.com/auborobot/aubo_ros2_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-13 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| aubo_controllers | 0.1.0 |
| aubo_dashboard_msgs | 2.3.2 |
| aubo_gazebo | 0.0.0 |
| aubo_moveit_config | 0.3.0 |
| aubo_msgs | 2.0.0 |
| aubo_ros2_driver | 2.3.2 |
| ros_joints_plan | 0.0.0 |
README
aubo_ros2_driver
遨博机器人ROS2驱动
安装与编译(Ubuntu 22.04 / ROS 2 Humble)
先建立 ROS 工作区,再把本仓库克隆到 src 下。克隆完成后目录为 ~/ws_humble/src/aubo_ros2_driver,各个 ROS 包在该目录内。编译、校准和启动命令都在工作区根目录 ~/ws_humble 执行。模型由 Git 子模块提供,首次克隆后必须初始化:
mkdir -p ~/ws_humble/src
cd ~/ws_humble/src
git clone https://github.com/AuboRobot/aubo_ros2_driver.git
cd ~/ws_humble
git -C src/aubo_ros2_driver submodule update --init --recursive
python3 src/aubo_ros2_driver/scripts/prepare_description.py
source /opt/ros/humble/setup.bash
# 首次使用 rosdep 时按需执行 sudo rosdep init;已有配置无需重复初始化
rosdep update
rosdep install --from-paths src/aubo_ros2_driver --ignore-src -r -y --rosdistro humble \
--skip-keys="gazebo_ros gazebo_ros2_control docker.io"
CMAKE_BUILD_PARALLEL_LEVEL=4 colcon build --base-paths src/aubo_ros2_driver --packages-skip aubo_gazebo \
--parallel-workers 2 --cmake-args -DCMAKE_BUILD_TYPE=Release
source install/setup.bash
aubo_gazebo 依赖 Gazebo Classic;上述 Humble 编译流程跳过此包及其两项依赖,不代表已验证 Gazebo 仿真。
--base-paths src/aubo_ros2_driver 只构建这次克隆进来的仓库。之后若在 src 下再放入其他仓库,它们不会被这次命令编进去。
内存较少时可将 CMAKE_BUILD_PARALLEL_LEVEL 降为 2。Docker 仅为测试依赖,本次未安装;需要 Docker 测试时移除对应 skip key。
请以普通用户运行 rosdep,按提示使用 sudo 安装系统包;不要直接用 root 运行 rosdep,否则可能找不到用户的 rosdep 缓存。
本机依赖检查与排查记录(2026-10-29)
已执行实际 colcon 构建及 rosdep check --from-paths src/aubo_ros2_driver --ignore-src。
初始环境缺少以下系统依赖(安装操作需要 sudo):
sudo apt update
sudo apt install \
ros-humble-controller-manager ros-humble-controller-manager-msgs \
ros-humble-hardware-interface ros-humble-controller-interface ros-humble-realtime-tools \
ros-humble-joint-state-broadcaster ros-humble-joint-trajectory-controller \
ros-humble-position-controllers ros-humble-velocity-controllers \
ros-humble-force-torque-sensor-broadcaster ros-humble-ros2-controllers-test-nodes \
ros-humble-control-msgs ros-humble-moveit-msgs \
ros-humble-moveit-ros-move-group ros-humble-moveit-kinematics ros-humble-moveit-planners \
ros-humble-moveit-simple-controller-manager ros-humble-moveit-configs-utils \
ros-humble-moveit-ros-visualization ros-humble-moveit-ros-warehouse \
ros-humble-moveit-setup-assistant ros-humble-moveit-ros-planning-interface \
ros-humble-warehouse-ros ros-humble-joint-state-publisher \
ros-humble-joint-state-publisher-gui ros-humble-xacro nlohmann-json3-dev socat
以上为 Humble 依赖名;完整安装以初始化子模块后的 rosdep 结果为准。
此前环境安装时 apt 新增 101 个包,其中包括驱动运行依赖 socat。
docker.io 为驱动测试依赖,本次跳过。模型子模块已初始化,固定版本为 47fa5e02fa873f27f7e812d31f31e3f4cf5e56b1。
驱动启动时在生成的 robot description 中设置 hardware plugin 和 Servo 参数,以兼容公开模型版本;use_fake_hardware:=true 使用 mock_components/GenericSystem,不连接 SDK。
公开模型版本含 6 个未被 URDF 引用的悬空 aubo_i10HL/visual/link0..5.DAE 链接,会使 Humble 的 --symlink-install 失败。上面的准备脚本仅在确认目标不存在且未被模型引用时移除它们,可重复执行,不替换 mesh。每次重新初始化或重置子模块后重新执行;Git 会显示这 6 项本地删除,子模块提交指针仍为公开的 47fa5e0。
模型包构建会在子模块 urdf/ 下生成 .urdf.xacro 文件,因此 Git 可能显示该子模块含未跟踪文件。
常见问题:
-
Cannot locate rosdep definition for [aubo_description]:先初始化子模块,确认目录内存在package.xml。 -
tf/actionlib:这是 ROS 1 依赖;ros_joints_plan/package.xml已改为声明 ROS 2 的 tf2 和 MoveIt 规划接口依赖。 - 找不到
controller_manager、hardware_interface等 CMake 配置:安装上列包后重新构建。 - SDK 下载失败:驱动 CMake 会按 CPU 架构下载 AUBO SDK
0.27.0-rc.4,需可访问download.aubo-robotics.cn;不能拿 x86_64 SDK 用于 ARM64。
最终构建结果:7 packages finished,驱动、控制器、消息、模型与规划包全部编译通过;
aubo_gazebo 按上述流程跳过。构建日志:/tmp/aubo-build.log(临时文件)。
本次同步修正:
-
ros_joints_plan删除 ROS 1 的tf/actionlib,补齐 tf2、MoveIt 规划接口和 lint 测试依赖。 -
aubo_dashboard_msgs补齐builtin_interfaces;驱动补齐ament_index_python和 CMake 对ament_cmake_python的显式查找。 - 硬件接口移除未使用的
robot_mode消息头、serviceinterface.h和visibility_control.h引用,显式包含unordered_map。 - 已确认
serviceinterface.h和aubo/robot/robot_state.h均由下载的 AUBO SDK 提供;前者在本硬件接口中未使用,移除以减少无关 SDK 依赖,后者保留。 - SDK 安装规则同时包含 Release 与 Debug 动态库,修复 Release 构建安装后缺少
libaubo_sdk.so的问题。
验证:rosdep 检查通过(排除 Gazebo Classic 和 Docker);驱动可执行文件可被 ROS 2 发现;
aubo_control.launch.py --show-args 解析成功;硬件插件的 ldd 无缺失库,ctypes.CDLL 加载成功。上述为早期编译检查,当时未连接机器人。
旧式 on_init(HardwareInfo) 等接口可能给出弃用警告,不影响本次构建通过。
本小节仅记录早期编译和依赖检查。ES3 真机频率验收见 ES 控制柜与频率验收。Gazebo 仿真仍未验证。
ros2_control 内核实时性配置
控制器管理器会在主控制循环上申请优先级 50 的 SCHED_FIFO。普通用户默认不能设置该调度策略。文件 capability 让 aubo_ros2_control_node 在不开放通用 root 的前提下获得 CAP_SYS_NICE 和 CAP_SYS_RESOURCE。
配置实时权限
这是不依赖 file capability 的备选:把当前用户加入 realtime 组并放宽 rtprio。改完后必须重新登录。
步骤 1:创建 realtime 用户组
sudo addgroup realtime
sudo usermod -a -G realtime $(whoami)
步骤 2:配置系统限制
File truncated at 100 lines see the full file
CONTRIBUTING
|
aubo_ros2_driver repositoryaubo_controllers aubo_dashboard_msgs aubo_gazebo aubo_moveit_config aubo_msgs aubo_ros2_driver ros_joints_plan |
ROS Distro
|
Repository Summary
| Description | |
| Checkout URI | https://github.com/auborobot/aubo_ros2_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-13 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| aubo_controllers | 0.1.0 |
| aubo_dashboard_msgs | 2.3.2 |
| aubo_gazebo | 0.0.0 |
| aubo_moveit_config | 0.3.0 |
| aubo_msgs | 2.0.0 |
| aubo_ros2_driver | 2.3.2 |
| ros_joints_plan | 0.0.0 |
README
aubo_ros2_driver
遨博机器人ROS2驱动
安装与编译(Ubuntu 22.04 / ROS 2 Humble)
先建立 ROS 工作区,再把本仓库克隆到 src 下。克隆完成后目录为 ~/ws_humble/src/aubo_ros2_driver,各个 ROS 包在该目录内。编译、校准和启动命令都在工作区根目录 ~/ws_humble 执行。模型由 Git 子模块提供,首次克隆后必须初始化:
mkdir -p ~/ws_humble/src
cd ~/ws_humble/src
git clone https://github.com/AuboRobot/aubo_ros2_driver.git
cd ~/ws_humble
git -C src/aubo_ros2_driver submodule update --init --recursive
python3 src/aubo_ros2_driver/scripts/prepare_description.py
source /opt/ros/humble/setup.bash
# 首次使用 rosdep 时按需执行 sudo rosdep init;已有配置无需重复初始化
rosdep update
rosdep install --from-paths src/aubo_ros2_driver --ignore-src -r -y --rosdistro humble \
--skip-keys="gazebo_ros gazebo_ros2_control docker.io"
CMAKE_BUILD_PARALLEL_LEVEL=4 colcon build --base-paths src/aubo_ros2_driver --packages-skip aubo_gazebo \
--parallel-workers 2 --cmake-args -DCMAKE_BUILD_TYPE=Release
source install/setup.bash
aubo_gazebo 依赖 Gazebo Classic;上述 Humble 编译流程跳过此包及其两项依赖,不代表已验证 Gazebo 仿真。
--base-paths src/aubo_ros2_driver 只构建这次克隆进来的仓库。之后若在 src 下再放入其他仓库,它们不会被这次命令编进去。
内存较少时可将 CMAKE_BUILD_PARALLEL_LEVEL 降为 2。Docker 仅为测试依赖,本次未安装;需要 Docker 测试时移除对应 skip key。
请以普通用户运行 rosdep,按提示使用 sudo 安装系统包;不要直接用 root 运行 rosdep,否则可能找不到用户的 rosdep 缓存。
本机依赖检查与排查记录(2026-10-29)
已执行实际 colcon 构建及 rosdep check --from-paths src/aubo_ros2_driver --ignore-src。
初始环境缺少以下系统依赖(安装操作需要 sudo):
sudo apt update
sudo apt install \
ros-humble-controller-manager ros-humble-controller-manager-msgs \
ros-humble-hardware-interface ros-humble-controller-interface ros-humble-realtime-tools \
ros-humble-joint-state-broadcaster ros-humble-joint-trajectory-controller \
ros-humble-position-controllers ros-humble-velocity-controllers \
ros-humble-force-torque-sensor-broadcaster ros-humble-ros2-controllers-test-nodes \
ros-humble-control-msgs ros-humble-moveit-msgs \
ros-humble-moveit-ros-move-group ros-humble-moveit-kinematics ros-humble-moveit-planners \
ros-humble-moveit-simple-controller-manager ros-humble-moveit-configs-utils \
ros-humble-moveit-ros-visualization ros-humble-moveit-ros-warehouse \
ros-humble-moveit-setup-assistant ros-humble-moveit-ros-planning-interface \
ros-humble-warehouse-ros ros-humble-joint-state-publisher \
ros-humble-joint-state-publisher-gui ros-humble-xacro nlohmann-json3-dev socat
以上为 Humble 依赖名;完整安装以初始化子模块后的 rosdep 结果为准。
此前环境安装时 apt 新增 101 个包,其中包括驱动运行依赖 socat。
docker.io 为驱动测试依赖,本次跳过。模型子模块已初始化,固定版本为 47fa5e02fa873f27f7e812d31f31e3f4cf5e56b1。
驱动启动时在生成的 robot description 中设置 hardware plugin 和 Servo 参数,以兼容公开模型版本;use_fake_hardware:=true 使用 mock_components/GenericSystem,不连接 SDK。
公开模型版本含 6 个未被 URDF 引用的悬空 aubo_i10HL/visual/link0..5.DAE 链接,会使 Humble 的 --symlink-install 失败。上面的准备脚本仅在确认目标不存在且未被模型引用时移除它们,可重复执行,不替换 mesh。每次重新初始化或重置子模块后重新执行;Git 会显示这 6 项本地删除,子模块提交指针仍为公开的 47fa5e0。
模型包构建会在子模块 urdf/ 下生成 .urdf.xacro 文件,因此 Git 可能显示该子模块含未跟踪文件。
常见问题:
-
Cannot locate rosdep definition for [aubo_description]:先初始化子模块,确认目录内存在package.xml。 -
tf/actionlib:这是 ROS 1 依赖;ros_joints_plan/package.xml已改为声明 ROS 2 的 tf2 和 MoveIt 规划接口依赖。 - 找不到
controller_manager、hardware_interface等 CMake 配置:安装上列包后重新构建。 - SDK 下载失败:驱动 CMake 会按 CPU 架构下载 AUBO SDK
0.27.0-rc.4,需可访问download.aubo-robotics.cn;不能拿 x86_64 SDK 用于 ARM64。
最终构建结果:7 packages finished,驱动、控制器、消息、模型与规划包全部编译通过;
aubo_gazebo 按上述流程跳过。构建日志:/tmp/aubo-build.log(临时文件)。
本次同步修正:
-
ros_joints_plan删除 ROS 1 的tf/actionlib,补齐 tf2、MoveIt 规划接口和 lint 测试依赖。 -
aubo_dashboard_msgs补齐builtin_interfaces;驱动补齐ament_index_python和 CMake 对ament_cmake_python的显式查找。 - 硬件接口移除未使用的
robot_mode消息头、serviceinterface.h和visibility_control.h引用,显式包含unordered_map。 - 已确认
serviceinterface.h和aubo/robot/robot_state.h均由下载的 AUBO SDK 提供;前者在本硬件接口中未使用,移除以减少无关 SDK 依赖,后者保留。 - SDK 安装规则同时包含 Release 与 Debug 动态库,修复 Release 构建安装后缺少
libaubo_sdk.so的问题。
验证:rosdep 检查通过(排除 Gazebo Classic 和 Docker);驱动可执行文件可被 ROS 2 发现;
aubo_control.launch.py --show-args 解析成功;硬件插件的 ldd 无缺失库,ctypes.CDLL 加载成功。上述为早期编译检查,当时未连接机器人。
旧式 on_init(HardwareInfo) 等接口可能给出弃用警告,不影响本次构建通过。
本小节仅记录早期编译和依赖检查。ES3 真机频率验收见 ES 控制柜与频率验收。Gazebo 仿真仍未验证。
ros2_control 内核实时性配置
控制器管理器会在主控制循环上申请优先级 50 的 SCHED_FIFO。普通用户默认不能设置该调度策略。文件 capability 让 aubo_ros2_control_node 在不开放通用 root 的前提下获得 CAP_SYS_NICE 和 CAP_SYS_RESOURCE。
配置实时权限
这是不依赖 file capability 的备选:把当前用户加入 realtime 组并放宽 rtprio。改完后必须重新登录。
步骤 1:创建 realtime 用户组
sudo addgroup realtime
sudo usermod -a -G realtime $(whoami)
步骤 2:配置系统限制
File truncated at 100 lines see the full file
CONTRIBUTING
|
aubo_ros2_driver repositoryaubo_controllers aubo_dashboard_msgs aubo_gazebo aubo_moveit_config aubo_msgs aubo_ros2_driver ros_joints_plan |
ROS Distro
|
Repository Summary
| Description | |
| Checkout URI | https://github.com/auborobot/aubo_ros2_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-13 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| aubo_controllers | 0.1.0 |
| aubo_dashboard_msgs | 2.3.2 |
| aubo_gazebo | 0.0.0 |
| aubo_moveit_config | 0.3.0 |
| aubo_msgs | 2.0.0 |
| aubo_ros2_driver | 2.3.2 |
| ros_joints_plan | 0.0.0 |
README
aubo_ros2_driver
遨博机器人ROS2驱动
安装与编译(Ubuntu 22.04 / ROS 2 Humble)
先建立 ROS 工作区,再把本仓库克隆到 src 下。克隆完成后目录为 ~/ws_humble/src/aubo_ros2_driver,各个 ROS 包在该目录内。编译、校准和启动命令都在工作区根目录 ~/ws_humble 执行。模型由 Git 子模块提供,首次克隆后必须初始化:
mkdir -p ~/ws_humble/src
cd ~/ws_humble/src
git clone https://github.com/AuboRobot/aubo_ros2_driver.git
cd ~/ws_humble
git -C src/aubo_ros2_driver submodule update --init --recursive
python3 src/aubo_ros2_driver/scripts/prepare_description.py
source /opt/ros/humble/setup.bash
# 首次使用 rosdep 时按需执行 sudo rosdep init;已有配置无需重复初始化
rosdep update
rosdep install --from-paths src/aubo_ros2_driver --ignore-src -r -y --rosdistro humble \
--skip-keys="gazebo_ros gazebo_ros2_control docker.io"
CMAKE_BUILD_PARALLEL_LEVEL=4 colcon build --base-paths src/aubo_ros2_driver --packages-skip aubo_gazebo \
--parallel-workers 2 --cmake-args -DCMAKE_BUILD_TYPE=Release
source install/setup.bash
aubo_gazebo 依赖 Gazebo Classic;上述 Humble 编译流程跳过此包及其两项依赖,不代表已验证 Gazebo 仿真。
--base-paths src/aubo_ros2_driver 只构建这次克隆进来的仓库。之后若在 src 下再放入其他仓库,它们不会被这次命令编进去。
内存较少时可将 CMAKE_BUILD_PARALLEL_LEVEL 降为 2。Docker 仅为测试依赖,本次未安装;需要 Docker 测试时移除对应 skip key。
请以普通用户运行 rosdep,按提示使用 sudo 安装系统包;不要直接用 root 运行 rosdep,否则可能找不到用户的 rosdep 缓存。
本机依赖检查与排查记录(2026-10-29)
已执行实际 colcon 构建及 rosdep check --from-paths src/aubo_ros2_driver --ignore-src。
初始环境缺少以下系统依赖(安装操作需要 sudo):
sudo apt update
sudo apt install \
ros-humble-controller-manager ros-humble-controller-manager-msgs \
ros-humble-hardware-interface ros-humble-controller-interface ros-humble-realtime-tools \
ros-humble-joint-state-broadcaster ros-humble-joint-trajectory-controller \
ros-humble-position-controllers ros-humble-velocity-controllers \
ros-humble-force-torque-sensor-broadcaster ros-humble-ros2-controllers-test-nodes \
ros-humble-control-msgs ros-humble-moveit-msgs \
ros-humble-moveit-ros-move-group ros-humble-moveit-kinematics ros-humble-moveit-planners \
ros-humble-moveit-simple-controller-manager ros-humble-moveit-configs-utils \
ros-humble-moveit-ros-visualization ros-humble-moveit-ros-warehouse \
ros-humble-moveit-setup-assistant ros-humble-moveit-ros-planning-interface \
ros-humble-warehouse-ros ros-humble-joint-state-publisher \
ros-humble-joint-state-publisher-gui ros-humble-xacro nlohmann-json3-dev socat
以上为 Humble 依赖名;完整安装以初始化子模块后的 rosdep 结果为准。
此前环境安装时 apt 新增 101 个包,其中包括驱动运行依赖 socat。
docker.io 为驱动测试依赖,本次跳过。模型子模块已初始化,固定版本为 47fa5e02fa873f27f7e812d31f31e3f4cf5e56b1。
驱动启动时在生成的 robot description 中设置 hardware plugin 和 Servo 参数,以兼容公开模型版本;use_fake_hardware:=true 使用 mock_components/GenericSystem,不连接 SDK。
公开模型版本含 6 个未被 URDF 引用的悬空 aubo_i10HL/visual/link0..5.DAE 链接,会使 Humble 的 --symlink-install 失败。上面的准备脚本仅在确认目标不存在且未被模型引用时移除它们,可重复执行,不替换 mesh。每次重新初始化或重置子模块后重新执行;Git 会显示这 6 项本地删除,子模块提交指针仍为公开的 47fa5e0。
模型包构建会在子模块 urdf/ 下生成 .urdf.xacro 文件,因此 Git 可能显示该子模块含未跟踪文件。
常见问题:
-
Cannot locate rosdep definition for [aubo_description]:先初始化子模块,确认目录内存在package.xml。 -
tf/actionlib:这是 ROS 1 依赖;ros_joints_plan/package.xml已改为声明 ROS 2 的 tf2 和 MoveIt 规划接口依赖。 - 找不到
controller_manager、hardware_interface等 CMake 配置:安装上列包后重新构建。 - SDK 下载失败:驱动 CMake 会按 CPU 架构下载 AUBO SDK
0.27.0-rc.4,需可访问download.aubo-robotics.cn;不能拿 x86_64 SDK 用于 ARM64。
最终构建结果:7 packages finished,驱动、控制器、消息、模型与规划包全部编译通过;
aubo_gazebo 按上述流程跳过。构建日志:/tmp/aubo-build.log(临时文件)。
本次同步修正:
-
ros_joints_plan删除 ROS 1 的tf/actionlib,补齐 tf2、MoveIt 规划接口和 lint 测试依赖。 -
aubo_dashboard_msgs补齐builtin_interfaces;驱动补齐ament_index_python和 CMake 对ament_cmake_python的显式查找。 - 硬件接口移除未使用的
robot_mode消息头、serviceinterface.h和visibility_control.h引用,显式包含unordered_map。 - 已确认
serviceinterface.h和aubo/robot/robot_state.h均由下载的 AUBO SDK 提供;前者在本硬件接口中未使用,移除以减少无关 SDK 依赖,后者保留。 - SDK 安装规则同时包含 Release 与 Debug 动态库,修复 Release 构建安装后缺少
libaubo_sdk.so的问题。
验证:rosdep 检查通过(排除 Gazebo Classic 和 Docker);驱动可执行文件可被 ROS 2 发现;
aubo_control.launch.py --show-args 解析成功;硬件插件的 ldd 无缺失库,ctypes.CDLL 加载成功。上述为早期编译检查,当时未连接机器人。
旧式 on_init(HardwareInfo) 等接口可能给出弃用警告,不影响本次构建通过。
本小节仅记录早期编译和依赖检查。ES3 真机频率验收见 ES 控制柜与频率验收。Gazebo 仿真仍未验证。
ros2_control 内核实时性配置
控制器管理器会在主控制循环上申请优先级 50 的 SCHED_FIFO。普通用户默认不能设置该调度策略。文件 capability 让 aubo_ros2_control_node 在不开放通用 root 的前提下获得 CAP_SYS_NICE 和 CAP_SYS_RESOURCE。
配置实时权限
这是不依赖 file capability 的备选:把当前用户加入 realtime 组并放宽 rtprio。改完后必须重新登录。
步骤 1:创建 realtime 用户组
sudo addgroup realtime
sudo usermod -a -G realtime $(whoami)
步骤 2:配置系统限制
File truncated at 100 lines see the full file
CONTRIBUTING
|
aubo_ros2_driver repositoryaubo_controllers aubo_dashboard_msgs aubo_gazebo aubo_moveit_config aubo_msgs aubo_ros2_driver ros_joints_plan |
ROS Distro
|
Repository Summary
| Description | |
| Checkout URI | https://github.com/auborobot/aubo_ros2_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-13 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| aubo_controllers | 0.1.0 |
| aubo_dashboard_msgs | 2.3.2 |
| aubo_gazebo | 0.0.0 |
| aubo_moveit_config | 0.3.0 |
| aubo_msgs | 2.0.0 |
| aubo_ros2_driver | 2.3.2 |
| ros_joints_plan | 0.0.0 |
README
aubo_ros2_driver
遨博机器人ROS2驱动
安装与编译(Ubuntu 22.04 / ROS 2 Humble)
先建立 ROS 工作区,再把本仓库克隆到 src 下。克隆完成后目录为 ~/ws_humble/src/aubo_ros2_driver,各个 ROS 包在该目录内。编译、校准和启动命令都在工作区根目录 ~/ws_humble 执行。模型由 Git 子模块提供,首次克隆后必须初始化:
mkdir -p ~/ws_humble/src
cd ~/ws_humble/src
git clone https://github.com/AuboRobot/aubo_ros2_driver.git
cd ~/ws_humble
git -C src/aubo_ros2_driver submodule update --init --recursive
python3 src/aubo_ros2_driver/scripts/prepare_description.py
source /opt/ros/humble/setup.bash
# 首次使用 rosdep 时按需执行 sudo rosdep init;已有配置无需重复初始化
rosdep update
rosdep install --from-paths src/aubo_ros2_driver --ignore-src -r -y --rosdistro humble \
--skip-keys="gazebo_ros gazebo_ros2_control docker.io"
CMAKE_BUILD_PARALLEL_LEVEL=4 colcon build --base-paths src/aubo_ros2_driver --packages-skip aubo_gazebo \
--parallel-workers 2 --cmake-args -DCMAKE_BUILD_TYPE=Release
source install/setup.bash
aubo_gazebo 依赖 Gazebo Classic;上述 Humble 编译流程跳过此包及其两项依赖,不代表已验证 Gazebo 仿真。
--base-paths src/aubo_ros2_driver 只构建这次克隆进来的仓库。之后若在 src 下再放入其他仓库,它们不会被这次命令编进去。
内存较少时可将 CMAKE_BUILD_PARALLEL_LEVEL 降为 2。Docker 仅为测试依赖,本次未安装;需要 Docker 测试时移除对应 skip key。
请以普通用户运行 rosdep,按提示使用 sudo 安装系统包;不要直接用 root 运行 rosdep,否则可能找不到用户的 rosdep 缓存。
本机依赖检查与排查记录(2026-10-29)
已执行实际 colcon 构建及 rosdep check --from-paths src/aubo_ros2_driver --ignore-src。
初始环境缺少以下系统依赖(安装操作需要 sudo):
sudo apt update
sudo apt install \
ros-humble-controller-manager ros-humble-controller-manager-msgs \
ros-humble-hardware-interface ros-humble-controller-interface ros-humble-realtime-tools \
ros-humble-joint-state-broadcaster ros-humble-joint-trajectory-controller \
ros-humble-position-controllers ros-humble-velocity-controllers \
ros-humble-force-torque-sensor-broadcaster ros-humble-ros2-controllers-test-nodes \
ros-humble-control-msgs ros-humble-moveit-msgs \
ros-humble-moveit-ros-move-group ros-humble-moveit-kinematics ros-humble-moveit-planners \
ros-humble-moveit-simple-controller-manager ros-humble-moveit-configs-utils \
ros-humble-moveit-ros-visualization ros-humble-moveit-ros-warehouse \
ros-humble-moveit-setup-assistant ros-humble-moveit-ros-planning-interface \
ros-humble-warehouse-ros ros-humble-joint-state-publisher \
ros-humble-joint-state-publisher-gui ros-humble-xacro nlohmann-json3-dev socat
以上为 Humble 依赖名;完整安装以初始化子模块后的 rosdep 结果为准。
此前环境安装时 apt 新增 101 个包,其中包括驱动运行依赖 socat。
docker.io 为驱动测试依赖,本次跳过。模型子模块已初始化,固定版本为 47fa5e02fa873f27f7e812d31f31e3f4cf5e56b1。
驱动启动时在生成的 robot description 中设置 hardware plugin 和 Servo 参数,以兼容公开模型版本;use_fake_hardware:=true 使用 mock_components/GenericSystem,不连接 SDK。
公开模型版本含 6 个未被 URDF 引用的悬空 aubo_i10HL/visual/link0..5.DAE 链接,会使 Humble 的 --symlink-install 失败。上面的准备脚本仅在确认目标不存在且未被模型引用时移除它们,可重复执行,不替换 mesh。每次重新初始化或重置子模块后重新执行;Git 会显示这 6 项本地删除,子模块提交指针仍为公开的 47fa5e0。
模型包构建会在子模块 urdf/ 下生成 .urdf.xacro 文件,因此 Git 可能显示该子模块含未跟踪文件。
常见问题:
-
Cannot locate rosdep definition for [aubo_description]:先初始化子模块,确认目录内存在package.xml。 -
tf/actionlib:这是 ROS 1 依赖;ros_joints_plan/package.xml已改为声明 ROS 2 的 tf2 和 MoveIt 规划接口依赖。 - 找不到
controller_manager、hardware_interface等 CMake 配置:安装上列包后重新构建。 - SDK 下载失败:驱动 CMake 会按 CPU 架构下载 AUBO SDK
0.27.0-rc.4,需可访问download.aubo-robotics.cn;不能拿 x86_64 SDK 用于 ARM64。
最终构建结果:7 packages finished,驱动、控制器、消息、模型与规划包全部编译通过;
aubo_gazebo 按上述流程跳过。构建日志:/tmp/aubo-build.log(临时文件)。
本次同步修正:
-
ros_joints_plan删除 ROS 1 的tf/actionlib,补齐 tf2、MoveIt 规划接口和 lint 测试依赖。 -
aubo_dashboard_msgs补齐builtin_interfaces;驱动补齐ament_index_python和 CMake 对ament_cmake_python的显式查找。 - 硬件接口移除未使用的
robot_mode消息头、serviceinterface.h和visibility_control.h引用,显式包含unordered_map。 - 已确认
serviceinterface.h和aubo/robot/robot_state.h均由下载的 AUBO SDK 提供;前者在本硬件接口中未使用,移除以减少无关 SDK 依赖,后者保留。 - SDK 安装规则同时包含 Release 与 Debug 动态库,修复 Release 构建安装后缺少
libaubo_sdk.so的问题。
验证:rosdep 检查通过(排除 Gazebo Classic 和 Docker);驱动可执行文件可被 ROS 2 发现;
aubo_control.launch.py --show-args 解析成功;硬件插件的 ldd 无缺失库,ctypes.CDLL 加载成功。上述为早期编译检查,当时未连接机器人。
旧式 on_init(HardwareInfo) 等接口可能给出弃用警告,不影响本次构建通过。
本小节仅记录早期编译和依赖检查。ES3 真机频率验收见 ES 控制柜与频率验收。Gazebo 仿真仍未验证。
ros2_control 内核实时性配置
控制器管理器会在主控制循环上申请优先级 50 的 SCHED_FIFO。普通用户默认不能设置该调度策略。文件 capability 让 aubo_ros2_control_node 在不开放通用 root 的前提下获得 CAP_SYS_NICE 和 CAP_SYS_RESOURCE。
配置实时权限
这是不依赖 file capability 的备选:把当前用户加入 realtime 组并放宽 rtprio。改完后必须重新登录。
步骤 1:创建 realtime 用户组
sudo addgroup realtime
sudo usermod -a -G realtime $(whoami)
步骤 2:配置系统限制
File truncated at 100 lines see the full file
CONTRIBUTING
|
aubo_ros2_driver repositoryaubo_controllers aubo_dashboard_msgs aubo_gazebo aubo_moveit_config aubo_msgs aubo_ros2_driver ros_joints_plan |
ROS Distro
|
Repository Summary
| Description | |
| Checkout URI | https://github.com/auborobot/aubo_ros2_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-13 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| aubo_controllers | 0.1.0 |
| aubo_dashboard_msgs | 2.3.2 |
| aubo_gazebo | 0.0.0 |
| aubo_moveit_config | 0.3.0 |
| aubo_msgs | 2.0.0 |
| aubo_ros2_driver | 2.3.2 |
| ros_joints_plan | 0.0.0 |
README
aubo_ros2_driver
遨博机器人ROS2驱动
安装与编译(Ubuntu 22.04 / ROS 2 Humble)
先建立 ROS 工作区,再把本仓库克隆到 src 下。克隆完成后目录为 ~/ws_humble/src/aubo_ros2_driver,各个 ROS 包在该目录内。编译、校准和启动命令都在工作区根目录 ~/ws_humble 执行。模型由 Git 子模块提供,首次克隆后必须初始化:
mkdir -p ~/ws_humble/src
cd ~/ws_humble/src
git clone https://github.com/AuboRobot/aubo_ros2_driver.git
cd ~/ws_humble
git -C src/aubo_ros2_driver submodule update --init --recursive
python3 src/aubo_ros2_driver/scripts/prepare_description.py
source /opt/ros/humble/setup.bash
# 首次使用 rosdep 时按需执行 sudo rosdep init;已有配置无需重复初始化
rosdep update
rosdep install --from-paths src/aubo_ros2_driver --ignore-src -r -y --rosdistro humble \
--skip-keys="gazebo_ros gazebo_ros2_control docker.io"
CMAKE_BUILD_PARALLEL_LEVEL=4 colcon build --base-paths src/aubo_ros2_driver --packages-skip aubo_gazebo \
--parallel-workers 2 --cmake-args -DCMAKE_BUILD_TYPE=Release
source install/setup.bash
aubo_gazebo 依赖 Gazebo Classic;上述 Humble 编译流程跳过此包及其两项依赖,不代表已验证 Gazebo 仿真。
--base-paths src/aubo_ros2_driver 只构建这次克隆进来的仓库。之后若在 src 下再放入其他仓库,它们不会被这次命令编进去。
内存较少时可将 CMAKE_BUILD_PARALLEL_LEVEL 降为 2。Docker 仅为测试依赖,本次未安装;需要 Docker 测试时移除对应 skip key。
请以普通用户运行 rosdep,按提示使用 sudo 安装系统包;不要直接用 root 运行 rosdep,否则可能找不到用户的 rosdep 缓存。
本机依赖检查与排查记录(2026-10-29)
已执行实际 colcon 构建及 rosdep check --from-paths src/aubo_ros2_driver --ignore-src。
初始环境缺少以下系统依赖(安装操作需要 sudo):
sudo apt update
sudo apt install \
ros-humble-controller-manager ros-humble-controller-manager-msgs \
ros-humble-hardware-interface ros-humble-controller-interface ros-humble-realtime-tools \
ros-humble-joint-state-broadcaster ros-humble-joint-trajectory-controller \
ros-humble-position-controllers ros-humble-velocity-controllers \
ros-humble-force-torque-sensor-broadcaster ros-humble-ros2-controllers-test-nodes \
ros-humble-control-msgs ros-humble-moveit-msgs \
ros-humble-moveit-ros-move-group ros-humble-moveit-kinematics ros-humble-moveit-planners \
ros-humble-moveit-simple-controller-manager ros-humble-moveit-configs-utils \
ros-humble-moveit-ros-visualization ros-humble-moveit-ros-warehouse \
ros-humble-moveit-setup-assistant ros-humble-moveit-ros-planning-interface \
ros-humble-warehouse-ros ros-humble-joint-state-publisher \
ros-humble-joint-state-publisher-gui ros-humble-xacro nlohmann-json3-dev socat
以上为 Humble 依赖名;完整安装以初始化子模块后的 rosdep 结果为准。
此前环境安装时 apt 新增 101 个包,其中包括驱动运行依赖 socat。
docker.io 为驱动测试依赖,本次跳过。模型子模块已初始化,固定版本为 47fa5e02fa873f27f7e812d31f31e3f4cf5e56b1。
驱动启动时在生成的 robot description 中设置 hardware plugin 和 Servo 参数,以兼容公开模型版本;use_fake_hardware:=true 使用 mock_components/GenericSystem,不连接 SDK。
公开模型版本含 6 个未被 URDF 引用的悬空 aubo_i10HL/visual/link0..5.DAE 链接,会使 Humble 的 --symlink-install 失败。上面的准备脚本仅在确认目标不存在且未被模型引用时移除它们,可重复执行,不替换 mesh。每次重新初始化或重置子模块后重新执行;Git 会显示这 6 项本地删除,子模块提交指针仍为公开的 47fa5e0。
模型包构建会在子模块 urdf/ 下生成 .urdf.xacro 文件,因此 Git 可能显示该子模块含未跟踪文件。
常见问题:
-
Cannot locate rosdep definition for [aubo_description]:先初始化子模块,确认目录内存在package.xml。 -
tf/actionlib:这是 ROS 1 依赖;ros_joints_plan/package.xml已改为声明 ROS 2 的 tf2 和 MoveIt 规划接口依赖。 - 找不到
controller_manager、hardware_interface等 CMake 配置:安装上列包后重新构建。 - SDK 下载失败:驱动 CMake 会按 CPU 架构下载 AUBO SDK
0.27.0-rc.4,需可访问download.aubo-robotics.cn;不能拿 x86_64 SDK 用于 ARM64。
最终构建结果:7 packages finished,驱动、控制器、消息、模型与规划包全部编译通过;
aubo_gazebo 按上述流程跳过。构建日志:/tmp/aubo-build.log(临时文件)。
本次同步修正:
-
ros_joints_plan删除 ROS 1 的tf/actionlib,补齐 tf2、MoveIt 规划接口和 lint 测试依赖。 -
aubo_dashboard_msgs补齐builtin_interfaces;驱动补齐ament_index_python和 CMake 对ament_cmake_python的显式查找。 - 硬件接口移除未使用的
robot_mode消息头、serviceinterface.h和visibility_control.h引用,显式包含unordered_map。 - 已确认
serviceinterface.h和aubo/robot/robot_state.h均由下载的 AUBO SDK 提供;前者在本硬件接口中未使用,移除以减少无关 SDK 依赖,后者保留。 - SDK 安装规则同时包含 Release 与 Debug 动态库,修复 Release 构建安装后缺少
libaubo_sdk.so的问题。
验证:rosdep 检查通过(排除 Gazebo Classic 和 Docker);驱动可执行文件可被 ROS 2 发现;
aubo_control.launch.py --show-args 解析成功;硬件插件的 ldd 无缺失库,ctypes.CDLL 加载成功。上述为早期编译检查,当时未连接机器人。
旧式 on_init(HardwareInfo) 等接口可能给出弃用警告,不影响本次构建通过。
本小节仅记录早期编译和依赖检查。ES3 真机频率验收见 ES 控制柜与频率验收。Gazebo 仿真仍未验证。
ros2_control 内核实时性配置
控制器管理器会在主控制循环上申请优先级 50 的 SCHED_FIFO。普通用户默认不能设置该调度策略。文件 capability 让 aubo_ros2_control_node 在不开放通用 root 的前提下获得 CAP_SYS_NICE 和 CAP_SYS_RESOURCE。
配置实时权限
这是不依赖 file capability 的备选:把当前用户加入 realtime 组并放宽 rtprio。改完后必须重新登录。
步骤 1:创建 realtime 用户组
sudo addgroup realtime
sudo usermod -a -G realtime $(whoami)
步骤 2:配置系统限制
File truncated at 100 lines see the full file
CONTRIBUTING
|
aubo_ros2_driver repositoryaubo_controllers aubo_dashboard_msgs aubo_gazebo aubo_moveit_config aubo_msgs aubo_ros2_driver ros_joints_plan |
ROS Distro
|
Repository Summary
| Description | |
| Checkout URI | https://github.com/auborobot/aubo_ros2_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-13 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| aubo_controllers | 0.1.0 |
| aubo_dashboard_msgs | 2.3.2 |
| aubo_gazebo | 0.0.0 |
| aubo_moveit_config | 0.3.0 |
| aubo_msgs | 2.0.0 |
| aubo_ros2_driver | 2.3.2 |
| ros_joints_plan | 0.0.0 |
README
aubo_ros2_driver
遨博机器人ROS2驱动
安装与编译(Ubuntu 22.04 / ROS 2 Humble)
先建立 ROS 工作区,再把本仓库克隆到 src 下。克隆完成后目录为 ~/ws_humble/src/aubo_ros2_driver,各个 ROS 包在该目录内。编译、校准和启动命令都在工作区根目录 ~/ws_humble 执行。模型由 Git 子模块提供,首次克隆后必须初始化:
mkdir -p ~/ws_humble/src
cd ~/ws_humble/src
git clone https://github.com/AuboRobot/aubo_ros2_driver.git
cd ~/ws_humble
git -C src/aubo_ros2_driver submodule update --init --recursive
python3 src/aubo_ros2_driver/scripts/prepare_description.py
source /opt/ros/humble/setup.bash
# 首次使用 rosdep 时按需执行 sudo rosdep init;已有配置无需重复初始化
rosdep update
rosdep install --from-paths src/aubo_ros2_driver --ignore-src -r -y --rosdistro humble \
--skip-keys="gazebo_ros gazebo_ros2_control docker.io"
CMAKE_BUILD_PARALLEL_LEVEL=4 colcon build --base-paths src/aubo_ros2_driver --packages-skip aubo_gazebo \
--parallel-workers 2 --cmake-args -DCMAKE_BUILD_TYPE=Release
source install/setup.bash
aubo_gazebo 依赖 Gazebo Classic;上述 Humble 编译流程跳过此包及其两项依赖,不代表已验证 Gazebo 仿真。
--base-paths src/aubo_ros2_driver 只构建这次克隆进来的仓库。之后若在 src 下再放入其他仓库,它们不会被这次命令编进去。
内存较少时可将 CMAKE_BUILD_PARALLEL_LEVEL 降为 2。Docker 仅为测试依赖,本次未安装;需要 Docker 测试时移除对应 skip key。
请以普通用户运行 rosdep,按提示使用 sudo 安装系统包;不要直接用 root 运行 rosdep,否则可能找不到用户的 rosdep 缓存。
本机依赖检查与排查记录(2026-10-29)
已执行实际 colcon 构建及 rosdep check --from-paths src/aubo_ros2_driver --ignore-src。
初始环境缺少以下系统依赖(安装操作需要 sudo):
sudo apt update
sudo apt install \
ros-humble-controller-manager ros-humble-controller-manager-msgs \
ros-humble-hardware-interface ros-humble-controller-interface ros-humble-realtime-tools \
ros-humble-joint-state-broadcaster ros-humble-joint-trajectory-controller \
ros-humble-position-controllers ros-humble-velocity-controllers \
ros-humble-force-torque-sensor-broadcaster ros-humble-ros2-controllers-test-nodes \
ros-humble-control-msgs ros-humble-moveit-msgs \
ros-humble-moveit-ros-move-group ros-humble-moveit-kinematics ros-humble-moveit-planners \
ros-humble-moveit-simple-controller-manager ros-humble-moveit-configs-utils \
ros-humble-moveit-ros-visualization ros-humble-moveit-ros-warehouse \
ros-humble-moveit-setup-assistant ros-humble-moveit-ros-planning-interface \
ros-humble-warehouse-ros ros-humble-joint-state-publisher \
ros-humble-joint-state-publisher-gui ros-humble-xacro nlohmann-json3-dev socat
以上为 Humble 依赖名;完整安装以初始化子模块后的 rosdep 结果为准。
此前环境安装时 apt 新增 101 个包,其中包括驱动运行依赖 socat。
docker.io 为驱动测试依赖,本次跳过。模型子模块已初始化,固定版本为 47fa5e02fa873f27f7e812d31f31e3f4cf5e56b1。
驱动启动时在生成的 robot description 中设置 hardware plugin 和 Servo 参数,以兼容公开模型版本;use_fake_hardware:=true 使用 mock_components/GenericSystem,不连接 SDK。
公开模型版本含 6 个未被 URDF 引用的悬空 aubo_i10HL/visual/link0..5.DAE 链接,会使 Humble 的 --symlink-install 失败。上面的准备脚本仅在确认目标不存在且未被模型引用时移除它们,可重复执行,不替换 mesh。每次重新初始化或重置子模块后重新执行;Git 会显示这 6 项本地删除,子模块提交指针仍为公开的 47fa5e0。
模型包构建会在子模块 urdf/ 下生成 .urdf.xacro 文件,因此 Git 可能显示该子模块含未跟踪文件。
常见问题:
-
Cannot locate rosdep definition for [aubo_description]:先初始化子模块,确认目录内存在package.xml。 -
tf/actionlib:这是 ROS 1 依赖;ros_joints_plan/package.xml已改为声明 ROS 2 的 tf2 和 MoveIt 规划接口依赖。 - 找不到
controller_manager、hardware_interface等 CMake 配置:安装上列包后重新构建。 - SDK 下载失败:驱动 CMake 会按 CPU 架构下载 AUBO SDK
0.27.0-rc.4,需可访问download.aubo-robotics.cn;不能拿 x86_64 SDK 用于 ARM64。
最终构建结果:7 packages finished,驱动、控制器、消息、模型与规划包全部编译通过;
aubo_gazebo 按上述流程跳过。构建日志:/tmp/aubo-build.log(临时文件)。
本次同步修正:
-
ros_joints_plan删除 ROS 1 的tf/actionlib,补齐 tf2、MoveIt 规划接口和 lint 测试依赖。 -
aubo_dashboard_msgs补齐builtin_interfaces;驱动补齐ament_index_python和 CMake 对ament_cmake_python的显式查找。 - 硬件接口移除未使用的
robot_mode消息头、serviceinterface.h和visibility_control.h引用,显式包含unordered_map。 - 已确认
serviceinterface.h和aubo/robot/robot_state.h均由下载的 AUBO SDK 提供;前者在本硬件接口中未使用,移除以减少无关 SDK 依赖,后者保留。 - SDK 安装规则同时包含 Release 与 Debug 动态库,修复 Release 构建安装后缺少
libaubo_sdk.so的问题。
验证:rosdep 检查通过(排除 Gazebo Classic 和 Docker);驱动可执行文件可被 ROS 2 发现;
aubo_control.launch.py --show-args 解析成功;硬件插件的 ldd 无缺失库,ctypes.CDLL 加载成功。上述为早期编译检查,当时未连接机器人。
旧式 on_init(HardwareInfo) 等接口可能给出弃用警告,不影响本次构建通过。
本小节仅记录早期编译和依赖检查。ES3 真机频率验收见 ES 控制柜与频率验收。Gazebo 仿真仍未验证。
ros2_control 内核实时性配置
控制器管理器会在主控制循环上申请优先级 50 的 SCHED_FIFO。普通用户默认不能设置该调度策略。文件 capability 让 aubo_ros2_control_node 在不开放通用 root 的前提下获得 CAP_SYS_NICE 和 CAP_SYS_RESOURCE。
配置实时权限
这是不依赖 file capability 的备选:把当前用户加入 realtime 组并放宽 rtprio。改完后必须重新登录。
步骤 1:创建 realtime 用户组
sudo addgroup realtime
sudo usermod -a -G realtime $(whoami)
步骤 2:配置系统限制
File truncated at 100 lines see the full file
CONTRIBUTING
|
aubo_ros2_driver repositoryaubo_controllers aubo_dashboard_msgs aubo_gazebo aubo_moveit_config aubo_msgs aubo_ros2_driver ros_joints_plan |
ROS Distro
|
Repository Summary
| Description | |
| Checkout URI | https://github.com/auborobot/aubo_ros2_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-13 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| aubo_controllers | 0.1.0 |
| aubo_dashboard_msgs | 2.3.2 |
| aubo_gazebo | 0.0.0 |
| aubo_moveit_config | 0.3.0 |
| aubo_msgs | 2.0.0 |
| aubo_ros2_driver | 2.3.2 |
| ros_joints_plan | 0.0.0 |
README
aubo_ros2_driver
遨博机器人ROS2驱动
安装与编译(Ubuntu 22.04 / ROS 2 Humble)
先建立 ROS 工作区,再把本仓库克隆到 src 下。克隆完成后目录为 ~/ws_humble/src/aubo_ros2_driver,各个 ROS 包在该目录内。编译、校准和启动命令都在工作区根目录 ~/ws_humble 执行。模型由 Git 子模块提供,首次克隆后必须初始化:
mkdir -p ~/ws_humble/src
cd ~/ws_humble/src
git clone https://github.com/AuboRobot/aubo_ros2_driver.git
cd ~/ws_humble
git -C src/aubo_ros2_driver submodule update --init --recursive
python3 src/aubo_ros2_driver/scripts/prepare_description.py
source /opt/ros/humble/setup.bash
# 首次使用 rosdep 时按需执行 sudo rosdep init;已有配置无需重复初始化
rosdep update
rosdep install --from-paths src/aubo_ros2_driver --ignore-src -r -y --rosdistro humble \
--skip-keys="gazebo_ros gazebo_ros2_control docker.io"
CMAKE_BUILD_PARALLEL_LEVEL=4 colcon build --base-paths src/aubo_ros2_driver --packages-skip aubo_gazebo \
--parallel-workers 2 --cmake-args -DCMAKE_BUILD_TYPE=Release
source install/setup.bash
aubo_gazebo 依赖 Gazebo Classic;上述 Humble 编译流程跳过此包及其两项依赖,不代表已验证 Gazebo 仿真。
--base-paths src/aubo_ros2_driver 只构建这次克隆进来的仓库。之后若在 src 下再放入其他仓库,它们不会被这次命令编进去。
内存较少时可将 CMAKE_BUILD_PARALLEL_LEVEL 降为 2。Docker 仅为测试依赖,本次未安装;需要 Docker 测试时移除对应 skip key。
请以普通用户运行 rosdep,按提示使用 sudo 安装系统包;不要直接用 root 运行 rosdep,否则可能找不到用户的 rosdep 缓存。
本机依赖检查与排查记录(2026-10-29)
已执行实际 colcon 构建及 rosdep check --from-paths src/aubo_ros2_driver --ignore-src。
初始环境缺少以下系统依赖(安装操作需要 sudo):
sudo apt update
sudo apt install \
ros-humble-controller-manager ros-humble-controller-manager-msgs \
ros-humble-hardware-interface ros-humble-controller-interface ros-humble-realtime-tools \
ros-humble-joint-state-broadcaster ros-humble-joint-trajectory-controller \
ros-humble-position-controllers ros-humble-velocity-controllers \
ros-humble-force-torque-sensor-broadcaster ros-humble-ros2-controllers-test-nodes \
ros-humble-control-msgs ros-humble-moveit-msgs \
ros-humble-moveit-ros-move-group ros-humble-moveit-kinematics ros-humble-moveit-planners \
ros-humble-moveit-simple-controller-manager ros-humble-moveit-configs-utils \
ros-humble-moveit-ros-visualization ros-humble-moveit-ros-warehouse \
ros-humble-moveit-setup-assistant ros-humble-moveit-ros-planning-interface \
ros-humble-warehouse-ros ros-humble-joint-state-publisher \
ros-humble-joint-state-publisher-gui ros-humble-xacro nlohmann-json3-dev socat
以上为 Humble 依赖名;完整安装以初始化子模块后的 rosdep 结果为准。
此前环境安装时 apt 新增 101 个包,其中包括驱动运行依赖 socat。
docker.io 为驱动测试依赖,本次跳过。模型子模块已初始化,固定版本为 47fa5e02fa873f27f7e812d31f31e3f4cf5e56b1。
驱动启动时在生成的 robot description 中设置 hardware plugin 和 Servo 参数,以兼容公开模型版本;use_fake_hardware:=true 使用 mock_components/GenericSystem,不连接 SDK。
公开模型版本含 6 个未被 URDF 引用的悬空 aubo_i10HL/visual/link0..5.DAE 链接,会使 Humble 的 --symlink-install 失败。上面的准备脚本仅在确认目标不存在且未被模型引用时移除它们,可重复执行,不替换 mesh。每次重新初始化或重置子模块后重新执行;Git 会显示这 6 项本地删除,子模块提交指针仍为公开的 47fa5e0。
模型包构建会在子模块 urdf/ 下生成 .urdf.xacro 文件,因此 Git 可能显示该子模块含未跟踪文件。
常见问题:
-
Cannot locate rosdep definition for [aubo_description]:先初始化子模块,确认目录内存在package.xml。 -
tf/actionlib:这是 ROS 1 依赖;ros_joints_plan/package.xml已改为声明 ROS 2 的 tf2 和 MoveIt 规划接口依赖。 - 找不到
controller_manager、hardware_interface等 CMake 配置:安装上列包后重新构建。 - SDK 下载失败:驱动 CMake 会按 CPU 架构下载 AUBO SDK
0.27.0-rc.4,需可访问download.aubo-robotics.cn;不能拿 x86_64 SDK 用于 ARM64。
最终构建结果:7 packages finished,驱动、控制器、消息、模型与规划包全部编译通过;
aubo_gazebo 按上述流程跳过。构建日志:/tmp/aubo-build.log(临时文件)。
本次同步修正:
-
ros_joints_plan删除 ROS 1 的tf/actionlib,补齐 tf2、MoveIt 规划接口和 lint 测试依赖。 -
aubo_dashboard_msgs补齐builtin_interfaces;驱动补齐ament_index_python和 CMake 对ament_cmake_python的显式查找。 - 硬件接口移除未使用的
robot_mode消息头、serviceinterface.h和visibility_control.h引用,显式包含unordered_map。 - 已确认
serviceinterface.h和aubo/robot/robot_state.h均由下载的 AUBO SDK 提供;前者在本硬件接口中未使用,移除以减少无关 SDK 依赖,后者保留。 - SDK 安装规则同时包含 Release 与 Debug 动态库,修复 Release 构建安装后缺少
libaubo_sdk.so的问题。
验证:rosdep 检查通过(排除 Gazebo Classic 和 Docker);驱动可执行文件可被 ROS 2 发现;
aubo_control.launch.py --show-args 解析成功;硬件插件的 ldd 无缺失库,ctypes.CDLL 加载成功。上述为早期编译检查,当时未连接机器人。
旧式 on_init(HardwareInfo) 等接口可能给出弃用警告,不影响本次构建通过。
本小节仅记录早期编译和依赖检查。ES3 真机频率验收见 ES 控制柜与频率验收。Gazebo 仿真仍未验证。
ros2_control 内核实时性配置
控制器管理器会在主控制循环上申请优先级 50 的 SCHED_FIFO。普通用户默认不能设置该调度策略。文件 capability 让 aubo_ros2_control_node 在不开放通用 root 的前提下获得 CAP_SYS_NICE 和 CAP_SYS_RESOURCE。
配置实时权限
这是不依赖 file capability 的备选:把当前用户加入 realtime 组并放宽 rtprio。改完后必须重新登录。
步骤 1:创建 realtime 用户组
sudo addgroup realtime
sudo usermod -a -G realtime $(whoami)
步骤 2:配置系统限制
File truncated at 100 lines see the full file
CONTRIBUTING
|
aubo_ros2_driver repositoryaubo_controllers aubo_dashboard_msgs aubo_gazebo aubo_moveit_config aubo_msgs aubo_ros2_driver ros_joints_plan |
ROS Distro
|
Repository Summary
| Description | |
| Checkout URI | https://github.com/auborobot/aubo_ros2_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-13 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| aubo_controllers | 0.1.0 |
| aubo_dashboard_msgs | 2.3.2 |
| aubo_gazebo | 0.0.0 |
| aubo_moveit_config | 0.3.0 |
| aubo_msgs | 2.0.0 |
| aubo_ros2_driver | 2.3.2 |
| ros_joints_plan | 0.0.0 |
README
aubo_ros2_driver
遨博机器人ROS2驱动
安装与编译(Ubuntu 22.04 / ROS 2 Humble)
先建立 ROS 工作区,再把本仓库克隆到 src 下。克隆完成后目录为 ~/ws_humble/src/aubo_ros2_driver,各个 ROS 包在该目录内。编译、校准和启动命令都在工作区根目录 ~/ws_humble 执行。模型由 Git 子模块提供,首次克隆后必须初始化:
mkdir -p ~/ws_humble/src
cd ~/ws_humble/src
git clone https://github.com/AuboRobot/aubo_ros2_driver.git
cd ~/ws_humble
git -C src/aubo_ros2_driver submodule update --init --recursive
python3 src/aubo_ros2_driver/scripts/prepare_description.py
source /opt/ros/humble/setup.bash
# 首次使用 rosdep 时按需执行 sudo rosdep init;已有配置无需重复初始化
rosdep update
rosdep install --from-paths src/aubo_ros2_driver --ignore-src -r -y --rosdistro humble \
--skip-keys="gazebo_ros gazebo_ros2_control docker.io"
CMAKE_BUILD_PARALLEL_LEVEL=4 colcon build --base-paths src/aubo_ros2_driver --packages-skip aubo_gazebo \
--parallel-workers 2 --cmake-args -DCMAKE_BUILD_TYPE=Release
source install/setup.bash
aubo_gazebo 依赖 Gazebo Classic;上述 Humble 编译流程跳过此包及其两项依赖,不代表已验证 Gazebo 仿真。
--base-paths src/aubo_ros2_driver 只构建这次克隆进来的仓库。之后若在 src 下再放入其他仓库,它们不会被这次命令编进去。
内存较少时可将 CMAKE_BUILD_PARALLEL_LEVEL 降为 2。Docker 仅为测试依赖,本次未安装;需要 Docker 测试时移除对应 skip key。
请以普通用户运行 rosdep,按提示使用 sudo 安装系统包;不要直接用 root 运行 rosdep,否则可能找不到用户的 rosdep 缓存。
本机依赖检查与排查记录(2026-10-29)
已执行实际 colcon 构建及 rosdep check --from-paths src/aubo_ros2_driver --ignore-src。
初始环境缺少以下系统依赖(安装操作需要 sudo):
sudo apt update
sudo apt install \
ros-humble-controller-manager ros-humble-controller-manager-msgs \
ros-humble-hardware-interface ros-humble-controller-interface ros-humble-realtime-tools \
ros-humble-joint-state-broadcaster ros-humble-joint-trajectory-controller \
ros-humble-position-controllers ros-humble-velocity-controllers \
ros-humble-force-torque-sensor-broadcaster ros-humble-ros2-controllers-test-nodes \
ros-humble-control-msgs ros-humble-moveit-msgs \
ros-humble-moveit-ros-move-group ros-humble-moveit-kinematics ros-humble-moveit-planners \
ros-humble-moveit-simple-controller-manager ros-humble-moveit-configs-utils \
ros-humble-moveit-ros-visualization ros-humble-moveit-ros-warehouse \
ros-humble-moveit-setup-assistant ros-humble-moveit-ros-planning-interface \
ros-humble-warehouse-ros ros-humble-joint-state-publisher \
ros-humble-joint-state-publisher-gui ros-humble-xacro nlohmann-json3-dev socat
以上为 Humble 依赖名;完整安装以初始化子模块后的 rosdep 结果为准。
此前环境安装时 apt 新增 101 个包,其中包括驱动运行依赖 socat。
docker.io 为驱动测试依赖,本次跳过。模型子模块已初始化,固定版本为 47fa5e02fa873f27f7e812d31f31e3f4cf5e56b1。
驱动启动时在生成的 robot description 中设置 hardware plugin 和 Servo 参数,以兼容公开模型版本;use_fake_hardware:=true 使用 mock_components/GenericSystem,不连接 SDK。
公开模型版本含 6 个未被 URDF 引用的悬空 aubo_i10HL/visual/link0..5.DAE 链接,会使 Humble 的 --symlink-install 失败。上面的准备脚本仅在确认目标不存在且未被模型引用时移除它们,可重复执行,不替换 mesh。每次重新初始化或重置子模块后重新执行;Git 会显示这 6 项本地删除,子模块提交指针仍为公开的 47fa5e0。
模型包构建会在子模块 urdf/ 下生成 .urdf.xacro 文件,因此 Git 可能显示该子模块含未跟踪文件。
常见问题:
-
Cannot locate rosdep definition for [aubo_description]:先初始化子模块,确认目录内存在package.xml。 -
tf/actionlib:这是 ROS 1 依赖;ros_joints_plan/package.xml已改为声明 ROS 2 的 tf2 和 MoveIt 规划接口依赖。 - 找不到
controller_manager、hardware_interface等 CMake 配置:安装上列包后重新构建。 - SDK 下载失败:驱动 CMake 会按 CPU 架构下载 AUBO SDK
0.27.0-rc.4,需可访问download.aubo-robotics.cn;不能拿 x86_64 SDK 用于 ARM64。
最终构建结果:7 packages finished,驱动、控制器、消息、模型与规划包全部编译通过;
aubo_gazebo 按上述流程跳过。构建日志:/tmp/aubo-build.log(临时文件)。
本次同步修正:
-
ros_joints_plan删除 ROS 1 的tf/actionlib,补齐 tf2、MoveIt 规划接口和 lint 测试依赖。 -
aubo_dashboard_msgs补齐builtin_interfaces;驱动补齐ament_index_python和 CMake 对ament_cmake_python的显式查找。 - 硬件接口移除未使用的
robot_mode消息头、serviceinterface.h和visibility_control.h引用,显式包含unordered_map。 - 已确认
serviceinterface.h和aubo/robot/robot_state.h均由下载的 AUBO SDK 提供;前者在本硬件接口中未使用,移除以减少无关 SDK 依赖,后者保留。 - SDK 安装规则同时包含 Release 与 Debug 动态库,修复 Release 构建安装后缺少
libaubo_sdk.so的问题。
验证:rosdep 检查通过(排除 Gazebo Classic 和 Docker);驱动可执行文件可被 ROS 2 发现;
aubo_control.launch.py --show-args 解析成功;硬件插件的 ldd 无缺失库,ctypes.CDLL 加载成功。上述为早期编译检查,当时未连接机器人。
旧式 on_init(HardwareInfo) 等接口可能给出弃用警告,不影响本次构建通过。
本小节仅记录早期编译和依赖检查。ES3 真机频率验收见 ES 控制柜与频率验收。Gazebo 仿真仍未验证。
ros2_control 内核实时性配置
控制器管理器会在主控制循环上申请优先级 50 的 SCHED_FIFO。普通用户默认不能设置该调度策略。文件 capability 让 aubo_ros2_control_node 在不开放通用 root 的前提下获得 CAP_SYS_NICE 和 CAP_SYS_RESOURCE。
配置实时权限
这是不依赖 file capability 的备选:把当前用户加入 realtime 组并放宽 rtprio。改完后必须重新登录。
步骤 1:创建 realtime 用户组
sudo addgroup realtime
sudo usermod -a -G realtime $(whoami)
步骤 2:配置系统限制
File truncated at 100 lines see the full file
CONTRIBUTING
|
aubo_ros2_driver repositoryaubo_controllers aubo_dashboard_msgs aubo_gazebo aubo_moveit_config aubo_msgs aubo_ros2_driver ros_joints_plan |
ROS Distro
|
Repository Summary
| Description | |
| Checkout URI | https://github.com/auborobot/aubo_ros2_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-13 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| aubo_controllers | 0.1.0 |
| aubo_dashboard_msgs | 2.3.2 |
| aubo_gazebo | 0.0.0 |
| aubo_moveit_config | 0.3.0 |
| aubo_msgs | 2.0.0 |
| aubo_ros2_driver | 2.3.2 |
| ros_joints_plan | 0.0.0 |
README
aubo_ros2_driver
遨博机器人ROS2驱动
安装与编译(Ubuntu 22.04 / ROS 2 Humble)
先建立 ROS 工作区,再把本仓库克隆到 src 下。克隆完成后目录为 ~/ws_humble/src/aubo_ros2_driver,各个 ROS 包在该目录内。编译、校准和启动命令都在工作区根目录 ~/ws_humble 执行。模型由 Git 子模块提供,首次克隆后必须初始化:
mkdir -p ~/ws_humble/src
cd ~/ws_humble/src
git clone https://github.com/AuboRobot/aubo_ros2_driver.git
cd ~/ws_humble
git -C src/aubo_ros2_driver submodule update --init --recursive
python3 src/aubo_ros2_driver/scripts/prepare_description.py
source /opt/ros/humble/setup.bash
# 首次使用 rosdep 时按需执行 sudo rosdep init;已有配置无需重复初始化
rosdep update
rosdep install --from-paths src/aubo_ros2_driver --ignore-src -r -y --rosdistro humble \
--skip-keys="gazebo_ros gazebo_ros2_control docker.io"
CMAKE_BUILD_PARALLEL_LEVEL=4 colcon build --base-paths src/aubo_ros2_driver --packages-skip aubo_gazebo \
--parallel-workers 2 --cmake-args -DCMAKE_BUILD_TYPE=Release
source install/setup.bash
aubo_gazebo 依赖 Gazebo Classic;上述 Humble 编译流程跳过此包及其两项依赖,不代表已验证 Gazebo 仿真。
--base-paths src/aubo_ros2_driver 只构建这次克隆进来的仓库。之后若在 src 下再放入其他仓库,它们不会被这次命令编进去。
内存较少时可将 CMAKE_BUILD_PARALLEL_LEVEL 降为 2。Docker 仅为测试依赖,本次未安装;需要 Docker 测试时移除对应 skip key。
请以普通用户运行 rosdep,按提示使用 sudo 安装系统包;不要直接用 root 运行 rosdep,否则可能找不到用户的 rosdep 缓存。
本机依赖检查与排查记录(2026-10-29)
已执行实际 colcon 构建及 rosdep check --from-paths src/aubo_ros2_driver --ignore-src。
初始环境缺少以下系统依赖(安装操作需要 sudo):
sudo apt update
sudo apt install \
ros-humble-controller-manager ros-humble-controller-manager-msgs \
ros-humble-hardware-interface ros-humble-controller-interface ros-humble-realtime-tools \
ros-humble-joint-state-broadcaster ros-humble-joint-trajectory-controller \
ros-humble-position-controllers ros-humble-velocity-controllers \
ros-humble-force-torque-sensor-broadcaster ros-humble-ros2-controllers-test-nodes \
ros-humble-control-msgs ros-humble-moveit-msgs \
ros-humble-moveit-ros-move-group ros-humble-moveit-kinematics ros-humble-moveit-planners \
ros-humble-moveit-simple-controller-manager ros-humble-moveit-configs-utils \
ros-humble-moveit-ros-visualization ros-humble-moveit-ros-warehouse \
ros-humble-moveit-setup-assistant ros-humble-moveit-ros-planning-interface \
ros-humble-warehouse-ros ros-humble-joint-state-publisher \
ros-humble-joint-state-publisher-gui ros-humble-xacro nlohmann-json3-dev socat
以上为 Humble 依赖名;完整安装以初始化子模块后的 rosdep 结果为准。
此前环境安装时 apt 新增 101 个包,其中包括驱动运行依赖 socat。
docker.io 为驱动测试依赖,本次跳过。模型子模块已初始化,固定版本为 47fa5e02fa873f27f7e812d31f31e3f4cf5e56b1。
驱动启动时在生成的 robot description 中设置 hardware plugin 和 Servo 参数,以兼容公开模型版本;use_fake_hardware:=true 使用 mock_components/GenericSystem,不连接 SDK。
公开模型版本含 6 个未被 URDF 引用的悬空 aubo_i10HL/visual/link0..5.DAE 链接,会使 Humble 的 --symlink-install 失败。上面的准备脚本仅在确认目标不存在且未被模型引用时移除它们,可重复执行,不替换 mesh。每次重新初始化或重置子模块后重新执行;Git 会显示这 6 项本地删除,子模块提交指针仍为公开的 47fa5e0。
模型包构建会在子模块 urdf/ 下生成 .urdf.xacro 文件,因此 Git 可能显示该子模块含未跟踪文件。
常见问题:
-
Cannot locate rosdep definition for [aubo_description]:先初始化子模块,确认目录内存在package.xml。 -
tf/actionlib:这是 ROS 1 依赖;ros_joints_plan/package.xml已改为声明 ROS 2 的 tf2 和 MoveIt 规划接口依赖。 - 找不到
controller_manager、hardware_interface等 CMake 配置:安装上列包后重新构建。 - SDK 下载失败:驱动 CMake 会按 CPU 架构下载 AUBO SDK
0.27.0-rc.4,需可访问download.aubo-robotics.cn;不能拿 x86_64 SDK 用于 ARM64。
最终构建结果:7 packages finished,驱动、控制器、消息、模型与规划包全部编译通过;
aubo_gazebo 按上述流程跳过。构建日志:/tmp/aubo-build.log(临时文件)。
本次同步修正:
-
ros_joints_plan删除 ROS 1 的tf/actionlib,补齐 tf2、MoveIt 规划接口和 lint 测试依赖。 -
aubo_dashboard_msgs补齐builtin_interfaces;驱动补齐ament_index_python和 CMake 对ament_cmake_python的显式查找。 - 硬件接口移除未使用的
robot_mode消息头、serviceinterface.h和visibility_control.h引用,显式包含unordered_map。 - 已确认
serviceinterface.h和aubo/robot/robot_state.h均由下载的 AUBO SDK 提供;前者在本硬件接口中未使用,移除以减少无关 SDK 依赖,后者保留。 - SDK 安装规则同时包含 Release 与 Debug 动态库,修复 Release 构建安装后缺少
libaubo_sdk.so的问题。
验证:rosdep 检查通过(排除 Gazebo Classic 和 Docker);驱动可执行文件可被 ROS 2 发现;
aubo_control.launch.py --show-args 解析成功;硬件插件的 ldd 无缺失库,ctypes.CDLL 加载成功。上述为早期编译检查,当时未连接机器人。
旧式 on_init(HardwareInfo) 等接口可能给出弃用警告,不影响本次构建通过。
本小节仅记录早期编译和依赖检查。ES3 真机频率验收见 ES 控制柜与频率验收。Gazebo 仿真仍未验证。
ros2_control 内核实时性配置
控制器管理器会在主控制循环上申请优先级 50 的 SCHED_FIFO。普通用户默认不能设置该调度策略。文件 capability 让 aubo_ros2_control_node 在不开放通用 root 的前提下获得 CAP_SYS_NICE 和 CAP_SYS_RESOURCE。
配置实时权限
这是不依赖 file capability 的备选:把当前用户加入 realtime 组并放宽 rtprio。改完后必须重新登录。
步骤 1:创建 realtime 用户组
sudo addgroup realtime
sudo usermod -a -G realtime $(whoami)
步骤 2:配置系统限制
File truncated at 100 lines see the full file