README 3.65 KB
Newer Older
lm's avatar
lm committed
1
QGroundControl Open Source Micro Air Vehicle Ground Control Station
pixhawk's avatar
pixhawk committed
2

3 4 5 6 7 8 9
Project:
http://qgroundcontrol.org

Files:
http://github.com/pixhawk/qgroundcontrol
http://github.com/pixhawk/mavlink

pixhawk's avatar
pixhawk committed
10 11
Credits:
http://qgroundcontrol.org/credits
12 13 14 15 16

**********************************************************************************************
* PLEASE NOTE: YOU NEED TO DOWNLOAD THE MAVLINK LIBRARY IN ORDER TO COMPILE THIS APPLICATION *
**********************************************************************************************

pixhawk's avatar
pixhawk committed
17

18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36
Mac OS X
========

To build on Mac OS X (10.5 or later):

Install SDL
-----------
1) Download SDL from:  <http://www.libsdl.org/release/SDL-1.2.14.dmg>

2) From the SDL disk image, copy the `sdl.framework` bundle to `/Library/Frameworks` directory (if you are not an admin copy to `~/Library/Framewroks`)

Install QT with Cocoa
----------------------
1) Download Qt 4.6.2 with Cocoa from `http://get.qt.nokia.com/qt/source/qt-mac-cocoa-opensource-4.6.2.dmg` 

2) Double click the package installer

Get the MAVLINK Library
-----------------------
37
1) Clone the MAVLINK repository : `git clone git@github.com:pixhawk/mavlink.git`. **NOTE:** Make sure that the mavlink directory is in the same directory as groundcontrol. QGround control will look for mavlink library in ../mavlink
38 39 40 41 42 43 44 45 46 47 48 49 50

Build QGroundControl
--------------------
1) From the terminal go to the `groundcontrol` directory

2) Run `qmake`

3) Run `xcodebuild -configuration Release` or open `qgroundcontrol.xcodeproj` in Xcode and build.


Linux 
=====

51

52
To build on Linux:
53

54 55 56
sudo apt-get install phonon libqt4-dev \
 libphonon-dev libphonon4 phonon-backend-gstreamer \
qtcreator libsdl1.2-dev libflite1 flite1-dev build-essential
57 58 59 60 61 62

cd directory

git clone git@github.com:pixhawk/mavlink.git
git clone git@github.com:pixhawk/qgroundcontrol.git

oberion's avatar
oberion committed
63 64 65 66
go to thirdParty -> libxbee 

Create Library -> Readme file in folder

67 68 69 70 71 72 73 74 75 76
Ubuntu Application Menu -> Development -> Qt Creator

QtCreator Menu File -> Open File or Project..

Open directory/qgroundcontrol/qgroundcontrol.pro

Hit the green play button to compile and launch it

Done.

Hugo Vincent's avatar
Hugo Vincent committed
77

78 79 80
Windows
=======

81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108
DETAILED STEPS BELOW THE VISUAL STUDIO 2010 NOTES.
GNU GCC / MINGW IS UNTESTED, COULD WORK
VISUAL STUDIO 2008 / 2010 EXPRESS EDITION IS FREE!

-------------------------------------------------------------------------------------
VISUAL STUDIO 2010 NOTES (VS 2008 runs out-of-the-box, just follow the steps below):

For use of Qt 4x with Visual Studio 2010 Add-in.

Visual studio adds automatically certain defines that are wrong and cause errors.
To resolve this, execute these steps:

In the projects properties -> C/C++ ->preprocessor change:

in DEBUG:
	delete QT_NO_DEBUG

in both (DEBUG / RELEASE):
	delete QT_NO_DYNAMIC_CAST
-------------------------------------------------------------------------------------




Steps for Visual Studio 2008 / 2010. (VS 2008 is easier, VS 2010 only recommended for
expert developers)


109
Windows XP/7:
110

111
1) Download and install the Qt SDK for Windows from http://qt.nokia.com/downloads/ (Visual Studio 2008 version) OR download Qt source and compile with VS 2010
112

113
2) Download and install Visual Studio 2008 Express Edition (free) OR VS 2010 Express Edition
114

oberion's avatar
oberion committed
115 116 117 118 119
3) Go to the QGroundControl folder and then to thirdParty -> libxbee

4) Build the library. See win32.README 

5) Go to the source folder of QGroundControl with the Qt 4.7.x Command Prompt tool (from the applications menu)
120

oberion's avatar
oberion committed
121
6) Create the Visual Studio project by typing:
122 123 124

qmake -tp vc qgroundcontrol.pro

oberion's avatar
oberion committed
125
7) Now start Visual Studio and load the qgroundcontrol.vcproj file
126

oberion's avatar
oberion committed
127
8) Compile and edit in Visual Studio. If you need to add new files, add them to qgroundcontrol.pro and re-run "quake -tp vc qgroundcontrol.pro"
128

pixhawk's avatar
pixhawk committed
129