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