libcreate/README.md
Jacob Perron 6b90694a84 Catkinize
Update CMakeLists.txt configuration and install rules
Add package.xml
Add config.cmake.in
2016-10-13 13:51:55 -07:00

38 lines
1.6 KiB
Markdown

# libcreate #
C++ library for interfacing with iRobot's [Create 1 and 2](http://www.irobot.com/About-iRobot/STEM/Create-2.aspx) as well as most models of Roomba. [create_autonomy](http://wiki.ros.org/create_autonomy) is a [ROS](http://www.ros.org/) wrapper for this library.
* Documentation: TODO
* Code API: TODO
* Protocol documentation:
- [`V_1`](http://www.ecsl.cs.sunysb.edu/mint/Roomba_SCI_Spec_Manual.pdf) (Roomba 400 series )
- [`V_2`](http://www.irobot.com/filelibrary/pdfs/hrd/create/Create%20Open%20Interface_v2.pdf) (Create 1, Roomba 500 series)
- [`V_3`](https://cdn-shop.adafruit.com/datasheets/create_2_Open_Interface_Spec.pdf) (Create 2, Roomba 600-800 series)
* Author: [Jacob Perron](http://jacobperron.ca) ([Autonomy Lab](http://autonomylab.org), [Simon Fraser University](http://www.sfu.ca))
* Contributors: [Mani Monajjemi](http:mani.im), [Ben Wolsieffer](https://github.com/lopsided98)
## Dependencies ##
* [Boost System Library](http://www.boost.org/doc/libs/1_59_0/libs/system/doc/index.html)
* [Boost Thread Library](http://www.boost.org/doc/libs/1_59_0/doc/html/thread.html)
## Install ##
* `cmake CMakeLists.txt`
* `make`
* `sudo make install`
## Example ##
See source for examples.
Example compile line: `g++ create_demo.cpp -lcreate -lboost_system -lboost_thread`
## Known issues ##
* _Clock_ and _Schedule_ buttons are not functional. This is a known bug related to the firmware.
* Inaccurate odometry angle for Create 1 ([#22](https://github.com/AutonomyLab/libcreate/issues/22))
## Build Status ##
![Build Status](https://api.travis-ci.org/AutonomyLab/libcreate.svg?branch=master)