Ubuntu 22.04 (x86_64) and Python 3.10. Run the commands below from the SDK root.
If you don't have Conda, install Miniforge.
wget "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"
bash Miniforge3-$(uname)-$(uname -m).shFollow the prompts to initialize Conda, then open a new terminal and return to the SDK root.
conda create -n t701-ht python=3.10 pip
conda activate t701-ht
python -I -m pip install ./motor_whl/hightorque_robot-1.2.0-cp310-cp310-linux_x86_64.whl
python -I -m pip install -r requirements.txtCheck the dependencies and URDF model. You can run this check with the arms disconnected.
python -I -c "import hightorque_robot, numpy, osqp, pinocchio, scipy, yaml; pinocchio.buildModelFromUrdf('T701-HT_URDF/urdf/T701-HT.urdf'); print('T701-HT environment check passed')"-
Connect the power supply.
-
Press the round power button.
-
Connect the computer to the mainboard's USB-C port with a USB data cable.
The left arm uses CAN1 and the right arm uses CAN2. Set board_serial in the serial binding configuration to the communication board's USB serial number. At startup, the SDK uses the board's USB identity to locate the current serial port. serial_binding.yaml
Check the mapping without opening the serial ports. Pass only the corresponding YAML file to check one arm.
ls -l /dev/serial/by-id/
python scripts/t701_ht_can_serial_adapter.py T701-HT_robot_param/T701-HT_left.yaml T701-HT_robot_param/T701-HT_right.yamlIf Ubuntu reports a serial port permission error, check that your user has read and write access to the device through the dialout group.
Enter 1 for the left arm, 2 for the right arm, or 3 for both. About twice a second, the script prints each joint's position, velocity, and torque, plus the gripper's position and velocity. Press Ctrl+C to exit.
python scripts/t701_ht_read_state.pyAfter choosing an arm, select 1 to read its state once or 2 to read it continuously. With its joints and gripper at their intended zero positions, select 3 to save the current pose as zero. Select 4 to drive the arm to its stored zero position or 0 to exit.
python scripts/t701_ht_set_zero.pyVerify the joint zero positions, remove any payload, and clear the arms' range of motion. Start with one arm. Run the demos from the scripts directory and enter 1, 2, or 3 to select the left arm, right arm, or both.
cd scriptsThe demo applies 0.8 × G(q) as MIT torque feedforward to make the arm easier to move by hand. The joint Kp and Kd gains and the gripper torque are zero. Support the arm when starting and stopping the demo.
python t701_ht_gravity_compensation.pyThe demo applies the configured joint torque limits. Press Ctrl+C to stop the motors.
For more examples, see T701-HT and Pinocchio.
Follow the VR teleoperation guide to start USB or WiFi streaming and scripts/t701_ht_vr_dual_cartesian_qp_control.py. This entry controls both arms directly. Stop Verify and clear the arms' range of motion before starting it.
See the license.


