Skip to content

bionicdl-sustech/ACDC4Robot

Repository files navigation

ACDC4Robot: Automated Conversion of Description Conventions for Robots from Design to Learning

Introduction

Robot description format (RDF) contains information about robot model which is required by simulation, visualization, planning etc. In this project, we provide a Fusion360 Add-In for generating robot description files automatically from robot design.

Currently, this Add-In supports exporting URDF and SDFormat. URDF (Unified Robotics Description Format) has been the most widely used robot description format, but has several limitations and lack of update. SDFormat (Simulation Description Format) has more features than URDF, such as supporting closed loop chain mechanism. Other robot description formats might be supported in the future.

Also, we provide a Fusion 360 robot model library that can be used out-of-box for design, simulation, and learning. 👉🤖Fusion 360 Robot Library

Features

Export robot descriptions files from Fusion360 design file directly with GUI panel.

  • Support 3 Fusion360 joint motion types:
    • Fixed joint type
    • Revolute joint type with limitation
    • Slider joint type with limitation
  • Supported robot description formats:
    • URDF (Unified Robotics Description Format)
    • SDFormat (Simulation Description Format) or SDF
    • MJCF (MuJoCo Format)

Installation

You can install this Add-In manually or by shell command.

Manually Installation

Download and copy /Add-IN/Fusion2Robot folder into Fusion360's Add-in directory which should be:

Windows:

%appdata%\Autodesk\Autodesk Fusion 360\API\AddIns

Mac:

$HOME/Library/Application Support/Autodesk/Autodesk Fusion 360/API/AddIns

or it can be found at Preferences -> General -> API -> Default Path for Scripts and Add-Ins.

Installation Using Shell Command

Windows (PowerShell):

cd <path to /Add-In/Fusion2Robot>
Copy-Item ".\Fusion2Robot\" -Destination "${env:APPDATA}\Autodesk\Autodesk Fusion 360\API\AddIns\" -Recurse

macOS (Terminal):

cd <path to /Add-In/Fusion2Robot>
cp -r ./Fusion2Robot "$HOME/Library/Application Support/Autodesk/Autodesk Fusion 360/API/AddIns/"

First Run

After installation for the first time, use Shift+S or click UTILITIES -> Add-Ins -> Scripts and Add-Ins to open Scripts and Add-Ins window.

Find Fusion2Robot at Add-Ins -> My Add-Ins, select Fusion2Robot and click Run(for normally use, please select Run on Startup). Then the icon will appear beside UTILITIES -> Add-Ins icon. Run the Add-In Click the icon to start exporting process from the current design.

Usage

Before Using This Add-In

Before exporting robot description files, please follow the following instructions to make sure the design file is suitable to execute this add-in.

To prevent unexpected modification of the original design, it is better to run this add-in in a copy of the design file.

  • Exit parametric mode: right click the root component of the design, choose Do not capture Design History Do not capture Design History
  • Set the default unit of the design document to m Change Units
  • Using Break Link to make external component into internal component Break Link
  • Occurrences refer to the same component are not supported yet, use Make Independent to independ those occurrences. Make Independent
    • Make sure all the components are named with alphanumeric characters, underscore character _, and hyphe character -. Other languages and characters might cause problems.

After Setting Up Design File

Click the add-in icon, then chose the robot description format and targeted simulation platform to export. Execute Fusion 360 Add-In

Tested Examples

Closed Chain Linkages

  • Test a closed loop linkages in Gazebo to show the ability of SDFormat to describe a closed-chain mechanism Test Four Bar Linkages

Robot Manipulator: UR5e

  • Test a UR5e manipulator in Gazebo Test UR5e manipulator

Robot Gripper: Robotiq-2F85-Gripper

  • Test Robotiq-2F85 Gripper in Gazebo Test Robotiq-2F85 Gripper

Robot Library

🤖Fusion 360 Robot Library

We also provides some robot models that assembled by us, and tested the Add-In with these models. Hope this robot models can save your time and your energy.

FAQ

Citation

Reference

About

ACDC4Robot: Automated Conversion of Description Conventions for Robots from Design to Learning

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages