AutoPilotPlugin.h 3.02 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23
/*=====================================================================
 
 QGroundControl Open Source Ground Control Station
 
 (c) 2009 - 2014 QGROUNDCONTROL PROJECT <http://www.qgroundcontrol.org>
 
 This file is part of the QGROUNDCONTROL project
 
 QGROUNDCONTROL 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 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. If not, see <http://www.gnu.org/licenses/>.
 
 ======================================================================*/

24 25 26
/// @file
///     @author Don Gagne <don@thegagnes.com>

27 28 29 30 31 32
#ifndef AUTOPILOTPLUGIN_H
#define AUTOPILOTPLUGIN_H

#include <QObject>
#include <QList>
#include <QString>
Don Gagne's avatar
Don Gagne committed
33
#include <QQmlContext>
34 35 36

#include "UASInterface.h"
#include "VehicleComponent.h"
Don Gagne's avatar
Don Gagne committed
37
#include "FactSystem.h"
38

39 40 41 42 43 44
/// This is the base class for AutoPilot plugins
///
/// The AutoPilotPlugin class is an abstract base class which represent the methods and objects
/// which are specific to a certain AutoPilot. This is the only place where AutoPilot specific
/// code should reside in QGroundControl. The remainder of the QGroundControl source is
/// generic to a common mavlink implementation.
45 46 47 48 49 50

class AutoPilotPlugin : public QObject
{
    Q_OBJECT

public:
Don Gagne's avatar
Don Gagne committed
51 52
    AutoPilotPlugin(UASInterface* uas, QObject* parent);
    
53 54
    Q_PROPERTY(QVariantList components READ components CONSTANT)
    Q_PROPERTY(QUrl setupBackgroundImage READ setupBackgroundImage CONSTANT)
55
    
Don Gagne's avatar
Don Gagne committed
56 57 58 59 60 61 62 63
    /// Re-request the full set of parameters from the autopilot
    Q_INVOKABLE void refreshAllParameters(void);
    
    /// Request a refresh on the specific parameter
    Q_INVOKABLE void refreshParameter(const QString& param);
    
    // Request a refresh on all parameters that begin with the specified prefix
    Q_INVOKABLE void refreshParametersPrefix(const QString& paramPrefix);
64 65 66 67
    
    Q_INVOKABLE bool factExists(const QString& param);
    
    Fact* getFact(const QString& name);
Don Gagne's avatar
Don Gagne committed
68

69 70 71 72
    // Property accessors
    virtual const QVariantList& components(void) = 0;
    virtual const QVariantMap& parameters(void) = 0;    
    virtual QUrl setupBackgroundImage(void) = 0;
73
    
74 75
    /// Returns true if the plugin is ready for use
    virtual bool pluginIsReady(void) const = 0;
76
    
77 78
    /// FIXME: Kind of hacky
    static void clearStaticData(void);
79
    
Don Gagne's avatar
Don Gagne committed
80 81
    UASInterface* uas(void) { return _uas; }
    
82 83 84
signals:
    /// Signalled when plugin is ready for use
    void pluginReady(void);
Don Gagne's avatar
Don Gagne committed
85
    
86
protected:
87
    /// All access to AutoPilotPugin objects is through getInstanceForAutoPilotPlugin
Don Gagne's avatar
Don Gagne committed
88
    AutoPilotPlugin(QObject* parent = NULL) : QObject(parent) { }
89
    
Don Gagne's avatar
Don Gagne committed
90
    UASInterface* _uas;
91 92 93
};

#endif