LinkManager.h 11.4 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.
 *
 ****************************************************************************/
9 10


11 12
/// @file
///     @author Lorenz Meier <mavteam@student.ethz.ch>
pixhawk's avatar
pixhawk committed
13 14 15 16 17

#ifndef _LINKMANAGER_H_
#define _LINKMANAGER_H_

#include <QList>
18
#include <QMultiMap>
19
#include <QMutex>
20

21
#include "LinkConfiguration.h"
22
#include "LinkInterface.h"
Don Gagne's avatar
Don Gagne committed
23
#include "QGCLoggingCategory.h"
24
#include "QGCToolbox.h"
Don Gagne's avatar
Don Gagne committed
25 26
#include "ProtocolInterface.h"
#include "MAVLinkProtocol.h"
Gus Grubba's avatar
Gus Grubba committed
27
#if !defined(__mobile__)
Don Gagne's avatar
Don Gagne committed
28
#include "LogReplayLink.h"
dogmaphobic's avatar
dogmaphobic committed
29
#endif
Don Gagne's avatar
Don Gagne committed
30
#include "QmlObjectListModel.h"
31

Gus Grubba's avatar
Gus Grubba committed
32
#ifndef NO_SERIAL_LINK
Don Gagne's avatar
Don Gagne committed
33
    #include "SerialLink.h"
dogmaphobic's avatar
dogmaphobic committed
34
#endif
35

36
#ifdef QT_DEBUG
Don Gagne's avatar
Don Gagne committed
37
    #include "MockLink.h"
38
#endif
39

Don Gagne's avatar
Don Gagne committed
40
class UDPConfiguration;
pixhawk's avatar
pixhawk committed
41

Don Gagne's avatar
Don Gagne committed
42
Q_DECLARE_LOGGING_CATEGORY(LinkManagerLog)
Don Gagne's avatar
Don Gagne committed
43
Q_DECLARE_LOGGING_CATEGORY(LinkManagerVerboseLog)
Don Gagne's avatar
Don Gagne committed
44

45
class QGCApplication;
46

47 48 49 50 51 52
/// Manage communication links
///
/// The Link Manager organizes the physical Links. It can manage arbitrary
/// links and takes care of connecting them as well assigning the correct
/// protocol instance to transport the link data into the application.

53
class LinkManager : public QGCTool
54
{
pixhawk's avatar
pixhawk committed
55
    Q_OBJECT
56

Don Gagne's avatar
Don Gagne committed
57 58
    /// Unit Test has access to private constructor/destructor
    friend class LinkManagerTest;
59

Don Gagne's avatar
Don Gagne committed
60
public:
61 62
    LinkManager(QGCApplication* app);
    ~LinkManager();
63

Don Gagne's avatar
Don Gagne committed
64 65 66 67
    Q_PROPERTY(bool autoconnectUDP                      READ autoconnectUDP                     WRITE setAutoconnectUDP         NOTIFY autoconnectUDPChanged)
    Q_PROPERTY(bool autoconnectPixhawk                  READ autoconnectPixhawk                 WRITE setAutoconnectPixhawk     NOTIFY autoconnectPixhawkChanged)
    Q_PROPERTY(bool autoconnect3DRRadio                 READ autoconnect3DRRadio                WRITE setAutoconnect3DRRadio    NOTIFY autoconnect3DRRadioChanged)
    Q_PROPERTY(bool autoconnectPX4Flow                  READ autoconnectPX4Flow                 WRITE setAutoconnectPX4Flow     NOTIFY autoconnectPX4FlowChanged)
Don Gagne's avatar
Don Gagne committed
68
    Q_PROPERTY(bool autoconnectRTKGPS                   READ autoconnectRTKGPS                  WRITE setAutoconnectRTKGPS      NOTIFY autoconnectRTKGPSChanged)
69
    Q_PROPERTY(bool autoconnectLibrePilot               READ autoconnectLibrePilot              WRITE setAutoconnectLibrePilot  NOTIFY autoconnectLibrePilotChanged)
70 71 72 73 74
    Q_PROPERTY(bool isBluetoothAvailable                READ isBluetoothAvailable                                               CONSTANT)

    Q_PROPERTY(QmlObjectListModel*  linkConfigurations  READ _qmlLinkConfigurations                                             NOTIFY linkConfigurationsChanged)
    Q_PROPERTY(QStringList          linkTypeStrings     READ linkTypeStrings                                                    CONSTANT)
    Q_PROPERTY(QStringList          serialBaudRates     READ serialBaudRates                                                    CONSTANT)
75 76 77 78 79 80 81 82 83 84
    Q_PROPERTY(QStringList          serialPortStrings   READ serialPortStrings                                                  NOTIFY commPortStringsChanged)
    Q_PROPERTY(QStringList          serialPorts         READ serialPorts                                                        NOTIFY commPortsChanged)

    // Create/Edit Link Configuration
    Q_INVOKABLE LinkConfiguration*  createConfiguration         (int type, const QString& name);
    Q_INVOKABLE LinkConfiguration*  startConfigurationEditing   (LinkConfiguration* config);
    Q_INVOKABLE void                cancelConfigurationEditing  (LinkConfiguration* config) { delete config; }
    Q_INVOKABLE bool                endConfigurationEditing     (LinkConfiguration* config, LinkConfiguration* editedConfig);
    Q_INVOKABLE bool                endCreateConfiguration      (LinkConfiguration* config);
    Q_INVOKABLE void                removeConfiguration         (LinkConfiguration* config);
Don Gagne's avatar
Don Gagne committed
85 86 87

    // Property accessors

dogmaphobic's avatar
dogmaphobic committed
88 89 90 91
    bool autoconnectUDP             (void)  { return _autoconnectUDP; }
    bool autoconnectPixhawk         (void)  { return _autoconnectPixhawk; }
    bool autoconnect3DRRadio        (void)  { return _autoconnect3DRRadio; }
    bool autoconnectPX4Flow         (void)  { return _autoconnectPX4Flow; }
Don Gagne's avatar
Don Gagne committed
92
    bool autoconnectRTKGPS          (void)  { return _autoconnectRTKGPS; }
93
    bool autoconnectLibrePilot      (void)  { return _autoconnectLibrePilot; }
dogmaphobic's avatar
dogmaphobic committed
94
    bool isBluetoothAvailable       (void);
Don Gagne's avatar
Don Gagne committed
95

96 97 98 99 100
    QList<LinkInterface*> links                 (void);
    QStringList         linkTypeStrings         (void) const;
    QStringList         serialBaudRates         (void);
    QStringList         serialPortStrings       (void);
    QStringList         serialPorts             (void);
101

102 103 104 105 106 107
    void setAutoconnectUDP        (bool autoconnect);
    void setAutoconnectPixhawk    (bool autoconnect);
    void setAutoconnect3DRRadio   (bool autoconnect);
    void setAutoconnectPX4Flow    (bool autoconnect);
    void setAutoconnectRTKGPS     (bool autoconnect);
    void setAutoconnectLibrePilot (bool autoconnect);
108 109 110 111 112 113 114 115 116 117

    /// Load list of link configurations from disk
    void loadLinkConfigurationList();

    /// Save list of link configurations from disk
    void saveLinkConfigurationList();

    /// Suspend automatic confguration updates (during link maintenance for instance)
    void suspendConfigurationUpdates(bool suspend);

118
    /// Sets the flag to suspend the all new connections
119 120
    ///     @param reason User visible reason to suspend connections
    void setConnectionsSuspended(QString reason);
121

122
    /// Sets the flag to allow new connections to be made
123
    void setConnectionsAllowed(void) { _connectionsSuspended = false; }
124

125
    /// Creates, connects (and adds) a link  based on the given configuration instance.
Don Gagne's avatar
Don Gagne committed
126
    /// Link takes ownership of config.
Don Gagne's avatar
Don Gagne committed
127 128 129 130
    LinkInterface* createConnectedLink(SharedLinkConfigurationPointer& config);

    // This should only be used by Qml code
    Q_INVOKABLE void createConnectedLink(LinkConfiguration* config);
131

132
    /// Creates, connects (and adds) a link  based on the given configuration name.
Don Gagne's avatar
Don Gagne committed
133
    LinkInterface* createConnectedLink(const QString& name);
134

Don Gagne's avatar
Don Gagne committed
135 136
    /// Disconnects all existing links
    void disconnectAll(void);
137

138 139
    /// Connect the specified link
    bool connectLink(LinkInterface* link);
140

Don Gagne's avatar
Don Gagne committed
141 142
    /// Disconnect the specified link
    Q_INVOKABLE void disconnectLink(LinkInterface* link);
143

144 145 146 147
    // The following APIs are public but should not be called in normal use. The are mainly exposed
    // here for unit test code.
    void _deleteLink(LinkInterface* link);
    void _addLink(LinkInterface* link);
148

Don Gagne's avatar
Don Gagne committed
149
    // Called to signal app shutdown. Disconnects all links while turning off auto-connect.
Don Gagne's avatar
Don Gagne committed
150
    Q_INVOKABLE void shutdown(void);
Don Gagne's avatar
Don Gagne committed
151

Don Gagne's avatar
Don Gagne committed
152 153 154 155 156
#ifdef QT_DEBUG
    // Only used by unit test tp restart after a shutdown
    void restart(void) { setConnectionsAllowed(); }
#endif

157 158 159
    /// @return true: specified link is an autoconnect link
    bool isAutoconnectLink(LinkInterface* link);

160 161 162
    // Override from QGCTool
    virtual void setToolbox(QGCToolbox *toolbox);

163 164 165 166 167 168 169 170 171 172 173
    /// @return This mavlink channel is never assigned to a vehicle.
    uint8_t reservedMavlinkChannel(void) { return 0; }

    /// If you are going to hold a reference to a LinkInterface* in your object you must reference count it
    /// by using this method to get access to the shared pointer.
    SharedLinkInterfacePointer sharedLinkInterfacePointerForLink(LinkInterface* link);

    bool containsLink(LinkInterface* link);

    SharedLinkConfigurationPointer addConfiguration(LinkConfiguration* config);

pixhawk's avatar
pixhawk committed
174
signals:
175 176 177 178 179 180 181
    void autoconnectUDPChanged        (bool autoconnect);
    void autoconnectPixhawkChanged    (bool autoconnect);
    void autoconnect3DRRadioChanged   (bool autoconnect);
    void autoconnectPX4FlowChanged    (bool autoconnect);
    void autoconnectRTKGPSChanged     (bool autoconnect);
    void autoconnectLibrePilotChanged (bool autoconnect);

Don Gagne's avatar
Don Gagne committed
182

pixhawk's avatar
pixhawk committed
183
    void newLink(LinkInterface* link);
Don Gagne's avatar
Don Gagne committed
184 185

    // Link has been deleted. You may not necessarily get a linkInactive before the link is deleted.
186
    void linkDeleted(LinkInterface* link);
Don Gagne's avatar
Don Gagne committed
187 188

    // Link has been connected, but no Vehicle seen on link yet.
189
    void linkConnected(LinkInterface* link);
Don Gagne's avatar
Don Gagne committed
190 191

    // Link disconnected, all vehicles on link should be gone as well.
192
    void linkDisconnected(LinkInterface* link);
Don Gagne's avatar
Don Gagne committed
193 194 195 196 197 198 199

    // New vehicle has been seen on the link.
    void linkActive(LinkInterface* link, int vehicleId, int vehicleFirmwareType, int vehicleType);

    // No longer hearing from any vehicles on this link.
    void linkInactive(LinkInterface* link);

200
    void commPortStringsChanged();
201 202
    void commPortsChanged();
    void linkConfigurationsChanged();
203

204 205 206
private slots:
    void _linkConnected(void);
    void _linkDisconnected(void);
207
    void _linkConnectionRemoved(LinkInterface* link);
Gus Grubba's avatar
Gus Grubba committed
208
#ifndef NO_SERIAL_LINK
Don Gagne's avatar
Don Gagne committed
209
    void _activeLinkCheck(void);
Don Gagne's avatar
Don Gagne committed
210
#endif
211

212
private:
213
    QmlObjectListModel* _qmlLinkConfigurations  (void) { return &_qmlConfigurations; }
214
    bool _connectionsSuspendedMsg(void);
Don Gagne's avatar
Don Gagne committed
215
    void _updateAutoConnectLinks(void);
216 217
    void _updateSerialPorts();
    void _fixUnnamed(LinkConfiguration* config);
Don Gagne's avatar
Don Gagne committed
218
    bool _setAutoconnectWorker(bool& currentAutoconnect, bool newAutoconnect, const char* autoconnectKey);
219
    void _removeConfiguration(LinkConfiguration* config);
Don Gagne's avatar
Don Gagne committed
220

Gus Grubba's avatar
Gus Grubba committed
221
#ifndef NO_SERIAL_LINK
Don Gagne's avatar
Don Gagne committed
222
    SerialConfiguration* _autoconnectConfigurationsContainsPort(const QString& portName);
dogmaphobic's avatar
dogmaphobic committed
223
#endif
224 225 226 227 228 229

    bool    _configUpdateSuspended;                     ///< true: stop updating configuration list
    bool    _configurationsLoaded;                      ///< true: Link configurations have been loaded
    bool    _connectionsSuspended;                      ///< true: all new connections should not be allowed
    QString _connectionsSuspendedReason;                ///< User visible reason for suspension
    QTimer  _portListTimer;
230
    uint32_t _mavlinkChannelsUsedBitMask;
231 232

    MAVLinkProtocol*    _mavlinkProtocol;
Don Gagne's avatar
Don Gagne committed
233

234 235 236 237 238

    QList<SharedLinkInterfacePointer>       _sharedLinks;
    QList<SharedLinkConfigurationPointer>   _sharedConfigurations;
    QList<SharedLinkConfigurationPointer>   _sharedAutoconnectConfigurations;
    QmlObjectListModel                      _qmlConfigurations;
Don Gagne's avatar
Don Gagne committed
239

240
    QMap<QString, int>  _autoconnectWaitList;   ///< key: QGCSerialPortInfo.systemLocation, value: wait count
241
    QStringList _commPortList;
242
    QStringList _commPortDisplayList;
243

Don Gagne's avatar
Don Gagne committed
244 245 246 247
    bool _autoconnectUDP;
    bool _autoconnectPixhawk;
    bool _autoconnect3DRRadio;
    bool _autoconnectPX4Flow;
Don Gagne's avatar
Don Gagne committed
248
    bool _autoconnectRTKGPS;
249
    bool _autoconnectLibrePilot;
Gus Grubba's avatar
Gus Grubba committed
250
#ifndef NO_SERIAL_LINK
251 252 253
    QTimer              _activeLinkCheckTimer;                  ///< Timer which checks for a vehicle showing up on a usb direct link
    QList<SerialLink*>  _activeLinkCheckList;                   ///< List of links we are waiting for a vehicle to show up on
    static const int    _activeLinkCheckTimeoutMSecs = 15000;   ///< Amount of time to wait for a heatbeat. Keep in mind ArduPilot stack heartbeat is slow to come.
Don Gagne's avatar
Don Gagne committed
254
#endif
Don Gagne's avatar
Don Gagne committed
255

256 257 258 259 260
    static const char*  _settingsGroup;
    static const char*  _autoconnectUDPKey;
    static const char*  _autoconnectPixhawkKey;
    static const char*  _autoconnect3DRRadioKey;
    static const char*  _autoconnectPX4FlowKey;
Don Gagne's avatar
Don Gagne committed
261
    static const char*  _autoconnectRTKGPSKey;
262
    static const char*  _autoconnectLibrePilotKey;
263 264 265
    static const char*  _defaultUPDLinkName;
    static const int    _autoconnectUpdateTimerMSecs;
    static const int    _autoconnectConnectDelayMSecs;
pixhawk's avatar
pixhawk committed
266 267
};

268
#endif