HTTPS SSH

IMPORTANT: Versioning:

Each of the repositories in the following table has a version number composed of 3 numbers in the form: v x.y.z

Tools [T] Libraries [L] Firmware [F]
qbmove simulink qbAPI qbmove firmware
qbadmin qbmove advanced firmware
hand firmware micro

E.g. xT is the x number of the Tools whereas yF is the y number of the Firmware version.

  • Every change in the number z means a change in the respective repo which not implies changes in other repos.
  • Every change in the number y in a repo is backward compatible reading the table from right to left. This means that if you have some new feature in a Firmware, you can still use old Libraries and Tools for management, but of course you will not be able to use the new features. In this case the rule is yF >= yL >= yT.
  • Every change in the number x means a change which is not backward compatible, hence you will need to update everything to use it. In this case the rule is xF = xL = xT.

Summarising - z independent - yF >= yL >= yT - xF = xL = xT

E.g.

Tools Libraries Firmware Compatible
qbadmin v4.2.3 qbAPI v4.5.0 qbmove firmware v4.6.7 YES
qbadmin v3.2.3 qbAPI v4.5.0 qbmove firmware v4.6.7 NO
qbadmin v4.2.3 qbAPI v4.5.7 qbmove firmware v4.5.0 YES

What is this?

These are the C/C++ libraries to interact with qbMove and qbHand

If you want to use these libraries with qbadmin software, be sure to organize your folder as follows:

  • your_workingcopy
    • qbAPI
    • qbadmin

Installation requirements

The simplest way to compile these libraries is by using the command line utility make. To do so, you will need also the gcc/g++ compiler installed on your system.

NOTE: if it is the first time you use qbrobotics devices on your computer, it is possible that you need to download the drivers to let your computer see the port correctly. To do that visit FTDI driver webpage -> VCP drivers and download the proper driver depending on your OS

Unix

You should have both gcc/g++ and make installed.

MacOSX

Download XCode from Mac App Store, this will install gcc/g++ and make utility.

Windows

Download MinGW and install it. Open MinGW Installation Manager, from the left panel select basic setup, then from the right panel select mingw32-base and mingw32-gcc-g++, then click on Installation -> Apply Changes. This will install the gcc/g++ compiler. To use it from the command line you need to provide to windows the binary path to the executable. Go to System Properties and click on Environment Variables. In the System Variable windows, look for path, select it and click edit. Go to the end of the Variable Value field, add a ; separator and add the path to the binary folder for gcc (usually it is in C:\MinGW\bin).

Download the make utility from here. Follow the installation instruction. In the end you will need to add the binary path to the Environment Variables. To do that follow the previous steps. (Usually the binary folder for the make utility is in C:\Program Files (x86)\GnuWin32\bin).

NOTE: if you have the CMD already opened when performing the installation, you probably will need to reopen a new one to be able to use the utilities.

Compile the libraries

Open the Terminal (UNIX and MacOSX) or the CMD (Windows), reach the /src folder and type make. Depending on your OS you should see a folder tree like this:

  • qbAPI
    • lib_win
      • libqbmove_comm.a
    • objs_win
    • src
    • license.txt
    • README.txt

or this:

  • qbAPI
    • lib_unix
      • libqbmove_comm.a
    • objs_unix
    • src
    • license.txt
    • README.txt

The generated libqbmove_comm.a is a static library and can be used in your own application. It is also used by qbadmin.