• AutoQuad Project

• AutoQuad Forums

• QGC AQ Release Notes

• AutoQuad Compiled Software and Firmware Downloads:

  • http://autoquad.org/software-downloads/
  • ftp://ftp.autoquad.org/3/334693_22529/

• Original QGroundControl Project and Credits

There are three ways to obtain the QGroundControl source code from our GitHub repository. You can either download a snapshot of the code in a ZIP file, clone the repository, or fork the repository if you plan to contribute to development. If you prefer one of the last two options you will need Git installed on your system; goto GitHub Help and see Set Up Git.

This option assumes that you have Git already. To clone (checkout) the QGC repository, run the following command in the directory that you want the qgroundcontrol_aq folder to be created:

git clone https://github.com/AutoQuad/qgroundcontrol_aq.git

If you plan to contribute to the development of QGC, you will want this option, which also requires that you have Git set up. To fork the QGC repository, do the following:

Goto GitHub Help and see Fork A Repo Fork the QGC Repo

QGroundControl builds are supported for OSX, Linux and Windows. Qt versions 4.8.6 and 5.x are supported (Qt5 recommended, tested up to 5.4 at time of writing). See the individual sections below for specific requirements for each OS.

To build without Text-To-Speech (and skip the corresponding optional, possibly onerous, steps below), you need to add "NO_TEXT_TO_SPEECH" to your Qt DEFINES variable. You can do this by un-commenting "#DEFINES += NO_TEXT_TO_SPEECH" in qgroundcontrol_aq.pro.

In general we recommend installing the latest Qt libraries and development environment (QtCreator), as this will provide the simplest and most tested build setup.

1. Download and install Qt 5 (including QtCreator) for your OS from: http://www.qt.io/download-open-source/
2. Choose the Qt flavor which matches your development environment, see OS-specific notes below.
3. Install Qt as per their instructions.

1. Open the qgroundcontrol_aq.pro file (at the root of this project) in QtCreator.
2. In the project Build Settings, expand the "Make" step and in the "Make arguments" field enter: release install (or debug install for debug type build).
3. Assuming all the requirements below are met, you should be able to initiate a build (big green button on lower left of QtCreator). Make sure you first select the proper build type (Release or Debug) using the menu just above the green arrow button.

Supported builds for Linux are 32 or 64-bit, built using gcc.

• For Ubuntu (requires 14.10 for Qt5.3): sudo apt-get install qtcreator qttools5-dev qtbase5-dev qt5-default qtdeclarative5-dev libqt5svg5-dev libqt5webkit5-dev libsdl1.2-dev build-essential libudev-dev
• For Fedora: sudo yum install qt-creator qt5-qtbase-devel qt5-qtdeclarative-devel qt5-qtsvg-devel qt5-qtwebkit-devel SDL-devel SDL-static systemd-devel
• For Arch Linux: pacman -Sy qtcreator qt5-base qt5-declarative qt5-serialport qt5-svg qt5-webkit

• For text-to-speech (espeak)
  • For Ubuntu: sudo apt-get install curl libasound2-dev libncurses5-dev festival festival-dev
  • For Fedora: sudo yum install curl libasound2-dev libncurses5-dev festival festival-dev
  • For Arch Linux: pacman -Sy festival festival-dev

1. [Optional] For text to speech support, first go to libs/QtSpeech and run: sh ./get-festival.sh (this may produce some errors but should still be OK in the end).
2. Build using QtCreator as described above. Alternately, build from the command line:
3. Change directory to you qgroundcontrol_aq source directory.
4. Run qmake
5. Run make

By default requires clang 64-bit compiler typical on modern OS X. Compilation has been tested up to OS X Mavericks. You shouldn't need anything else. Just open the project file in QtCreator and build, as described above.

Note that the Google Earth plugin does not work with 64-bit builds. To buld a version with a working Google Earth plugin, one must use 32 bit Qt libraries. At the time of this writing, this means building the libraries from source, using the ./configure -arch x386 option.

Supported builds for Windows are 32bit (64b might work, not tested), using MSVC 2010 or higher. MinGW/GCC might work, but not tested.

Currently to build with Speech support (QtSpeech) requires MSVC 2010 (VC10) compiler (either Visual Studio 2010 or Windows SDK 7.1).

Apparent bug with Qt 5.4 and MSVC 2013: You must revert this change: https://qt.gitorious.org/qt/qtbase/commit/9f0e5d00ab51cc7c0dc87c8d72f48c4e6eda This file can be found in your Qt install folder, eg: Qt/5.4/msvc_2013_opengl/mkspecs/win32-msvc2013/qmake.conf. Remove the "-Zc:strictStrings" part from both lines (28 and 29).

Obtain an MSVC development environment (compiler/linker/etc) if you don't have one yet. The simplest way it probably to install a Visual Studio package, although the SDKs provide similar functionality but w/out the massive overhead of the IDE (editor) which you don't really need. If using VS, make sure you install the Windows Desktop version.

When installing Qt, you need to choose which compiler you're using, and how many bits. Choose the variant that matches your MSVC version, and pick the 32-bit variant with OpenGL support.

Optional for Text To Speech:

• First follow the instructions in libs/QtSpeech/INSTALL.txt (in the qgroundcontrol_aq root folder).
• If you do not have Visual Studio PRO version installed, you also need the ATL MFC developer package. The simplest way to get this is to download the Windows Driver Kit Version 7.1.0 (http://www.microsoft.com/en-us/download/details.aspx?id=11800). Mount the ISO and run the installer, then select the "Build Environments" feature (also keep Debuggin Tools checked if it is already). Install it to the folder of your choice (you can remove it later). Once installed, find the inc/atl71 folder and copy the contents to C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\atlmfc. Then find the lib/ATL/i386 folder and copy the contents to C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\lib. (For 32-bit systems, adjust the paths accordingly and then edit the path definitions in the /libs/QtSpeech/qtspeech.pri file.)

Simply open the qgroundcontrol_aq.pro file in QtCreator, adjust the build directories on the opening screen if needed. You should be able to simply build the project now using the Build button or CTRL-B.

1. Open the Qt Command Prompt program from the Start Menu
2. Change directory to your 'qgroundcontrol_aq' source folder.
3. Run qmake -tp vc qgroundcontrol.pro. This will create a 'qgroundcontrol.vcxproj' project file which is capable of building both debug and release configurations.
4. Now open the generated 'qgroundcontrol.vcxproj' file in Visual Studio.
5. Compile and edit in Visual Studio. If you need to add new files, add them to src/src.pri and re-run qmake from step 3.

QGroundControl Creator: Lorenz Meier lm@inf.ethz.ch (c) 2009-2011 QGroundControl Developers

AutoQuad Maintainer: Maxim Paperno MPaperno@WorldDesign.com (c) 2013-2015 Maxim Paperno

Original Conversion for AutoQuad (c) 2012-2013 by Peter Hafner

This file is part of the open source AutoQuad project. QGroundControl AQ is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. QGroundControl AQ is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with QGroundControl AQ. If not, see http://www.gnu.org/licenses/.