Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

QSimGenericAccess Class Reference
[QtTelephonyModule]

The QSimGenericAccess class provides an interface to send commands directly to a SIM. More...

    #include <QSimGenericAccess>

Inherits QCommInterface.

Inherited by QModemSimGenericAccess.

• List of all members, including inherited members

Public Functions

• QSimGenericAccess ( const QString & service = QString(), QObject * parent = 0, QCommInterface::Mode mode = Client )
• ~QSimGenericAccess ()
• QString command ( const QByteArray & data )

• 1 public function inherited from QCommInterface
• 4 public functions inherited from QAbstractIpcInterface
• 29 public functions inherited from QObject

Public Slots

• virtual void command ( const QString & reqid, const QByteArray & data )

• 1 public slot inherited from QObject

Signals

• void response ( const QString & reqid, QTelephony::Result result, const QByteArray & data )

• 1 signal inherited from QAbstractIpcInterface
• 1 signal inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QObject
• 14 protected functions inherited from QAbstractIpcInterface
• 7 protected functions inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The QSimGenericAccess class provides an interface to send commands directly to a SIM.

Use of this class usually results in an AT+CSIM command being sent to the modem. The commands must be in the format described in 3GPP TS 51.011.

Sending generic access commands to a SIM bypasses the normal mechanisms that are used to access SIM files, SIM application toolkit, operator data, etc. This class should therefore be used only for commands that are not already covered by other classes such as QSimFiles, QBinarySimFile, QRecordBasedSimFile, and QSimToolkit.

See also QSimFiles, QBinarySimFile, QRecordBasedSimFile, and QSimToolkit.

Member Function Documentation

QSimGenericAccess::QSimGenericAccess ( const QString & service = QString(), QObject * parent = 0, QCommInterface::Mode mode = Client )

Construct a new SIM generic access object for service and attach it to parent. The object will be created in client mode if mode is Client, or server mode otherwise.

If service is empty, this class will use the first available service that supports SIM generic access. If there is more than one service that supports SIM generic access, the caller should enumerate them with QCommServiceManager::supports() and create separate QSimGenericAccess objects for each.

See also QCommServiceManager::supports().

QSimGenericAccess::~QSimGenericAccess ()

Destroy this generic SIM access object.

QString QSimGenericAccess::command ( const QByteArray & data )

Sends data to the SIM as a generic access command and returns a unique request identifier for it. The command has the format described in 3GPP TS 51.011. The telephony service will emit the response() signal once the command has completed.

See also response().

void QSimGenericAccess::command ( const QString & reqid, const QByteArray & data )   [virtual slot]

This is an overloaded member function, provided for convenience.

Sends data to the SIM as a generic access command. The reqid will be returned via the response() signal to help match up commands and responses. The command has the format described in 3GPP TS 51.011.

See also response().

void QSimGenericAccess::response ( const QString & reqid, QTelephony::Result result, const QByteArray & data )   [signal]

Signal that is emitted to report the result of issuing the request reqid via command(). If result is QTelephony::Ok, then data is the data returned by the SIM in response to the command. The response has the format described in 3GPP TS 51.011.

See also command().