diff --git a/Simulation/SO101/README.md b/Simulation/SO101/README.md new file mode 100644 index 0000000..7b77320 --- /dev/null +++ b/Simulation/SO101/README.md @@ -0,0 +1,34 @@ +# SO101 Robot - URDF and MuJoCo Description + +This repository contains the URDF and MuJoCo (MJCF) files for the SO101 robot. + +## Overview + +- The robot model files were generated using the [onshape-to-robot](https://github.com/Rhoban/onshape-to-robot) plugin from a CAD model designed in Onshape. +- Base collision meshes were removed due to problematic collision behavior during simulation and planning. + +## Calibration Methods + +The MuJoCo file `scene.xml` supports two differenly calibrated SO101 robot files: + +- **New Calibration (Default)**: Each joint's virtual zero is set to the **middle** of its joint range. Use -> `so101_new_calib.xml`. +- **Old Calibration**: Each joint's virtual zero is set to the configuration where the robot is **fully extended horizontally**. Use -> `so101_old_calib.xml`. + +To switch between calibration methods, modify the included robot file in `scene.xml`. + +## Motor Parameters + +Motor properties for the STS3215 motors used in the robot are adapted from the [Open Duck Mini project](https://github.com/apirrone/Open_Duck_Mini). + +## Gripper Note + +In LeRobot, the gripper is represented as a **linear joint**, where: + +* `0` = fully closed +* `100` = fully open + +This mapping is **not yet reflected** in the current URDF and MuJoCo files. + +--- + +Feel free to open an issue or contribute improvements! diff --git a/Simulation/SO101/joints_properties.xml b/Simulation/SO101/joints_properties.xml index 8b98629..0e2b2a5 100644 --- a/Simulation/SO101/joints_properties.xml +++ b/Simulation/SO101/joints_properties.xml @@ -1,4 +1,3 @@ - diff --git a/Simulation/SO101/scene.xml b/Simulation/SO101/scene.xml index 0b5c370..255b970 100644 --- a/Simulation/SO101/scene.xml +++ b/Simulation/SO101/scene.xml @@ -1,5 +1,5 @@ - + diff --git a/Simulation/SO101/so101.urdf b/Simulation/SO101/so101_new_calib.urdf similarity index 86% rename from Simulation/SO101/so101.urdf rename to Simulation/SO101/so101_new_calib.urdf index 0aba5de..c55a1d7 100644 --- a/Simulation/SO101/so101.urdf +++ b/Simulation/SO101/so101_new_calib.urdf @@ -1,6 +1,7 @@ - + + @@ -153,7 +154,7 @@ - + @@ -162,14 +163,14 @@ - + - + @@ -178,7 +179,7 @@ - + @@ -193,7 +194,7 @@ - + @@ -202,14 +203,14 @@ - + - + @@ -218,14 +219,14 @@ - + - + @@ -234,7 +235,7 @@ - + @@ -249,7 +250,7 @@ - + @@ -258,7 +259,7 @@ - + @@ -305,7 +306,7 @@ - + @@ -314,7 +315,7 @@ - + @@ -330,7 +331,7 @@ - + @@ -344,7 +345,7 @@ - + @@ -353,7 +354,7 @@ - + @@ -361,15 +362,15 @@ - + - + - + @@ -377,7 +378,7 @@ - + @@ -385,19 +386,19 @@ - + - + - + - + diff --git a/Simulation/SO101/so101.xml b/Simulation/SO101/so101_new_calib.xml similarity index 80% rename from Simulation/SO101/so101.xml rename to Simulation/SO101/so101_new_calib.xml index fa9157b..a95af55 100644 --- a/Simulation/SO101/so101.xml +++ b/Simulation/SO101/so101_new_calib.xml @@ -1,9 +1,10 @@ - + + - + @@ -14,7 +15,7 @@ - + @@ -28,7 +29,7 @@ - + @@ -55,62 +56,62 @@ - + - + - - + + - + - + - - + + - - + + - + - + - - + + - + - + - - + + - + - + - - + + @@ -120,19 +121,19 @@ - - - + + + + + + + + + - - - - - - - + diff --git a/Simulation/SO101/so101_old_calib.urdf b/Simulation/SO101/so101_old_calib.urdf new file mode 100644 index 0000000..fc41e30 --- /dev/null +++ b/Simulation/SO101/so101_old_calib.urdf @@ -0,0 +1,423 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Simulation/SO101/so101_old_calib.xml b/Simulation/SO101/so101_old_calib.xml new file mode 100644 index 0000000..e11d693 --- /dev/null +++ b/Simulation/SO101/so101_old_calib.xml @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +