QGCApplication.h 6.49 KB
Newer Older
1 2 3 4 5 6 7 8
/****************************************************************************
 *
 *   (c) 2009-2016 QGROUNDCONTROL PROJECT <http://www.qgroundcontrol.org>
 *
 * QGroundControl is licensed according to the terms in the file
 * COPYING.md in the root of the source code directory.
 *
 ****************************************************************************/
dogmaphobic's avatar
dogmaphobic committed
9

pixhawk's avatar
pixhawk committed
10 11 12

/**
 * @file
13
 *   @brief Definition of main class
pixhawk's avatar
pixhawk committed
14 15 16 17 18
 *
 *   @author Lorenz Meier <mavteam@student.ethz.ch>
 *
 */

Don Gagne's avatar
Don Gagne committed
19 20
#ifndef QGCAPPLICATION_H
#define QGCAPPLICATION_H
pixhawk's avatar
pixhawk committed
21 22

#include <QApplication>
23
#include <QTimer>
Don Gagne's avatar
Don Gagne committed
24
#include <QQmlApplicationEngine>
pixhawk's avatar
pixhawk committed
25

Don Gagne's avatar
Don Gagne committed
26
#include "LinkConfiguration.h"
27 28 29 30 31 32
#include "LinkManager.h"
#include "MAVLinkProtocol.h"
#include "FlightMapSettings.h"
#include "FirmwarePluginManager.h"
#include "MultiVehicleManager.h"
#include "JoystickManager.h"
33
#include "AudioOutput.h"
34 35
#include "UASMessageHandler.h"
#include "FactSystem.h"
Don Gagne's avatar
Don Gagne committed
36

37
#ifdef QGC_RTLAB_ENABLED
38 39
#include "OpalLink.h"
#endif
40

41 42 43
// Work around circular header includes
class QGCSingleton;
class MainWindow;
44
class QGCToolbox;
Don Gagne's avatar
Don Gagne committed
45

pixhawk's avatar
pixhawk committed
46 47 48 49 50 51 52
/**
 * @brief The main application and management class.
 *
 * This class is started by the main method and provides
 * the central management unit of the groundstation application.
 *
 **/
Don Gagne's avatar
Don Gagne committed
53 54 55 56 57 58
class QGCApplication : public
#ifdef __mobile__
    QGuiApplication // Native Qml based application
#else
    QApplication    // QtWidget based application
#endif
pixhawk's avatar
pixhawk committed
59
{
60
    Q_OBJECT
dogmaphobic's avatar
dogmaphobic committed
61

pixhawk's avatar
pixhawk committed
62
public:
DonLakeFlyer's avatar
DonLakeFlyer committed
63
    QGCApplication(int &argc, char* argv[], bool unitTesting);
Don Gagne's avatar
Don Gagne committed
64
    ~QGCApplication();
dogmaphobic's avatar
dogmaphobic committed
65

Don Gagne's avatar
Don Gagne committed
66 67
    /// @brief Sets the persistent flag to delete all settings the next time QGroundControl is started.
    void deleteAllSettingsNextBoot(void);
dogmaphobic's avatar
dogmaphobic committed
68

Don Gagne's avatar
Don Gagne committed
69 70
    /// @brief Clears the persistent flag to delete all settings the next time QGroundControl is started.
    void clearDeleteAllSettingsNextBoot(void);
dogmaphobic's avatar
dogmaphobic committed
71

72
    /// @brief Returns true if unit tests are being run
Don Gagne's avatar
Don Gagne committed
73
    bool runningUnitTests(void) { return _runningUnitTests; }
dogmaphobic's avatar
dogmaphobic committed
74

75 76 77
    /// @brief Returns true if Qt debug output should be logged to a file
    bool logOutput(void) { return _logOutput; }

Don Gagne's avatar
Don Gagne committed
78
    /// Used to report a missing Parameter. Warning will be displayed to user. Method may be called
79
    /// multiple times.
Don Gagne's avatar
Don Gagne committed
80
    void reportMissingParameter(int componentId, const QString& name);
81

Don Gagne's avatar
Don Gagne committed
82
    /// Show a non-modal message to the user
83
    void showMessage(const QString& message);
84

dogmaphobic's avatar
dogmaphobic committed
85 86 87
    /// @return true: Fake ui into showing mobile interface
    bool fakeMobile(void) { return _fakeMobile; }

88 89 90
#ifdef QT_DEBUG
    bool testHighDPI(void) { return _testHighDPI; }
#endif
91 92 93

    // Still working on getting rid of this and using dependency injection instead for everything
    QGCToolbox* toolbox(void) { return _toolbox; }
dogmaphobic's avatar
dogmaphobic committed
94 95 96 97

    /// Do we have Bluetooth Support?
    bool isBluetoothAvailable() { return _bluetoothAvailable; }

98 99 100
    /// Is Internet available?
    bool isInternetAvailable();

101 102 103
public slots:
    /// You can connect to this slot to show an information message box from a different thread.
    void informationMessageBoxOnMainThread(const QString& title, const QString& msg);
dogmaphobic's avatar
dogmaphobic committed
104

105 106
    /// You can connect to this slot to show a warning message box from a different thread.
    void warningMessageBoxOnMainThread(const QString& title, const QString& msg);
dogmaphobic's avatar
dogmaphobic committed
107

108 109
    /// You can connect to this slot to show a critical message box from a different thread.
    void criticalMessageBoxOnMainThread(const QString& title, const QString& msg);
dogmaphobic's avatar
dogmaphobic committed
110

Don Gagne's avatar
Don Gagne committed
111 112
    void showSetupView(void);

113
    void qmlAttemptWindowClose(void);
Don Gagne's avatar
Don Gagne committed
114

115 116 117 118 119
    /// Save the specified telemetry Log
    void saveTelemetryLogOnMainThread(QString tempLogfile);

    /// Check that the telemetry save path is set correctly
    void checkTelemetrySavePathOnMainThread(void);
120

121 122 123 124
signals:
    /// This is connected to MAVLinkProtocol::checkForLostLogFiles. We signal this to ourselves to call the slot
    /// on the MAVLinkProtocol thread;
    void checkForLostLogFiles(void);
dogmaphobic's avatar
dogmaphobic committed
125

126
public:
127
    // Although public, these methods are internal and should only be called by UnitTest code
dogmaphobic's avatar
dogmaphobic committed
128

129 130 131 132
    /// @brief Perform initialize which is common to both normal application running and unit tests.
    ///         Although public should only be called by main.
    void _initCommon(void);

Patrick José Pereira's avatar
Patrick José Pereira committed
133
    /// @brief Initialize the application for normal application boot. Or in other words we are not going to run
134 135
    ///         unit tests. Although public should only be called by main.
    bool _initForNormalAppBoot(void);
dogmaphobic's avatar
dogmaphobic committed
136

Patrick José Pereira's avatar
Patrick José Pereira committed
137
    /// @brief Initialize the application for normal application boot. Or in other words we are not going to run
138 139
    ///         unit tests. Although public should only be called by main.
    bool _initForUnitTests(void);
Don Gagne's avatar
Don Gagne committed
140

141 142
    void _loadCurrentStyleSheet(void);

143
    static QGCApplication*  _app;   ///< Our own singleton. Should be reference directly by qgcApp
dogmaphobic's avatar
dogmaphobic committed
144

Don Gagne's avatar
Don Gagne committed
145 146 147 148 149 150
public:
    // Although public, these methods are internal and should only be called by UnitTest code

    /// Shutdown the application object
    void _shutdown(void);

151 152
    bool _checkTelemetrySavePath(bool useMessageBox);

Don Gagne's avatar
Don Gagne committed
153
private slots:
Don Gagne's avatar
Don Gagne committed
154
    void _missingParamsDisplay(void);
dogmaphobic's avatar
dogmaphobic committed
155

pixhawk's avatar
pixhawk committed
156
private:
157
    QObject* _rootQmlObject(void);
Don Gagne's avatar
Don Gagne committed
158 159 160 161

#ifdef __mobile__
    QQmlApplicationEngine* _qmlAppEngine;
#endif
dogmaphobic's avatar
dogmaphobic committed
162

Don Gagne's avatar
Don Gagne committed
163
    bool _runningUnitTests; ///< true: running unit tests, false: normal app
164
    bool _logOutput;        ///< true: Log Qt debug output to file
dogmaphobic's avatar
dogmaphobic committed
165

166 167
    static const char*  _darkStyleFile;
    static const char*  _lightStyleFile;
168 169 170 171 172
    static const int    _missingParamsDelayedDisplayTimerTimeout = 1000;    ///< Timeout to wait for next missing fact to come in before display
    QTimer              _missingParamsDelayedDisplayTimer;                  ///< Timer use to delay missing fact display
    QStringList         _missingParams;                                     ///< List of missing facts to be displayed
    bool				_fakeMobile;                                        ///< true: Fake ui into displaying mobile interface
    bool                _settingsUpgraded;                                  ///< true: Settings format has been upgrade to new version
dogmaphobic's avatar
dogmaphobic committed
173

174 175 176
#ifdef QT_DEBUG
    bool _testHighDPI;  ///< true: double fonts sizes for simulating high dpi devices
#endif
177

178 179
    QGCToolbox* _toolbox;

180 181
    QTranslator _QGCTranslator;

dogmaphobic's avatar
dogmaphobic committed
182 183
    bool _bluetoothAvailable;

Don Gagne's avatar
Don Gagne committed
184 185 186
    static const char* _settingsVersionKey;             ///< Settings key which hold settings version
    static const char* _deleteAllSettingsKey;           ///< If this settings key is set on boot, all settings will be deleted

Don Gagne's avatar
Don Gagne committed
187 188
    /// Unit Test have access to creating and destroying singletons
    friend class UnitTest;
Gus Grubba's avatar
Gus Grubba committed
189

pixhawk's avatar
pixhawk committed
190 191
};

Don Gagne's avatar
Don Gagne committed
192 193 194 195
/// @brief Returns the QGCApplication object singleton.
QGCApplication* qgcApp(void);

#endif