ParameterLoader.cc 33.6 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 623 624 625 626 627
        }
    }

    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;
}

void ParameterLoader::_tryCacheHashLoad(int uasId, QVariant hash_value)
{
    uint32_t crc32_value = 0;
    /* The datastructure of the cache table */
    QMap<int, MapID2NamedParam> cache_map;
628 629
    const QDir settingsDir(QFileInfo(QSettings().fileName()).dir());
    QFile cache_file(settingsDir.filePath("param_cache"));
630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657
    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;
658
                const int mavType = _factTypeToMavType(static_cast<FactMetaData::ValueType_t>(cache_map[component][id].second.first));
659 660 661 662 663 664 665 666 667
                _parameterUpdate(uasId, component, name, count, id, mavType, value);
            }
        }
    } else {
        /* cache and remote hashes differ. Immediately request all params */
        refreshAllParameters();
    }
}

668 669
void ParameterLoader::_saveToEEPROM(void)
{
Don Gagne's avatar
Don Gagne committed
670 671 672
    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);
673
        _vehicle->sendMessageOnLink(_vehicle->priorityLink(), msg);
Don Gagne's avatar
Don Gagne committed
674 675 676 677
        qCDebug(ParameterLoaderLog) << "_saveToEEPROM";
    } else {
        qCDebug(ParameterLoaderLog) << "_saveToEEPROM skipped due to FirmwarePlugin::isCapable";
    }
678 679
}

680
QString ParameterLoader::readParametersFromStream(QTextStream& stream)
681
{
682
    QString errors;
dogmaphobic's avatar
dogmaphobic committed
683

684 685 686 687 688 689
    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
690 691
                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
692 693
                }

694 695 696 697
                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
698

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

707 708
                Fact* fact = _autopilot->getFact(FactSystem::ParameterProvider, componentId, paramName);
                if (fact->type() != _mavTypeToFactType((MAV_PARAM_TYPE)mavType)) {
709 710 711 712
                    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;
713 714
                    continue;
                }
dogmaphobic's avatar
dogmaphobic committed
715

716
                qCDebug(ParameterLoaderLog) << "Updating parameter" << componentId << paramName << valStr;
Don Gagne's avatar
Don Gagne committed
717
                fact->setRawValue(valStr);
718 719 720
            }
        }
    }
dogmaphobic's avatar
dogmaphobic committed
721

722
    return errors;
723 724
}

725
void ParameterLoader::writeParametersToStream(QTextStream &stream)
726
{
727
    stream << "# Onboard parameters for vehicle " << _vehicle->id() << "\n";
728 729 730 731
    stream << "#\n";
    stream << "# MAV ID  COMPONENT ID  PARAM NAME  VALUE (FLOAT)\n";

    foreach (int componentId, _mapParameterName2Variant.keys()) {
732
        foreach (const QString &paramName, _mapParameterName2Variant[componentId].keys()) {
733 734
            Fact* fact = _mapParameterName2Variant[componentId][paramName].value<Fact*>();
            Q_ASSERT(fact);
dogmaphobic's avatar
dogmaphobic committed
735

736
            stream << _vehicle->id() << "\t" << componentId << "\t" << paramName << "\t" << fact->rawValueString() << "\t" << QString("%1").arg(_factTypeToMavType(fact->type())) << "\n";
737 738
        }
    }
dogmaphobic's avatar
dogmaphobic committed
739

740 741 742 743 744 745 746 747
    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
748

749 750
        case FactMetaData::valueTypeInt8:
            return MAV_PARAM_TYPE_INT8;
dogmaphobic's avatar
dogmaphobic committed
751

752 753
        case FactMetaData::valueTypeUint16:
            return MAV_PARAM_TYPE_UINT16;
dogmaphobic's avatar
dogmaphobic committed
754

755 756
        case FactMetaData::valueTypeInt16:
            return MAV_PARAM_TYPE_INT16;
dogmaphobic's avatar
dogmaphobic committed
757

758 759
        case FactMetaData::valueTypeUint32:
            return MAV_PARAM_TYPE_UINT32;
dogmaphobic's avatar
dogmaphobic committed
760

761 762
        case FactMetaData::valueTypeFloat:
            return MAV_PARAM_TYPE_REAL32;
dogmaphobic's avatar
dogmaphobic committed
763

764 765 766
        default:
            qWarning() << "Unsupported fact type" << factType;
            // fall through
dogmaphobic's avatar
dogmaphobic committed
767

768 769 770 771 772 773 774 775 776 777
        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
778

779 780
        case MAV_PARAM_TYPE_INT8:
            return FactMetaData::valueTypeInt8;
dogmaphobic's avatar
dogmaphobic committed
781

782 783
        case MAV_PARAM_TYPE_UINT16:
            return FactMetaData::valueTypeUint16;
dogmaphobic's avatar
dogmaphobic committed
784

785 786
        case MAV_PARAM_TYPE_INT16:
            return FactMetaData::valueTypeInt16;
dogmaphobic's avatar
dogmaphobic committed
787

788 789
        case MAV_PARAM_TYPE_UINT32:
            return FactMetaData::valueTypeUint32;
dogmaphobic's avatar
dogmaphobic committed
790

791 792
        case MAV_PARAM_TYPE_REAL32:
            return FactMetaData::valueTypeFloat;
dogmaphobic's avatar
dogmaphobic committed
793

794 795 796
        default:
            qWarning() << "Unsupported mav param type" << mavType;
            // fall through
dogmaphobic's avatar
dogmaphobic committed
797

798 799 800 801 802 803 804 805 806
        case MAV_PARAM_TYPE_INT32:
            return FactMetaData::valueTypeInt32;
    }
}

void ParameterLoader::_restartWaitingParamTimer(void)
{
    _waitingParamTimeoutTimer.start();
}
807 808 809 810 811 812 813

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

815 816 817 818 819 820
    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
821 822


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

826 827 828 829 830 831 832 833 834 835 836 837 838
    // 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
839

840
    // Check for any errors during vehicle boot
dogmaphobic's avatar
dogmaphobic committed
841

842
    UASMessageHandler* msgHandler = qgcApp()->toolbox()->uasMessageHandler();
843
    if (msgHandler->getErrorCountTotal()) {
844
        QString errors;
845
        bool firstError = true;
846
        bool errorsFound = false;
dogmaphobic's avatar
dogmaphobic committed
847

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

863
        if (errorsFound) {
dogmaphobic's avatar
dogmaphobic committed
864
            QString errorMsg = QString("<b>Critical safety issue detected:</b><br>%1").arg(errors);
865
            qgcApp()->showMessage(errorMsg);
866
        }
867
    }
dogmaphobic's avatar
dogmaphobic committed
868

869
    // Warn of parameter load failure
dogmaphobic's avatar
dogmaphobic committed
870

871
    if (initialLoadFailures) {
872
        qgcApp()->showMessage("QGroundControl was unable to retrieve the full set of parameters from the vehicle. "
dogmaphobic's avatar
dogmaphobic committed
873
                              "This will cause QGroundControl to be unable to display its full user interface. "
874 875
                              "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.");
876
        qCWarning(ParameterLoaderLog) << "The following parameter indices could not be loaded after the maximum number of retries: " << indexList;
877
        emit parametersReady(true);
878 879 880 881 882
    } else {
        // No failed parameters, ok to signal ready
        _parametersReady = true;
        _determineDefaultComponentId();
        _setupGroupMap();
883
        emit parametersReady(false);
884
    }
885
}
886 887 888 889 890 891 892

void ParameterLoader::_initialRequestTimeout(void)
{
    qgcApp()->showMessage("Vehicle did not respond to request for parameters, retrying");
    refreshAllParameters();
    _initialRequestTimeoutTimer.start();
}
dogmaphobic's avatar
dogmaphobic committed
893 894 895 896 897 898

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