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 name READ name NOTIFY nameChanged)
  47     Q_PROPERTY(QString status READ status NOTIFY statusChanged)
  48     Q_PROPERTY(QString mcc READ mcc NOTIFY mccChanged)
  49     Q_PROPERTY(QString mnc READ mnc NOTIFY mncChanged)
  50     Q_PROPERTY(QStringList technologies READ technologies NOTIFY technologiesChanged)
  51     Q_PROPERTY(QString additionalInfo READ additionalInfo NOTIFY additionalInfoChanged)
  52
  53 public:
  54     OfonoNetworkOperator(const QString& operatorId, QObject *parent=0);
  55     OfonoNetworkOperator(const OfonoNetworkOperator& op);
  56     ~OfonoNetworkOperator();
  57
  58     OfonoNetworkOperator operator=(const OfonoNetworkOperator &op);
  59     bool operator==(const OfonoNetworkOperator &op);
  60
  61     //! Returns the D-Bus object path of the network operator object
  62     QString path() const;
  63
  64     //! Get the D-Bus error name of the last operation.
  65     /*!
  66      * Returns the D-Bus error name of the last operation (setting a property
  67      * or calling a method) if it has failed
  68      */
  69     QString errorName() const;
  70
  71     //! Get the D-Bus error message of the last operation.
  72     /*!
  73      * Returns the D-Bus error message of the last operation (setting a property
  74      * or calling a method) if it has failed
  75      */
  76     QString errorMessage() const;
  77
  78     void registerOp();
  79
  80     QString name() const;
  81     QString status() const;
  82     QString mcc() const;
  83     QString mnc() const;
  84     QStringList technologies() const;
  85     QString additionalInfo() const;
  86
  87 signals:
  88     void registerComplete(bool success);
  89
  90     void nameChanged(const QString &name);
  91     void statusChanged(const QString &status);
  92     void mccChanged(const QString &mcc);
  93     void mncChanged(const QString &mnc);
  94     void technologiesChanged(const QStringList &technologies);
  95     void additionalInfoChanged(const QString &additionalInfo);
  96
  97 private:
  98
  99 private slots:
 100     void propertyChanged(const QString& property, const QVariant& value);
 101
 102     void registerResp();
 103     void registerErr(const QDBusError& error);
 104
 105
 106 private:
 107     OfonoInterface *m_if;
 108
 109 };
 110 #endif