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

QModemNetworkRegistration Class Reference
[QtCellModule]

The QModemNetworkRegistration class provides access to network registration features of AT-based modems. More...

    #include <QModemNetworkRegistration>

Inherits QNetworkRegistrationServer.

• List of all members, including inherited members

Public Functions

• QModemNetworkRegistration ( QModemService * service )
• ~QModemNetworkRegistration ()
• void setSupportsOperatorTechnology ( bool value )
• bool supportsOperatorTechnology () const

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

Public Slots

• virtual void setCurrentOperator ( QTelephony::OperatorMode mode, const QString & id, const QString & technology )

• 2 public slots inherited from QNetworkRegistration
• 1 public slot inherited from QObject

Static Public Members

• QString operatorNameForId ( const QString & id )

• 4 static public members inherited from QObject

Protected Functions

• virtual QString setCurrentOperatorCommand ( QTelephony::OperatorMode mode, const QString & id, const QString & technology )

• 4 protected functions inherited from QNetworkRegistrationServer
• 14 protected functions inherited from QAbstractIpcInterface
• 7 protected functions inherited from QObject

Protected Slots

• void queryRegistration ()
• virtual void resetModem ()

Additional Inherited Members

• 8 properties inherited from QNetworkRegistration
• 1 property inherited from QObject
• 6 signals inherited from QNetworkRegistration
• 1 signal inherited from QAbstractIpcInterface
• 1 signal inherited from QObject
• 1 public type inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The QModemNetworkRegistration class provides access to network registration features of AT-based modems.

This class uses the AT+COPS and AT+CREG commands from 3GPP TS 27.007.

QModemNetworkRegistration implements the QNetworkRegistration telephony interface. Client applications should use QNetworkRegistration instead of this class to access the modem's network registration settings.

See also QNetworkRegistration.

Member Function Documentation

QModemNetworkRegistration::QModemNetworkRegistration ( QModemService * service )

Construct an AT-based modem network registration object for service.

QModemNetworkRegistration::~QModemNetworkRegistration ()

Destroy this AT-based modem network registration object.

QString QModemNetworkRegistration::operatorNameForId ( const QString & id )   [static]

Convert an operator identifier id into the corresponding operator name.

void QModemNetworkRegistration::queryRegistration ()   [protected slot]

Query the current network registration state with AT+CREG?. This is typically used at the end of the initialization process that is performed in resetModem().

void QModemNetworkRegistration::resetModem ()   [virtual protected slot]

Issue commands to reset the modem's network registration functionality. The default implementation issues AT+CREG=2 and AT+COPS=3,0 and then calls queryRegistration().

This may be overridden for modems that need different commands to initialize network registration. The queryRegistration() function must be called at the end of the modem-specific initialization.

void QModemNetworkRegistration::setCurrentOperator ( QTelephony::OperatorMode mode, const QString & id, const QString & technology )   [virtual slot]

Sets the current network operator information to mode, id, and technology. The server will respond with the setCurrentOperatorResult() signal when the request completes.

The setCurrentOperatorCommand() method is used to create the AT command for changing the operator.

Reimplemented from QNetworkRegistration.

QString QModemNetworkRegistration::setCurrentOperatorCommand ( QTelephony::OperatorMode mode, const QString & id, const QString & technology )   [virtual protected]

Returns the AT command to use to effect a setCurrentOperator() request for mode, id, and technology.

This implementation formats a AT+COPS command according to 3GPP TS 27.007. That is, AT+COPS=mode,[format[,oper[,AcT]]]. The AcT field is only present if supportsOperatorTechnology() returns true. Modem vendor plug-ins should override this method if the syntax of their modem's AT+COPS command is different.

See also setCurrentOperator().

void QModemNetworkRegistration::setSupportsOperatorTechnology ( bool value )

Sets the flag to value that determines if the modem supports the operator technology flag on the AT+COPS command.

Normally the value is detected automatically based on the response to the AT+COPS? or AT+COPS=? command. This function can be used in a modem vendor plug-in to explicitly set the flag at start up. The default value, before auto-detection, is false.

See also supportsOperatorTechnology().

bool QModemNetworkRegistration::supportsOperatorTechnology () const

Returns true if the modem supports the operator technology flag to the AT+COPS command; otherwise returns false.

See also setSupportsOperatorTechnology().