A communication framework for robotics and the Internet of Things, developed by Wason Technology, LLC
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
RobotRaconteurCore
RobotRaconteurGen
RobotRaconteurJava
RobotRaconteurMex
RobotRaconteurNET
RobotRaconteurPython
RobotRaconteurPython3
SWIG
cmake
testing
.gitignore
CMakeLists.txt
LICENSE.txt
README.md

README.md

Robot Raconteur Core Library and Wrappers

A communication framework for robotics, automation, and the Internet of Things

http://robotraconteur.com

J. Wason, "Robot Raconteur® version 0.8: An Updated Communication System for Robotics, Automation, Building Control, and the Internet of Things", in Proc. IEEE Conference on Automation Science and Engineering, 2016, pp. 595-602.

WARNING: THIS REPOSITORY CONTAINS UNFINISHED SOFTWARE

Release Version 0.8.1 can be downloaded from http://robotraconteur.com/download. Registration is required due to US export restrictions on binary software.

Building

The software has been tested with Visual Studio 2017 and Boost 1.65.1, Ubuntu Xenial, and Mac OSX with Boost 1.65.1.

Windows

Building the core library requires Visual Studio 2017, Boost 1.65.1, and CMake. Follow the instructions on the Boost website to build Boost. CMake uses FindBoost to locate the boost libraries.

Ubuntu Xenial

Install the dependencies:

apt-get install default-jdk default-jdk-headless default-jre default-jre-headless python2.7-minimal libpython2.7 python2.7-dev libpython2.7-dev libssl1.0.0 zlib1g zlib1g-dev libssl-dev libusb-1.0-0 libusb-1.0-0-dev libdbus-1-3 libdbus-1-dev libbluetooth3 libbluetooth-dev zlib1g zlib1g-dev python-numpy git cmake-qt-gui g++ make libboost-all-dev autoconf automake libtool bison libpcre3-dev

To build:

mkdir build && cd build
cmake -DBUILD_GEN=ON -DBUILD_TEST=ON -DBoost_USE_STATIC_LIBS=OFF ..
make

Mac OSX

Build Boost using utility: https://github.com/faithfracture/Apple-Boost-BuildScript

Make the following changes to boost.sh

`BOOST_VERSION=1.65.1`
`BOOST_LIBS="atomic chrono date_time exception filesystem program_options random signals system thread test regex"`

Build OpenSSL using utility script: https://github.com/keeshux/OpenSSL-Apple. Make sure that you are not building against the old OpenSSL library included in MacOSX.

Configure build for XCode using CMake GUI. Open resulting project file and build.

Swig

Python, Java, and C# use SWIG to generate intearnal language bindings. Due to a bug in SWIG, a forked repo must be used to build SWIG from source. The SWIG source can be found here: https://github.com/johnwason/swig. Note that C# cannot currenty be built on Mac OSX or Linux.

MATLAB Mex

MATLAB install required for build. CMake FindMatlab module is used to locate the MATLAB build dependencies. Be sure to build the MEX file against static boost libraries. Linux will require Boost to be built from source with "-fPIC" C++ gcc option. The apt repository static libraries cannot be used because they were not built with "-fPIC".

Documentation

Documentation for version 0.8.1 can be found at https://robotraconteur.com/documentation. Documentation is being updated for the upcoming 0.9 release.

License

The Robot Raconteur core library is Apache 2.0 licensed.

"Robot Raconteur" and the Robot Raconteur logo are registered trademarks of Wason Technology, LLC. All rights reserved.

Robot Raconteur is patent pending.

Robot Raconteur is developed by Dr. John Wason, Wason Technology, LLC