Skip to content

Latest commit

 

History

History
81 lines (65 loc) · 2.68 KB

README.md

File metadata and controls

81 lines (65 loc) · 2.68 KB
Raw

Freecad to Gazebo exporter

Introduction

Freecad to gazebo exporter is a tool for exporting freecad assembly project to gazebo/ros model.

Design Rules

This project is in its early stage therefore specific design rules must be followed to work with it.

  • The assmbly file must be created with A2Plus (freecad's prefered assembly workspace).
  • Parts of the assembly must be in separate files.
  • Imovable parts of the main assembly must be made in separate subasssemblies.
  • Joints should be represented by AxisConsident constraints with lock rotation turned off.
  • For URDF files to work properly, tree structure must be maintained (ie. parent and childs of constraints must follow tree structure).

Requirements

  • Freecad with A2Plus workspace installed
  • ROS Optional, If you wish to install it as a package

Usage

Clone the repository to catkin workspace

$ git clone https://github.com/Dave-Elec/freecad_to_gazebo.git ~/catkin_ws/src

Re-build catkin workspace

$ catkin_make
$ source devel/setup.bash

To generate only SDF model from freecad assembly:

# freecad2gazebo <assembly_file> <path/to/model_dir> --sdf-only

To generate SDF and URDF model from freecad assembly:

$ freecad2gazebo <assembly_file> <path/to/model_dir>

Note: Only links and joints are generated in the SDF model. to use the model with ros, use the URDF model.

Options

$ freecad2gazebo <assembly_file> <path/to/model> [--sdf-only] [--noexport] [--config <path/to/config>]

--sdf: Export only SDF.

--noexport: Don't export mesh files.

--config: Use other configuration file. (default is robot_config.json inside a directory the same as the assembly file).

Example config file

{
    "name": "robot_name",
    "joints_limits": {"upper": 90, "lower": -90, "effort": 10, "velocity": 5},
    "transmission": {
        "type": "transmission_interface/SimpleTransmission",
        "hardware_interface": "hardware_interface/PositionJointInterface"
    },
    "joints_config": {
        "type": "position_controllers/JointGroupPositionController",
        "grouped": true
    },
    "joints_pid": {"p": 20.0, "i": 10.0, "d": 0.0, "i_clamp": 0.0},
    "root_link": "base_link",
    "ros_package": "humanoid_17dof_description"
}

Future plans

  • Extend collada exporter to export materials from assemblies.
  • Create a FreeCAD workbench to interactively assign joints and export to gazebo.
  • Reduce set of design rules by making it more robust and general perpouse.
  • Support any valid structures of assemblies.