從零創建學習工作區

從這裏開始，由你創建自己的工作區。先用 GenericSystem 跑通配置鏈路，再換成自編硬件插件。

1.示例 1：創建目錄與功能包

source /opt/ros/jazzy/setup.bash
mkdir -p ~/ros2_control_jazzy_ws/src
cd ~/ros2_control_jazzy_ws/src
ros2 pkg create jazzy_control_hardware --build-type ament_cmake
cd jazzy_control_hardware
mkdir -p urdf config launch src include/jazzy_control_hardware

所有文件都由你跟隨文章建立。後面的相對路徑以 jazzy_control_hardware 包目錄為起點。

jazzy_control_hardware/
├── CMakeLists.txt
├── package.xml
├── urdf/two_joint.urdf
├── config/
├── launch/
├── src/
└── include/jazzy_control_hardware/

1.1.完整 package.xml

<?xml version="1.0"?>
<package format="3">
  <name>jazzy_control_hardware</name><version>0.1.0</version>
  <description>Jazzy two joint learning hardware and models</description>
  <maintainer email="learner@example.com">Learner</maintainer><license>Apache-2.0</license>
  <buildtool_depend>ament_cmake</buildtool_depend>
  <depend>hardware_interface</depend><depend>pluginlib</depend>
  <depend>rclcpp</depend><depend>rclcpp_lifecycle</depend>
  <exec_depend>controller_manager</exec_depend>
  <exec_depend>joint_state_broadcaster</exec_depend>
  <exec_depend>forward_command_controller</exec_depend>
  <exec_depend>joint_trajectory_controller</exec_depend>
  <exec_depend>robot_state_publisher</exec_depend><exec_depend>xacro</exec_depend>
  <exec_depend>launch_ros</exec_depend>
  <export><build_type>ament_cmake</build_type></export>
</package>

maintainer 是示例身份，請換成自己的信息。本文件列出了基礎階段所需依賴。

1.2.當前階段的完整 CMakeLists.txt

cmake_minimum_required(VERSION 3.22)
project(jazzy_control_hardware)
find_package(ament_cmake REQUIRED)
install(DIRECTORY urdf config launch DESTINATION share/${PROJECT_NAME})
ament_package()

現在只安裝資源文件，還沒有構建 C++ 庫。install 讓 launch 可以通過包的 share 路徑找到模型。

2.示例 2：編寫完整機械人描述

保存為 urdf/two_joint.urdf：

<?xml version="1.0"?>
<robot name="mini">

  <link name="world"/>
  <link name="base_link">
    <inertial><mass value="1"/><inertia ixx="0.005" ixy="0" ixz="0" iyy="0.005" iyz="0" izz="0.007"/></inertial>
    <visual><geometry><box size="0.2 0.2 0.1"/></geometry></visual>
  </link>
  <joint name="world_fixed" type="fixed"><parent link="world"/><child link="base_link"/></joint>

  <link name="link1">
    <inertial><origin xyz="0 0 0.2"/><mass value="1"/>
      <inertia ixx="0.0135" ixy="0" ixz="0" iyy="0.0135" iyz="0" izz="0.00042"/>
    </inertial>
    <visual><origin xyz="0 0 0.2"/><geometry><box size="0.05 0.05 0.4"/></geometry></visual>
    <collision><origin xyz="0 0 0.2"/><geometry><box size="0.05 0.05 0.4"/></geometry></collision>
  </link>
  <joint name="joint1" type="revolute">
    <parent link="base_link"/><child link="link1"/>
    <origin xyz="0 0 0.05"/><axis xyz="0 1 0"/>
    <limit lower="-1" upper="1" effort="20" velocity="2"/>
  </joint>

  <link name="link2">
    <inertial><origin xyz="0 0 0.2"/><mass value="1"/>
      <inertia ixx="0.0135" ixy="0" ixz="0" iyy="0.0135" iyz="0" izz="0.00042"/>
    </inertial>
    <visual><origin xyz="0 0 0.2"/><geometry><box size="0.05 0.05 0.4"/></geometry></visual>
    <collision><origin xyz="0 0 0.2"/><geometry><box size="0.05 0.05 0.4"/></geometry></collision>
  </link>
  <joint name="joint2" type="revolute">
    <parent link="link1"/><child link="link2"/>
    <origin xyz="0 0 0.4"/><axis xyz="0 1 0"/>
    <limit lower="-1" upper="1" effort="20" velocity="2"/>
  </joint>

  <ros2_control name="MiniSystem" type="system">
    <hardware><plugin>mock_components/GenericSystem</plugin></hardware>
    <joint name="joint1">
      <command_interface name="position"/>
      <state_interface name="position"><param name="initial_value">0.0</param></state_interface>
      <state_interface name="velocity"/>
    </joint>
    <joint name="joint2">
      <command_interface name="position"/>
      <state_interface name="position"><param name="initial_value">0.0</param></state_interface>
      <state_interface name="velocity"/>
    </joint>
  </ros2_control>
</robot>

兩個關節分別連接 base_link、link1、link2；world_fixed 固定基座。模型中的慣量與碰撞用於後續仿真準備，GenericSystem 不根據它們計算動力學。

3.構建並檢查

cd ~/ros2_control_jazzy_ws
colcon build --symlink-install --packages-select jazzy_control_hardware
source install/setup.bash

ros2 pkg prefix jazzy_control_hardware
xacro src/jazzy_control_hardware/urdf/two_joint.urdf > /tmp/two_joint.urdf

此階段驗收包和模型是否能找到、解析，不要求機械人已經運動。YAML與spawner啓動過程會補齊啓動所需文件。

---

返回 Jazzy 總覽 · 上一篇：運行第一個RRBot實例 · 下一篇：URDF與控制接口