Add new Satellite Information example

[ChangeLog][QtPositioning] New SatelliteInfo example
added. The example displays the signal strength of surrounding satellites.
The example employs a demo mode on those platforms which don't provide
satellite information

Change-Id: I573266c7a4429c0d2f1bcdfeb01af52ad02efba7
Reviewed-by: Aaron McCarthy <mccarthy.aaron@gmail.com>
Reviewed-by: Alex Blasche <alexander.blasche@digia.com>

1 files changed, 124 insertions, 0 deletions

diff --git a/examples/positioning/satelliteinfo/satellitemodel.h b/examples/positioning/satelliteinfo/satellitemodel.h
new file mode 100644
index 00000000..d7ce84e3
--- /dev/null
+++ b/examples/positioning/satelliteinfo/satellitemodel.h
@@ -0,0 +1,124 @@
+/****************************************************************************
+**
+** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies).
+** Contact: http://www.qt-project.org/legal
+**
+** This file is part of the examples of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:BSD$
+** You may use this file under the terms of the BSD license as follows:
+**
+** "Redistribution and use in source and binary forms, with or without
+** modification, are permitted provided that the following conditions are
+** met:
+**   * Redistributions of source code must retain the above copyright
+**     notice, this list of conditions and the following disclaimer.
+**   * Redistributions in binary form must reproduce the above copyright
+**     notice, this list of conditions and the following disclaimer in
+**     the documentation and/or other materials provided with the
+**     distribution.
+**   * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names
+**     of its contributors may be used to endorse or promote products derived
+**     from this software without specific prior written permission.
+**
+**
+** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#ifndef SATELLITEMODEL_H
+#define SATELLITEMODEL_H
+
+#include <QAbstractListModel>
+#include <QSet>
+#include <QtQml/qqml.h>
+#include <QtQml/QQmlParserStatus>
+#include <QtPositioning/QGeoSatelliteInfoSource>
+
+QT_FORWARD_DECLARE_CLASS(QTimer)
+QT_FORWARD_DECLARE_CLASS(QGeoSatelliteInfoSource)
+
+class SatelliteModel : public QAbstractListModel, public QQmlParserStatus
+{
+    Q_OBJECT
+    Q_PROPERTY(bool running READ running WRITE setRunning NOTIFY runningChanged)
+    Q_PROPERTY(bool satelliteInfoAvailable READ canProvideSatelliteInfo NOTIFY canProvideSatelliteInfoChanged)
+    Q_PROPERTY(int entryCount READ entryCount NOTIFY entryCountChanged)
+    Q_PROPERTY(bool singleRequestMode READ isSingleRequest WRITE setSingleRequest NOTIFY singleRequestChanged)
+    Q_INTERFACES(QQmlParserStatus)
+public:
+    explicit SatelliteModel(QObject *parent = 0);
+
+    enum {
+        IdentifierRole = Qt::UserRole + 1,
+        InUseRole,
+        SignalStrengthRole,
+        ElevationRole,
+        AzimuthRole
+    };
+
+    //From QAbstractListModel
+    int rowCount(const QModelIndex &parent) const;
+    QVariant data(const QModelIndex &index, int role) const;
+    QHash<int, QByteArray> roleNames() const;
+
+    //From QQmlParserStatus
+    void classBegin() {}
+    void componentComplete();
+
+    bool running() const;
+    void setRunning(bool isActive);
+
+    bool isSingleRequest() const;
+    void setSingleRequest(bool single);
+
+    int entryCount() const;
+
+    bool canProvideSatelliteInfo() const;
+
+signals:
+    void runningChanged();
+    void entryCountChanged();
+    void errorFound(int code);
+    void canProvideSatelliteInfoChanged();
+    void singleRequestChanged();
+
+public slots:
+    void clearModel();
+    void updateDemoData();
+
+private slots:
+    void error(QGeoSatelliteInfoSource::Error);
+    void satellitesInViewUpdated(const QList<QGeoSatelliteInfo> &infos);
+    void satellitesInUseUpdated(const QList<QGeoSatelliteInfo> &infos);
+
+private:
+    QGeoSatelliteInfoSource *source;
+    bool m_componentCompleted;
+    bool m_running;
+    bool m_runningRequested;
+    QList <QGeoSatelliteInfo> knownSatellites;
+    QSet<int> knownSatelliteIds;
+    QSet<int> satellitesInUse;
+    bool demo;
+    QTimer *timer;
+    bool isSingle;
+    bool singleRequestServed;
+
+};
+
+QML_DECLARE_TYPE(SatelliteModel)
+
+#endif // SATELLITEMODEL_H