UPSTREAM RIGHTS (CONFLICTING NOTICES) Source-Robotics/MSG-compliant-AI-stepper-gripper, commit ca47db35ccb35dbcc33985367f76899fb4804d5a (MSG gripper by Petar Crnjak / Source Robotics). The root LICENSE file is the "CERN Open Hardware Licence Version 2 - Strongly Reciprocal" (https://ohwr.org/cern_ohl_s_v2.txt) and the README states "Project is under [CERN Open Hardware Licence Version 2 - Strongly Reciprocal]". MSG_gripper_description/readme.md states "This model is released under an [Apache-2.0 License](LICENSE)", but MSG_gripper_description contains no LICENSE file. The URDF package.xml that accompanies the previewed URDF declares "BSD" (a SolidWorks-to-URDF exporter default). The repository does not say which notice governs the robot description. The exporter log (MSG_gripper_description/URDF/msg_gripper/export.log, SW2URDF 1.6) records that the gripper link mesh was built from SolidWorks components named MSG_Gripper_body_150mm, linearguide_150mm, 17HS08-1004S, MGN7C (two), OV9732_camera, camera extension, camera_lid, connectorFemaleFlange, connector_lid, jaw_blocker (two), stepper_gripper_cover_CAMERA and ring_cover, and each jaw mesh from linear_track_URDF and solid_jaws_pinch of the URDF_SSG48_assem (SSG-48 gripper) assembly. Purchased components (stepper motor, linear guide, carriages, camera) are kept as modeled; their third-party terms are not stated. Under the user decision of October 4, 2026 for ambiguous licenses, Open Source Robotics hosts the unchanged MSG_gripper_description folder (URDF package, exporter log, MJCF files and meshes) with the root LICENSE, README and safety disclaimer in a ZIP bundle, and a triangulated preview of PAR6_MSG.urdf at zero joint positions, with attribution to Petar Crnjak / Source Robotics. The preview is offered under the strictest reading, CERN-OHL-S-2.0. No manufacturing, redistribution or other clearance is claimed beyond what the source states. --- UPSTREAM LICENSE --- CERN Open Hardware Licence Version 2 - Strongly Reciprocal Preamble CERN has developed this licence to promote collaboration among hardware designers and to provide a legal tool which supports the freedom to use, study, modify, share and distribute hardware designs and products based on those designs. Version 2 of the CERN Open Hardware Licence comes in three variants: CERN-OHL-P (permissive); and two reciprocal licences: CERN-OHL-W (weakly reciprocal) and this licence, CERN-OHL-S (strongly reciprocal). The CERN-OHL-S is copyright CERN 2020. Anyone is welcome to use it, in unmodified form only. Use of this Licence does not imply any endorsement by CERN of any Licensor or their designs nor does it imply any involvement by CERN in their development. 1 Definitions 1.1 'Licence' means this CERN-OHL-S. 1.2 'Compatible Licence' means a) any earlier version of the CERN Open Hardware licence, or b) any version of the CERN-OHL-S, or c) any licence which permits You to treat the Source to which it applies as licensed under CERN-OHL-S provided that on Conveyance of any such Source, or any associated Product You treat the Source in question as being licensed under CERN-OHL-S. 1.3 'Source' means information such as design materials or digital code which can be applied to Make or test a Product or to prepare a Product for use, Conveyance or sale, regardless of its medium or how it is expressed. It may include Notices. 1.4 'Covered Source' means Source that is explicitly made available under this Licence. 1.5 'Product' means any device, component, work or physical object, whether in finished or intermediate form, arising from the use, application or processing of Covered Source. 1.6 'Make' means to create or configure something, whether by manufacture, assembly, compiling, loading or applying Covered Source or another Product or otherwise. 1.7 'Available Component' means any part, sub-assembly, library or code which: a) is licensed to You as Complete Source under a Compatible Licence; or b) is available, at the time a Product or the Source containing it is first Conveyed, to You and any other prospective licensees i) as a physical part with sufficient rights and information (including any configuration and programming files and information about its characteristics and interfaces) to enable it either to be Made itself, or to be sourced and used to Make the Product; or ii) as part of the normal distribution of a tool used to design or Make the Product. 1.8 'Complete Source' means the set of all Source necessary to Make a Product, in the preferred form for making modifications, including necessary installation and interfacing information both for the Product, and for any included Available Components. If the format is proprietary, it must also be made available in a format (if the proprietary tool can create it) which is viewable with a tool available to potential licensees and licensed under a licence approved by the Free Software Foundation or the Open Source Initiative. Complete Source need not include the Source of any Available Component, provided that You include in the Complete Source sufficient information to enable a recipient to Make or source and use the Available Component to Make the Product. 1.9 'Source Location' means a location where a Licensor has placed Covered Source, and which that Licensor reasonably believes will remain easily accessible for at least three years for anyone to obtain a digital copy. 1.10 'Notice' means copyright, acknowledgement and trademark notices, Source Location references, modification notices (subsection 3.3(b)) and all notices that refer to this Licence and to the disclaimer of warranties that are included in the Covered Source. 1.11 'Licensee' or 'You' means any person exercising rights under this Licence. 1.12 'Licensor' means a natural or legal person who creates or modifies Covered Source. A person may be a Licensee and a Licensor at the same time. 1.13 'Convey' means to communicate to the public or distribute. 2 Applicability 2.1 This Licence governs the use, copying, modification, Conveying of Covered Source and Products, and the Making of Products. By exercising any right granted under this Licence, You irrevocably accept these terms and conditions. 2.2 This Licence is granted by the Licensor directly to You, and shall apply worldwide and without limitation in time. 2.3 You shall not attempt to restrict by contract or otherwise the rights granted under this Licence to other Licensees. 2.4 This Licence is not intended to restrict fair use, fair dealing, or any other similar right. 3 Copying, Modifying and Conveying Covered Source 3.1 You may copy and Convey verbatim copies of Covered Source, in any medium, provided You retain all Notices. 3.2 You may modify Covered Source, other than Notices, provided that You irrevocably undertake to make that modified Covered Source available from a Source Location should You Convey a Product in circumstances where the recipient does not otherwise receive a copy of the modified Covered Source. In each case subsection 3.3 shall apply. You may only delete Notices if they are no longer applicable to the corresponding Covered Source as modified by You and You may add additional Notices applicable to Your modifications. Including Covered Source in a larger work is modifying the Covered Source, and the larger work becomes modified Covered Source. 3.3 You may Convey modified Covered Source (with the effect that You shall also become a Licensor) provided that You: a) retain Notices as required in subsection 3.2; b) add a Notice to the modified Covered Source stating that You have modified it, with the date and brief description of how You have modified it; c) add a Source Location Notice for the modified Covered Source if You Convey in circumstances where the recipient does not otherwise receive a copy of the modified Covered Source; and d) license the modified Covered Source under the terms and conditions of this Licence (or, as set out in subsection 8.3, a later version, if permitted by the licence of the original Covered Source). Such modified Covered Source must be licensed as a whole, but excluding Available Components contained in it, which remain licensed under their own applicable licences. 4 Making and Conveying Products You may Make Products, and/or Convey them, provided that You either provide each recipient with a copy of the Complete Source or ensure that each recipient is notified of the Source Location of the Complete Source. That Complete Source is Covered Source, and You must accordingly satisfy Your obligations set out in subsection 3.3. If specified in a Notice, the Product must visibly and securely display the Source Location on it or its packaging or documentation in the manner specified in that Notice. 5 Research and Development You may Convey Covered Source, modified Covered Source or Products to a legal entity carrying out development, testing or quality assurance work on Your behalf provided that the work is performed on terms which prevent the entity from both using the Source or Products for its own internal purposes and Conveying the Source or Products or any modifications to them to any person other than You. Any modifications made by the entity shall be deemed to be made by You pursuant to subsection 3.2. 6 DISCLAIMER AND LIABILITY 6.1 DISCLAIMER OF WARRANTY -- The Covered Source and any Products are provided 'as is' and any express or implied warranties, including, but not limited to, implied warranties of merchantability, of satisfactory quality, non-infringement of third party rights, and fitness for a particular purpose or use are disclaimed in respect of any Source or Product to the maximum extent permitted by law. The Licensor makes no representation that any Source or Product does not or will not infringe any patent, copyright, trade secret or other proprietary right. The entire risk as to the use, quality, and performance of any Source or Product shall be with You and not the Licensor. This disclaimer of warranty is an essential part of this Licence and a condition for the grant of any rights granted under this Licence. 6.2 EXCLUSION AND LIMITATION OF LIABILITY -- The Licensor shall, to the maximum extent permitted by law, have no liability for direct, indirect, special, incidental, consequential, exemplary, punitive or other damages of any character including, without limitation, procurement of substitute goods or services, loss of use, data or profits, or business interruption, however caused and on any theory of contract, warranty, tort (including negligence), product liability or otherwise, arising in any way in relation to the Covered Source, modified Covered Source and/or the Making or Conveyance of a Product, even if advised of the possibility of such damages, and You shall hold the Licensor(s) free and harmless from any liability, costs, damages, fees and expenses, including claims by third parties, in relation to such use. 7 Patents 7.1 Subject to the terms and conditions of this Licence, each Licensor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in subsections 7.2 and 8.4) patent licence to Make, have Made, use, offer to sell, sell, import, and otherwise transfer the Covered Source and Products, where such licence applies only to those patent claims licensable by such Licensor that are necessarily infringed by exercising rights under the Covered Source as Conveyed by that Licensor. 7.2 If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Covered Source or a Product constitutes direct or contributory patent infringement, or You seek any declaration that a patent licensed to You under this Licence is invalid or unenforceable then any rights granted to You under this Licence shall terminate as of the date such process is initiated. 8 General 8.1 If any provisions of this Licence are or subsequently become invalid or unenforceable for any reason, the remaining provisions shall remain effective. 8.2 You shall not use any of the name (including acronyms and abbreviations), image, or logo by which the Licensor or CERN is known, except where needed to comply with section 3, or where the use is otherwise allowed by law. Any such permitted use shall be factual and shall not be made so as to suggest any kind of endorsement or implication of involvement by the Licensor or its personnel. 8.3 CERN may publish updated versions and variants of this Licence which it considers to be in the spirit of this version, but may differ in detail to address new problems or concerns. New versions will be published with a unique version number and a variant identifier specifying the variant. If the Licensor has specified that a given variant applies to the Covered Source without specifying a version, You may treat that Covered Source as being released under any version of the CERN-OHL with that variant. If no variant is specified, the Covered Source shall be treated as being released under CERN-OHL-S. The Licensor may also specify that the Covered Source is subject to a specific version of the CERN-OHL or any later version in which case You may apply this or any later version of CERN-OHL with the same variant identifier published by CERN. 8.4 This Licence shall terminate with immediate effect if You fail to comply with any of its terms and conditions. 8.5 However, if You cease all breaches of this Licence, then Your Licence from any Licensor is reinstated unless such Licensor has terminated this Licence by giving You, while You remain in breach, a notice specifying the breach and requiring You to cure it within 30 days, and You have failed to come into compliance in all material respects by the end of the 30 day period. Should You repeat the breach after receipt of a cure notice and subsequent reinstatement, this Licence will terminate immediately and permanently. Section 6 shall continue to apply after any termination. 8.6 This Licence shall not be enforceable except by a Licensor acting as such, and third party beneficiary rights are specifically excluded. --- UPSTREAM README.md --- > [!CAUTION] > The gripper is still in BETA release meaning it will have some bugs from hardware to software! > drawing
# MSG-compliant-AI-stepper-gripper [![License: CERN OHL v2 - Strongly Reciprocal](https://img.shields.io/badge/license-CERN--OHL--S--2.0-blue.svg)](https://spdx.org/licenses/CERN-OHL-S-2.0.html) ![Issues](https://img.shields.io/github/issues/PCrnjak/MSG-compliant-AI-stepper-gripper) ![release](https://img.shields.io/github/v/release/PCrnjak/MSG-compliant-AI-stepper-gripper)

Documentation Discord Shop LinkedIn X YouTube

## [▶️YouTube🔴 Video of Gripper in Action!](https://youtu.be/YUvNXfaHM6s)
## 📖 Project Overview The **MSG compliant AI stepper gripper** is built around [StepFOC stepper drivers](https://source-robotics.com/products/stepfoc-stepper-controller), which enable precise FOC-based force control on standard stepper motors. This makes it well-suited for assembly tasks, human-robot collaboration, and AI data collection applications — including embodied AI, teleoperation, and VLA training — thanks to its camera-friendly design. **The gripper is modular in two key ways:** | Option | Variants | Notes | |--------|----------|-------| | Rail length | 100 mm, 150 mm, 200 mm | Determines maximum grip span | | Stepper length | 21.5 mm, 40 mm, 60 mm | Determines maximum grip force output | **All mechanical files, firmware, and software are open source, allowing you to attach a custom gripping tool and integrate the gripper with any robotic arm or platform.** ## ⚒️How to build / Where to buy? You can buy MSG gripper on our website: https://source-robotics.com/products/msg-gripper If you want to Source all the parts yourself and build your own follow these steps: Print files from the STEP files folder based on your chosen configuration: | Rail Size | Folders to Print | |-----------|------------------| | 100 mm | [Common parts](STEP%20files/Common%20parts) + [Linear rail dependant parts/100mm rail](STEP%20files/Linear%20rail%20dependant%20parts/100mm%20rail) + [Stepper dependant parts/\](STEP%20files/Stepper%20dependant%20parts) | | 150 mm | [Common parts](STEP%20files/Common%20parts) + [Linear rail dependant parts/150mm rail](STEP%20files/Linear%20rail%20dependant%20parts/150mm%20rail) + [Stepper dependant parts/\](STEP%20files/Stepper%20dependant%20parts) | | 200 mm | [Common parts](STEP%20files/Common%20parts) + [Linear rail dependant parts/200mm rail](STEP%20files/Linear%20rail%20dependant%20parts/200mm%20rail) + [Stepper dependant parts/\](STEP%20files/Stepper%20dependant%20parts) | * Source all the parts from the [BOM](https://github.com/PCrnjak/MSG-compliant-AI-stepper-gripper/blob/main/BOM.md) * Follow [Assembly instructions ](https://youtu.be/EosuDy-heqM) or [Video instructions](https://youtu.be/EosuDy-heqM) to assemble your gripper * Follow [DOCS](https://source-robotics.github.io/MSG-gripper-docs/) to get your gripper up and running. ## 📚Documentation: | Resource | Description | |----------|-------------| | [Official website](https://source-robotics.com) | Buy the MSG gripper or explore other Source Robotics products | | [DOCS](https://source-robotics.github.io/MSG-gripper-docs/) | Getting started, wiring, configuration, and full API reference | | [Python API](https://github.com/PCrnjak/Spectral-BLDC-Python/tree/main) | Control the gripper from Python over CAN bus | | [BOM](https://github.com/PCrnjak/MSG-compliant-AI-stepper-gripper/blob/main/BOM.md) | Complete list of parts needed to build the gripper | | [Building instructions *(coming soon)*](https://github.com/PCrnjak/MSG-compliant-AI-stepper-gripper/tree/main/Building%20instructions) | Mechanical assembly walkthrough | | [URDF & MJCF files](/MSG_gripper_description/) | Ready-to-use robot description files for ROS2, Gazebo, and MuJoCo | | [ROS2 package — MSG gripper](https://github.com/BiomechatronicsLab/source_robotics_msg_gripper_ros2) | ROS2 driver and example nodes for the MSG gripper | | [ROS2 package — SSG48 gripper](https://github.com/Lass6230/ssg48_adaptive_electric_gripper_ros2) | ROS2 driver and example nodes for the SSG48 gripper (Should work with MSG also) | ## 💻Quick start code example ```python import Spectral_BLDC as Spectral import time Communication1 = Spectral.CanCommunication(bustype='slcan', channel='COM20', bitrate=1000000) Motor1 = Spectral.SpectralCAN(node_id=0, communication=Communication1) Motor1.Send_Clear_Error() Motor1.Send_gripper_calibrate() time.sleep(4) temp_var = 0 while True: if temp_var == 0: Motor1.Send_gripper_data_pack(50,100,700,1,1,0,0) temp_var = 1 elif temp_var == 1: Motor1.Send_gripper_data_pack(240,100,700,1,1,0,0) temp_var = 0 message, UnpackedMessageID = Communication1.receive_can_messages(timeout=0.2) if message is not None: print(f"Message is: {message}") print(f"Node ID is : {UnpackedMessageID.node_id}") print(f"Message ID is: {UnpackedMessageID.command_id}") print(f"Error bit is: {UnpackedMessageID.error_bit}") print(f"Timestamp is: {message.timestamp}") time.sleep(3) ``` ## 🌐 More about MSG gripper | YouTube | Instagram | Twitter | LinkedIn | |--------|-----------|---------|----------| | [![YouTube](https://img.shields.io/badge/YouTube-FF0000?logo=youtube&logoColor=white)](https://www.youtube.com/@source-robotics) | [![Instagram](https://img.shields.io/badge/Instagram-E4405F?logo=instagram&logoColor=white)](https://www.instagram.com/source_robotics/) | [![Twitter](https://img.shields.io/badge/Twitter-1DA1F2?logo=twitter&logoColor=white)](https://twitter.com/SourceRobotics) | [![LinkedIn](https://img.shields.io/badge/LinkedIn-0A66C2?logo=linkedin&logoColor=white)](https://www.linkedin.com/company/source-robotics) | | Discord | Forum | Hackaday | Blog | |--------|-------|------| ------| | [![Discord](https://img.shields.io/badge/Discord-5865F2?logo=discord&logoColor=white)](https://discord.com/invite/prjUvjmGpZ) | [![Forum](https://img.shields.io/badge/Forum-0A0A0A)](https://discourse.source-robotics.com/) | [![Hackaday](https://img.shields.io/badge/Hackaday-000000?logo=hackaday&logoColor=white)](https://hackaday.io/project/191860-parol6-desktop-robotic-arm) | [![Blog](https://img.shields.io/badge/Blog-Source%20Robotics-blue)](https://source-robotics.com/blogs/blog) ## ⚠️ Safety, Liability & Disclaimer This project includes experimental software, hardware designs, and assembly documentation that are still under development and may contain bugs, errors, or incomplete features. By using, building, or modifying this project, you acknowledge that: * You use this project entirely at your own risk * You are solely responsible for safe assembly, testing, and operation * No guarantee is made regarding correctness, safety, or reliability * The authors are not responsible for any damage, injury, or loss resulting from the use or misuse of this project * Hardware performance and safety depend on user assembly, component quality, calibration, and handling, which cannot be guaranteed * This project is provided “as is.” If you choose to build a device yourself using these files, designs, or instructions, you do so without any warranties or guarantees, including regarding safety, reliability, or suitability for any particular purpose. THIS PROJECT INVOLVES LETHAL VOLTAGES AND OTHER SERIOUS HAZARDS THAT CAN CAUSE SEVERE INJURY. YOU MUST READ THE FULL [SAFETY WARNING AND DISCLAIMER DOCUMENT](SAFETY_WARNING_AND_DISCLAIMER.md) BEFORE USING ANY PROJECT FILES. BY PROCEEDING, YOU ACKNOWLEDGE AND ACCEPT ALL RISKS AND AGREE TO USE THIS PROJECT ENTIRELY AT YOUR OWN RESPONSIBILITY. ## 💸Support us The majority of this project is open source and freely available to everyone. Your assistance, whether through donations or advice, is highly valued. Thank you! [![General badge](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white)](https://paypal.me/PCrnjak?locale.x=en_US) [![General badge](https://img.shields.io/badge/Patreon-F96854?style=for-the-badge&logo=patreon&logoColor=white)](https://www.patreon.com/PCrnjak) ## 🛡️ Licensing Project is under [CERN Open Hardware Licence Version 2 - Strongly Reciprocal](https://github.com/PCrnjak/MSG-compliant-AI-stepper-gripper?tab=CERN-OHL-S-2.0-1-ov-file) --- UPSTREAM MSG_gripper_description/readme.md --- # Source Robotics MSG gripper Description (MJCF) & URDF > [!IMPORTANT] > Requires MuJoCo 3.1.3 or later. ## Changelog See [CHANGELOG.md](./CHANGELOG.md) for a full history of changes. ## Overview This package contains a simplified robot description (MJCF) and URDF files of the [MSG gripper](https://source-robotics.com/products/msg-gripper) developed by [Source Robotics](https://source-robotics.com/). There are 2 available MJCF files. ## Online mujoco viewer https://mujoco-viewer.org/ ## URDF folder [URDF](./URDF/) folder contains: * MSG gripper More about URDF here: [Link](./urdf.md) ## URDF → MJCF derivation steps 1. Loaded the URDF into MuJoCo and saved a corresponding MJCF. 2. Manually edited the MJCF to extract common properties into the `` section. 3. Added position-controlled actuators for the arm. 4. Added `scene.xml` which includes the robot, with a textured groundplane, skybox, and haze. ## License This model is released under an [Apache-2.0 License](LICENSE). ## References Mjcf reference Mujoco managerie - references: - https://mujoco.readthedocs.io/en/stable/XMLreference.html - https://github.com/google-deepmind/mujoco_menagerie/tree/main/ufactory_lite6 - https://github.com/google-deepmind/mujoco_menagerie/blob/main/trossen_vx300s/vx300s.xml - https://github.com/google-deepmind/mujoco_menagerie/blob/main/aloha/aloha.xml - https://github.com/google-deepmind/mujoco_menagerie/blob/main/franka_emika_panda/panda.xml - https://github.com/jeongeun980906/lerobot-mujoco-tutorial/blob/master/asset/robotis_omy/omy.xml --- UPSTREAM MSG_gripper_description/URDF/msg_gripper/package.xml --- msg_gripper 1.0.0

URDF Description package for MSG Gripper

This package contains configuration data, 3D models and launch files for the MSG gripper

TODO BSD catkin roslaunch robot_state_publisher rviz joint_state_publisher_gui gazebo