Command line tools for qbmoves and hands
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
|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|
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
You should have both gcc/g++ and make installed.
Download XCode from Mac App Store, this will install gcc/g++ and make utility.
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
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
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 software
Fisrt of all you need to download the
repository and be sure to have a file tree organised like this (remove the
Then you will need to compile the libraries.
To do that, go to
qbAPI/src and type
Then, to compile the tools, go to
qbadmin/src folder and type
If everything is ok, depending on your OS, you should see a folder tree like this:
Using the tools
Usign a terminal, go to the binary folder and execute what you need e.g.:
By executing the tools you will receive the usage instruction