Assembly guide for Universal Manipulation Exoskeleton (UME)
Wearable two-arm exoskeleton that feeds a robot's joint torques back to the operator
License
Apache 2.0
Code and CAD: Apache-2.0, per LICENSE.md in the repository. The bundled OpenArm model keeps its own Apache-2.0 licence file, and the ACT and DETR code carries Facebook's copyright header from the original projects. The Yahboom IMU reader is the vendor's code and states no licence. The project website's template is CC BY-SA 4.0; the paper and videos are the authors'. Checked 2026-11-08 against LICENSE.md and the files in the repository.
Assembly guide
1. Prepare the parts
Gather the actuators and hardware, and print the exoskeleton parts.
1.1 Gather the purchased parts
Get the aluminium extrusions, screws and actuators ready.
- Use Appendix E.2 of the paper as the parts list
- Get 8 DM-J4340-2EC and 8 DM-J4310-2EC actuators for the two arms
- Have the Damiao UART to USB-C adapter and a DC power supply ready for configuration
1.2 Print the exoskeleton parts
Print all the orange parts of the exploded view in PLA.
- Take the STL files listed in the MuJoCo model, or edit the STEP files in the ume_step folder
- Print in Bambu Lab PLA Basic with triangular infill at 20 percent
- Use orange PLA for better strength, as the guide recommends
- Change the arm lengths in the CAD if needed to fit your arms
2. Configure the Damiao actuators
Set each actuator's CAN ID, master ID and bus speed before installing it.
2.1 Connect an actuator to the PC
Link the actuator's UART port to the PC and prepare its power.
- Download and open the Damiao debugging tool
- Connect the actuator's UART port to the UART to USB-C adapter, then to the PC
- Set the DC power supply to 24 V
- Click open serial port and check that it turns green
- Power on the actuator and check that a status report appears; if not, try another USB-C cable
2.2 Write the CAN IDs
Give each actuator an ID by its place on the arm, counting 1 to 8 from shoulder to gripper.
- Open Parameter settings and click Read parameters
- For the actuator in place i, set CAN ID to 0x0i and master ID to 0x1i, for example 0x01 and 0x11 for the shoulder
- Click Write parameter and wait for the message that the write succeeded
2.3 Set the bus speed to 5 Mbps
Raise the CAN bus speed and confirm the new settings.
- Return to the serial port tab
- Send s in the command window, then send FCB9
- Power cycle the actuator and check that the status report shows the new CAN ID, master ID and CAN baud
- Repeat for all 8 actuators of the right arm and all 8 of the left arm
3. Assemble the exoskeleton
Build each arm from the shoulder to the wrist, following the exploded view.
3.1 Start at the shoulder
Mount the shoulder on a table and work outward.
- Mount the shoulder onto the table
- Assemble from the shoulder to the wrist, following the exploded view in the guide
- Fix each actuator with screws about 5 mm longer than the depth of the screw hole in the printed part
3.2 Route the shoulder cable
Hide the J2 cable inside the extrusion.
- Thread the XT30 2+2 cable from J1 through the 2020 aluminium extrusion
- Pass it through the hole in the printed part and connect it to J2
3.3 Route the other cables
Leave each joint just enough free cable to move.
- Assemble the joint and connect its cables
- Rotate the joint to the limit of the human range of motion to find the shortest free length
- Tape the cable down where it does not block your movements
3.4 Mount the IMU
Fix the Yahboom IMU on the back of the exoskeleton.
- Mount the IMU anywhere on the back of the exoskeleton
- Orient it with x up, y left and z forward
4. Zero and test
Zero every joint against the software model, then check gravity compensation and teleoperation.
4.1 Zero each joint
Lock each joint at its reference position and store zero.
- Print the zeroing key, a block with a 5 mm x 2.5 mm x 100 mm slot
- Align the bumps before and after the actuator and hold them together with the key
- In motor_chain_test.py, set motor_ids and motor_types to this joint and uncomment the set_zero line
- Run it and check that the actuator turns green and reads 0
- Repeat for every joint
4.2 Check the zeroing safely
Run the simulation check with the torque command switched off first.
- In real_teleop_sim.py, set the torque multiplier before tau_ff to 0 for both arms
- Run real_teleop_sim.py and check the joint readings against the model
- When the readings are right, restore the multiplier and move the exoskeleton by hand to feel the gravity compensation
4.3 Connect the software
Set up the IMU, the CAN buses and the gravity-compensation demo.
- Install the ume_redis and ume_torch conda environments from their yaml files
- Add yourself to the dialout group so the IMU can be read
- Run enable_can.sh with the mobile base on CAN0 and CAN1, the arm on CAN2 and CAN3 and the exoskeleton on CAN4 and CAN5
- For a first build, run the gravity-compensation demo with the MuJoCo window on and the torque scaled by 0.5
4.4 Teleoperate the OpenArm
Run the arm teleoperation demo to check that the exoskeleton and the robot work together.
- Start teleop_openarm.yaml with process-compose
- Press b to move the arm slowly to the start position
- Press the backtick key to start torque-feedback teleoperation