lib/ofononetworkoperator.h

   1 /*
   2  * This file is part of ofono-qt
   3  *
   4  * Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
   5  *
   6  * Contact: Alexander Kanavin <alexander.kanavin@nokia.com>
   7  *
   8  * This library is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU Lesser General Public License
  10  * version 2.1 as published by the Free Software Foundation.
  11  *
  12  * This library is distributed in the hope that it will be useful, but
  13  * WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  15  * Lesser General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Lesser General Public
  18  * License along with this library; if not, write to the Free Software
  19  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
  20  * 02110-1301 USA
  21  *
  22  */
  23
  24
  25 #ifndef OFONONETWORKOPERATOR_H
  26 #define OFONONETWORKOPERATOR_H
  27
  28 #include <QtCore/QObject>
  29 #include <QVariant>
  30 #include <QStringList>
  31 #include <QDBusError>
  32
  33 #include "libofono-qt_global.h"
  34
  35 class OfonoInterface;
  36
  37 //! This class is used to access oFono network operator API
  38 /*!
  39  * The API is documented in
  40  * http://git.kernel.org/?p=network/ofono/ofono.git;a=blob_plain;f=doc/network-api.txt
  41  */
  42 class OFONO_QT_EXPORT OfonoNetworkOperator : public QObject
  43 {
  44     Q_OBJECT
  45
  46     Q_PROPERTY(QString path READ path)
  47     Q_PROPERTY(QString errorName READ errorName)
  48     Q_PROPERTY(QString errorMessage READ errorMessage)
  49
  50     Q_PROPERTY(QString name READ name NOTIFY nameChanged)
  51     Q_PROPERTY(QString status READ status NOTIFY statusChanged)
  52     Q_PROPERTY(QString mcc READ mcc NOTIFY mccChanged)
  53     Q_PROPERTY(QString mnc READ mnc NOTIFY mncChanged)
  54     Q_PROPERTY(QStringList technologies READ technologies NOTIFY technologiesChanged)
  55     Q_PROPERTY(QString additionalInfo READ additionalInfo NOTIFY additionalInfoChanged)
  56
  57 public:
  58     OfonoNetworkOperator(const QString& operatorId, QObject *parent=0);
  59     OfonoNetworkOperator(const OfonoNetworkOperator& op);
  60     ~OfonoNetworkOperator();
  61
  62     OfonoNetworkOperator operator=(const OfonoNetworkOperator &op);
  63     bool operator==(const OfonoNetworkOperator &op);
  64
  65     //! Returns the D-Bus object path of the network operator object
  66     QString path() const;
  67
  68     //! Get the D-Bus error name of the last operation.
  69     /*!
  70      * Returns the D-Bus error name of the last operation (setting a property
  71      * or calling a method) if it has failed
  72      */
  73     QString errorName() const;
  74
  75     //! Get the D-Bus error message of the last operation.
  76     /*!
  77      * Returns the D-Bus error message of the last operation (setting a property
  78      * or calling a method) if it has failed
  79      */
  80     QString errorMessage() const;
  81
  82     QString name() const;
  83     QString status() const;
  84     QString mcc() const;
  85     QString mnc() const;
  86     QStringList technologies() const;
  87     QString additionalInfo() const;
  88
  89 public slots:
  90     void registerOp();
  91
  92 signals:
  93     void registerComplete(bool success);
  94
  95     void nameChanged(const QString &name);
  96     void statusChanged(const QString &status);
  97     void mccChanged(const QString &mcc);
  98     void mncChanged(const QString &mnc);
  99     void technologiesChanged(const QStringList &technologies);
 100     void additionalInfoChanged(const QString &additionalInfo);
 101
 102 private:
 103
 104 private slots:
 105     void propertyChanged(const QString& property, const QVariant& value);
 106
 107     void registerResp();
 108     void registerErr(const QDBusError& error);
 109
 110
 111 private:
 112     OfonoInterface *m_if;
 113
 114 };
 115 #endif