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().
