This website uses browsing/session and functional cookies to ensure you get the best experience. Learn More


From Wiki for iCub and Friends
Revision as of 12:29, 30 July 2014 by Parmiggiani (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search


.svn iCub hardware repository

To access the documentation there are two options:

  • download all files using a Subversion client (see below)
  • navigate the repository using a web browsers. Just click here.

Browsing the repository with a browser is not convenient; users are suggested to adopt the first method.

The repository is open for anonymous reading. To obtain writing permits e-mail the project administrator (

.svn 101

The basic commands available to .svn for manipulating the repository are:

  • add: to add files and directories to the repository
  • update: to get an up-to-date version of the code from the repository
  • checkout: to get the first-time copy (or a new one) of the repository
  • commit: to upload changes to any file into the repository
Important - Before committing any data to the repository (both Software or Hardware), make sure you setup properly the subversion client flags.

How to download the documentation

Before you download:

  • you need a Subversion (svn) client and perhaps a Sourceforge account. Follow instructions here.


Assuming you have an svn client, type at the console:

  svn co 

this will create in the local directory a new directory containing the iCub project mechanics documentation.


These instructions assume you have the tortoise SVN client. It is trivial to adapt these instructions to other clients.

  • Use file manager to browse to the location where you would like to download the documentation
  • Right click on an empty region of the window
  • Select "SVN checkout" from the contextual menu.

Type (or copy/paste) the following string in the entry "URL of repository": 

this will create in the local directory a new directory containing the iCub project mechanics documentation.

Repository structure

Accessing the iCubHardware repository with the TortoiseSVN client the directory structure is as follows:

  • Image00.pngmechanics
    • Image00.pngoutput_dir
    • Image00.pngpublic
      • Image00.pngcommercial
      • Image00.pngconfig
      • Image00.pngdoc
      • Image00.pngeltr
      • Image00.pnggadgets
      • Image00.pngicub1_icub2
      • Image00.pngikart
      • Image00.pngrelease
      • Image00.pngscrapyard
      • Image20.pngcreo_parametric_customization.ui
    • Image00.pngtrail

The file has been configured for the Creo Parametric assemblies to regenerate correctly with this directory structure. Users are warmly suggested to maintain the current directory structure to avoid potential file conflicts and regeneration issues.

Where are the documentation files

The iCub main assembly is ./mechanics/public/icub1_icub2/icub.asm.1.

The iCub2 main assembly is ./mechanics/public/icub1_icub2/icub2.asm.1.

All the iCub and iCub2 production documentation (.dxf drawings and .stp and .stl 3D files) is stored in a subfolder of the main iCub and iCub2 folder. Its location is ./mechanics/public/icub1_icub2/prodoc

The iKart main assembly is ./mechanics/public/ikart/rc_tlr_013_a_001_ikart.asm.1. The folder “.mechanics/prodoc” contains the robots’ production documents.

All the iKart production documentation (.dxf drawings and .stp and .stl 3D files) is stored in a subfolder of the main iKart folder. Its location is ./mechanics/public/ikart/prodoc

If I develop where should I put my files?

All custom part, assembly, and drawing files of iCub and iCub2 shall be stored in the ./mechanics/public/icub1_icub2 folder.

All commercial parts shall be stored in the ./mechanics/public/commercial folder.

All 3D models of electronic boards, components, etc. parts shall be stored in the ./mechanics/public/eltr folder.

The folder ./mechanics/public/gadgets contains the documentation and CAD files of tools, and ancillary equipment for the operation, and maintenance of the robot.

What are the other folders for?

The folder ./mechanics/public/config contains the PTC Creo Parametric custom configuration files.

The folder ./mechanics/public/doc contains relevant iCub project documentation files.

The folder ./mechanics/public/scrapyard contains old and obsolete iCub project files.

The folder ./mechanics/output_dir is used as a temporary storage folder for the scripts that automatically generate the project documentation.

The folder ./mechanics/trail is used to store the trail files automatically generated by Creo Parametric.

Personal tools