taskSavannah Administration - Tasks: task #8211, Submission of iRobot Create...


task #8211: Submission of iRobot Create communication library

Submitted by:  Thomas Moulard <thomas_moulard>
Submitted on:  Sat 31 May 2008 02:09:50 AM UTC  
Should Start On:  Fri 30 May 2008 07:00:00 AM UTC Should be Finished on:  Mon 09 Jun 2008 07:00:00 AM UTC
Category:  Project Approval Priority:  5 - Normal
Status:  Done Privacy:  Public
Percent Complete:  0% Assigned to:  Alexander Shulgin <alexshulgin>
Open/Closed:  Closed Effort:  0.00

Add a New Comment (Rich Markup)

You are not logged in

Please log in, so followups can be emailed to you.


( Jump to the original submission)

Wed 27 Aug 2008 09:10:57 PM UTC, comment #10: 

I've approved your project.  You'll receive a mail with further instructions shortly.

Before uploading the sources, please update your copyright headers. :-)


Alexander Shulgin <alexshulgin>In charge of this item.
Wed 27 Aug 2008 09:07:52 PM UTC, comment #9: 

OK, I'll change that tomorrow.

No, I would prefer having my project approved quicker if possible and then making it match the requirements to be a GNU package.

Thomas Moulard <thomas_moulard>
Wed 27 Aug 2008 08:17:37 PM UTC, comment #8: 


This copyright notice looks good. :)

Do you really want to make your project an official GNU software package?  If not, I can change the project details upon approval.


Alexander Shulgin <alexshulgin>In charge of this item.
Wed 27 Aug 2008 07:43:13 PM UTC, comment #7: 

My adviser told me to put this, does it look ok for you?

Copyright (C) 2008 by Thomas Moulard, the University of Southern California (USC), and iLab at USC

Thomas Moulard <thomas_moulard>
Mon 25 Aug 2008 08:23:23 PM UTC, comment #6: 

Nice to hear this.  Please notify us when you get response from iLab. :-)


Alexander Shulgin <alexshulgin>In charge of this item.
Mon 25 Aug 2008 08:19:26 PM UTC, comment #5: 

I think so (http://ilab.usc.edu/) but I'm checking with my adviser to see what should be the best. The library has been written while I was during an internship at this lab.

The Assembla space is only here to allow me to get feedback and save my work while the project is under review here. It'll be closed if the project get accepted.

Thomas Moulard <thomas_moulard>
Mon 25 Aug 2008 07:34:24 PM UTC, comment #4: 

Hm... you put 'iLab' as the copyright holder in your files.  Is 'iLab' a legal entity and really owns the copyright?

Also, if you want to host your project at Savannah the development should happen primarily here, as we don't allow Savannah to be just a file mirror.


Alexander Shulgin <alexshulgin>In charge of this item.
Mon 25 Aug 2008 07:00:15 PM UTC, comment #3: 

Thanks, I've fixed that.

The current repository can be seen here:

I've also updated the archive.

(file #16354)

Thomas Moulard <thomas_moulard>
Sun 24 Aug 2008 09:22:41 PM UTC, comment #2: 


Sorry for delay in review.

Your license headers seem to be OK, however you are missing the copyright headers.  Please add them in the following form before the license block:

Copyright (C) <year> <author>

Besides that your project seems to be OK and can be approved shortly. :-)

Yeah, you should contact GNU evaluation team in order to become an official GNU package.  Please read this for details: http://www.gnu.org/help/evaluation.html


Alexander Shulgin <alexshulgin>In charge of this item.
Fri 18 Jul 2008 11:07:48 PM UTC, comment #1: 

Here is an update of my library, just to highlight the fact that I'm still wanting to be hosted on Savannah and I'm still interested by the project.
If an admin could take an eye at my project, I have time next week to fix any possible issue. However from July 25th from August 19th, I probably won't have access to my e-mail so don't be surprised if you don't obtain a quick answer.

Additional documentation if available here:


(file #16153)

Thomas Moulard <thomas_moulard>
Sat 31 May 2008 02:09:50 AM UTC, original submission:  

A new project has been registered at Savannah
This project account will remain inactive until a site admin approves or discards the registration.

Registration Administration

While this item will be useful to track the registration process, approving or discarding the registration must be done using the specific Group Administration page, accessible only to site administrators, effectively logged as site administrators (superuser):

Registration Details

  • Name: iRobot Create communication library
  • System Name:  libirobot-create
  • Type: Official GNU software
  • License: GNU General Public License v3 or later


This library provides easy and safe communication to the iRobot Create robot by implementing the Open Interface version 2 protocol.

iRobot is a robot manufacturing company (http://www.irobot.com/).
The Open Interfance open specification is available here:

This project is written in C++, use Autotools for the building mechanisms and Doxygen for code documentation.

The goal is providing a standard, free, library to communicate with this robot. It should also be simple to use as many scientists who are using the robot are not programming experts. I haven't seen any equivalent project except a Java library.

  • Already advanced project (only the sensor part still have to be implemented)
  • Well documented
  • Well tested
  • Small light-weight library (about 1800 lines).
  • Bundled with a command line tool control software for the robot (irobot-create-ctl).

Here is a sample about how to use this library:
#include <fstream>
#include <irobot-create.hh>

int main (int argc, char** argv)
  using namespace iRobot;

  if (argc < 2)
    return 1;
  std::fstream stream (argv[1]);
  Create robot (stream);

    robot.sendDemoCommand (Create::DEMO_COVER);
    // You can add more commands here.
  catch (InvalidArgument& e)
    std::cerr << e.what () << std::endl;
    return 1;
  catch (CommandNotAvailable& e)
    std::cerr << e.what () << std::endl;
    return 2;

Other Software Required:

No dependencies (except libstdc++).

Other Comments:

This library is designed to be portable. My main target is not Microsoft Windows however I'll make this library available for this OS (some goes for Mac OS X).

I also does not yet provide texinfo documentation. This
is mainly due to the fact that the project is not totally finished (and therefore the API will still probably change).

Last thing: I am not affiliated by iRobot and this is not an official library.

Tarball URL:


Thomas Moulard <thomas_moulard>


(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:

Attached Files
file #16354:  libirobot-create-0.1.tar.gz added by thomas_moulard (414KiB - application/x-gzip - Update version with fixed copyright headers.)
file #16153:  libirobot-create-0.1.tar.gz added by thomas_moulard (414KiB - application/x-gzip - New version.)


Depends on the following items: None found

Items that depend on this one: None found


Carbon-Copy List
  • -email is unavailable- added by alexshulgin (Posted a comment)
  • -email is unavailable- added by thomas_moulard (Submitted the item)

    Do you think this task is very important?
    If so, you can add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.




    Follow 6 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2008-08-27 alexshulgin StatusWait reply => Done
        Open/ClosedOpen => Closed
    2008-08-25 thomas_moulard Attached File- => Added libirobot-create-0.1.tar.gz, #16354
    2008-08-24 alexshulgin StatusNone => Wait reply
        Assigned toNone => alexshulgin
    2008-07-18 thomas_moulard Attached File- => Added libirobot-create-0.1.tar.gz, #16153

    Back to the top

    Powered by Savane 3.5