Skip to content

🦾 UPPERLIMB 子系统 ​

📊 接口概览 ​


📦 Services (70) ​

1. CartesianPlanningParamsGet ​

字段值
Service Name/zj_humanoid/upperlimb/CartesianPlanningParamsGet
Typeupperlimb/CartesianPlanningParamsGet
Description获取笛卡尔规划参数
Note1.4 新增

2. CartesianPlanningParamsSet ​

字段值
Service Name/zj_humanoid/upperlimb/CartesianPlanningParamsSet
Typeupperlimb/CartesianPlanningParamsSet
Description设置笛卡尔规划参数
Note1.4 新增

3. FK/left_arm ​

字段值
Service Name/zj_humanoid/upperlimb/FK/left_arm
Typeupperlimb/FK
Description左臂正解

4. FK/right_arm ​

字段值
Service Name/zj_humanoid/upperlimb/FK/right_arm
Typeupperlimb/FK
Description右臂正解

5. FK/whole_body ​

字段值
Service Name/zj_humanoid/upperlimb/FK/whole_body
Typeupperlimb/FK
Description全身运动学正解
Note1.4 新增;2.0.0 响应增加 arm_type 和 arm_type_array

6. IK/left_arm ​

字段值
Service Name/zj_humanoid/upperlimb/IK/left_arm
Typeupperlimb/IK
Description左臂逆解
Note左臂逆解

7. IK/right_arm ​

字段值
Service Name/zj_humanoid/upperlimb/IK/right_arm
Typeupperlimb/IK
Description右臂逆解

8. IK/whole_body ​

字段值
Service Name/zj_humanoid/upperlimb/IK/whole_body
Typeupperlimb/IK
Description全身运动学逆解
Note双臂求解时 pose 数组需包含两个目标位姿

9. basic_info ​

字段值
Service Name/zj_humanoid/upperlimb/basic_info
Typeupperlimb/BasicInfoGet
Description获取当前机型上肢部位与关节信息
Note上肢 2.0.0 新增,返回可用部位掩码、关节总数和部位列表

10. clear_servo_params ​

字段值
Service Name/zj_humanoid/upperlimb/clear_servo_params
Typeupperlimb/Servo
Description清除伺服参数
Note清除上肢伺服参数配置

11. collision_detection/enable ​

字段值
Service Name/zj_humanoid/upperlimb/collision_detection/enable
Typestd_srvs/SetBool
Description启用或停用碰撞保护
Note1.3 新增

12. collision_detection/get_params ​

字段值
Service Name/zj_humanoid/upperlimb/collision_detection/get_params
Typeupperlimb/ParamsGet
Description获取碰撞保护参数

13. collision_detection/set_params ​

字段值
Service Name/zj_humanoid/upperlimb/collision_detection/set_params
Typeupperlimb/ParamsSet
Description设置碰撞保护参数

14. enable_speedj ​

字段值
Service Name/zj_humanoid/upperlimb/enable_speedj
Typestd_srvs/SetBool
Description关节速度控制开关
Note启用或禁用上肢speedj速度控制模式

15. enable_speedl ​

字段值
Service Name/zj_humanoid/upperlimb/enable_speedl
Typestd_srvs/SetBool
Description启用笛卡尔空间速度控制
Note启用或禁用上肢speedl笛卡尔空间速度控制模式

16. go_down/dual_arm ​

字段值
Service Name/zj_humanoid/upperlimb/go_down/dual_arm
Typestd_srvs/Trigger
Description双臂放下

17. go_down/left_arm ​

字段值
Service Name/zj_humanoid/upperlimb/go_down/left_arm
Typestd_srvs/Trigger
Description左臂放下

18. go_down/right_arm ​

字段值
Service Name/zj_humanoid/upperlimb/go_down/right_arm
Typestd_srvs/Trigger
Description右臂放下

19. go_home/dual_arm ​

字段值
Service Name/zj_humanoid/upperlimb/go_home/dual_arm
Typestd_srvs/Trigger
Description双臂回到home点
Note双臂回到内置设置的home点

20. go_home/left_arm ​

字段值
Service Name/zj_humanoid/upperlimb/go_home/left_arm
Typestd_srvs/Trigger
Description左臂回到home点
Note左臂回到内置设置的home点

21. go_home/lifting ​

字段值
Service Name/zj_humanoid/upperlimb/go_home/lifting
Typestd_srvs/Trigger
Description升降回到home点
Note升降回到内置设置的home点

22. go_home/neck ​

字段值
Service Name/zj_humanoid/upperlimb/go_home/neck
Typestd_srvs/Trigger
Description脖子回到home点
Note脖子回到内置设置的home点

23. go_home/right_arm ​

字段值
Service Name/zj_humanoid/upperlimb/go_home/right_arm
Typestd_srvs/Trigger
Description右臂回到home点
Note右臂回到内置设置的home点

24. go_home/waist ​

字段值
Service Name/zj_humanoid/upperlimb/go_home/waist
Typestd_srvs/Trigger
Description腰部回到home点
Note腰部回到内置设置的home点

25. go_home/whole_body ​

字段值
Service Name/zj_humanoid/upperlimb/go_home/whole_body
Typeupperlimb/ArmType
Description全身回到home点
Note全身指定部位回到内置设置的home点

26. is_singular/left_arm ​

字段值
Service Name/zj_humanoid/upperlimb/is_singular/left_arm
Typestd_srvs/Trigger
Description检查左臂奇异点
Note检查左臂当前位置是否处于奇异点配置

27. is_singular/right_arm ​

字段值
Service Name/zj_humanoid/upperlimb/is_singular/right_arm
Typestd_srvs/Trigger
Description检查右臂奇异点
Note检查右臂当前位置是否处于奇异点配置

28. is_singular/whole_body ​

字段值
Service Name/zj_humanoid/upperlimb/is_singular/whole_body
Typeupperlimb/IsSingular
Description检查全身目标位姿是否奇异
Note1.4 新增

29. jacobian ​

字段值
Service Name/zj_humanoid/upperlimb/jacobian
Typeupperlimb/JacobianMatrixGet
Description获取雅可比矩阵
Note通过请求中的 arm_type 选择左臂、右臂或全身

30. motion/lists ​

字段值
Service Name/zj_humanoid/upperlimb/motion/lists
Typeupperlimb/FilesLists
Description获取动作列表
Note获取可用的预定义动作列表

31. motion/load ​

字段值
Service Name/zj_humanoid/upperlimb/motion/load
Typeupperlimb/MotionsManage
Description加载动作文件
Note从文件加载预定义动作到内存

32. motion/loaded_lists ​

字段值
Service Name/zj_humanoid/upperlimb/motion/loaded_lists
Typeupperlimb/MotionsLoadedList
Description获取已加载动作列表
Note获取当前已加载到内存的动作列表

33. motion/unload ​

字段值
Service Name/zj_humanoid/upperlimb/motion/unload
Typeupperlimb/MotionsManage
Description卸载动作文件
Note从内存中卸载指定的预定义动作

34. movej/dual_arm ​

字段值
Service Name/zj_humanoid/upperlimb/movej/dual_arm
Typeupperlimb/MoveJ
Description双臂movej
Note关节空间下,双臂点到点运动

35. movej/left_arm ​

字段值
Service Name/zj_humanoid/upperlimb/movej/left_arm
Typeupperlimb/MoveJ
Description左臂movej
Note关节空间下,左臂点到点运动

36. movej/lifting ​

字段值
Service Name/zj_humanoid/upperlimb/movej/lifting
Typeupperlimb/MoveJ
Description升降movej
Note关节空间下,升降点到点运动

37. movej/neck ​

字段值
Service Name/zj_humanoid/upperlimb/movej/neck
Typeupperlimb/MoveJ
Description脖子movej
Note关节空间下,脖子点到点运动

38. movej/right_arm ​

字段值
Service Name/zj_humanoid/upperlimb/movej/right_arm
Typeupperlimb/MoveJ
Description右臂movej
Note关节空间下,右臂点到点运动

39. movej/waist ​

字段值
Service Name/zj_humanoid/upperlimb/movej/waist
Typeupperlimb/MoveJ
Description腰部movej
Note关节空间下,腰部点到点运动

40. movej/whole_body ​

字段值
Service Name/zj_humanoid/upperlimb/movej/whole_body
Typeupperlimb/MoveJ
Description全身movej
Note关节空间下,全身各部位点到点运动

41. movej_by_path/dual_arm ​

字段值
Service Name/zj_humanoid/upperlimb/movej_by_path/dual_arm
Typeupperlimb/MoveJByPath
Description双臂轨迹movej
Note关节空间下,双臂轨迹点路径运动

42. movej_by_path/left_arm ​

字段值
Service Name/zj_humanoid/upperlimb/movej_by_path/left_arm
Typeupperlimb/MoveJByPath
Description左臂轨迹movej
Note关节空间下,左臂轨迹点路径运动

43. movej_by_path/lifting ​

字段值
Service Name/zj_humanoid/upperlimb/movej_by_path/lifting
Typeupperlimb/MoveJByPath
Description关节空间下,脖子轨迹点路径运动
Note控制颈部按照关节空间路径运动

44. movej_by_path/neck ​

字段值
Service Name/zj_humanoid/upperlimb/movej_by_path/neck
Typeupperlimb/MoveJByPath
Description关节空间下,脖子轨迹点路径运动
Note控制颈部按照关节空间路径运动

45. movej_by_path/right_arm ​

字段值
Service Name/zj_humanoid/upperlimb/movej_by_path/right_arm
Typeupperlimb/MoveJByPath
Description右臂轨迹movej
Note关节空间下,右臂轨迹点路径运动

46. movej_by_path/waist ​

字段值
Service Name/zj_humanoid/upperlimb/movej_by_path/waist
Typeupperlimb/MoveJByPath
Description关节空间下,腰部轨迹点路径运动
Note控制腰部按照关节空间路径运动

47. movej_by_path/whole_body ​

字段值
Service Name/zj_humanoid/upperlimb/movej_by_path/whole_body
Typeupperlimb/MoveJByPath
Description关节空间下,全身轨迹点路径运动
Note控制全身按照关节空间路径运动

48. movej_by_pose/dual_arm ​

字段值
Service Name/zj_humanoid/upperlimb/movej_by_pose/dual_arm
Typeupperlimb/MoveJByPose
Description双臂末端movej
Notetcp末端空间下,双臂末端位姿movej

49. movej_by_pose/left_arm ​

字段值
Service Name/zj_humanoid/upperlimb/movej_by_pose/left_arm
Typeupperlimb/MoveJByPose
Description左臂末端movej
Notetcp末端空间下,左臂末端位姿movej

50. movej_by_pose/right_arm ​

字段值
Service Name/zj_humanoid/upperlimb/movej_by_pose/right_arm
Typeupperlimb/MoveJByPose
Description右臂末端movej
Notetcp末端空间下,右臂末端位姿movej

51. movej_by_pose/whole_body ​

字段值
Service Name/zj_humanoid/upperlimb/movej_by_pose/whole_body
Typeupperlimb/MoveJByPose
Description通过目标位姿进行全身关节空间规划
Note1.4 新增

52. movel/dual_arm ​

字段值
Service Name/zj_humanoid/upperlimb/movel/dual_arm
Typeupperlimb/MoveL
Description双臂movel
Note关节空间下,双臂直线轨迹点运动

53. movel/left_arm ​

字段值
Service Name/zj_humanoid/upperlimb/movel/left_arm
Typeupperlimb/MoveL
Description左臂movel
Note关节空间下,左臂直线轨迹点运动

54. movel/right_arm ​

字段值
Service Name/zj_humanoid/upperlimb/movel/right_arm
Typeupperlimb/MoveL
Description右臂movel
Note关节空间下,右臂直线轨迹点运动

55. movel/whole_body ​

字段值
Service Name/zj_humanoid/upperlimb/movel/whole_body
Typeupperlimb/MoveL
Description全身笛卡尔直线点运动
Note1.4 新增

56. movel_by_path/dual_arm ​

字段值
Service Name/zj_humanoid/upperlimb/movel_by_path/dual_arm
Typeupperlimb/MoveJByPath
Description双臂轨迹movej
Note关节空间下,双臂轨迹点路径运动

57. movel_by_path/left_arm ​

字段值
Service Name/zj_humanoid/upperlimb/movel_by_path/left_arm
Typeupperlimb/MoveJByPath
Description左臂轨迹movej
Note关节空间下,左臂轨迹点路径运动

58. movel_by_path/right_arm ​

字段值
Service Name/zj_humanoid/upperlimb/movel_by_path/right_arm
Typeupperlimb/MoveJByPath
Description右臂轨迹movej
Note关节空间下,右臂轨迹点路径运动

59. movel_by_path/whole_body ​

字段值
Service Name/zj_humanoid/upperlimb/movel_by_path/whole_body
Typeupperlimb/MoveLByPath
Description全身笛卡尔直线路径运动
Note1.4 新增

60. payload/get ​

字段值
Service Name/zj_humanoid/upperlimb/payload/get
Typeupperlimb/PayLoadGet
Description获取末端负载

61. payload/set ​

字段值
Service Name/zj_humanoid/upperlimb/payload/set
Typeupperlimb/PayLoadSet
Description设置末端负载

62. safety_lock ​

字段值
Service Name/zj_humanoid/upperlimb/safety_lock
Typestd_srvs/Trigger
Description安全锁定
Note启用上肢安全锁定,防止意外运动

63. set_servo_params ​

字段值
Service Name/zj_humanoid/upperlimb/set_servo_params
Typeupperlimb/Servo
Description设置伺服参数
Note设置上肢伺服参数配置,包括时间和增益参数

64. stop ​

字段值
Service Name/zj_humanoid/upperlimb/stop
Typestd_srvs/Trigger
Description停止上肢运动
Note立即停止上肢所有运动

65. teach_mode/enter ​

字段值
Service Name/zj_humanoid/upperlimb/teach_mode/enter
Typeupperlimb/ArmType
Description进入示教模式

66. teach_mode/exit ​

字段值
Service Name/zj_humanoid/upperlimb/teach_mode/exit
Typeupperlimb/ArmType
Description退出示教模式

67. teach_mode/lists ​

字段值
Service Name/zj_humanoid/upperlimb/teach_mode/lists
Typeupperlimb/FilesLists
Description获取拖动示教轨迹列表

68. teach_mode/stop_record ​

字段值
Service Name/zj_humanoid/upperlimb/teach_mode/stop_record
Typestd_srvs/Trigger
Description停止记录拖动示教轨迹

69. unlock ​

字段值
Service Name/zj_humanoid/upperlimb/unlock
Typestd_srvs/Trigger
Description解除锁定
Note解除上肢安全锁定,允许运动控制

70. version ​

字段值
Service Name/zj_humanoid/upperlimb/version
Typestd_srvs/Trigger
Description上肢版本信息
Note查询上肢控制模块的版本信息

📡 Topics (32) ​

1. upperlimb/from_algo ​

字段值
Topic Name/zj_humanoid/sim/upperlimb/from_algo
Typeupperlimb/Joints
Direction📥 Subscribe
Description上肢算法输出仿真
Note1.3 新增

2. upperlimb/to_algo ​

字段值
Topic Name/zj_humanoid/sim/upperlimb/to_algo
Typeupperlimb/Joints
Direction📤 Publish
Description仿真上肢数据输入算法
Note1.3 新增

3. jacobian/left_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/jacobian/left_arm
Typestd_msgs/Float64MultiArray
Direction📤 Publish
Description左臂雅可比矩阵
Note发布左臂当前位置的雅可比矩阵,用于速度和力的映射

4. jacobian/right_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/jacobian/right_arm
Typestd_msgs/Float64MultiArray
Direction📤 Publish
Description右臂雅可比矩阵
Note发布右臂当前位置的雅可比矩阵,用于速度和力的映射

5. joint_states ​

字段值
Topic Name/zj_humanoid/upperlimb/joint_states
Typesensor_msgs/JointState
Direction📤 Publish
Description上肢关节位置
Note机器人上肢关节position状态值发布,查询当前机器人颈部pitch的角度 回复应处于+-42度间

6. occupancy_state ​

字段值
Topic Name/zj_humanoid/upperlimb/occupancy_state
Typestd_msgs/Int8
Direction📥 Subscribe
Description上肢占用控制
Note该话题发布上肢的当前占用状态,用于防止多个控制源同时控制机器人

7. servoj/dual_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/servoj/dual_arm
Typeupperlimb/Joints
Direction📤 Publish
Description双臂servoj
Note双臂关节空间伺服控制,不要使用定时sleep,该接口执行需要准确的时间戳会达到更好的效果

8. servoj/left_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/servoj/left_arm
Typeupperlimb/Joints
Direction📥 Subscribe
Description左臂servoj
Note关节空间 高频位置控制

9. servoj/lifting ​

字段值
Topic Name/zj_humanoid/upperlimb/servoj/lifting
Typeupperlimb/Joints
Direction📥 Subscribe
Description全身servoj
Note关节空间 高频位置控制

10. servoj/neck ​

字段值
Topic Name/zj_humanoid/upperlimb/servoj/neck
Typeupperlimb/Joints
Direction📥 Subscribe
Description颈部servoj
Note关节空间 高频位置控制

11. servoj/right_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/servoj/right_arm
Typeupperlimb/Joints
Direction📥 Subscribe
Description右臂servoj
Note关节空间 高频位置控制

12. servoj/waist ​

字段值
Topic Name/zj_humanoid/upperlimb/servoj/waist
Typeupperlimb/Joints
Direction📥 Subscribe
Description腰部servoj
Note关节空间 高频位置控制

13. servoj/whole_body ​

字段值
Topic Name/zj_humanoid/upperlimb/servoj/whole_body
Typeupperlimb/Joints
Direction📥 Subscribe
Description全身servoj
Note关节空间 高频位置控制

14. servol/dual_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/servol/dual_arm
Typegeometry_msgs/Pose
Direction📥 Subscribe
Description双臂servol
Note笛卡尔空间 高频位置跟随控制

15. servol/left_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/servol/left_arm
Typegeometry_msgs/Pose
Direction📥 Subscribe
Description左臂servol
Note笛卡尔空间 高频位置跟随控制

16. servol/right_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/servol/right_arm
Typegeometry_msgs/Pose
Direction📥 Subscribe
Description右臂servol
Note笛卡尔空间 高频位置跟随控制

17. speedj/dual_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/speedj/dual_arm
Typeupperlimb/SpeedJ
Direction📤 Publish
Description双臂关节speedj
Note双臂关节空间速度控制

18. speedj/left_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/speedj/left_arm
Typeupperlimb/TcpSpeed
Direction📥 Subscribe
Description左臂speedj
Note关节空间速度控制

19. speedj/lifting ​

字段值
Topic Name/zj_humanoid/upperlimb/speedj/lifting
Typeupperlimb/TcpSpeed
Direction📥 Subscribe
Description升降speedj
Note关节空间速度控制

20. speedj/neck ​

字段值
Topic Name/zj_humanoid/upperlimb/speedj/neck
Typeupperlimb/TcpSpeed
Direction📥 Subscribe
Description脖子speedj
Note关节空间速度控制

21. speedj/right_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/speedj/right_arm
Typeupperlimb/TcpSpeed
Direction📥 Subscribe
Description右臂speedj
Note关节空间速度控制

22. speedj/waist ​

字段值
Topic Name/zj_humanoid/upperlimb/speedj/waist
Typeupperlimb/TcpSpeed
Direction📥 Subscribe
Description腰speedj
Note关节空间速度控制

23. speedj/whole_body ​

字段值
Topic Name/zj_humanoid/upperlimb/speedj/whole_body
Typeupperlimb/TcpSpeed
Direction📥 Subscribe
Description全身speedj
Note关节空间速度控制

24. speedl/dual_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/speedl/dual_arm
Typeupperlimb/SpeedL
Direction📥 Subscribe
Description双臂speedl
Note笛卡尔空间 速度控制

25. speedl/left_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/speedl/left_arm
Typeupperlimb/SpeedL
Direction📥 Subscribe
Description左臂speedl
Note笛卡尔空间 速度控制

26. speedl/right_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/speedl/right_arm
Typeupperlimb/SpeedL
Direction📥 Subscribe
Description右臂speedl
Note笛卡尔空间 速度控制

27. speedl/whole_body ​

字段值
Topic Name/zj_humanoid/upperlimb/speedl/whole_body
Typeupperlimb/SpeedL
Direction📥 Subscribe
Description全身笛卡尔速度控制
Note1.4 新增

28. tcp_pose/left_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/tcp_pose/left_arm
Typeupperlimb/Pose
Direction📤 Publish
Description左臂tcp位姿控制
Note左手臂末端位姿

29. tcp_pose/right_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/tcp_pose/right_arm
Typeupperlimb/Pose
Direction📤 Publish
Description右臂tcp位姿控制
Note右手臂末端位姿

30. tcp_speed/dual_arm ​

字段值
Topic Name/zj_humanoid/upperlimb/tcp_speed/dual_arm
Typeupperlimb/TcpSpeed
Direction📥 Subscribe
Description双臂TCP速度
Note该话题发布双臂末端执行器(TCP)的实时速度信息

31. uplimb_occupation ​

字段值
Topic Name/zj_humanoid/upperlimb/uplimb_occupation
Typestd_msgs/Int8
Direction📤 Publish
Description上肢占用状态
Note用于发布上肢占用状态信息

32. uplimb_state ​

字段值
Topic Name/zj_humanoid/upperlimb/uplimb_state
Typeupperlimb/UplimbState
Direction📥 Subscribe
Description当前上肢命令
Note该话题发布上肢机器人的当前命令状态信息

⚙️ Actions (3) ​

1. motion ​

字段值
Action Name/zj_humanoid/upperlimb/motion
Typeupperlimb/MotionExecute
Description执行预加载轨迹

2. teach_mode/replay ​

字段值
Action Name/zj_humanoid/upperlimb/teach_mode/replay
Typeupperlimb/DragTeachReplay
Description回放拖动示教轨迹
Note1.3 新增

3. teach_mode/start_record ​

字段值
Action Name/zj_humanoid/upperlimb/teach_mode/start_record
Typeupperlimb/DragTeachRecord
Description开始记录拖动示教轨迹
Note1.3 新增