WimaController.h 17 KB
Newer Older
1
#pragma once
2 3

#include <QObject>
4
#include "QGCMapPolygon.h"
5
#include "QmlObjectListModel.h"
6 7

#include "WimaArea.h"
8
#include "WimaMeasurementArea.h"
9
#include "WimaServiceArea.h"
Valentin Platzgummer's avatar
Valentin Platzgummer committed
10
#include "WimaCorridor.h"
11
#include "WimaDataContainer.h"
12 13 14
#include "WimaMeasurementAreaData.h"
#include "WimaCorridorData.h"
#include "WimaServiceAreaData.h"
15 16 17

#include "PlanMasterController.h"
#include "MissionController.h"
18
#include "SurveyComplexItem.h"
19 20
#include "SimpleMissionItem.h"
#include "MissionSettingsItem.h"
21 22
#include "JsonHelper.h"
#include "QGCApplication.h"
23
#include "SettingsFact.h"
24 25
#include "WimaSettings.h"
#include "SettingsManager.h"
26

27 28 29 30
#define CHECK_BATTERY_INTERVAL 1000
#define SMART_RTL_MAX_ATTEMPTS 3
#define SMART_RTL_ATTEMPT_INTERVAL 200 // ms

31 32 33

class WimaController : public QObject
{
34 35
    Q_OBJECT

36 37
    enum FileType {WimaFile, PlanFile};

38
public:
39 40 41
    WimaController(QObject *parent = nullptr);


42 43
    Q_PROPERTY(PlanMasterController*    masterController        READ masterController       WRITE setMasterController       NOTIFY masterControllerChanged)
    Q_PROPERTY(MissionController*       missionController       READ missionController      WRITE setMissionController      NOTIFY missionControllerChanged)
44
    Q_PROPERTY(QmlObjectListModel*      visualItems             READ visualItems                                            NOTIFY visualItemsChanged)
45 46 47 48 49
    Q_PROPERTY(QString                  currentFile             READ currentFile                                            NOTIFY currentFileChanged)
    Q_PROPERTY(QStringList              loadNameFilters         READ loadNameFilters                                        CONSTANT)
    Q_PROPERTY(QStringList              saveNameFilters         READ saveNameFilters                                        CONSTANT)
    Q_PROPERTY(QString                  fileExtension           READ fileExtension                                          CONSTANT)
    Q_PROPERTY(WimaDataContainer*       dataContainer           READ dataContainer          WRITE setDataContainer          NOTIFY dataContainerChanged)
50 51
    Q_PROPERTY(QmlObjectListModel*      missionItems            READ missionItems                                           NOTIFY missionItemsChanged)
    Q_PROPERTY(QmlObjectListModel*      currentMissionItems     READ currentMissionItems                                    NOTIFY currentMissionItemsChanged)
52
    Q_PROPERTY(QVariantList             waypointPath            READ waypointPath                                           NOTIFY waypointPathChanged)
53
    Q_PROPERTY(QVariantList             currentWaypointPath     READ currentWaypointPath                                    NOTIFY currentWaypointPathChanged)
54 55 56 57 58 59
    Q_PROPERTY(Fact*                    enableWimaController    READ enableWimaController                                   CONSTANT)
    Q_PROPERTY(Fact*                    overlapWaypoints        READ overlapWaypoints                                       CONSTANT)
    Q_PROPERTY(Fact*                    maxWaypointsPerPhase    READ maxWaypointsPerPhase                                   CONSTANT)
    Q_PROPERTY(Fact*                    startWaypointIndex      READ startWaypointIndex                                     CONSTANT)
    Q_PROPERTY(Fact*                    showAllMissionItems     READ showAllMissionItems                                    CONSTANT)
    Q_PROPERTY(Fact*                    showCurrentMissionItems READ showCurrentMissionItems                                CONSTANT)
60 61
    Q_PROPERTY(Fact*                    flightSpeed             READ flightSpeed                                            CONSTANT)
    Q_PROPERTY(Fact*                    altitude                READ altitude                                               CONSTANT)
62
    Q_PROPERTY(Fact*                    arrivalReturnSpeed      READ arrivalReturnSpeed                                     CONSTANT)
63
    Q_PROPERTY(Fact*                    reverse                 READ reverse                                                CONSTANT)
64
    Q_PROPERTY(bool                     uploadOverrideRequired  READ uploadOverrideRequired WRITE setUploadOverrideRequired NOTIFY uploadOverrideRequiredChanged)
65 66
    Q_PROPERTY(double                   phaseDistance           READ phaseDistance                                          NOTIFY phaseDistanceChanged)
    Q_PROPERTY(double                   phaseDuration           READ phaseDuration                                          NOTIFY phaseDurationChanged)
67
    Q_PROPERTY(bool                     vehicleHasLowBattery    READ vehicleHasLowBattery                                   NOTIFY vehicleHasLowBatteryChanged)
68

69 70 71


    // Property accessors
72 73
    PlanMasterController*       masterController       (void)          { return _masterController; }
    MissionController*          missionController      (void)          { return _missionController; }
74
    QmlObjectListModel*         visualItems            (void);
75
    QString                     currentFile            (void) const    { return _currentFile; }
Valentin Platzgummer's avatar
Valentin Platzgummer committed
76
    QStringList                 loadNameFilters        (void) const;
77
    QStringList                 saveNameFilters        (void) const;
78
    QString                     fileExtension          (void) const    { return wimaFileExtension; }
Valentin Platzgummer's avatar
Valentin Platzgummer committed
79
    QGCMapPolygon               joinedArea             (void) const;
80
    WimaDataContainer*          dataContainer          (void);
81 82
    QmlObjectListModel*         missionItems           (void);
    QmlObjectListModel*         currentMissionItems    (void);
83
    QVariantList                waypointPath           (void);
84
    QVariantList                currentWaypointPath    (void);
85 86 87 88
    Fact*                       enableWimaController   (void);
    Fact*                       overlapWaypoints       (void);
    Fact*                       maxWaypointsPerPhase   (void);
    Fact*                       startWaypointIndex     (void);
89 90
    Fact*                       showAllMissionItems    (void);
    Fact*                       showCurrentMissionItems(void);
91
    Fact*                       flightSpeed            (void);
92
    Fact*                       arrivalReturnSpeed     (void);
93 94
    Fact*                       altitude               (void);    
    Fact*                       reverse                (void);
95
    bool                        uploadOverrideRequired (void) const;
96 97
    double                      phaseDistance          (void) const;
    double                      phaseDuration          (void) const;
98
    bool                        vehicleHasLowBattery   (void) const;
99 100 101 102 103


    // Property setters
    void setMasterController        (PlanMasterController* masterController);
    void setMissionController       (MissionController* missionController);
104
    void setDataContainer           (WimaDataContainer* container);
105
    void setUploadOverrideRequired  (bool overrideRequired);
106

107
    // Member Methodes
108
    Q_INVOKABLE void nextPhase();
109 110
    Q_INVOKABLE void previousPhase();
    Q_INVOKABLE void resetPhase();
111
    Q_INVOKABLE bool uploadToVehicle();
112
    Q_INVOKABLE bool forceUploadToVehicle();
113 114
    Q_INVOKABLE void removeFromVehicle();    
    Q_INVOKABLE bool checkSmartRTLPreCondition(); // wrapper for _checkSmartRTLPreCondition(QString &errorString)
115
    Q_INVOKABLE bool calcReturnPath(); // wrapper for _calcReturnPath(QString &errorSring)#
116 117
    Q_INVOKABLE void executeSmartRTL(); // wrapper for _executeSmartRTL(QString &errorSring)
    Q_INVOKABLE void initSmartRTL();
118
    Q_INVOKABLE void removeVehicleTrajectoryHistory();
119

120

121 122
    Q_INVOKABLE void saveToCurrent  ();
    Q_INVOKABLE void saveToFile     (const QString& filename);
123
    Q_INVOKABLE bool loadFromCurrent();
124
    Q_INVOKABLE bool loadFromFile   (const QString& filename);
125 126


127 128
    // static Members
    static const char* wimaFileExtension;
129
    static const char* areaItemsName;
130 131 132 133 134 135 136 137 138
    static const char* missionItemsName;    
    static const char* settingsGroup;
    static const char* endWaypointIndexName;
    static const char* enableWimaControllerName;
    static const char* overlapWaypointsName;
    static const char* maxWaypointsPerPhaseName;
    static const char* startWaypointIndexName;
    static const char* showAllMissionItemsName;
    static const char* showCurrentMissionItemsName;
139
    static const char* flightSpeedName;
140
    static const char* arrivalReturnSpeedName;
141 142
    static const char* altitudeName;    
    static const char* reverseName;
143 144

    // Member Methodes
145
    QJsonDocument saveToJson(FileType fileType);
146

147
    bool calcShortestPath(const QGeoCoordinate &start, const QGeoCoordinate &destination, QVector<QGeoCoordinate> &path);
148
    /// extracts the coordinates stored in missionItems (list of MissionItems) and stores them in coordinateList
149
    bool extractCoordinateList(QmlObjectListModel &missionItems, QVector<QGeoCoordinate> &coordinateList);
150
    /// extracts the coordinates (between startIndex and endIndex) stored in missionItems (list of MissionItems) and stores them in coordinateList.
151
    bool extractCoordinateList(QmlObjectListModel &missionItems, QVector<QGeoCoordinate> &coordinateList, int startIndex, int endIndex);
152
    /// extracts the coordinates stored in missionItems (list of MissionItems) and stores them in coordinateList
153
    bool extractCoordinateList(QmlObjectListModel &missionItems, QVariantList &coordinateList);
154
    /// extracts the coordinates (between startIndex and endIndex) stored in missionItems (list of MissionItems) and stores them in coordinateList.
155
    bool extractCoordinateList(QmlObjectListModel &missionItems, QVariantList &coordinateList, int startIndex, int endIndex);
156

157
signals:
158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175
    void masterControllerChanged            (void);
    void missionControllerChanged           (void);
    void visualItemsChanged                 (void);
    void currentFileChanged                 ();
    void dataContainerChanged               ();
    void readyForSaveSendChanged            (bool ready);
    void missionItemsChanged                (void);
    void currentMissionItemsChanged         (void);
    void waypointPathChanged                (void);
    void currentWaypointPathChanged         (void);
    void uploadOverrideRequiredChanged      (void);
    void phaseDistanceChanged               (void);
    void phaseDurationChanged               (void);
    void vehicleHasLowBatteryChanged        (void);
    void returnBatteryLowConfirmRequired    (void);
    void returnUserRequestConfirmRequired   (void);
private:
    enum SRTL_Reason {BatteryLow, UserRequest};
176
private slots:
177 178
    bool fetchContainerData();
    bool calcNextPhase(void);
179
    void updateWaypointPath                 (void);
180
    void updateCurrentPath                  (void);
181
    void updateNextWaypoint                 (void);
182
    void recalcCurrentPhase                 (void);
183
    bool setTakeoffLandPosition             (void);
184 185
    void updateflightSpeed                  (void);
    void updateArrivalReturnSpeed           (void);
186
    void updateAltitude                     (void);
187
    void checkBatteryLevel                  (void);
188
    void smartRTLCleanUp                    (bool flying); // cleans up after successfull smart RTL
189
    void enableDisableLowBatteryHandling    (QVariant enable);
Valentin Platzgummer's avatar
Valentin Platzgummer committed
190
    void reverseChangedHandler              ();
191 192 193
    void _initSmartRTL                      ();
    void _executeSmartRTL                   ();

194 195 196 197

private:
    void _setPhaseDistance(double distance);
    void _setPhaseDuration(double duration);
198 199 200
    bool _checkSmartRTLPreCondition(QString &errorString); // should be called from gui, befor calcReturnPath()
    bool _calcReturnPath(QString &errorSring); // Calculates return path (destination: service area center) for a flying vehicle
    void _setVehicleHasLowBattery(bool batteryLow);
201 202
    void _loadCurrentMissionItemsFromBuffer();
    void _saveCurrentMissionItemsToBuffer();
203

204
private:
205 206 207 208
    PlanMasterController   *_masterController;
    MissionController      *_missionController;
    QString                 _currentFile; // file for saveing
    WimaDataContainer      *_container; // container for data exchange with WimaController
209
    QmlObjectListModel      _visualItems; // contains all visible areas
210
    WimaJoinedAreaData      _joinedArea; // joined area fromed by opArea, serArea, _corridor
211 212 213 214
    WimaMeasurementAreaData _measurementArea; // measurement area
    WimaServiceAreaData     _serviceArea; // area for supplying
    WimaCorridorData        _corridor; // corridor connecting opArea and serArea
    bool                    _localPlanDataValid;
215 216 217 218
    QmlObjectListModel      _missionItems; // all mission itmes (Mission Items) generaded by wimaPlaner, displayed in flightView
    QmlObjectListModel      _currentMissionItems; // contains the current mission items, which are a sub set of _missionItems,
                                                  // _currentMissionItems contains a number of mission items which can be worked off with a single battery chrage
    QmlObjectListModel      _missionItemsBuffer; // Buffer to store mission items, e.g. for storing _currentMissionItems when smartRTL() is invoked
219
    QVariantList            _waypointPath; // path connecting the items in _missionItems
220
    QVariantList            _currentWaypointPath; // path connecting the items in _currentMissionItems
221
    QGeoCoordinate          _takeoffLandPostion;
222

223 224 225 226 227

    QMap<QString, FactMetaData*> _metaDataMap;
    SettingsFact                 _enableWimaController; // enables or disables the wimaControler
    SettingsFact                 _overlapWaypoints; // determines the number of overlapping waypoints between two consecutive mission phases
    SettingsFact                 _maxWaypointsPerPhase; // determines the maximum number waypoints per phase
228
    SettingsFact                 _nextPhaseStartWaypointIndex; // index (displayed on the map, -1 to get index of item in _missionItems) of the mission item
229
                                                      // defining the first element of the next phase
230 231
    SettingsFact                 _showAllMissionItems; // bool value, Determines whether the mission items of the overall mission are displayed or not.
    SettingsFact                 _showCurrentMissionItems; // bool value, Determines whether the mission items of the current mission phase are displayed or not.
232
    SettingsFact                 _flightSpeed; // mission flight speed
233
    SettingsFact                 _arrivalReturnSpeed; // arrival and return path speed
234
    SettingsFact                 _altitude; // mission altitude
235
    SettingsFact                 _reverse; // Reverses the phase direction. Phases go from high to low waypoint numbers, if true.
236

237
    int                          _endWaypointIndex; // index of the mission item stored in _missionItems defining the last element
238
                                                    // (which is not part of the return path) of _currentMissionItem
239
    int                          _startWaypointIndex; // index of the mission item stored in _missionItems defining the first element
240
                                                      // (which is not part of the arrival path) of _currentMissionItem
241 242
    bool                         _uploadOverrideRequired; // Is set to true if uploadToVehicle() did not suceed because the vehicle is not inside the service area.
                                                          // The user can override the upload lock with a slider, this will reset this variable to false.
243 244 245
    double                       _measurementPathLength; // the lenght of the phase in meters
    double                       _arrivalPathLength; // the length of the arrival and return path in meters
    double                       _returnPathLength; // the length of the arrival and return path in meters
246 247
    double                       _phaseDistance; // the lenth in meters of the current phase
    double                       _phaseDuration; // the phase duration in seconds
248 249
    double                       _phaseDistanceBuffer; // buffer for storing _phaseDistance when doing smart RTL
    double                       _phaseDurationBuffer; // buffer for storing _phaseDuration when doing smart RTL
250 251

    QTimer                       _checkBatteryTimer;
252 253 254
    QTimer                       _smartRTLAttemptTimer;
    SRTL_Reason                  _srtlReason;

255 256
    bool                         _vehicleHasLowBattery;
    bool                         _lowBatteryHandlingTriggered;
257 258
    bool                         _executingSmartRTL;

259
};
260

261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284
/*
 * The following explains the structure of
 * _missionController.visualItems(). The indices
 * are not that important and only specified for
 * reasons of completeness.
 *
 * Index        Description
 * --------------------------------------------
 * 0            MissionSettingsItem
 * 1            Takeoff Command
 * 2            Speed Command: arrivalReturnSpeed
 * 3            Arrival Path Waypoint 0
 * ...
 * 3+n-1        Arrival Path Waypoint n-1
 * 3+n          Speed Command: flightSpeed
 * 3+n+1        Circular Survey Waypoint 0
 * ...
 * 3+n+m        Circular Survey Waypoint m-1
 * 3+n+m+1      Speed Command: arrivalReturnSpeed
 * 3+n+m+2      Return Path Waypoint 0
 * ...
 * 3+n+m+2+l    Return Path Waypoint l-1
 * 3+n+m+2+l+1  Land command
 *
285 286 287
 * _currentMissionItems is equal to
 * _missionController.visualItems() except that it
 * is missing the MissionSettingsItem
288 289
 */

290