ParameterLoader.cc 33.7 KB
Newer Older
1
/*=====================================================================
dogmaphobic's avatar
dogmaphobic committed
2

3
 QGroundControl Open Source Ground Control Station
dogmaphobic's avatar
dogmaphobic committed
4

5
 (c) 2009 - 2014 QGROUNDCONTROL PROJECT <http://www.qgroundcontrol.org>
dogmaphobic's avatar
dogmaphobic committed
6

7
 This file is part of the QGROUNDCONTROL project
dogmaphobic's avatar
dogmaphobic committed
8

9 10 11 12
 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.
dogmaphobic's avatar
dogmaphobic committed
13

14 15 16 17
 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.
dogmaphobic's avatar
dogmaphobic committed
18

19 20
 You should have received a copy of the GNU General Public License
 along with QGROUNDCONTROL. If not, see <http://www.gnu.org/licenses/>.
dogmaphobic's avatar
dogmaphobic committed
21

22 23 24 25 26 27 28 29
 ======================================================================*/

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

#include "ParameterLoader.h"
#include "QGCApplication.h"
#include "QGCLoggingCategory.h"
30
#include "QGCApplication.h"
31
#include "UASMessageHandler.h"
Don Gagne's avatar
Don Gagne committed
32
#include "FirmwarePlugin.h"
33
#include "UAS.h"
34 35 36 37

#include <QFile>
#include <QDebug>

38 39 40 41 42
/* types for local parameter cache */
typedef QPair<int, QVariant> ParamTypeVal;
typedef QPair<QString, ParamTypeVal> NamedParam;
typedef QMap<int, NamedParam> MapID2NamedParam;

43
QGC_LOGGING_CATEGORY(ParameterLoaderLog, "ParameterLoaderLog")
44
QGC_LOGGING_CATEGORY(ParameterLoaderVerboseLog, "ParameterLoaderVerboseLog")
45

Don Gagne's avatar
Don Gagne committed
46 47
Fact ParameterLoader::_defaultFact;

48 49 50 51 52 53 54 55 56
ParameterLoader::ParameterLoader(AutoPilotPlugin* autopilot, Vehicle* vehicle, QObject* parent)
    : QObject(parent)
    , _autopilot(autopilot)
    , _vehicle(vehicle)
    , _mavlink(qgcApp()->toolbox()->mavlinkProtocol())
    , _parametersReady(false)
    , _initialLoadComplete(false)
    , _defaultComponentId(FactSystem::defaultComponentId)
    , _totalParamCount(0)
57
{
58
    Q_ASSERT(_autopilot);
59
    Q_ASSERT(_vehicle);
60
    Q_ASSERT(_mavlink);
dogmaphobic's avatar
dogmaphobic committed
61

62 63
    // We signal this to ouselves in order to start timer on our thread
    connect(this, &ParameterLoader::restartWaitingParamTimer, this, &ParameterLoader::_restartWaitingParamTimer);
dogmaphobic's avatar
dogmaphobic committed
64

65 66 67 68
    _initialRequestTimeoutTimer.setSingleShot(true);
    _initialRequestTimeoutTimer.setInterval(6000);
    connect(&_initialRequestTimeoutTimer, &QTimer::timeout, this, &ParameterLoader::_initialRequestTimeout);

69
    _waitingParamTimeoutTimer.setSingleShot(true);
Don Gagne's avatar
Don Gagne committed
70
    _waitingParamTimeoutTimer.setInterval(1000);
71
    connect(&_waitingParamTimeoutTimer, &QTimer::timeout, this, &ParameterLoader::_waitingParamTimeout);
72 73 74

    _cacheTimeoutTimer.setSingleShot(true);
    _cacheTimeoutTimer.setInterval(2500);
dogmaphobic's avatar
dogmaphobic committed
75
    connect(&_cacheTimeoutTimer, &QTimer::timeout, this, &ParameterLoader::_timeoutRefreshAll);
dogmaphobic's avatar
dogmaphobic committed
76

77
    connect(_vehicle->uas(), &UASInterface::parameterUpdate, this, &ParameterLoader::_parameterUpdate);
78 79 80

    /* Initially attempt a local cache load, refresh over the link if it fails */
    _tryCacheLookup();
81 82 83 84 85 86 87 88
}

ParameterLoader::~ParameterLoader()
{

}

/// Called whenever a parameter is updated or first seen.
89
void ParameterLoader::_parameterUpdate(int uasId, int componentId, QString parameterName, int parameterCount, int parameterId, int mavType, QVariant value)
90 91
{
    bool setMetaData = false;
dogmaphobic's avatar
dogmaphobic committed
92

93
    // Is this for our uas?
94
    if (uasId != _vehicle->id()) {
95 96
        return;
    }
dogmaphobic's avatar
dogmaphobic committed
97

98 99
    _initialRequestTimeoutTimer.stop();

100 101 102 103 104 105 106 107
    qCDebug(ParameterLoaderLog) << "_parameterUpdate (usaId:" << uasId <<
                                    "componentId:" << componentId <<
                                    "name:" << parameterName <<
                                    "count:" << parameterCount <<
                                    "index:" << parameterId <<
                                    "mavType:" << mavType <<
                                    "value:" << value <<
                                    ")";
dogmaphobic's avatar
dogmaphobic committed
108

109 110 111 112 113 114 115 116
#if 0
    // Handy for testing retry logic
    static int counter = 0;
    if (counter++ & 0x3) {
        qCDebug(ParameterLoaderLog) << "Artificial discard" << counter;
        return;
    }
#endif
117 118 119 120 121 122 123

    if (parameterName == "_HASH_CHECK") {
        /* we received a cache hash, potentially load from cache */
        _cacheTimeoutTimer.stop();
        _tryCacheHashLoad(uasId, value);
        return;
    }
124
    _dataMutex.lock();
dogmaphobic's avatar
dogmaphobic committed
125

126 127
    // Restart our waiting for param timer
    _waitingParamTimeoutTimer.start();
dogmaphobic's avatar
dogmaphobic committed
128

129 130 131 132 133
    // Update our total parameter counts
    if (!_paramCountMap.contains(componentId)) {
        _paramCountMap[componentId] = parameterCount;
        _totalParamCount += parameterCount;
    }
134 135

    _mapParameterId2Name[componentId][parameterId] = parameterName;
dogmaphobic's avatar
dogmaphobic committed
136

137 138
    // If we've never seen this component id before, setup the wait lists.
    if (!_waitingReadParamIndexMap.contains(componentId)) {
139 140 141 142
        // Add all indices to the wait list, parameter index is 0-based
        for (int waitingIndex=0; waitingIndex<parameterCount; waitingIndex++) {
            // This will add the new component id, as well as the the new waiting index and set the retry count for that index to 0
            _waitingReadParamIndexMap[componentId][waitingIndex] = 0;
143
        }
dogmaphobic's avatar
dogmaphobic committed
144

145 146 147
        // The read and write waiting lists for this component are initialized the empty
        _waitingReadParamNameMap[componentId] = QMap<QString, int>();
        _waitingWriteParamNameMap[componentId] = QMap<QString, int>();
dogmaphobic's avatar
dogmaphobic committed
148

149 150
        qCDebug(ParameterLoaderLog) << "Seeing component for first time, id:" << componentId << "parameter count:" << parameterCount;
    }
dogmaphobic's avatar
dogmaphobic committed
151

152
    // Remove this parameter from the waiting lists
153 154 155
    _waitingReadParamIndexMap[componentId].remove(parameterId);
    _waitingReadParamNameMap[componentId].remove(parameterName);
    _waitingWriteParamNameMap[componentId].remove(parameterName);
156
    qCDebug(ParameterLoaderVerboseLog) << "_waitingReadParamIndexMap:" << _waitingReadParamIndexMap[componentId];
157 158 159 160
    qCDebug(ParameterLoaderLog) << "_waitingReadParamNameMap" << _waitingReadParamNameMap[componentId];
    qCDebug(ParameterLoaderLog) << "_waitingWriteParamNameMap" << _waitingWriteParamNameMap[componentId];

    // Track how many parameters we are still waiting for
dogmaphobic's avatar
dogmaphobic committed
161

162 163 164
    int waitingReadParamIndexCount = 0;
    int waitingReadParamNameCount = 0;
    int waitingWriteParamNameCount = 0;
dogmaphobic's avatar
dogmaphobic committed
165

166 167 168 169 170 171 172
    foreach(int waitingComponentId, _waitingReadParamIndexMap.keys()) {
        waitingReadParamIndexCount += _waitingReadParamIndexMap[waitingComponentId].count();
    }
    if (waitingReadParamIndexCount) {
        qCDebug(ParameterLoaderLog) << "waitingReadParamIndexCount:" << waitingReadParamIndexCount;
    }

dogmaphobic's avatar
dogmaphobic committed
173

174 175 176 177 178 179
    foreach(int waitingComponentId, _waitingReadParamNameMap.keys()) {
        waitingReadParamNameCount += _waitingReadParamNameMap[waitingComponentId].count();
    }
    if (waitingReadParamNameCount) {
        qCDebug(ParameterLoaderLog) << "waitingReadParamNameCount:" << waitingReadParamNameCount;
    }
dogmaphobic's avatar
dogmaphobic committed
180

181 182 183 184 185 186
    foreach(int waitingComponentId, _waitingWriteParamNameMap.keys()) {
        waitingWriteParamNameCount += _waitingWriteParamNameMap[waitingComponentId].count();
    }
    if (waitingWriteParamNameCount) {
        qCDebug(ParameterLoaderLog) << "waitingWriteParamNameCount:" << waitingWriteParamNameCount;
    }
dogmaphobic's avatar
dogmaphobic committed
187

188 189 190 191 192 193 194 195 196 197 198 199 200 201
    int waitingParamCount = waitingReadParamIndexCount + waitingReadParamNameCount + waitingWriteParamNameCount;
    if (waitingParamCount) {
        qCDebug(ParameterLoaderLog) << "waitingParamCount:" << waitingParamCount;
    } else {
        // No more parameters to wait for, stop the timeout
        _waitingParamTimeoutTimer.stop();
    }

    // Update progress bar
    if (waitingParamCount == 0) {
        emit parameterListProgress(0);
    } else {
        emit parameterListProgress((float)(_totalParamCount - waitingParamCount) / (float)_totalParamCount);
    }
dogmaphobic's avatar
dogmaphobic committed
202

203 204
    // Attempt to determine default component id
    if (_defaultComponentId == FactSystem::defaultComponentId && _defaultComponentIdParam.isEmpty()) {
205
        _defaultComponentIdParam = _vehicle->firmwarePlugin()->getDefaultComponentIdParam();
206 207 208 209
    }
    if (!_defaultComponentIdParam.isEmpty() && _defaultComponentIdParam == parameterName) {
        _defaultComponentId = componentId;
    }
dogmaphobic's avatar
dogmaphobic committed
210

211
    if (!_mapParameterName2Variant.contains(componentId) || !_mapParameterName2Variant[componentId].contains(parameterName)) {
212
        qCDebug(ParameterLoaderLog) << "Adding new fact";
dogmaphobic's avatar
dogmaphobic committed
213

214 215 216 217 218 219
        FactMetaData::ValueType_t factType;
        switch (mavType) {
            case MAV_PARAM_TYPE_UINT8:
                factType = FactMetaData::valueTypeUint8;
                break;
            case MAV_PARAM_TYPE_INT8:
220
                factType = FactMetaData::valueTypeInt8;
221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244
                break;
            case MAV_PARAM_TYPE_UINT16:
                factType = FactMetaData::valueTypeUint16;
                break;
            case MAV_PARAM_TYPE_INT16:
                factType = FactMetaData::valueTypeInt16;
                break;
            case MAV_PARAM_TYPE_UINT32:
                factType = FactMetaData::valueTypeUint32;
                break;
            case MAV_PARAM_TYPE_INT32:
                factType = FactMetaData::valueTypeInt32;
                break;
            case MAV_PARAM_TYPE_REAL32:
                factType = FactMetaData::valueTypeFloat;
                break;
            case MAV_PARAM_TYPE_REAL64:
                factType = FactMetaData::valueTypeDouble;
                break;
            default:
                factType = FactMetaData::valueTypeInt32;
                qCritical() << "Unsupported fact type" << mavType;
                break;
        }
dogmaphobic's avatar
dogmaphobic committed
245

246 247
        Fact* fact = new Fact(componentId, parameterName, factType, this);
        setMetaData = true;
dogmaphobic's avatar
dogmaphobic committed
248

249
        _mapParameterName2Variant[componentId][parameterName] = QVariant::fromValue(fact);
dogmaphobic's avatar
dogmaphobic committed
250

251
        // We need to know when the fact changes from QML so that we can send the new value to the parameter manager
Don Gagne's avatar
Don Gagne committed
252
        connect(fact, &Fact::_containerRawValueChanged, this, &ParameterLoader::_valueUpdated);
253
    }
dogmaphobic's avatar
dogmaphobic committed
254

Don Gagne's avatar
Don Gagne committed
255 256
    _dataMutex.unlock();

257
    Q_ASSERT(_mapParameterName2Variant[componentId].contains(parameterName));
dogmaphobic's avatar
dogmaphobic committed
258

259 260
    Fact* fact = _mapParameterName2Variant[componentId][parameterName].value<Fact*>();
    Q_ASSERT(fact);
Don Gagne's avatar
Don Gagne committed
261
    fact->_containerSetRawValue(value);
dogmaphobic's avatar
dogmaphobic committed
262

263
    if (setMetaData) {
264
        _vehicle->firmwarePlugin()->addMetaDataToFact(fact, _vehicle->vehicleType());
265
    }
dogmaphobic's avatar
dogmaphobic committed
266

267 268 269
    if (waitingParamCount == 0) {
        // Now that we know vehicle is up to date persist
        _saveToEEPROM();
270
        _writeLocalParamCache();
271
    }
dogmaphobic's avatar
dogmaphobic committed
272

273
    _checkInitialLoadComplete();
274 275 276 277
}

/// Connected to Fact::valueUpdated
///
278
/// Writes the parameter to mavlink, sets up for write wait
279 280 281 282
void ParameterLoader::_valueUpdated(const QVariant& value)
{
    Fact* fact = qobject_cast<Fact*>(sender());
    Q_ASSERT(fact);
dogmaphobic's avatar
dogmaphobic committed
283

284
    int componentId = fact->componentId();
285
    QString name = fact->name();
dogmaphobic's avatar
dogmaphobic committed
286

287
    _dataMutex.lock();
dogmaphobic's avatar
dogmaphobic committed
288

289
    Q_ASSERT(_waitingWriteParamNameMap.contains(componentId));
290 291
    _waitingWriteParamNameMap[componentId].remove(name);    // Remove any old entry
    _waitingWriteParamNameMap[componentId][name] = 0;       // Add new entry and set retry count
292
    _waitingParamTimeoutTimer.start();
dogmaphobic's avatar
dogmaphobic committed
293

294
    _dataMutex.unlock();
dogmaphobic's avatar
dogmaphobic committed
295

296 297
    _writeParameterRaw(componentId, fact->name(), value);
    qCDebug(ParameterLoaderLog) << "Set parameter (componentId:" << componentId << "name:" << name << value << ")";
298

299 300
    if (fact->rebootRequired() && !qgcApp()->runningUnitTests()) {
        qgcApp()->showMessage(QStringLiteral("Change of parameter %1 requires a Vehicle reboot to take effect").arg(name));
301
    }
302 303
}

dogmaphobic's avatar
dogmaphobic committed
304
void ParameterLoader::refreshAllParameters(uint8_t componentID)
305
{
306
    _dataMutex.lock();
dogmaphobic's avatar
dogmaphobic committed
307

308 309 310 311
    if (!_initialLoadComplete) {
        _initialRequestTimeoutTimer.start();
    }

312
    // Reset index wait lists
dogmaphobic's avatar
dogmaphobic committed
313
    foreach (int cid, _paramCountMap.keys()) {
314
        // Add/Update all indices to the wait list, parameter index is 0-based
dogmaphobic's avatar
dogmaphobic committed
315 316 317
        if(componentID != MAV_COMP_ID_ALL && componentID != cid)
            continue;
        for (int waitingIndex = 0; waitingIndex < _paramCountMap[cid]; waitingIndex++) {
318
            // This will add a new waiting index if needed and set the retry count for that index to 0
dogmaphobic's avatar
dogmaphobic committed
319
            _waitingReadParamIndexMap[cid][waitingIndex] = 0;
320 321
        }
    }
dogmaphobic's avatar
dogmaphobic committed
322

323
    _dataMutex.unlock();
dogmaphobic's avatar
dogmaphobic committed
324

325
    MAVLinkProtocol* mavlink = qgcApp()->toolbox()->mavlinkProtocol();
326
    Q_ASSERT(mavlink);
dogmaphobic's avatar
dogmaphobic committed
327

328
    mavlink_message_t msg;
dogmaphobic's avatar
dogmaphobic committed
329
    mavlink_msg_param_request_list_pack(mavlink->getSystemId(), mavlink->getComponentId(), &msg, _vehicle->id(), componentID);
330
    _vehicle->sendMessageOnLink(_vehicle->priorityLink(), msg);
dogmaphobic's avatar
dogmaphobic committed
331

dogmaphobic's avatar
dogmaphobic committed
332 333
    QString what = (componentID == MAV_COMP_ID_ALL) ? "MAV_COMP_ID_ALL" : QString::number(componentID);
    qCDebug(ParameterLoaderLog) << "Request to refresh all parameters for component ID:" << what;
334 335 336 337 338 339 340 341
}

void ParameterLoader::_determineDefaultComponentId(void)
{
    if (_defaultComponentId == FactSystem::defaultComponentId) {
        // We don't have a default component id yet. That means the plugin can't provide
        // the param to trigger off of. Instead we use the most prominent component id in
        // the set of parameters. Better than nothing!
dogmaphobic's avatar
dogmaphobic committed
342

343
        _defaultComponentId = -1;
344
        int largestCompParamCount = 0;
345
        foreach(int componentId, _mapParameterName2Variant.keys()) {
346 347 348
            int compParamCount = _mapParameterName2Variant[componentId].count();
            if (compParamCount > largestCompParamCount) {
                largestCompParamCount = compParamCount;
349 350 351
                _defaultComponentId = componentId;
            }
        }
352 353 354 355

        if (_defaultComponentId == -1) {
            qWarning() << "All parameters missing, unable to determine default componet id";
        }
356 357 358 359 360 361 362 363
    }
}

/// Translates FactSystem::defaultComponentId to real component id if needed
int ParameterLoader::_actualComponentId(int componentId)
{
    if (componentId == FactSystem::defaultComponentId) {
        componentId = _defaultComponentId;
Don Gagne's avatar
Don Gagne committed
364
        if (componentId == FactSystem::defaultComponentId) {
Don Gagne's avatar
Don Gagne committed
365 366
            qWarning() << "Default component id not set";
        }
367
    }
dogmaphobic's avatar
dogmaphobic committed
368

369 370 371 372 373
    return componentId;
}

void ParameterLoader::refreshParameter(int componentId, const QString& name)
{
374 375
    componentId = _actualComponentId(componentId);
    qCDebug(ParameterLoaderLog) << "refreshParameter (component id:" << componentId << "name:" << name << ")";
dogmaphobic's avatar
dogmaphobic committed
376

377 378 379
    _dataMutex.lock();

    Q_ASSERT(_waitingReadParamNameMap.contains(componentId));
dogmaphobic's avatar
dogmaphobic committed
380

381
    if (_waitingReadParamNameMap.contains(componentId)) {
382 383
        _waitingReadParamNameMap[componentId].remove(name); // Remove old wait entry if there
        _waitingReadParamNameMap[componentId][name] = 0;    // Add new wait entry and update retry count
384 385
        emit restartWaitingParamTimer();
    }
dogmaphobic's avatar
dogmaphobic committed
386

387 388 389
    _dataMutex.unlock();

    _readParameterRaw(componentId, name, -1);
390 391 392 393 394
}

void ParameterLoader::refreshParametersPrefix(int componentId, const QString& namePrefix)
{
    componentId = _actualComponentId(componentId);
395 396
    qCDebug(ParameterLoaderLog) << "refreshParametersPrefix (component id:" << componentId << "name:" << namePrefix << ")";

397
    foreach(const QString &name, _mapParameterName2Variant[componentId].keys()) {
398 399 400 401 402 403
        if (name.startsWith(namePrefix)) {
            refreshParameter(componentId, name);
        }
    }
}

404
bool ParameterLoader::parameterExists(int componentId, const QString&  name)
405
{
406
    bool ret = false;
dogmaphobic's avatar
dogmaphobic committed
407

408 409
    componentId = _actualComponentId(componentId);
    if (_mapParameterName2Variant.contains(componentId)) {
410
        ret = _mapParameterName2Variant[componentId].contains(name);
411
    }
412 413

    return ret;
414 415 416 417 418
}

Fact* ParameterLoader::getFact(int componentId, const QString& name)
{
    componentId = _actualComponentId(componentId);
dogmaphobic's avatar
dogmaphobic committed
419

420
    if (!_mapParameterName2Variant.contains(componentId) || !_mapParameterName2Variant[componentId].contains(name)) {
Don Gagne's avatar
Don Gagne committed
421 422
        qgcApp()->reportMissingParameter(componentId, name);
        return &_defaultFact;
423
    }
dogmaphobic's avatar
dogmaphobic committed
424

Don Gagne's avatar
Don Gagne committed
425
    return _mapParameterName2Variant[componentId][name].value<Fact*>();
426
}
427

Don Gagne's avatar
Don Gagne committed
428
QStringList ParameterLoader::parameterNames(int componentId)
429
{
dogmaphobic's avatar
dogmaphobic committed
430 431
    QStringList names;

432
    foreach(const QString &paramName, _mapParameterName2Variant[_actualComponentId(componentId)].keys()) {
dogmaphobic's avatar
dogmaphobic committed
433 434 435 436
        names << paramName;
    }

    return names;
437 438 439 440 441
}

void ParameterLoader::_setupGroupMap(void)
{
    foreach (int componentId, _mapParameterName2Variant.keys()) {
442
        foreach (const QString &name, _mapParameterName2Variant[componentId].keys()) {
443 444 445 446 447 448 449 450 451 452
            Fact* fact = _mapParameterName2Variant[componentId][name].value<Fact*>();
            _mapGroup2ParameterName[componentId][fact->group()] += name;
        }
    }
}

const QMap<int, QMap<QString, QStringList> >& ParameterLoader::getGroupMap(void)
{
    return _mapGroup2ParameterName;
}
453 454 455 456 457 458

void ParameterLoader::_waitingParamTimeout(void)
{
    bool paramsRequested = false;
    const int maxBatchSize = 10;
    int batchCount = 0;
dogmaphobic's avatar
dogmaphobic committed
459

460
    // We timed out waiting for some parameters from the initial set. Re-request those.
dogmaphobic's avatar
dogmaphobic committed
461

462 463
    batchCount = 0;
    foreach(int componentId, _waitingReadParamIndexMap.keys()) {
464 465 466 467 468 469 470 471 472 473 474 475
        foreach(int paramIndex, _waitingReadParamIndexMap[componentId].keys()) {
            _waitingReadParamIndexMap[componentId][paramIndex]++;   // Bump retry count
            if (_waitingReadParamIndexMap[componentId][paramIndex] > _maxInitialLoadRetry) {
                // Give up on this index
                _failedReadParamIndexMap[componentId] << paramIndex;
                qCDebug(ParameterLoaderLog) << "Giving up on (componentId:" << componentId << "paramIndex:" << paramIndex << "retryCount:" << _waitingReadParamIndexMap[componentId][paramIndex] << ")";
                _waitingReadParamIndexMap[componentId].remove(paramIndex);
            } else {
                // Retry again
                paramsRequested = true;
                _readParameterRaw(componentId, "", paramIndex);
                qCDebug(ParameterLoaderLog) << "Read re-request for (componentId:" << componentId << "paramIndex:" << paramIndex << "retryCount:" << _waitingReadParamIndexMap[componentId][paramIndex] << ")";
dogmaphobic's avatar
dogmaphobic committed
476

477 478 479
                if (++batchCount > maxBatchSize) {
                    goto Out;
                }
480 481 482
            }
        }
    }
483 484
    // We need to check for initial load complete here as well, since it could complete on a max retry failure
    _checkInitialLoadComplete();
dogmaphobic's avatar
dogmaphobic committed
485

486 487
    if (!paramsRequested) {
        foreach(int componentId, _waitingWriteParamNameMap.keys()) {
488
            foreach(const QString &paramName, _waitingWriteParamNameMap[componentId].keys()) {
489
                paramsRequested = true;
490
                _waitingWriteParamNameMap[componentId][paramName]++;   // Bump retry count
Don Gagne's avatar
Don Gagne committed
491
                _writeParameterRaw(componentId, paramName, _autopilot->getFact(FactSystem::ParameterProvider, componentId, paramName)->rawValue());
492
                qCDebug(ParameterLoaderLog) << "Write resend for (componentId:" << componentId << "paramName:" << paramName << "retryCount:" << _waitingWriteParamNameMap[componentId][paramName] << ")";
dogmaphobic's avatar
dogmaphobic committed
493

494 495 496 497 498 499
                if (++batchCount > maxBatchSize) {
                    goto Out;
                }
            }
        }
    }
dogmaphobic's avatar
dogmaphobic committed
500

501 502
    if (!paramsRequested) {
        foreach(int componentId, _waitingReadParamNameMap.keys()) {
503
            foreach(const QString &paramName, _waitingReadParamNameMap[componentId].keys()) {
504
                paramsRequested = true;
505
                _waitingReadParamNameMap[componentId][paramName]++;   // Bump retry count
506
                _readParameterRaw(componentId, paramName, -1);
507
                qCDebug(ParameterLoaderLog) << "Read re-request for (componentId:" << componentId << "paramName:" << paramName << "retryCount:" << _waitingReadParamNameMap[componentId][paramName] << ")";
dogmaphobic's avatar
dogmaphobic committed
508

509 510 511 512 513 514
                if (++batchCount > maxBatchSize) {
                    goto Out;
                }
            }
        }
    }
dogmaphobic's avatar
dogmaphobic committed
515

516 517 518 519 520 521
Out:
    if (paramsRequested) {
        _waitingParamTimeoutTimer.start();
    }
}

522 523 524 525 526
void ParameterLoader::_tryCacheLookup()
{
    /* Start waiting for 2.5 seconds to get a cache hit and avoid loading all params over the radio */
    _cacheTimeoutTimer.start();

527
    MAVLinkProtocol* mavlink = qgcApp()->toolbox()->mavlinkProtocol();
528 529 530 531
    Q_ASSERT(mavlink);

    mavlink_message_t msg;
    mavlink_msg_param_request_read_pack(mavlink->getSystemId(), mavlink->getComponentId(), &msg, _vehicle->id(), MAV_COMP_ID_ALL, "_HASH_CHECK", -1);
532
    _vehicle->sendMessageOnLink(_vehicle->priorityLink(), msg);
533 534
}

535 536 537 538 539 540 541 542 543
void ParameterLoader::_readParameterRaw(int componentId, const QString& paramName, int paramIndex)
{
    mavlink_message_t msg;
    char fixedParamName[MAVLINK_MSG_PARAM_REQUEST_READ_FIELD_PARAM_ID_LEN];

    strncpy(fixedParamName, paramName.toStdString().c_str(), sizeof(fixedParamName));
    mavlink_msg_param_request_read_pack(_mavlink->getSystemId(),    // Our system id
                                        _mavlink->getComponentId(), // Our component id
                                        &msg,                       // Pack into this mavlink_message_t
544
                                        _vehicle->id(),             // Target system id
545 546 547
                                        componentId,                // Target component id
                                        fixedParamName,             // Named parameter being requested
                                        paramIndex);                // Parameter index being requested, -1 for named
548
    _vehicle->sendMessageOnLink(_vehicle->priorityLink(), msg);
549 550 551 552 553 554
}

void ParameterLoader::_writeParameterRaw(int componentId, const QString& paramName, const QVariant& value)
{
    mavlink_param_set_t     p;
    mavlink_param_union_t   union_value;
dogmaphobic's avatar
dogmaphobic committed
555

556 557
    FactMetaData::ValueType_t factType = _autopilot->getFact(FactSystem::ParameterProvider, componentId, paramName)->type();
    p.param_type = _factTypeToMavType(factType);
dogmaphobic's avatar
dogmaphobic committed
558

559 560
    switch (factType) {
        case FactMetaData::valueTypeUint8:
Don Gagne's avatar
Don Gagne committed
561
            union_value.param_uint8 = (uint8_t)value.toUInt();
562
            break;
dogmaphobic's avatar
dogmaphobic committed
563

564
        case FactMetaData::valueTypeInt8:
Don Gagne's avatar
Don Gagne committed
565
            union_value.param_int8 = (int8_t)value.toInt();
566
            break;
dogmaphobic's avatar
dogmaphobic committed
567

568
        case FactMetaData::valueTypeUint16:
Don Gagne's avatar
Don Gagne committed
569
            union_value.param_uint16 = (uint16_t)value.toUInt();
570
            break;
dogmaphobic's avatar
dogmaphobic committed
571

572
        case FactMetaData::valueTypeInt16:
Don Gagne's avatar
Don Gagne committed
573
            union_value.param_int16 = (int16_t)value.toInt();
574
            break;
dogmaphobic's avatar
dogmaphobic committed
575

576
        case FactMetaData::valueTypeUint32:
Don Gagne's avatar
Don Gagne committed
577
            union_value.param_uint32 = (uint32_t)value.toUInt();
578
            break;
dogmaphobic's avatar
dogmaphobic committed
579

580 581 582
        case FactMetaData::valueTypeFloat:
            union_value.param_float = value.toFloat();
            break;
dogmaphobic's avatar
dogmaphobic committed
583

584 585 586
        default:
            qCritical() << "Unsupported fact type" << factType;
            // fall through
dogmaphobic's avatar
dogmaphobic committed
587

588
        case FactMetaData::valueTypeInt32:
Don Gagne's avatar
Don Gagne committed
589
            union_value.param_int32 = (int32_t)value.toInt();
590 591
            break;
    }
dogmaphobic's avatar
dogmaphobic committed
592

593
    p.param_value = union_value.param_float;
594
    p.target_system = (uint8_t)_vehicle->id();
595
    p.target_component = (uint8_t)componentId;
dogmaphobic's avatar
dogmaphobic committed
596

597
    strncpy(p.param_id, paramName.toStdString().c_str(), sizeof(p.param_id));
dogmaphobic's avatar
dogmaphobic committed
598

599 600
    mavlink_message_t msg;
    mavlink_msg_param_set_encode(_mavlink->getSystemId(), _mavlink->getComponentId(), &msg, &p);
601
    _vehicle->sendMessageOnLink(_vehicle->priorityLink(), msg);
602 603
}

604 605 606 607 608 609 610 611
void ParameterLoader::_writeLocalParamCache()
{
    QMap<int, MapID2NamedParam> cache_map;

    foreach(int component, _mapParameterId2Name.keys()) {
        foreach(int id, _mapParameterId2Name[component].keys()) {
            const QString name(_mapParameterId2Name[component][id]);
            const Fact *fact = _mapParameterName2Variant[component][name].value<Fact*>();
Don Gagne's avatar
Don Gagne committed
612
            cache_map[component][id] = NamedParam(name, ParamTypeVal(fact->type(), fact->rawValue()));
613 614 615 616 617 618 619 620 621 622
        }
    }

    QFile cache_file(QFileInfo(QSettings().fileName()).path() + QDir::separator() + "param_cache");
    cache_file.open(QIODevice::WriteOnly | QIODevice::Truncate);

    QDataStream ds(&cache_file);
    ds << cache_map;
}

623 624 625 626 627 628
QString ParameterLoader::parameterCacheFile(void)
{
    const QDir settingsDir(QFileInfo(QSettings().fileName()).dir());
    return settingsDir.filePath("param_cache");
}

629 630 631 632 633
void ParameterLoader::_tryCacheHashLoad(int uasId, QVariant hash_value)
{
    uint32_t crc32_value = 0;
    /* The datastructure of the cache table */
    QMap<int, MapID2NamedParam> cache_map;
634
    QFile cache_file(parameterCacheFile());
635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662
    if (!cache_file.exists()) {
        /* no local cache, immediately refresh all params */
        refreshAllParameters();
        return;
    }
    cache_file.open(QIODevice::ReadOnly);

    /* Deserialize the parameter cache table */
    QDataStream ds(&cache_file);
    ds >> cache_map;

    /* compute the crc of the local cache to check against the remote */
    foreach(int component, cache_map.keys()) {
        foreach(int id, cache_map[component].keys()) {
            const QString name(cache_map[component][id].first);
            const void *vdat = cache_map[component][id].second.second.constData();
            crc32_value = QGC::crc32((const uint8_t *)qPrintable(name), name.length(),  crc32_value);
            crc32_value = QGC::crc32((const uint8_t *)vdat, sizeof(uint32_t), crc32_value);
        }
    }

    if (crc32_value == hash_value.toUInt()) {
        /* if the two param set hashes match, just load from the disk */
        foreach(int component, cache_map.keys()) {
            int count = cache_map[component].count();
            foreach(int id, cache_map[component].keys()) {
                const QString &name = cache_map[component][id].first;
                const QVariant &value = cache_map[component][id].second.second;
663
                const int mavType = _factTypeToMavType(static_cast<FactMetaData::ValueType_t>(cache_map[component][id].second.first));
664 665 666 667 668 669 670 671 672
                _parameterUpdate(uasId, component, name, count, id, mavType, value);
            }
        }
    } else {
        /* cache and remote hashes differ. Immediately request all params */
        refreshAllParameters();
    }
}

673 674
void ParameterLoader::_saveToEEPROM(void)
{
Don Gagne's avatar
Don Gagne committed
675 676 677
    if (_vehicle->firmwarePlugin()->isCapable(FirmwarePlugin::MavCmdPreflightStorageCapability)) {
        mavlink_message_t msg;
        mavlink_msg_command_long_pack(_mavlink->getSystemId(), _mavlink->getComponentId(), &msg, _vehicle->id(), 0, MAV_CMD_PREFLIGHT_STORAGE, 1, 1, -1, -1, -1, 0, 0, 0);
678
        _vehicle->sendMessageOnLink(_vehicle->priorityLink(), msg);
Don Gagne's avatar
Don Gagne committed
679 680 681 682
        qCDebug(ParameterLoaderLog) << "_saveToEEPROM";
    } else {
        qCDebug(ParameterLoaderLog) << "_saveToEEPROM skipped due to FirmwarePlugin::isCapable";
    }
683 684
}

685
QString ParameterLoader::readParametersFromStream(QTextStream& stream)
686
{
687
    QString errors;
dogmaphobic's avatar
dogmaphobic committed
688

689 690 691 692 693 694
    while (!stream.atEnd()) {
        QString line = stream.readLine();
        if (!line.startsWith("#")) {
            QStringList wpParams = line.split("\t");
            int lineMavId = wpParams.at(0).toInt();
            if (wpParams.size() == 5) {
Don Gagne's avatar
Don Gagne committed
695 696
                if (_vehicle->id() != lineMavId) {
                    return QString("The parameters in the stream have been saved from System Id %1, but the current vehicle has the System Id %2.").arg(lineMavId).arg(_vehicle->id());
dogmaphobic's avatar
dogmaphobic committed
697 698
                }

699 700 701 702
                int     componentId = wpParams.at(1).toInt();
                QString paramName = wpParams.at(2);
                QString valStr = wpParams.at(3);
                uint    mavType = wpParams.at(4).toUInt();
dogmaphobic's avatar
dogmaphobic committed
703

704
                if (!_autopilot->factExists(FactSystem::ParameterProvider, componentId, paramName)) {
705 706 707 708
                    QString error;
                    error = QString("Skipped parameter %1:%2 - does not exist on this vehicle\n").arg(componentId).arg(paramName);
                    errors += error;
                    qCDebug(ParameterLoaderLog) << error;
709 710
                    continue;
                }
dogmaphobic's avatar
dogmaphobic committed
711

712 713
                Fact* fact = _autopilot->getFact(FactSystem::ParameterProvider, componentId, paramName);
                if (fact->type() != _mavTypeToFactType((MAV_PARAM_TYPE)mavType)) {
714 715 716 717
                    QString error;
                    error  = QString("Skipped parameter %1:%2 - type mismatch %3:%4\n").arg(componentId).arg(paramName).arg(fact->type()).arg(_mavTypeToFactType((MAV_PARAM_TYPE)mavType));
                    errors += error;
                    qCDebug(ParameterLoaderLog) << error;
718 719
                    continue;
                }
dogmaphobic's avatar
dogmaphobic committed
720

721
                qCDebug(ParameterLoaderLog) << "Updating parameter" << componentId << paramName << valStr;
Don Gagne's avatar
Don Gagne committed
722
                fact->setRawValue(valStr);
723 724 725
            }
        }
    }
dogmaphobic's avatar
dogmaphobic committed
726

727
    return errors;
728 729
}

730
void ParameterLoader::writeParametersToStream(QTextStream &stream)
731
{
732
    stream << "# Onboard parameters for vehicle " << _vehicle->id() << "\n";
733 734 735 736
    stream << "#\n";
    stream << "# MAV ID  COMPONENT ID  PARAM NAME  VALUE (FLOAT)\n";

    foreach (int componentId, _mapParameterName2Variant.keys()) {
737
        foreach (const QString &paramName, _mapParameterName2Variant[componentId].keys()) {
738 739
            Fact* fact = _mapParameterName2Variant[componentId][paramName].value<Fact*>();
            Q_ASSERT(fact);
dogmaphobic's avatar
dogmaphobic committed
740

741
            stream << _vehicle->id() << "\t" << componentId << "\t" << paramName << "\t" << fact->rawValueString() << "\t" << QString("%1").arg(_factTypeToMavType(fact->type())) << "\n";
742 743
        }
    }
dogmaphobic's avatar
dogmaphobic committed
744

745 746 747 748 749 750 751 752
    stream.flush();
}

MAV_PARAM_TYPE ParameterLoader::_factTypeToMavType(FactMetaData::ValueType_t factType)
{
    switch (factType) {
        case FactMetaData::valueTypeUint8:
            return MAV_PARAM_TYPE_UINT8;
dogmaphobic's avatar
dogmaphobic committed
753

754 755
        case FactMetaData::valueTypeInt8:
            return MAV_PARAM_TYPE_INT8;
dogmaphobic's avatar
dogmaphobic committed
756

757 758
        case FactMetaData::valueTypeUint16:
            return MAV_PARAM_TYPE_UINT16;
dogmaphobic's avatar
dogmaphobic committed
759

760 761
        case FactMetaData::valueTypeInt16:
            return MAV_PARAM_TYPE_INT16;
dogmaphobic's avatar
dogmaphobic committed
762

763 764
        case FactMetaData::valueTypeUint32:
            return MAV_PARAM_TYPE_UINT32;
dogmaphobic's avatar
dogmaphobic committed
765

766 767
        case FactMetaData::valueTypeFloat:
            return MAV_PARAM_TYPE_REAL32;
dogmaphobic's avatar
dogmaphobic committed
768

769 770 771
        default:
            qWarning() << "Unsupported fact type" << factType;
            // fall through
dogmaphobic's avatar
dogmaphobic committed
772

773 774 775 776 777 778 779 780 781 782
        case FactMetaData::valueTypeInt32:
            return MAV_PARAM_TYPE_INT32;
    }
}

FactMetaData::ValueType_t ParameterLoader::_mavTypeToFactType(MAV_PARAM_TYPE mavType)
{
    switch (mavType) {
        case MAV_PARAM_TYPE_UINT8:
            return FactMetaData::valueTypeUint8;
dogmaphobic's avatar
dogmaphobic committed
783

784 785
        case MAV_PARAM_TYPE_INT8:
            return FactMetaData::valueTypeInt8;
dogmaphobic's avatar
dogmaphobic committed
786

787 788
        case MAV_PARAM_TYPE_UINT16:
            return FactMetaData::valueTypeUint16;
dogmaphobic's avatar
dogmaphobic committed
789

790 791
        case MAV_PARAM_TYPE_INT16:
            return FactMetaData::valueTypeInt16;
dogmaphobic's avatar
dogmaphobic committed
792

793 794
        case MAV_PARAM_TYPE_UINT32:
            return FactMetaData::valueTypeUint32;
dogmaphobic's avatar
dogmaphobic committed
795

796 797
        case MAV_PARAM_TYPE_REAL32:
            return FactMetaData::valueTypeFloat;
dogmaphobic's avatar
dogmaphobic committed
798

799 800 801
        default:
            qWarning() << "Unsupported mav param type" << mavType;
            // fall through
dogmaphobic's avatar
dogmaphobic committed
802

803 804 805 806 807 808 809 810 811
        case MAV_PARAM_TYPE_INT32:
            return FactMetaData::valueTypeInt32;
    }
}

void ParameterLoader::_restartWaitingParamTimer(void)
{
    _waitingParamTimeoutTimer.start();
}
812 813 814 815 816 817 818

void ParameterLoader::_checkInitialLoadComplete(void)
{
    // Already processed?
    if (_initialLoadComplete) {
        return;
    }
dogmaphobic's avatar
dogmaphobic committed
819

820 821 822 823 824 825
    foreach (int componentId, _waitingReadParamIndexMap.keys()) {
        if (_waitingReadParamIndexMap[componentId].count()) {
            // We are still waiting on some parameters, not done yet
            return;
        }
    }
dogmaphobic's avatar
dogmaphobic committed
826 827


828 829
    // We aren't waiting for any more initial parameter updates, initial parameter loading is complete
    _initialLoadComplete = true;
dogmaphobic's avatar
dogmaphobic committed
830

831 832 833 834 835 836 837 838 839 840 841 842 843
    // Check for load failures
    QString indexList;
    bool initialLoadFailures = false;
    foreach (int componentId, _failedReadParamIndexMap.keys()) {
        foreach (int paramIndex, _failedReadParamIndexMap[componentId]) {
            if (initialLoadFailures) {
                indexList += ", ";
            }
            indexList += QString("%1").arg(paramIndex);
            initialLoadFailures = true;
            qCDebug(ParameterLoaderLog) << "Gave up on initial load after max retries (componentId:" << componentId << "paramIndex:" << paramIndex << ")";
        }
    }
dogmaphobic's avatar
dogmaphobic committed
844

845
    // Check for any errors during vehicle boot
dogmaphobic's avatar
dogmaphobic committed
846

847
    UASMessageHandler* msgHandler = qgcApp()->toolbox()->uasMessageHandler();
848
    if (msgHandler->getErrorCountTotal()) {
849
        QString errors;
850
        bool firstError = true;
851
        bool errorsFound = false;
dogmaphobic's avatar
dogmaphobic committed
852

853 854 855
        msgHandler->lockAccess();
        foreach (UASMessage* msg, msgHandler->messages()) {
            if (msg->severityIsError()) {
856
                if (!firstError) {
dogmaphobic's avatar
dogmaphobic committed
857
                    errors += "<br>";
858 859
                }
                errors += " - ";
860
                errors += msg->getText();
861
                firstError = false;
862
                errorsFound = true;
863 864
            }
        }
865
        msgHandler->showErrorsInToolbar();
866
        msgHandler->unlockAccess();
dogmaphobic's avatar
dogmaphobic committed
867

868
        if (errorsFound) {
dogmaphobic's avatar
dogmaphobic committed
869
            QString errorMsg = QString("<b>Critical safety issue detected:</b><br>%1").arg(errors);
870
            qgcApp()->showMessage(errorMsg);
871
        }
872
    }
dogmaphobic's avatar
dogmaphobic committed
873

874
    // Warn of parameter load failure
dogmaphobic's avatar
dogmaphobic committed
875

876
    if (initialLoadFailures) {
877
        qgcApp()->showMessage("QGroundControl was unable to retrieve the full set of parameters from the vehicle. "
dogmaphobic's avatar
dogmaphobic committed
878
                              "This will cause QGroundControl to be unable to display its full user interface. "
879 880
                              "If you are using modified firmware, you may need to resolve any vehicle startup errors to resolve the issue. "
                              "If you are using standard firmware, you may need to upgrade to a newer version to resolve the issue.");
881
        qCWarning(ParameterLoaderLog) << "The following parameter indices could not be loaded after the maximum number of retries: " << indexList;
882
        emit parametersReady(true);
883 884 885 886 887
    } else {
        // No failed parameters, ok to signal ready
        _parametersReady = true;
        _determineDefaultComponentId();
        _setupGroupMap();
888
        emit parametersReady(false);
889
    }
890
}
891 892 893 894 895 896 897

void ParameterLoader::_initialRequestTimeout(void)
{
    qgcApp()->showMessage("Vehicle did not respond to request for parameters, retrying");
    refreshAllParameters();
    _initialRequestTimeoutTimer.start();
}
dogmaphobic's avatar
dogmaphobic committed
898 899 900 901 902 903

void ParameterLoader::_timeoutRefreshAll()
{
    refreshAllParameters();
}