lib/ofonosimmanager.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 #ifndef OFONOSIMMANAGER_H
  25 #define OFONOSIMMANAGER_H
  26
  27 #include <QtCore/QObject>
  28 #include <QStringList>
  29 #include <QDBusError>
  30 #include "ofonomodeminterface.h"
  31 #include "libofono-qt_global.h"
  32
  33 typedef QMap<QString, QString> OfonoServiceNumbers;
  34 Q_DECLARE_METATYPE(OfonoServiceNumbers);
  35
  36 typedef QMap<QString, quint8> OfonoPinRetries;
  37 Q_DECLARE_METATYPE(OfonoPinRetries);
  38
  39 //! This class is used to access oFono SIM API
  40 /*!
  41  * The API is documented in
  42  * http://git.kernel.org/?p=network/ofono/ofono.git;a=blob_plain;f=doc/sim-api.txt
  43  */
  44 class OFONO_QT_EXPORT OfonoSimManager : public OfonoModemInterface
  45 {
  46     Q_OBJECT
  47
  48     Q_PROPERTY(bool present READ present NOTIFY presenceChanged)
  49     Q_PROPERTY(QString subscriberIdentity READ subscriberIdentity NOTIFY subscriberIdentityChanged)
  50     Q_PROPERTY(QString mobileCountryCode READ mobileCountryCode NOTIFY mobileCountryCodeChanged)
  51     Q_PROPERTY(QString mobileNetworkCode READ mobileNetworkCode NOTIFY mobileNetworkCodeChanged)
  52     Q_PROPERTY(QStringList subscriberNumbers READ subscriberNumbers WRITE setSubscriberNumbers NOTIFY subscriberNumbersChanged)
  53     Q_PROPERTY(QString pinRequired READ pinRequired NOTIFY pinRequiredChanged)
  54     Q_PROPERTY(QStringList lockedPins READ lockedPins NOTIFY lockedPinsChanged)
  55     Q_PROPERTY(QString cardIdentifier READ cardIdentifier NOTIFY cardIdentifierChanged)
  56     Q_PROPERTY(QStringList preferredLanguages READ preferredLanguages NOTIFY preferredLanguagesChanged)
  57     Q_PROPERTY(OfonoPinRetries pinRetries READ pinRetries NOTIFY pinRetriesChanged)
  58
  59 public:
  60     OfonoSimManager(OfonoModem::SelectionSetting modemSetting, const QString &modemPath, QObject *parent=0);
  61     ~OfonoSimManager();
  62
  63     /* Properties */
  64     bool present() const;
  65     QString subscriberIdentity() const;
  66     QString mobileCountryCode() const;
  67     QString mobileNetworkCode() const;
  68     QStringList subscriberNumbers() const;
  69     OfonoServiceNumbers serviceNumbers() const;
  70     QString pinRequired() const;
  71     QStringList lockedPins() const;
  72     QString cardIdentifier() const;
  73     QStringList preferredLanguages() const;
  74     OfonoPinRetries pinRetries() const;
  75
  76     void changePin(const QString &pintype, const QString &oldpin, const QString &newpin);
  77     void enterPin(const QString &pintype, const QString &pin);
  78     void resetPin(const QString &pintype, const QString &puk, const QString &newpin);
  79     void lockPin(const QString &pintype, const QString &pin);
  80     void unlockPin(const QString &pintype, const QString &pin);
  81
  82     void setSubscriberNumbers(const QStringList &numbers);
  83
  84 signals:
  85     void presenceChanged(bool ispresent);
  86     void subscriberIdentityChanged(const QString &imsi);
  87     void mobileCountryCodeChanged(const QString &mcc);
  88     void mobileNetworkCodeChanged(const QString &mnc);
  89     void subscriberNumbersChanged(const QStringList &msisdns);
  90     void setSubscriberNumbersFailed();
  91     void serviceNumbersChanged(const OfonoServiceNumbers &sdns);
  92     void pinRequiredChanged(const QString &pintype);
  93     void lockedPinsChanged(const QStringList &pins);
  94     void cardIdentifierChanged(const QString &iccid);
  95     void preferredLanguagesChanged(const QStringList &languages);
  96     void pinRetriesChanged(const OfonoPinRetries &pinRetries);
  97
  98     void changePinComplete(bool success);
  99     void enterPinComplete(bool success);
 100     void resetPinComplete(bool success);
 101     void lockPinComplete(bool success);
 102     void unlockPinComplete(bool success);
 103
 104
 105 private slots:
 106     void propertyChanged(const QString& property, const QVariant& value);
 107     void setPropertyFailed(const QString& property);
 108
 109     void changePinResp();
 110     void changePinErr(QDBusError error);
 111     void enterPinResp();
 112     void enterPinErr(QDBusError error);
 113     void resetPinResp();
 114     void resetPinErr(QDBusError error);
 115     void lockPinResp();
 116     void lockPinErr(QDBusError error);
 117     void unlockPinResp();
 118     void unlockPinErr(QDBusError error);
 119
 120 private:
 121
 122 };
 123
 124 #endif  /* !OFONOSIMMANAGER_H */