⚙️ ros2_control 实战深挖:控制器与硬件接口

1 ros2_control 架构全景

上一页我们反复提到「轨迹交给 ros2_control 执行」,这一页就把这件事彻底讲透。ros2_control 是 ROS2 官方维护的机器人控制框架,它的核心使命只有一句:把「控制逻辑」与「硬件驱动」彻底解耦。控制算法(轨迹插值、PID、状态广播)不需要知道底下是伺服电机、是 EtherCAT 从站、还是 Gazebo 仿真关节;硬件驱动也不需要知道上层跑的是轨迹控制器还是力控。

1.1 三层架构与数据流向

数据流是一个闭环:每个控制周期(update_rate,如 1000 Hz)内,controller_manager 先调硬件接口的 read() 把状态刷进来 → 再逐个调用激活控制器的 update(),让它们读状态、写命令 → 最后调硬件接口的 write() 把命令刷到电机。

          ┌────────────── controller_manager (RT 线程, update_rate Hz) ──────────────┐
          │   ① read(): 硬件 → 状态接口         ② update(): 控制器读状态/写命令      │
          │   ③ write(): 命令接口 → 硬件                                               │
          └───────────────┬───────────────────────────────────────┬────────────────────┘
              state 接口 ▲│(位置/速度/力矩)        command 接口 ▼│(位置/速度/力矩/effort)
          ┌───────────────┴───────────────────────────────────────┴────────────────────┐
          │              hardware_interface (SystemInterface / ActuatorInterface)       │
          │   CAN / EtherCAT / RS485 / 仿真插件(ign_ros2_control / gazebo_ros2_control) │
          └─────────────────────────────────────────────────────────────────────────────┘
                                    │ 写电机命令 / 读编码器反馈
                          ┌─────────▼─────────┐
                          │ 关节模组(伺服+减速器) │
                          └───────────────────┘

1.2 关键抽象:state / command 接口

控制器与硬件之间只通过两类命名接口交流,名字必须逐字匹配,这是全框架的「契约」:

1.3 URDF 里的 ros2_control 描述块

URDF 描述机器人的几何与运动学,而 ros2_control 需要的「用什么硬件插件、每个关节暴露哪些接口」写在 URDF 的 <ros2_control> 标签里(通常单独放一个 xacro 文件再 <xacro:include> 进来)。一个最小示例:

<!-- 文件:ros2_control.xacro,被主 URDF xacro include -->
<ros2_control name="my_arm" type="system">
  <hardware>
    <plugin>hdrive_system/HDriveSystemHardware</plugin>
    <param name="can_interface">can0</param>
    <param name="motor_id">1</param>
    <param name="reduction_ratio">9.0</param>
  </hardware>
  <joint name="elbow_joint">
    <command_interface name="position"/>
    <command_interface name="effort"/>
    <state_interface name="position"/>
    <state_interface name="velocity"/>
    <state_interface name="effort"/>
  </joint>
</ros2_control>

• name + type:类型有 system(整机一个硬件插件,负责多个关节)、actuator(每个执行器一个插件,见第 4 节)、sensor(纯传感器);
• <hardware><plugin>:插件名 = pluginlib 里注册的类名;
• <joint> 下的接口名必须与硬件插件里 export_xxx_interfaces() 导出的名字一致;
• <param> 是传给硬件插件的初始化参数(总线名、电机 ID、减速比等),会出现在 on_init() 的 hardware_info 里。

1.4 实时性:为什么要 RT 线程

控制回路对周期确定性有硬要求:如果本该 1 ms 执行一次的回路偶尔卡到 5 ms,关节就会一顿一顿,力矩控制甚至可能发散。因此 ros2_control 的 controller_manager 以实时(RT)线程跑控制循环,要求:

• 固定的更新频率:update_rate 参数决定控制器调度频率(如 1000 Hz);
• 实时调度优先级:RT 线程需要 SCHED_FIFO 优先级,否则会被普通进程抢占导致抖动;
• 锁页内存:mlockall 防止内存被换页到磁盘,避免缺页中断破坏实时性;
• RT 循环内禁阻塞:控制器 update() 与硬件 read()/write() 里不能打日志、申请内存、做网络 I/O(这些会引入非确定延迟)。

2 controller_manager 详解

controller_manager 是所有控制器的生命周期管理器,它本身也是一个生命周期节点,配合命令行 ros2 control 完成「运行时动态增删控制器」而不重启整机——这是真机调试最重要的能力(改一个控制器不用重新拉起全部节点)。

2.1 生命周期(lifecycle)状态机

每个控制器都要走过一串状态:unconfigured → inactive → active,并可逆向 deactivate,最后 finalize(清理)。关键语义:

• unconfigured:已加载但未配置,还没申请到命令接口资源;
• inactive:已配置、接口已「预占」,但尚未运行(update() 不被调用);
• active:正在被 controller_manager 每个周期调度,真正读写接口。

「加载 ≠ 激活」是新手的头号坑:load 之后控制器停在 inactive,不 activate 就永远不干活。

2.2 命令行:ros2 control

官方命令行工具 ros2 control 提供完整的运行时管理(下方命令均已核实于官方 ros2controlcli 文档):

ros2 control list_controllers            # 列出所有已加载控制器及其状态(active/inactive/unconfigured)
ros2 control list_controller_types       # 列出本机可用的控制器插件类型
ros2 control list_hardware_interfaces    # 列出硬件导出的全部 state/command 接口(诊断神器)

ros2 control load_controller   joint_state_broadcaster        # 加载(进入 unconfigured)
ros2 control configure_controller joint_state_broadcaster     # 配置(进入 inactive)
ros2 control set_controller_state joint_state_broadcaster active   # 激活
ros2 control set_controller_state joint_state_broadcaster inactive # 停用
ros2 control unload_controller joint_state_broadcaster        # 卸载

2.3 controller_manager 的 yaml 配置

controller_manager 本身的参数(更新频率、是否用仿真时间)与各控制器的参数写在同一份 yaml 里,一起传给节点:

controller_manager:
  ros__parameters:
    update_rate: 1000          # 控制循环 Hz(务必与硬件能力匹配)
    use_sim_time: false

# 下面每个顶级 key 是一个「待 spawner 启动的控制器」名
joint_state_broadcaster:
  ros__parameters:
    type: joint_state_broadcaster/JointStateBroadcaster
    publish_rate: 100

arm_controller:
  ros__parameters:
    type: joint_trajectory_controller/JointTrajectoryController
    # ... 具体参数见第 3 节

注意 update_rate 是整机的控制频率,所有 active 控制器共享同一节奏;每个控制器内部再靠各自参数(如 publish_rate、state_publish_rate)做降频。

2.4 控制器切换:switch_controller

真机上经常要在「力控」与「位置轨迹」之间来回切(抓取时用力控柔顺,搬运时用轨迹)。切换不是「停了 A 再起 B」那么随意,因为两个控制器可能争抢同一个关节的命令接口——同一时刻一个关节的 position 命令接口只能被一个 active 控制器占用。切换靠:

# 同时停用 joint_group_effort_controller、激活 arm_controller
ros2 control switch_controllers \
  --deactivate joint_group_effort_controller \
  --activate arm_controller

# 带严格度与时间窗(不同版本参数名略有差异,以 distro 文档为准)
ros2 control switch_controllers \
  --activate arm_controller \
  --deactivate joint_group_effort_controller \
  --strictness STRICT \
  --activate-asap --deactivate-asap

3 常用控制器逐个配置

官方 ros2_controllers 仓库提供了一整套「开箱即用」的控制器,人形机器人关节模组最常用的四类如下(类型名均来自官方 controllers_index):

3.1 joint_state_broadcaster

它是最基础的控制器,只「读」不「写」:把硬件上报的关节状态整理成 sensor_msgs/msg/JointState 发布到 /joint_states,供 robot_state_publisher 计算 TF、供 MoveIt2 获取当前状态。它不申请任何命令接口,所以可以和轨迹控制器同时 active、互不冲突。

joint_state_broadcaster:
  ros__parameters:
    type: joint_state_broadcaster/JointStateBroadcaster
    publish_rate: 100     # /joint_states 发布频率 Hz
    extra_joints: []      # 额外并入的非受控关节名(可选)

# 启动 + 验证
ros2 run controller_manager spawner joint_state_broadcaster
ros2 control list_controllers          # 应看到 joint_state_broadcaster : active
ros2 topic echo /joint_states          # 应能看到 position/velocity 数组在跳动

3.2 joint_trajectory_controller(轨迹控制器,核心)

它是 MoveIt2 真机执行的主力:通过 FollowJointTrajectory action 接收一条带时间戳的轨迹,在控制周期内做样条插值,把每个采样点的期望位置/速度下发到命令接口。参数(已核实官方 userdoc):

arm_controller:
  ros__parameters:
    type: joint_trajectory_controller/JointTrajectoryController
    joints:                       # 受控关节列表,顺序即命令数组顺序
      - shoulder_pan_joint
      - shoulder_lift_joint
      - elbow_joint
      - wrist_1_joint
    command_interfaces:           # 申请的命令接口(位置模式)
      - position
    state_interfaces:
      - position
      - velocity
    state_publish_rate: 50.0      # 控制器状态回传频率
    action_monitor_rate: 20.0     # action 目标监控频率
    allow_partial_joints_goal: false   # 是否允许只给部分关节下目标
    constraints:
      stopped_velocity_tolerance: 0.01  # 判定「已停止」的速度容差
      goal_time: 0.0                    # 目标允许的到达时间余量

ros2 run controller_manager spawner arm_controller
ros2 control list_controllers        # arm_controller : active
# 发一条「各关节回到 0」的轨迹(action 方式,3 秒走完)
ros2 action send_goal /arm_controller/follow_joint_trajectory \
  control_msgs/action/FollowJointTrajectory \
  "{trajectory: {joint_names: [shoulder_pan_joint, shoulder_lift_joint, elbow_joint, wrist_1_joint],
     points: [{positions: [0.0, 0.0, 0.0, 0.0], time_from_start: {sec: 3, nanosec: 0}}]}}"

3.3 joint_group_effort_controller(力矩组控制器)

它把 std_msgs/msg/Float64MultiArray 话题上的一组力矩值,直接映射到一组关节的 effort 命令接口。常用于重力补偿、拖动示教、以及纯力矩的力控实验。注意它不做闭环,只是开环「你给多少我就下发多少」。

effort_controller:
  ros__parameters:
    type: effort_controllers/JointGroupEffortController
    joints:
      - elbow_joint
      - wrist_1_joint
    command_interfaces:
      - effort
    state_interfaces:
      - position
      - velocity

ros2 run controller_manager spawner effort_controller
# 给两个关节各下发 0.5 / -0.3 的力矩(单位通常为 N·m)
ros2 topic pub /effort_controller/commands std_msgs/msg/Float64MultiArray \
  "{data: [0.5, -0.3]}"

3.4 forward_command_controller(前馈/透传控制器)

它把 std_msgs/msg/Float64MultiArray 话题值原样写进指定的一种命令接口。比 joint_group_effort_controller 更通用:interface_name 参数决定透传的是 position、velocity 还是 effort。适合手动点动、单关节测试、或把自定义高层控制器的输出直接送入底层。

forward_position_controller:
  ros__parameters:
    type: forward_command_controller/ForwardCommandController
    joints:
      - elbow_joint
    interface_name: position     # 透传到 position 命令接口
    # interface_name: velocity / effort   # 也可透传速度或力矩

ros2 run controller_manager spawner forward_position_controller
ros2 topic pub /forward_position_controller/commands std_msgs/msg/Float64MultiArray \
  "{data: [0.78]}"   # 让 elbow_joint 走到约 0.78 rad

4 自定义硬件接口实战

官方控制器覆盖了「控制律」,但「硬件」千差万别:你的关节模组可能是 CAN 总线的宇树电机、是 EtherCAT 伺服、也可能只是一块开发板发 PWM。这部分必须自己写 hardware_interface 插件。核心是继承 hardware_interface::SystemInterface(整机)或 ActuatorInterface(单个执行器),实现一组标准虚函数。

4.1 SystemInterface vs ActuatorInterface

人形机器人「每个关节模组一个独立电机」的形态,既可以用一个大 SystemInterface 统一收发,也可以用多个 ActuatorInterface 每个模组一个插件(更模块化,便于单个模组热插拔)。下面以 SystemInterface 为例,ActuatorInterface 只是把「多个关节」换成「单个关节」、虚函数签名略有差异。

4.2 必须实现的虚函数

• on_init(hardware_info):从 URDF 的 ros2_control 块读关节名、接口名、param,初始化数据结构;
• export_state_interfaces() / export_command_interfaces():把「我提供哪些状态/命令接口」上报给框架,名字与 URDF 必须一致;
• on_configure() / on_activate():打开总线、使能电机(activate 后电机才能上力矩);
• read():从硬件读编码器/电流,写进 state 变量;
• write():把 command 变量(控制器刚写的期望值)发给电机;
• on_deactivate() / on_shutdown():停机、关闭总线。

4.3 C++ 骨架:读编码器、写力矩

#include <hardware_interface/system_interface.hpp>
#include <hardware_interface/types/hardware_interface_return_values.hpp>
#include <hardware_interface/types/hardware_interface_type_values.hpp>
#include <pluginlib/class_list_macros.hpp>
#include <rclcpp/rclcpp.hpp>
#include <vector>
#include <string>

namespace hdrive_system
{
class HDriveSystemHardware : public hardware_interface::SystemInterface
{
public:
  hardware_interface::CallbackReturn on_init(
      const hardware_interface::HardwareInfo & info) override
  {
    if (hardware_interface::SystemInterface::on_init(info) !=
        hardware_interface::CallbackReturn::SUCCESS)
      return hardware_interface::CallbackReturn::ERROR;
    // 读 URDF 里的参数(总线名、电机 ID、减速比等)
    can_interface_ = info_.hardware_parameters.at("can_interface");
    motor_id_ = std::stoi(info_.hardware_parameters.at("motor_id"));
    joint_name_ = info_.joints[0].name;
    // 为每个状态/命令接口分配存储
    position_state_ = 0.0;
    velocity_state_ = 0.0;
    effort_state_ = 0.0;
    effort_command_ = 0.0;
    return hardware_interface::CallbackReturn::SUCCESS;
  }

  std::vector<hardware_interface::StateInterface>
  export_state_interfaces() override
  {
    std::vector<hardware_interface::StateInterface> state;
    // 接口名必须与 URDF <state_interface> 一致
    state.emplace_back(joint_name_, "position", &position_state_);
    state.emplace_back(joint_name_, "velocity", &velocity_state_);
    state.emplace_back(joint_name_, "effort", &effort_state_);
    return state;
  }

  std::vector<hardware_interface::CommandInterface>
  export_command_interfaces() override
  {
    std::vector<hardware_interface::CommandInterface> cmd;
    // 只导出 effort 命令接口(力矩模式);要位置模式就加 "position"
    cmd.emplace_back(joint_name_, "effort", &effort_command_);
    return cmd;
  }

  hardware_interface::CallbackReturn on_activate(
      const rclcpp_lifecycle::State &) override
  {
    // 打开 CAN、使能电机(上电使能)
    open_can(can_interface_);
    enable_motor(motor_id_);
    return hardware_interface::CallbackReturn::SUCCESS;
  }

  hardware_interface::return_type read(
      const rclcpp::Time &, const rclcpp::Duration &) override
  {
    // 从总线读编码器(角位移)→ 换算关节角(除以减速比)→ 写状态
    double raw = read_encoder(motor_id_);
    position_state_ = raw / reduction_ratio_;
    // 速度、力矩可在此处一并估算/读取
    return hardware_interface::return_type::OK;
  }

  hardware_interface::return_type write(
      const rclcpp::Time &, const rclcpp::Duration &) override
  {
    // 把期望力矩换算成电机电流/占空比后写入总线
    double current = effort_command_ * torque_to_current_;  // N·m → A
    write_current(motor_id_, current);
    return hardware_interface::return_type::OK;
  }

private:
  std::string joint_name_, can_interface_;
  int motor_id_ = 0;
  double reduction_ratio_ = 1.0, torque_to_current_ = 1.0;
  double position_state_ = 0.0, velocity_state_ = 0.0, effort_state_ = 0.0;
  double effort_command_ = 0.0;
};

}  // namespace hdrive_system

// pluginlib 注册:类名、命名空间类、基类
PLUGINLIB_EXPORT_CLASS(hdrive_system::HDriveSystemHardware,
                       hardware_interface::SystemInterface)

4.4 插件注册与构建(pluginlib / CMakeLists / package.xml)

硬件插件靠 pluginlib 机制被发现:编译产物是一个共享库,配一个 XML 清单声明「库里有哪个类、继承哪个基类」。三件套:

<!-- 文件:config/hdrive_system_plugin.xml -->
<library path="hdrive_system_hardware">
  <class name="hdrive_system/HDriveSystemHardware"
         type="hdrive_system::HDriveSystemHardware"
         base_class_type="hardware_interface::SystemInterface">
    <description>HDrive 关节模组硬件接口(CAN 收发)</description>
  </class>
</library>

# CMakeLists.txt 关键片段
find_package(ament_cmake REQUIRED)
find_package(hardware_interface REQUIRED)
find_package(pluginlib REQUIRED)
find_package(rclcpp REQUIRED)
find_package(rclcpp_lifecycle REQUIRED)

add_library(hdrive_system_hardware src/hdrive_system_hardware.cpp)
target_include_directories(hdrive_system_hardware PRIVATE include)
ament_target_dependencies(hdrive_system_hardware
  hardware_interface pluginlib rclcpp rclcpp_lifecycle)

# 安装插件库与插件清单
pluginlib_export_plugin_description_file(hardware_interface config/hdrive_system_plugin.xml)
install(TARGETS hdrive_system_hardware
  ARCHIVE DESTINATION lib
  LIBRARY DESTINATION lib
  RUNTIME DESTINATION bin)
install(DIRECTORY config DESTINATION share/${PROJECT_NAME})
ament_export_dependencies(hardware_interface pluginlib rclcpp rclcpp_lifecycle)
ament_package()

<!-- package.xml 关键片段 -->
<depend>hardware_interface</depend>
<depend>pluginlib</depend>
<depend>rclcpp</depend>
<depend>rclcpp_lifecycle</depend>
<export>
  <build_type>ament_cmake</build_type>
</export>

编译后验证插件是否被找到:ros2 control list_hardware_components 里应能看到 hdrive_system/HDriveSystemHardware。

5 与真实关节模组对接

关节模组的「硬件接口」本质就是一条通信总线的收发封装:CAN、EtherCAT、RS485、甚至 USB 串口。适配思路万变不离其宗——把「总线协议读写」隔离在 read()/write() 里,让上层控制器只看到标准的 position/velocity/effort 接口。

5.1 三类主流模组的适配思路

通用适配三步:① 写通信驱动(CAN 初始化、报文编解码、超时处理)→ ② 封装硬件接口(把「电机量」换算到「关节量」,乘/除减速比)→ ③ 在 URDF ros2_control 块声明接口与参数(总线名、电机 ID、减速比、力矩-电流系数)。

5.2 写 test 模式(模拟硬件)

真机到手前,先用模拟硬件把整套 ros2_control + MoveIt2 跑通,能提前暴露 90% 的配置错误。两种做法:

• 官方 mock_components:ros2_control 自带 mock_components/GenericSystem,不接任何真实硬件,read() 直接把「上次写入的命令」当状态回读(即假设电机瞬时到位)。适合测控制器与 MoveIt2 的配置正确性。
• 仿真插件:gazebo_ros2_control / ign_ros2_control 把 ros2_control 的接口接到仿真器的物理关节,能验证动力学与闭环,代价是要配 URDF 的仿真插件。

<!-- URDF 用 mock 组件做 test 模式(GenericSystem,type 为 system) -->
<ros2_control name="my_arm" type="system">
  <hardware>
    <plugin>mock_components/GenericSystem</plugin>
  </hardware>
  <joint name="elbow_joint">
    <command_interface name="position"/>
    <state_interface name="position"/>
    <state_interface name="velocity"/>
  </joint>
</ros2_control>

6 与 MoveIt2 串联:从规划到执行

MoveIt2 只做「规划」,不直接发电机指令。全链路:MoveIt2 规划 → 发布 control_msgs/action/FollowJointTrajectory 目标 → joint_trajectory_controller 逐周期插值写 position/velocity → hardware_interface 写电机/读编码器 → 关节模组,编码器反馈再沿 state 接口回到控制器形成闭环。

6.1 move_group 侧的 ros2_control 配置

MoveIt2 需要知道「规划组 arm 该把轨迹发给哪个 action、用哪个控制器」。在 moveit_config 包里配 ros2_controllers.yaml(控制器名、类型、关节、action 命名空间),并让 moveit_controller_manager 加载它:

# moveit_config/config/ros2_controllers.yaml
controller_manager:
  ros__parameters:
    update_rate: 1000

arm_controller:
  ros__parameters:
    type: joint_trajectory_controller/JointTrajectoryController
    joints:
      - shoulder_pan_joint
      - shoulder_lift_joint
      - elbow_joint
      - wrist_1_joint
    command_interfaces:
      - position
    state_interfaces:
      - position
      - velocity

# MoveIt 侧:moveit_controller_manager 的控制器声明
moveit_controller_manager: moveit_simple_controller_manager/MoveItSimpleControllerManager
moveit_simple_controller_manager:
  controller_names:
    - arm_controller
  arm_controller:
    action_ns: follow_joint_trajectory   # action 命名空间
    type: FollowJointTrajectory
    default: true
    joints:
      - shoulder_pan_joint
      - shoulder_lift_joint
      - elbow_joint
      - wrist_1_joint

6.2 真机调试流程(减速起步)

7 关节模式切换与力控/阻抗

人形机器人关节模组很少「一种模式跑到底」:定位用位置模式,柔顺拖动用速度/力矩模式,接触作业要力控/阻抗控制。ros2_control 支持同一关节暴露多个命令接口,由「当前激活哪个控制器」决定走哪条命令通道。

7.1 位置/速度/力矩模式如何切换

在 URDF 里给关节同时声明三种命令接口,然后配三个控制器各占一种:

<joint name="elbow_joint">
  <command_interface name="position"/>
  <command_interface name="velocity"/>
  <command_interface name="effort"/>
  <state_interface name="position"/>
  <state_interface name="velocity"/>
  <state_interface name="effort"/>
</joint>

切换就是「换一个 active 控制器」:ros2 control switch_controllers --deactivate arm_position_controller --activate arm_effort_controller。因为三个控制器各申请不同的命令接口(position / velocity / effort),理论上可同时 active;但同一类接口(如两个都申请 position)则互斥,必须切。

7.2 笛卡尔力控与阻抗控制的实现思路

• 关节力矩控制(基础):用 effort_controllers/JointGroupEffortController 直接下发关节力矩,配合重力/摩擦补偿,是最底层的力控单元;
• 阻抗/导纳控制(关节空间):经典阻抗律 τ = K(q_d − q) + D(q̇_d − q̇) + 重力补偿,可自己写一个 controller 插件,在 update() 里读位置/速度状态、按阻抗律算出 effort 写回;或把 K/D 增益下沉到电机 MIT 模式(CyberGear/宇树电机都支持)由底层执行;
• 笛卡尔力控:需要在末端加六维力/力矩传感器(F/T sensor),经 force_torque_sensor_broadcaster 广播到话题,上层再算「末端力 → 关节力矩」的雅可比转置映射,交给 effort 接口。MoveIt 侧的 moveit_servo 亦可配合做实时伺服。

8 常见坑与调试

8.1 实时权限配置(优先级 + 锁页内存)

# ① 给实时用户组配置 rtprio 与 memlock(/etc/security/limits.d/ros2_rt.conf)
@realtime  -  rtprio  98
@realtime  -  memlock unlimited

# ② 把运行用户加入 realtime 组,重新登录生效
sudo usermod -a -G realtime $USER

# ③(可选)给 controller_manager 可执行文件授予调度能力,免 root
sudo setcap cap_sys_nice+ep /opt/ros/humble/lib/controller_manager/controller_manager

# ④ 验证:应分别显示 98 与 unlimited
ulimit -r; ulimit -l

8.2 诊断命令速查

ros2 control list_controllers          # 谁 active / 谁 inactive / 谁配置失败
ros2 control list_hardware_interfaces  # 硬件到底导出了哪些 state/command 接口
ros2 control list_controller_types     # 有哪些控制器插件可加载
ros2 topic echo /joint_states          # 状态流是否在动

9 本节自测

10 参考来源

• ros2_control 官方文档(总入口)
• ros2_control · Command Line Interface(ros2 control 命令行)
• controller_manager 官方用户文档
• joint_trajectory_controller 官方用户文档
• joint_state_broadcaster 官方用户文档
• ros2_controllers GitHub 仓库(控制器索引 controllers_index)
• ros2_control · Hardware Interface Types(SystemInterface / ActuatorInterface / SensorInterface)
• ros2_control · Writing a Hardware Component(硬件组件开发指南)
• ros2_control_demos GitHub 仓库(官方示例 example_1~example_N)
• MoveIt2 · Controller Configuration 教程(moveit 与 ros2_control 集成)
• 宇树官方 unitree_ros 仓库(电机 SDK 与描述文件)
• cybergear_ros2(小米 CyberGear 的 ROS2 适配,社区)
• CyberGear 指令手册整理(cybergear-docs,CAN/MIT 模式)
• 本站 04-13 · MoveIt2 进阶:运动规划与抓取管线(本页前置,讲规划层)
• 本站 04-10 · ROS2 实战进阶:URDF 与 MoveIt2(ros2_control 入门)

资料整理更新至 2026-08;包名、命令与配置项已用 web_search 对照官方文档核实,不同 distro 的参数名与弃用状态可能略有差异,文中未能逐一核实之处均标注「约」,请以当前版本官方文档为准。