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