Skip to content
A cross-platform C++ library for controlling Pololu Maestro devices
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmake Updated RapaFindQt.cmake Jan 1, 2016
docs
include
samples Initial commit Mar 21, 2015
src
CMakeLists.txt
LICENSE
README.md

README.md

RapaPololuMaestro

A cross-platform C++ library for controlling Pololu Maestro devices

alt text alt text alt text

Overview

RapaPololuMaestro (formerly Polstro) is a lightweight cross-platform C++ library that provides access, in an object-oriented fashion, to one or more Pololu Maestro servo-controller devices connected to the computer.

The communication is based on the [Serial Interface protocol](http://www.pololu.com/docs/0J40/5.c Serial Interface), not the native USB interface (which offers more advanced functionalities).

With RapaPololuMaestro it's possible to:

  • set/get the target position of any servo connected to the Maestro device (from 6 to 24 depending on the Maestro model)
  • set the speed and acceleration at which the Maestro changes the position.

Note that by servo here we mean any RC component that is driven by a PWM signal. This can be for example an ESC (Electronic Speed Controller) that controls a brushless motor.

The code is based on the cross-platform C and [Windows examples](http://www.pololu.com/docs/0J40/5.h.2 Windows) provided by Pololu.

Example of use

#include "RPMSerialInterface.h"

int main( int argc, char** argv )
{
    // Create the interface
    RPM::SerialInterface* serialInterface = RPM::SerialInterface::createSerialInterface( "COM4", 9600 );
    if ( !serialInterface->isOpen() )
        return -1;

    // Set the value of channel 0 to 6000 quarter-of-microseconds (i.e. 1.5 milliseconds)
    serialInterface->setTargetCP( 0, 6000 );

    // Delete the interface
    delete serialInterface;

    return 0;
}

Compiling the code

RapaPololuMaestro uses CMake 3 to create the build system corresponding to the platform. You need to have it installed on your system, please visit CMake for more information.

After downloading the source code and opening a console in the main source folder, creating the build system can be done like this:

mkdir _build_
cd _build_
cmake .. -DCMAKE_INSTALL_PREFIX=../_output_ 

You should then have a build system ready to use for your platform (for example, a Visual Studio solution on Windows, a makefile on Linux, etc...).

The build process generates a static library, and two samples:

  • a command-line test program.
  • a GUI program to control a Maestro interactively

The GUI uses Qt as a dependency. If it can't be found on your system, the GUI program will simply be not built. Either Qt4 or Qt5 can be used. You can specify one or the other using the RAPA_USE_QT5 CMake variable. For example, to compile using QT4:

cmake .. -DCMAKE_INSTALL_PREFIX=../_output_ -DRAPA_USE_QT5=OFF

If CMake doesn't find Qt automatically, you can point it to the appropriate folder. In this example we also compile for Visual Studio 12 2013 in 64 bits:

cmake .. -DCMAKE_INSTALL_PREFIX=../_output_ -DCMAKE_PREFIX_PATH=C:\SomePath\Qt\5.5\msvc2013_64 -G "Visual Studio 12 2013 Win64" 

Once the compilation done, you can deploy/install RapaPololuMaestro as a standalone SDK, by building the INSTALL target/project generated by CMake. This will copy the headers, libs and binaries into the directory designated by the standard CMAKE_INSTALL_PREFIX variable.

You can’t perform that action at this time.