UPSTREAM RIGHTS (CONFLICTING NOTICES) The previewed URDF and meshes come from leap-hand/LEAP_Hand_Sim, commit 150bc3d4b61fd6619193ba5a8ef209f3609ced89, whose LICENSE.txt is the MIT license (Copyright 2023 Ananye Agarwal). The LEAP Hand CAD itself is published in leap-hand/LEAP_Hand_API (profile revision b0d00c881d0119077b2cab771a6de44f5aaec904): its LICENSE file states "Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0)", Copyright (c) 2023 Kenny Shaw, Deepak Pathak (https://creativecommons.org/licenses/by-nc/4.0/), and its readme License section states "Code: MIT License" and "CAD: CC BY-NC-SA (non-commercial use with attribution)" without a version. Open Source Robotics does not extend the MIT simulation-repository notice to the hand geometry. It applies the stricter noncommercial CAD terms: attribution to Kenny Shaw and Deepak Pathak (LEAP Hand, Carnegie Mellon University) and Ananye Agarwal (LEAP_Hand_Sim), noncommercial use only, and the preview shared alike under the same noncommercial terms. The ZIP bundle contains the unchanged URDF, its 8 meshes, the LEAP_Hand_Sim LICENSE.txt and README.md, and the LEAP_Hand_API LICENSE and readme.md (in a folder named for that repository and revision). The model does not distinguish the Full and Lite motor options. No commercial-use, manufacturing or other clearance is claimed. --- UPSTREAM LEAP_Hand_API-b0d00c881d0119077b2cab771a6de44f5aaec904/LICENSE --- Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0) Copyright (c) 2023 Kenny Shaw, Deepak Pathak This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License. To view a full legal copy of this license, visit: https://creativecommons.org/licenses/by-nc/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA. You are free to share, i.e., copy and redistribute the material in any medium or format under the following terms: - Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use. - NonCommercial — You may not use the material for commercial purposes. No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits. This is a human-readable summary of (and not a substitute for) the license. For the full legal text of the license, please refer to the Creative Commons Attribution-NonCommercial 4.0 International License at the provided URL on the link above below. --- UPSTREAM LEAP_Hand_API-b0d00c881d0119077b2cab771a6de44f5aaec904/readme.md --- ## Welcome to the LEAP Hand SDK 👉 **More info:** [LEAP Hand Website](http://leaphand.com/) --- ### Software Setup - See these folders for setup details: - [Python API](https://github.com/leap-hand/LEAP_Hand_API/tree/main/python) - [C++](https://github.com/leap-hand/LEAP_Hand_API/tree/main/cpp) - [ROS API](https://github.com/leap-hand/LEAP_Hand_API/tree/main/ros_module) - [ROS2 API](https://github.com/leap-hand/LEAP_Hand_API/tree/main/ros2_module) - [Useful Tools](https://github.com/leap-hand/LEAP_Hand_API/tree/main/useful_tools) --- ### 🔌 Hardware Setup - Connect **5 V power** to the hand (Dynamixels should light up on boot). - Connect the **Micro‑USB** cable (avoid multiple USB extensions). - Use [Dynamixel Wizard](https://emanual.robotis.com/docs/en/software/rplus1/dynamixel_wizard/) to find the correct port. ➡️ Put that port into `main.py` or `ros_example.py`. ⚠️ You **cannot** have Dynamixel Wizard open while using the API (the port will be busy). - On Ubuntu, find the hand by ID at `/dev/serial/by-id` (persistent across reboots). - `sudo chmod 666 /dev/serial/by-id/(your_id)` to give serial port permissions. - Official support: **Python** and **C++** and **ROS/ROS2**. Other languages can use the [Dynamixel SDK](https://emanual.robotis.com/docs/en/software/dynamixel/dynamixel_sdk/overview/). - To improve latency on Ubuntu: - [Adjust USB Latency Settings](https://emanual.robotis.com/docs/en/software/dynamixel/dynamixel_wizard2/) - Tune the [Dynamixel Python SDK](https://github.com/ROBOTIS-GIT/DynamixelSDK/issues/288) - Set *Return Delay Time* (Control Table Register 9) from 250 µs to **0 µs**. - If you are using the full hand, you can raise the current limit from 300 mA to 550 mA in the API for increased strength! --- ### 🤖 Functionality - Leap Node allows commanding joint angles in different scalings. - You can read **position, velocity, and current**. - **Query limits:** - Position only: ≤ 500 Hz - Position + velocity + current: ≤ 500 Hz (Higher rates can slow USB communication.) - Default control: **PID** (up to current limit). Velocity and current control also supported—see the [motor manual](https://emanual.robotis.com/docs/en/dxl/x/xc330-m288/). - Current limits: - Lite: ≈ 300 mA - Full: up to ≈ 550 mA - **By default the API is at 300, you can raise it to 550mA on the Full hand!!!** - Jittery hand? ➡️ Lower P/D values. Weak hand? ➡️ Raise P/D values. --- ### 🛠️ Troubleshooting - Motor off by 90°/180°/270° → **Remount the horn.** - No motors show up → Check **serial port permissions**. - Some motors missing → Verify **IDs** and **U2D2 connections**. - Overload error (motors flashing red) → **Power cycle**. If frequent, **lower current limits**. - Jittery motors → Lower P/D values. - Inaccurate motors → Raise P/D values. --- ### 🔧 Useful Tools - **MANO → LEAP** joint angle mapping. - [Bimanual Dexterity for Complex Tasks](https://bidex-teleop.github.io/) shows how to use **Manus gloves** with LEAP Hand. - Have a useful tool to share? **Pull requests welcome!** (Or ask and I can add tools for you.) --- ### Support - Questions/issues: **kshaw2@andrew.cmu.edu** - **License:** - Code: MIT License - CAD: CC BY‑NC‑SA (non‑commercial use with attribution) - Provided **as‑is**, without warranty. **If you use LEAP Hand in research, please cite:** ```bibtex @article{shaw2023leaphand, title={LEAP Hand: Low-Cost, Efficient, and Anthropomorphic Hand for Robot Learning}, author={Shaw, Kenneth and Agarwal, Ananye and Pathak, Deepak}, journal={Robotics: Science and Systems (RSS)}, year={2023} } --- UPSTREAM LICENSE.txt --- Copyright 2023 Ananye Agarwal Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.