kuavo-humanoid-sdk 1.2.2__20250922181216-py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of kuavo-humanoid-sdk might be problematic. Click here for more details.

Files changed (137) hide show
  1. kuavo_humanoid_sdk/__init__.py +6 -0
  2. kuavo_humanoid_sdk/common/logger.py +45 -0
  3. kuavo_humanoid_sdk/interfaces/__init__.py +4 -0
  4. kuavo_humanoid_sdk/interfaces/data_types.py +276 -0
  5. kuavo_humanoid_sdk/interfaces/end_effector.py +62 -0
  6. kuavo_humanoid_sdk/interfaces/robot.py +22 -0
  7. kuavo_humanoid_sdk/interfaces/robot_info.py +56 -0
  8. kuavo_humanoid_sdk/kuavo/__init__.py +11 -0
  9. kuavo_humanoid_sdk/kuavo/core/audio.py +32 -0
  10. kuavo_humanoid_sdk/kuavo/core/core.py +612 -0
  11. kuavo_humanoid_sdk/kuavo/core/dex_hand_control.py +114 -0
  12. kuavo_humanoid_sdk/kuavo/core/leju_claw_control.py +67 -0
  13. kuavo_humanoid_sdk/kuavo/core/ros/audio.py +92 -0
  14. kuavo_humanoid_sdk/kuavo/core/ros/control.py +1309 -0
  15. kuavo_humanoid_sdk/kuavo/core/ros/observation.py +94 -0
  16. kuavo_humanoid_sdk/kuavo/core/ros/param.py +183 -0
  17. kuavo_humanoid_sdk/kuavo/core/ros/sat_utils.py +103 -0
  18. kuavo_humanoid_sdk/kuavo/core/ros/state.py +605 -0
  19. kuavo_humanoid_sdk/kuavo/core/ros/tools.py +219 -0
  20. kuavo_humanoid_sdk/kuavo/core/ros/vision.py +234 -0
  21. kuavo_humanoid_sdk/kuavo/core/ros_env.py +237 -0
  22. kuavo_humanoid_sdk/kuavo/dexterous_hand.py +201 -0
  23. kuavo_humanoid_sdk/kuavo/leju_claw.py +235 -0
  24. kuavo_humanoid_sdk/kuavo/robot.py +465 -0
  25. kuavo_humanoid_sdk/kuavo/robot_arm.py +210 -0
  26. kuavo_humanoid_sdk/kuavo/robot_audio.py +39 -0
  27. kuavo_humanoid_sdk/kuavo/robot_head.py +50 -0
  28. kuavo_humanoid_sdk/kuavo/robot_info.py +113 -0
  29. kuavo_humanoid_sdk/kuavo/robot_observation.py +64 -0
  30. kuavo_humanoid_sdk/kuavo/robot_state.py +299 -0
  31. kuavo_humanoid_sdk/kuavo/robot_tool.py +82 -0
  32. kuavo_humanoid_sdk/kuavo/robot_vision.py +83 -0
  33. kuavo_humanoid_sdk/kuavo_strategy/__init__.py +2 -0
  34. kuavo_humanoid_sdk/kuavo_strategy/grasp_box/grasp_box_strategy.py +1126 -0
  35. kuavo_humanoid_sdk/kuavo_strategy/kuavo_strategy.py +104 -0
  36. kuavo_humanoid_sdk/msg/__init__.py +4 -0
  37. kuavo_humanoid_sdk/msg/kuavo_msgs/__init__.py +7 -0
  38. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_AprilTagDetection.py +306 -0
  39. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_AprilTagDetectionArray.py +437 -0
  40. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_JoySticks.py +191 -0
  41. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_Metadata.py +199 -0
  42. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_RobotActionState.py +112 -0
  43. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_TFArray.py +323 -0
  44. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/__init__.py +48 -0
  45. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_armHandPose.py +160 -0
  46. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_armHandPoseFree.py +171 -0
  47. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_armPoseWithTimeStamp.py +168 -0
  48. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_armTargetPoses.py +151 -0
  49. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_bezierCurveCubicPoint.py +178 -0
  50. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_dexhandCommand.py +229 -0
  51. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_dexhandTouchState.py +256 -0
  52. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_endEffectorData.py +227 -0
  53. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_footPose.py +123 -0
  54. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_footPoseTargetTrajectories.py +301 -0
  55. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_footPoses.py +149 -0
  56. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_fullBodyTargetTrajectories.py +258 -0
  57. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_gaitTimeName.py +147 -0
  58. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_gestureInfo.py +218 -0
  59. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_gestureTask.py +149 -0
  60. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_handPose.py +136 -0
  61. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_headBodyPose.py +145 -0
  62. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_ikSolveError.py +171 -0
  63. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_ikSolveParam.py +140 -0
  64. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_imuData.py +165 -0
  65. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_jointBezierTrajectory.py +201 -0
  66. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_jointCmd.py +390 -0
  67. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_jointData.py +205 -0
  68. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_lejuClawCommand.py +320 -0
  69. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_lejuClawState.py +341 -0
  70. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_motorParam.py +122 -0
  71. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_planArmState.py +120 -0
  72. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_questJoySticks.py +191 -0
  73. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_qv.py +121 -0
  74. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_robotArmQVVD.py +177 -0
  75. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_robotHandPosition.py +225 -0
  76. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_robotHeadMotionData.py +128 -0
  77. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_robotState.py +222 -0
  78. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_sensorsData.py +495 -0
  79. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_switchGaitByName.py +200 -0
  80. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_touchSensorStatus.py +162 -0
  81. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_twoArmHandPose.py +272 -0
  82. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_twoArmHandPoseCmd.py +315 -0
  83. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_twoArmHandPoseCmdFree.py +338 -0
  84. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_twoArmHandPoseFree.py +299 -0
  85. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_yoloDetection.py +251 -0
  86. kuavo_humanoid_sdk/msg/kuavo_msgs/msg/_yoloOutputData.py +168 -0
  87. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_ExecuteArmAction.py +281 -0
  88. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_RepublishTFs.py +373 -0
  89. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_SetJoyTopic.py +282 -0
  90. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_SpeechSynthesis.py +270 -0
  91. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/__init__.py +29 -0
  92. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_changeArmCtrlMode.py +275 -0
  93. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_changeArmCtrlModeKuavo.py +236 -0
  94. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_changeMotorParam.py +299 -0
  95. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_changeTorsoCtrlMode.py +274 -0
  96. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_controlLejuClaw.py +408 -0
  97. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_enableHandTouchSensor.py +304 -0
  98. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_fkSrv.py +394 -0
  99. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_footPoseTargetTrajectoriesSrv.py +409 -0
  100. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_gestureExecute.py +339 -0
  101. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_gestureExecuteState.py +257 -0
  102. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_gestureList.py +418 -0
  103. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_getCurrentGaitName.py +253 -0
  104. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_getMotorParam.py +299 -0
  105. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_handForceLevel.py +330 -0
  106. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_jointMoveTo.py +302 -0
  107. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_planArmTrajectoryBezierCurve.py +421 -0
  108. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_planArmTrajectoryCubicSpline.py +490 -0
  109. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_playmusic.py +268 -0
  110. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_setHwIntialState.py +304 -0
  111. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_setMmCtrlFrame.py +273 -0
  112. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_setMotorEncoderRoundService.py +283 -0
  113. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_setTagId.py +275 -0
  114. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_singleStepControl.py +444 -0
  115. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_twoArmHandPoseCmdFreeSrv.py +716 -0
  116. kuavo_humanoid_sdk/msg/kuavo_msgs/srv/_twoArmHandPoseCmdSrv.py +662 -0
  117. kuavo_humanoid_sdk/msg/motion_capture_ik/__init__.py +7 -0
  118. kuavo_humanoid_sdk/msg/ocs2_msgs/__init__.py +7 -0
  119. kuavo_humanoid_sdk/msg/ocs2_msgs/msg/__init__.py +12 -0
  120. kuavo_humanoid_sdk/msg/ocs2_msgs/msg/_constraint.py +142 -0
  121. kuavo_humanoid_sdk/msg/ocs2_msgs/msg/_controller_data.py +121 -0
  122. kuavo_humanoid_sdk/msg/ocs2_msgs/msg/_lagrangian_metrics.py +148 -0
  123. kuavo_humanoid_sdk/msg/ocs2_msgs/msg/_mode_schedule.py +150 -0
  124. kuavo_humanoid_sdk/msg/ocs2_msgs/msg/_mpc_flattened_controller.py +666 -0
  125. kuavo_humanoid_sdk/msg/ocs2_msgs/msg/_mpc_input.py +122 -0
  126. kuavo_humanoid_sdk/msg/ocs2_msgs/msg/_mpc_observation.py +209 -0
  127. kuavo_humanoid_sdk/msg/ocs2_msgs/msg/_mpc_performance_indices.py +140 -0
  128. kuavo_humanoid_sdk/msg/ocs2_msgs/msg/_mpc_solver_data.py +886 -0
  129. kuavo_humanoid_sdk/msg/ocs2_msgs/msg/_mpc_state.py +122 -0
  130. kuavo_humanoid_sdk/msg/ocs2_msgs/msg/_mpc_target_trajectories.py +239 -0
  131. kuavo_humanoid_sdk/msg/ocs2_msgs/msg/_multiplier.py +148 -0
  132. kuavo_humanoid_sdk/msg/ocs2_msgs/srv/__init__.py +1 -0
  133. kuavo_humanoid_sdk/msg/ocs2_msgs/srv/_reset.py +376 -0
  134. kuavo_humanoid_sdk-1.2.2.dist-info/METADATA +291 -0
  135. kuavo_humanoid_sdk-1.2.2.dist-info/RECORD +137 -0
  136. kuavo_humanoid_sdk-1.2.2.dist-info/WHEEL +6 -0
  137. kuavo_humanoid_sdk-1.2.2.dist-info/top_level.txt +1 -0
@@ -0,0 +1,605 @@
1
+ import time
2
+ from typing import Tuple
3
+ import copy
4
+ import rospy
5
+ from std_msgs.msg import Float64
6
+ from nav_msgs.msg import Odometry
7
+ from sensor_msgs.msg import JointState
8
+ from kuavo_humanoid_sdk.msg.kuavo_msgs.msg import sensorsData, lejuClawState, gaitTimeName, dexhandTouchState
9
+ from kuavo_msgs.srv import changeArmCtrlMode, changeArmCtrlModeRequest, getCurrentGaitName, getCurrentGaitNameRequest
10
+ from kuavo_humanoid_sdk.msg.ocs2_msgs.msg import mpc_observation
11
+ from kuavo_humanoid_sdk.msg.kuavo_msgs.srv import (changeArmCtrlMode, changeArmCtrlModeRequest,setMmCtrlFrame, setMmCtrlFrameRequest, changeTorsoCtrlMode, changeTorsoCtrlModeRequest)
12
+ from collections import deque
13
+ from typing import Tuple
14
+ import copy
15
+ from kuavo_humanoid_sdk.common.logger import SDKLogger
16
+ from kuavo_humanoid_sdk.kuavo.core.ros.param import make_robot_param, EndEffectorType
17
+ from kuavo_humanoid_sdk.interfaces.data_types import (KuavoImuData, KuavoJointData, KuavoOdometry, KuavoManipulationMpcFrame,
18
+ KuavoArmCtrlMode, EndEffectorState, KuavoDexHandTouchState,
19
+ KuavoManipulationMpcCtrlMode, KuavoManipulationMpcControlFlow)
20
+ class GaitManager:
21
+ def __init__(self, max_size: int = 20):
22
+ self._max_size = max_size
23
+ self._gait_time_names = deque(maxlen=max_size)
24
+
25
+ @property
26
+ def is_empty(self) -> bool:
27
+ """Check if there are any gait time names stored.
28
+
29
+ Returns:
30
+ bool: True if no gait time names are stored, False otherwise
31
+ """
32
+ return len(self._gait_time_names) == 0
33
+ def add(self, start_time: float, name: str) -> None:
34
+ self._gait_time_names.append((start_time, name))
35
+
36
+ def get_gait(self, current_time: float) -> str:
37
+ if not self._gait_time_names:
38
+ return "No_Gait"
39
+
40
+ for start_time, name in reversed(self._gait_time_names):
41
+ if current_time >= start_time:
42
+ return name
43
+
44
+ return self._gait_time_names[0].name
45
+
46
+ def get_gait_name(self, current_time: float) -> str:
47
+ return self.get_gait(current_time)[1]
48
+
49
+ def get_last_gait_name(self) -> str:
50
+ if not self._gait_time_names:
51
+ return "No_Gait"
52
+ return self._gait_time_names[-1][1]
53
+
54
+
55
+ class KuavoRobotStateCore:
56
+ _instance = None
57
+
58
+ def __new__(cls, *args, **kwargs):
59
+ if not cls._instance:
60
+ cls._instance = super().__new__(cls)
61
+ return cls._instance
62
+
63
+ def __init__(self):
64
+ if not hasattr(self, '_initialized'):
65
+ rospy.Subscriber("/sensors_data_raw", sensorsData, self._sensors_data_raw_callback)
66
+ rospy.Subscriber("/odom", Odometry, self._odom_callback)
67
+ rospy.Subscriber("/humanoid/mpc/terrainHeight", Float64, self._terrain_height_callback)
68
+ rospy.Subscriber("/humanoid_mpc_gait_time_name", gaitTimeName, self._humanoid_mpc_gait_changed_callback)
69
+ rospy.Subscriber("/humanoid_mpc_observation", mpc_observation, self._humanoid_mpc_observation_callback)
70
+
71
+ kuavo_info = make_robot_param()
72
+ self._ee_type = kuavo_info['end_effector_type']
73
+ if self._ee_type == EndEffectorType.LEJUCLAW:
74
+ rospy.Subscriber("/leju_claw_state", lejuClawState, self._lejuclaw_state_callback)
75
+ elif self._ee_type == EndEffectorType.QIANGNAO:
76
+ rospy.Subscriber("/dexhand/state", JointState, self._dexterous_hand_state_callback)
77
+ elif self._ee_type == EndEffectorType.QIANGNAO_TOUCH:
78
+ rospy.Subscriber("/dexhand/state", JointState, self._dexterous_hand_state_callback)
79
+ rospy.Subscriber("/dexhand/touch_state", dexhandTouchState, self._dexhand_touch_state_callback)
80
+ # Initialize touch state for both hands with empty KuavoDexHandTouchState instances
81
+ self._dexhand_touch_state = (
82
+ KuavoDexHandTouchState(
83
+ data=(KuavoDexHandTouchState.KuavoTouchState(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0),
84
+ KuavoDexHandTouchState.KuavoTouchState(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0),
85
+ KuavoDexHandTouchState.KuavoTouchState(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0),
86
+ KuavoDexHandTouchState.KuavoTouchState(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0),
87
+ KuavoDexHandTouchState.KuavoTouchState(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0))
88
+ ), # Left hand touch state
89
+ KuavoDexHandTouchState(
90
+ data=(KuavoDexHandTouchState.KuavoTouchState(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0),
91
+ KuavoDexHandTouchState.KuavoTouchState(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0),
92
+ KuavoDexHandTouchState.KuavoTouchState(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0),
93
+ KuavoDexHandTouchState.KuavoTouchState(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0),
94
+ KuavoDexHandTouchState.KuavoTouchState(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0))
95
+ ) # Right hand touch state
96
+ )
97
+
98
+ """ data """
99
+ self._terrain_height = 0.0
100
+ self._imu_data = KuavoImuData(
101
+ gyro = (0.0, 0.0, 0.0),
102
+ acc = (0.0, 0.0, 0.0),
103
+ free_acc = (0.0, 0.0, 0.0),
104
+ quat = (0.0, 0.0, 0.0, 0.0)
105
+ )
106
+ self._joint_data = KuavoJointData(
107
+ position = [0.0] * 28,
108
+ velocity = [0.0] * 28,
109
+ torque = [0.0] * 28,
110
+ acceleration = [0.0] * 28
111
+ )
112
+ self._odom_data = KuavoOdometry(
113
+ position = (0.0, 0.0, 0.0),
114
+ orientation = (0.0, 0.0, 0.0, 0.0),
115
+ linear = (0.0, 0.0, 0.0),
116
+ angular = (0.0, 0.0, 0.0)
117
+ )
118
+ self._eef_state = (EndEffectorState(
119
+ position = [0.0] * 12 if kuavo_info['end_effector_type'] is not None and kuavo_info['end_effector_type'].startswith('qiangnao') else [0.0] * 2,
120
+ velocity = [0.0] * 12 if kuavo_info['end_effector_type'] is not None and kuavo_info['end_effector_type'].startswith('qiangnao') else [0.0] * 2,
121
+ effort = [0.0] * 12 if kuavo_info['end_effector_type'] is not None and kuavo_info['end_effector_type'].startswith('qiangnao') else [0.0] * 2,
122
+ state=EndEffectorState.GraspingState.UNKNOWN
123
+ ), EndEffectorState(
124
+ position = [0.0] * 12 if kuavo_info['end_effector_type'] is not None and kuavo_info['end_effector_type'].startswith('qiangnao') else [0.0] * 2,
125
+ velocity = [0.0] * 12 if kuavo_info['end_effector_type'] is not None and kuavo_info['end_effector_type'].startswith('qiangnao') else [0.0] * 2,
126
+ effort = [0.0] * 12 if kuavo_info['end_effector_type'] is not None and kuavo_info['end_effector_type'].startswith('qiangnao') else [0.0] * 2,
127
+ state=EndEffectorState.GraspingState.UNKNOWN
128
+ ))
129
+
130
+ # gait manager
131
+ self._gait_manager = GaitManager()
132
+ self._prev_gait_name = self.gait_name()
133
+
134
+ # Wait for first MPC observation data
135
+ self._mpc_observation_data = None
136
+ start_time = time.time()
137
+ while self._mpc_observation_data is None:
138
+ if time.time() - start_time > 1.0: # 1.0s timeout
139
+ SDKLogger.warn("Timeout waiting for MPC observation data")
140
+ break
141
+ SDKLogger.debug("Waiting for first MPC observation data...")
142
+ time.sleep(0.1)
143
+ # 如果 gait_manager 为空,则把当前的状态添加到其中
144
+ if self._mpc_observation_data is not None:
145
+ if self._gait_manager.is_empty:
146
+ self._prev_gait_name = self.gait_name()
147
+ SDKLogger.debug(f"[State] Adding initial gait state: {self._prev_gait_name} at time {self._mpc_observation_data.time}")
148
+ self._gait_manager.add(self._mpc_observation_data.time, self._prev_gait_name)
149
+
150
+ # 获取当前手臂控制模式
151
+ self._arm_ctrl_mode = self._srv_get_arm_ctrl_mode()
152
+ self._initialized = True
153
+
154
+ # 获取manipulation mpc 相关参数
155
+ self._manipulation_mpc_frame = self._srv_get_manipulation_mpc_frame()
156
+ self._manipulation_mpc_ctrl_mode = self._srv_get_manipulation_mpc_ctrl_mode()
157
+ self._manipulation_mpc_control_flow = self._srv_get_manipulation_mpc_control_flow()
158
+
159
+ @property
160
+ def com_height(self)->float:
161
+ # odom.position.z - terrain_height = com_height
162
+ return self._odom_data.position[2] - self._terrain_height
163
+
164
+ @property
165
+ def imu_data(self)->KuavoImuData:
166
+ return self._imu_data
167
+
168
+ @property
169
+ def joint_data(self)->KuavoJointData:
170
+ return self._joint_data
171
+
172
+ @property
173
+ def odom_data(self)->KuavoOdometry:
174
+ return self._odom_data
175
+
176
+ @property
177
+ def arm_control_mode(self) -> KuavoArmCtrlMode:
178
+ mode = self._srv_get_arm_ctrl_mode()
179
+ if mode is not None:
180
+ self._arm_ctrl_mode = mode
181
+ return self._arm_ctrl_mode
182
+
183
+ @property
184
+ def manipulation_mpc_ctrl_mode(self)->KuavoManipulationMpcCtrlMode:
185
+ mode = self._srv_get_manipulation_mpc_ctrl_mode()
186
+ if mode is not None:
187
+ self._manipulation_mpc_ctrl_mode = mode
188
+ return self._manipulation_mpc_ctrl_mode
189
+
190
+ @property
191
+ def manipulation_mpc_frame(self)->KuavoManipulationMpcFrame:
192
+ frame = self._srv_get_manipulation_mpc_frame()
193
+ if frame is not None:
194
+ self._manipulation_mpc_frame = frame
195
+ return self._manipulation_mpc_frame
196
+
197
+ @property
198
+ def manipulation_mpc_control_flow(self)->KuavoManipulationMpcControlFlow:
199
+ flow = self._srv_get_manipulation_mpc_control_flow()
200
+ if flow is not None:
201
+ self._manipulation_mpc_control_flow = flow
202
+ return self._manipulation_mpc_control_flow
203
+
204
+ @property
205
+ def eef_state(self)->Tuple[EndEffectorState, EndEffectorState]:
206
+ return self._eef_state
207
+
208
+ @property
209
+ def dexhand_touch_state(self)-> Tuple[KuavoDexHandTouchState, KuavoDexHandTouchState]:
210
+ if self._ee_type != EndEffectorType.QIANGNAO_TOUCH:
211
+ raise Exception("This robot does not support touch state")
212
+ return self._dexhand_touch_state
213
+
214
+ @property
215
+ def current_observation_time(self) -> float:
216
+ """Get the current observation time from MPC.
217
+
218
+ Returns:
219
+ float: Current observation time in seconds, or None if no observation data available
220
+ """
221
+ if self._mpc_observation_data is None:
222
+ return None
223
+ return self._mpc_observation_data.time
224
+
225
+ @property
226
+ def current_gait_mode(self) -> int:
227
+ """
228
+ Get the current gait mode from MPC observation.
229
+
230
+ Notes: FF=0, FH=1, FT=2, FS=3, HF=4, HH=5, HT=6, HS=7, TF=8, TH=9, TT=10, TS=11, SF=12, SH=13, ST=14, SS=15
231
+
232
+ Returns:
233
+ int: Current gait mode, or None if no observation data available
234
+ """
235
+ if self._mpc_observation_data is None:
236
+ return None
237
+ return self._mpc_observation_data.mode
238
+
239
+ def gait_name(self)->str:
240
+ return self._srv_get_current_gait_name()
241
+
242
+ def is_gait(self, gait_name: str) -> bool:
243
+ """Check if current gait matches the given gait name.
244
+
245
+ Args:
246
+ gait_name (str): Name of gait to check
247
+
248
+ Returns:
249
+ bool: True if current gait matches given name, False otherwise
250
+ """
251
+ return self._gait_manager.get_gait(self._mpc_observation_data.time) == gait_name
252
+
253
+ def register_gait_changed_callback(self, callback):
254
+ """Register a callback function that will be called when the gait changes.
255
+
256
+ Args:
257
+ callback: A function that takes current time (float) and gait name (str) as arguments
258
+ Raises:
259
+ ValueError: If callback does not accept 2 parameters: current_time (float), gait_name (str)
260
+ """
261
+ if not hasattr(self, '_gait_changed_callbacks'):
262
+ self._gait_changed_callbacks = []
263
+
264
+ # Verify callback accepts current_time (float) and gait_name (str) parameters
265
+ from inspect import signature
266
+ sig = signature(callback)
267
+ if len(sig.parameters) != 2:
268
+ raise ValueError("Callback must accept 2 parameters: current_time (float), gait_name (str)")
269
+ if callback not in self._gait_changed_callbacks:
270
+ self._gait_changed_callbacks.append(callback)
271
+
272
+ """ ------------------------------- callback ------------------------------- """
273
+ def _terrain_height_callback(self, msg)->None:
274
+ self._terrain_height = msg.data
275
+
276
+ def _sensors_data_raw_callback(self, msg)->None:
277
+ # update imu data
278
+ self._imu_data = KuavoImuData(
279
+ gyro = (msg.imu_data.gyro.x, msg.imu_data.gyro.y, msg.imu_data.gyro.z),
280
+ acc = (msg.imu_data.acc.x, msg.imu_data.acc.y, msg.imu_data.acc.z),
281
+ free_acc = (msg.imu_data.free_acc.x, msg.imu_data.free_acc.y, msg.imu_data.free_acc.z),
282
+ quat = (msg.imu_data.quat.x, msg.imu_data.quat.y, msg.imu_data.quat.z, msg.imu_data.quat.w)
283
+ )
284
+ # update joint data
285
+ self._joint_data = KuavoJointData(
286
+ position = copy.deepcopy(msg.joint_data.joint_q),
287
+ velocity = copy.deepcopy(msg.joint_data.joint_v),
288
+ torque = copy.deepcopy(msg.joint_data.joint_vd),
289
+ acceleration = copy.deepcopy(msg.joint_data.joint_current if hasattr(msg.joint_data, 'joint_current') else msg.joint_data.joint_torque)
290
+ )
291
+
292
+ def _odom_callback(self, msg)->None:
293
+ # update odom data
294
+ self._odom_data = KuavoOdometry(
295
+ position = (msg.pose.pose.position.x, msg.pose.pose.position.y, msg.pose.pose.position.z),
296
+ orientation = (msg.pose.pose.orientation.x, msg.pose.pose.orientation.y, msg.pose.pose.orientation.z, msg.pose.pose.orientation.w),
297
+ linear = (msg.twist.twist.linear.x, msg.twist.twist.linear.y, msg.twist.twist.linear.z),
298
+ angular = (msg.twist.twist.angular.x, msg.twist.twist.angular.y, msg.twist.twist.angular.z)
299
+ )
300
+
301
+ def _lejuclaw_state_callback(self, msg)->None:
302
+ self._eef_state = (EndEffectorState(
303
+ # left claw
304
+ position = [msg.data.position[0]],
305
+ velocity = [msg.data.velocity[0]],
306
+ effort = [msg.data.effort[0]],
307
+ state=EndEffectorState.GraspingState(msg.state[0])
308
+ ), EndEffectorState(
309
+ # right claw
310
+ position = [msg.data.position[1]],
311
+ velocity = [msg.data.velocity[1]],
312
+ effort = [msg.data.effort[1]],
313
+ state=EndEffectorState.GraspingState(msg.state[1])
314
+ ))
315
+
316
+ def _dexterous_hand_state_callback(self, msg)->None:
317
+ self._eef_state = (EndEffectorState(
318
+ # left hand
319
+ position = list(msg.position[:len(msg.position)//2]),
320
+ velocity = list(msg.velocity[:len(msg.velocity)//2]),
321
+ effort = list(msg.effort[:len(msg.effort)//2]),
322
+ state=EndEffectorState.GraspingState.UNKNOWN
323
+ ), EndEffectorState(
324
+ # right hand
325
+ position = list(msg.position[len(msg.position)//2:]),
326
+ velocity = list(msg.velocity[len(msg.velocity)//2:]),
327
+ effort = list(msg.effort[len(msg.effort)//2:]),
328
+ state=EndEffectorState.GraspingState.UNKNOWN
329
+ ))
330
+
331
+ def _dexhand_touch_state_callback(self, msg)->None:
332
+ # Update touch state for both hands
333
+ self._dexhand_touch_state = (
334
+ KuavoDexHandTouchState(
335
+ data=tuple(KuavoDexHandTouchState.KuavoTouchState(
336
+ sensor.normal_force1, sensor.normal_force2, sensor.normal_force3,
337
+ sensor.tangential_force1, sensor.tangential_force2, sensor.tangential_force3,
338
+ sensor.tangential_direction1, sensor.tangential_direction2, sensor.tangential_direction3,
339
+ sensor.self_proximity1, sensor.self_proximity2, sensor.mutual_proximity,
340
+ sensor.status
341
+ ) for sensor in msg.left_hand)
342
+ ), # Left hand touch state
343
+ KuavoDexHandTouchState(
344
+ data=tuple(KuavoDexHandTouchState.KuavoTouchState(
345
+ sensor.normal_force1, sensor.normal_force2, sensor.normal_force3,
346
+ sensor.tangential_force1, sensor.tangential_force2, sensor.tangential_force3,
347
+ sensor.tangential_direction1, sensor.tangential_direction2, sensor.tangential_direction3,
348
+ sensor.self_proximity1, sensor.self_proximity2, sensor.mutual_proximity,
349
+ sensor.status
350
+ ) for sensor in msg.right_hand)
351
+ ) # Right hand touch state
352
+ )
353
+
354
+ def _humanoid_mpc_gait_changed_callback(self, msg):
355
+ """
356
+ Callback function for gait change messages.
357
+ Updates the current gait name when a gait change occurs.
358
+ """
359
+ SDKLogger.debug(f"[State] Received gait change message: {msg.gait_name} at time {msg.start_time}")
360
+ self._gait_manager.add(msg.start_time, msg.gait_name)
361
+
362
+ def _humanoid_mpc_observation_callback(self, msg) -> None:
363
+ """
364
+ Callback function for MPC observation messages.
365
+ Updates the current MPC state and input data.
366
+ """
367
+ try:
368
+ self._mpc_observation_data = msg
369
+ # Only update gait info after initialization
370
+ if hasattr(self, '_initialized'):
371
+ curr_time = self._mpc_observation_data.time
372
+ current_gait = self._gait_manager.get_gait(curr_time)
373
+ if self._prev_gait_name != current_gait:
374
+ SDKLogger.debug(f"[State] Gait changed to: {current_gait} at time {curr_time}")
375
+ # Update previous gait name and notify callback if registered
376
+ self._prev_gait_name = current_gait
377
+ if hasattr(self, '_gait_changed_callbacks') and self._gait_changed_callbacks is not None:
378
+ for callback in self._gait_changed_callbacks:
379
+ callback(curr_time, current_gait)
380
+ except Exception as e:
381
+ SDKLogger.error(f"Error processing MPC observation: {e}")
382
+
383
+ def _srv_get_arm_ctrl_mode(self)-> KuavoArmCtrlMode:
384
+ try:
385
+ rospy.wait_for_service('/humanoid_get_arm_ctrl_mode', timeout=1.0)
386
+ get_arm_ctrl_mode_srv = rospy.ServiceProxy('/humanoid_get_arm_ctrl_mode', changeArmCtrlMode)
387
+ req = changeArmCtrlModeRequest()
388
+ resp = get_arm_ctrl_mode_srv(req)
389
+ return KuavoArmCtrlMode(resp.mode)
390
+ except rospy.ServiceException as e:
391
+ SDKLogger.error(f"Service call failed: {e}")
392
+ except Exception as e:
393
+ SDKLogger.error(f"[Error] get arm ctrl mode: {e}")
394
+ return None
395
+
396
+ def _srv_get_current_gait_name(self)->str:
397
+ try:
398
+ rospy.wait_for_service('/humanoid_get_current_gait_name', timeout=1.0)
399
+ srv = rospy.ServiceProxy('/humanoid_get_current_gait_name', getCurrentGaitName)
400
+ request = getCurrentGaitNameRequest()
401
+ response = srv(request)
402
+ if response.success:
403
+ return response.gait_name
404
+ else:
405
+ return None
406
+ except Exception as e:
407
+ SDKLogger.error(f"Service call failed: {e}")
408
+ return None
409
+
410
+ def _srv_get_manipulation_mpc_ctrl_mode(self, )->KuavoManipulationMpcCtrlMode:
411
+ try:
412
+ service_name = '/mobile_manipulator_get_mpc_control_mode'
413
+ rospy.wait_for_service(service_name, timeout=2.0)
414
+ get_mode_srv = rospy.ServiceProxy(service_name, changeTorsoCtrlMode)
415
+
416
+ req = changeTorsoCtrlModeRequest()
417
+
418
+ resp = get_mode_srv(req)
419
+ if not resp.result:
420
+ SDKLogger.error(f"Failed to get manipulation mpc control mode: {resp.message}")
421
+ return KuavoManipulationMpcCtrlMode.ERROR
422
+ return KuavoManipulationMpcCtrlMode(resp.mode)
423
+ except rospy.ServiceException as e:
424
+ SDKLogger.error(f"Service call to {service_name} failed: {e}")
425
+ except rospy.ROSException as e: # For timeout from wait_for_service
426
+ SDKLogger.error(f"Failed to connect to service {service_name}: {e}")
427
+ except Exception as e:
428
+ SDKLogger.error(f"Failed to get manipulation mpc control mode: {e}")
429
+ return KuavoManipulationMpcCtrlMode.ERROR
430
+
431
+ def _srv_get_manipulation_mpc_frame(self, )->KuavoManipulationMpcFrame:
432
+ try:
433
+ service_name = '/get_mm_ctrl_frame'
434
+ rospy.wait_for_service(service_name, timeout=2.0)
435
+ get_frame_srv = rospy.ServiceProxy(service_name, setMmCtrlFrame)
436
+
437
+ req = setMmCtrlFrameRequest()
438
+
439
+ resp = get_frame_srv(req)
440
+ if not resp.result:
441
+ SDKLogger.error(f"Failed to get manipulation mpc frame: {resp.message}")
442
+ return KuavoManipulationMpcFrame.ERROR
443
+ return KuavoManipulationMpcFrame(resp.currentFrame)
444
+ except rospy.ServiceException as e:
445
+ SDKLogger.error(f"Service call to {service_name} failed: {e}")
446
+ except rospy.ROSException as e: # For timeout from wait_for_service
447
+ SDKLogger.error(f"Failed to connect to service {service_name}: {e}")
448
+ except Exception as e:
449
+ SDKLogger.error(f"Failed to get manipulation mpc frame: {e}")
450
+ return KuavoManipulationMpcFrame.ERROR
451
+
452
+ def _srv_get_manipulation_mpc_control_flow(self, )->KuavoManipulationMpcControlFlow:
453
+ try:
454
+ service_name = '/get_mm_wbc_arm_trajectory_control'
455
+ rospy.wait_for_service(service_name, timeout=2.0)
456
+ get_mode_srv = rospy.ServiceProxy(service_name, changeArmCtrlMode)
457
+
458
+ req = changeArmCtrlModeRequest()
459
+
460
+ resp = get_mode_srv(req)
461
+ if not resp.result:
462
+ SDKLogger.error(f"Failed to get manipulation mpc wbc arm trajectory control mode: {resp.message}")
463
+ return KuavoManipulationMpcControlFlow.Error
464
+ return KuavoManipulationMpcControlFlow(resp.mode)
465
+ except rospy.ServiceException as e:
466
+ SDKLogger.error(f"Service call to {service_name} failed: {e}")
467
+ except rospy.ROSException as e: # For timeout from wait_for_service
468
+ SDKLogger.error(f"Failed to connect to service {service_name}: {e}")
469
+ except Exception as e:
470
+ SDKLogger.error(f"Failed to get manipulation mpc wbc arm trajectory control mode: {e}")
471
+ return KuavoManipulationMpcControlFlow.Error
472
+
473
+ def _srv_get_manipulation_mpc_ctrl_mode(self, )->KuavoManipulationMpcCtrlMode:
474
+ try:
475
+ service_name = '/mobile_manipulator_get_mpc_control_mode'
476
+ rospy.wait_for_service(service_name, timeout=2.0)
477
+ get_mode_srv = rospy.ServiceProxy(service_name, changeTorsoCtrlMode)
478
+
479
+ req = changeTorsoCtrlModeRequest()
480
+
481
+ resp = get_mode_srv(req)
482
+ if not resp.result:
483
+ SDKLogger.error(f"Failed to get manipulation mpc control mode: {resp.message}")
484
+ return KuavoManipulationMpcCtrlMode.ERROR
485
+ return KuavoManipulationMpcCtrlMode(resp.mode)
486
+ except rospy.ServiceException as e:
487
+ SDKLogger.error(f"Service call to {service_name} failed: {e}")
488
+ except rospy.ROSException as e: # For timeout from wait_for_service
489
+ SDKLogger.error(f"Failed to connect to service {service_name}: {e}")
490
+ except Exception as e:
491
+ SDKLogger.error(f"Failed to get manipulation mpc control mode: {e}")
492
+ return KuavoManipulationMpcCtrlMode.ERROR
493
+
494
+ def _srv_get_manipulation_mpc_frame(self, )->KuavoManipulationMpcFrame:
495
+ try:
496
+ service_name = '/get_mm_ctrl_frame'
497
+ rospy.wait_for_service(service_name, timeout=2.0)
498
+ get_frame_srv = rospy.ServiceProxy(service_name, setMmCtrlFrame)
499
+
500
+ req = setMmCtrlFrameRequest()
501
+
502
+ resp = get_frame_srv(req)
503
+ if not resp.result:
504
+ SDKLogger.error(f"Failed to get manipulation mpc frame: {resp.message}")
505
+ return KuavoManipulationMpcFrame.ERROR
506
+ return KuavoManipulationMpcFrame(resp.currentFrame)
507
+ except rospy.ServiceException as e:
508
+ SDKLogger.error(f"Service call to {service_name} failed: {e}")
509
+ except rospy.ROSException as e: # For timeout from wait_for_service
510
+ SDKLogger.error(f"Failed to connect to service {service_name}: {e}")
511
+ except Exception as e:
512
+ SDKLogger.error(f"Failed to get manipulation mpc frame: {e}")
513
+ return KuavoManipulationMpcFrame.ERROR
514
+
515
+ def _srv_get_manipulation_mpc_control_flow(self, )->KuavoManipulationMpcControlFlow:
516
+ try:
517
+ service_name = '/get_mm_wbc_arm_trajectory_control'
518
+ rospy.wait_for_service(service_name, timeout=2.0)
519
+ get_mode_srv = rospy.ServiceProxy(service_name, changeArmCtrlMode)
520
+
521
+ req = changeArmCtrlModeRequest()
522
+
523
+ resp = get_mode_srv(req)
524
+ if not resp.result:
525
+ SDKLogger.error(f"Failed to get manipulation mpc wbc arm trajectory control mode: {resp.message}")
526
+ return KuavoManipulationMpcControlFlow.Error
527
+ return KuavoManipulationMpcControlFlow(resp.mode)
528
+ except rospy.ServiceException as e:
529
+ SDKLogger.error(f"Service call to {service_name} failed: {e}")
530
+ except rospy.ROSException as e: # For timeout from wait_for_service
531
+ SDKLogger.error(f"Failed to connect to service {service_name}: {e}")
532
+ except Exception as e:
533
+ SDKLogger.error(f"Failed to get manipulation mpc wbc arm trajectory control mode: {e}")
534
+ return KuavoManipulationMpcControlFlow.Error
535
+
536
+ def _srv_get_manipulation_mpc_ctrl_mode(self, )->KuavoManipulationMpcCtrlMode:
537
+ try:
538
+ service_name = '/mobile_manipulator_get_mpc_control_mode'
539
+ rospy.wait_for_service(service_name, timeout=2.0)
540
+ get_mode_srv = rospy.ServiceProxy(service_name, changeTorsoCtrlMode)
541
+
542
+ req = changeTorsoCtrlModeRequest()
543
+
544
+ resp = get_mode_srv(req)
545
+ if not resp.result:
546
+ SDKLogger.error(f"Failed to get manipulation mpc control mode: {resp.message}")
547
+ return KuavoManipulationMpcCtrlMode.ERROR
548
+ return KuavoManipulationMpcCtrlMode(resp.mode)
549
+ except rospy.ServiceException as e:
550
+ SDKLogger.error(f"Service call to {service_name} failed: {e}")
551
+ except rospy.ROSException as e: # For timeout from wait_for_service
552
+ SDKLogger.error(f"Failed to connect to service {service_name}: {e}")
553
+ except Exception as e:
554
+ SDKLogger.error(f"Failed to get manipulation mpc control mode: {e}")
555
+ return KuavoManipulationMpcCtrlMode.ERROR
556
+
557
+ def _srv_get_manipulation_mpc_frame(self, )->KuavoManipulationMpcFrame:
558
+ try:
559
+ service_name = '/get_mm_ctrl_frame'
560
+ rospy.wait_for_service(service_name, timeout=2.0)
561
+ get_frame_srv = rospy.ServiceProxy(service_name, setMmCtrlFrame)
562
+
563
+ req = setMmCtrlFrameRequest()
564
+
565
+ resp = get_frame_srv(req)
566
+ if not resp.result:
567
+ SDKLogger.error(f"Failed to get manipulation mpc frame: {resp.message}")
568
+ return KuavoManipulationMpcFrame.ERROR
569
+ return KuavoManipulationMpcFrame(resp.currentFrame)
570
+ except rospy.ServiceException as e:
571
+ SDKLogger.error(f"Service call to {service_name} failed: {e}")
572
+ except rospy.ROSException as e: # For timeout from wait_for_service
573
+ SDKLogger.error(f"Failed to connect to service {service_name}: {e}")
574
+ except Exception as e:
575
+ SDKLogger.error(f"Failed to get manipulation mpc frame: {e}")
576
+ return KuavoManipulationMpcFrame.ERROR
577
+
578
+ def _srv_get_manipulation_mpc_control_flow(self, )->KuavoManipulationMpcControlFlow:
579
+ try:
580
+ service_name = '/get_mm_wbc_arm_trajectory_control'
581
+ rospy.wait_for_service(service_name, timeout=2.0)
582
+ get_mode_srv = rospy.ServiceProxy(service_name, changeArmCtrlMode)
583
+
584
+ req = changeArmCtrlModeRequest()
585
+
586
+ resp = get_mode_srv(req)
587
+ if not resp.result:
588
+ SDKLogger.error(f"Failed to get manipulation mpc wbc arm trajectory control mode: {resp.message}")
589
+ return KuavoManipulationMpcControlFlow.Error
590
+ return KuavoManipulationMpcControlFlow(resp.mode)
591
+ except rospy.ServiceException as e:
592
+ SDKLogger.error(f"Service call to {service_name} failed: {e}")
593
+ except rospy.ROSException as e: # For timeout from wait_for_service
594
+ SDKLogger.error(f"Failed to connect to service {service_name}: {e}")
595
+ except Exception as e:
596
+ SDKLogger.error(f"Failed to get manipulation mpc wbc arm trajectory control mode: {e}")
597
+ return KuavoManipulationMpcControlFlow.Error
598
+
599
+
600
+ if __name__ == "__main__":
601
+ state = KuavoRobotStateCore()
602
+ print(state.manipulation_mpc_frame)
603
+ print(state.manipulation_mpc_control_flow)
604
+ print(state.manipulation_mpc_ctrl_mode)
605
+ print(state.arm_control_mode)