ModemManager::Modem3gpp Class

class ModemManager::Modem3gpp

The Modem3gpp class. More...

Header:	`#include <ModemManagerQt/Modem3gpp>`
CMake:	`find_package(KF6 REQUIRED COMPONENTS ModemManagerQt)` `target_link_libraries(mytarget PRIVATE KF6::ModemManagerQt)`
Inherits:	ModemManager::Interface

List of all members, including inherited members

Public Types

	List
	Ptr

Public Functions

	Modem3gpp(const QString &path, QObject *parent = nullptr)
QString	countryCode() const
ModemManager::Modem3gpp::FacilityLocks	enabledFacilityLocks() const
QString	imei() const
QString	operatorCode() const
QString	operatorName() const
void	registerToNetwork(const QString &networkId = QString())
MMModem3gppRegistrationState	registrationState() const
QDBusPendingReply<ModemManager::QVariantMapList>	scan()
void	setTimeout(int timeout)
MMModem3gppSubscriptionState	subscriptionState() const
int	timeout() const

Signals

void	countryCodeChanged(const QString &countryCode)
void	enabledFacilityLocksChanged(QFlags<MMModem3gppFacility> locks)
void	imeiChanged(const QString &imei)
void	operatorCodeChanged(const QString &operatorCode)
void	operatorNameChanged(const QString &operatorName)
void	registrationStateChanged(MMModem3gppRegistrationState registrationState)
void	subscriptionStateChanged(MMModem3gppSubscriptionState subscriptionState)

Detailed Description

This class provides access to specific actions that may be performed in modems with 3GPP capabilities.

Member Type Documentation

Modem3gpp::List

Modem3gpp::Ptr

Member Function Documentation

`[explicit]` Modem3gpp::Modem3gpp(const QString &path, QObject **parent* = nullptr)

QString Modem3gpp::countryCode() const

Returns country code of the operator to which the mobile is currently registered.

Returned in the format "ISO 3166-1 alpha-2" according to the MMC mapping from Wikipedia. Country Code is the two-letter country codes defined in ISO 3166-1, part of the ISO 3166 standard, e.g. "RU" or "FI".

If the MCC is not known or the mobile is not registered to a mobile network, this property will be an empty string.

`[signal]` void Modem3gpp::countryCodeChanged(const QString &countryCode)

ModemManager::Modem3gpp::FacilityLocks Modem3gpp::enabledFacilityLocks() const

Returns QFlags of MMModem3gppFacility values for which PIN locking is enabled

`[signal]` void Modem3gpp::enabledFacilityLocksChanged(QFlags<MMModem3gppFacility> locks)

QString Modem3gpp::imei() const

Returns the IMEI of the device

`[signal]` void Modem3gpp::imeiChanged(const QString &imei)

QString Modem3gpp::operatorCode() const

Returns code of the operator to which the mobile is currently registered.

Returned in the format "MCCMNC", where MCC is the three-digit ITU E.212 Mobile Country Code and MNC is the two- or three-digit GSM Mobile Network Code. e.g. e"31026" or "310260".

If the MCC and MNC are not known or the mobile is not registered to a mobile network, this property will be an empty string.

`[signal]` void Modem3gpp::operatorCodeChanged(const QString &operatorCode)

QString Modem3gpp::operatorName() const

Returns name of the operator to which the mobile is currently registered.

If the operator name is not known or the mobile is not registered to a mobile network, this property will be an empty string.

`[signal]` void Modem3gpp::operatorNameChanged(const QString &operatorName)

void Modem3gpp::registerToNetwork(const QString &networkId = QString())

networkId The operator ID (ie, "MCCMNC", like "310260") to register. An empty string can be used to register to the home network.

MMModem3gppRegistrationState Modem3gpp::registrationState() const

Returns mobile registration status as defined in 3GPP TS 27.007 section 10.1.19

`[signal]` void Modem3gpp::registrationStateChanged(MMModem3gppRegistrationState registrationState)

QDBusPendingReply<ModemManager::QVariantMapList> Modem3gpp::scan()

Scan for available networks.

Returns a QList<QVariantMap> with the results, where each map may contain these values:

"status": A MMModem3gppNetworkAvailability value representing network availability status, given as an unsigned integer (signature "u"). This key will always be present.

"operator-long": Long-format name of operator, given as a string value (signature "s"). If the name is unknown, this field should not be present.

"operator-short": Short-format name of operator, given as a string value (signature "s"). If the name is unknown, this field should not be present.

"operator-code": Mobile code of the operator, given as a string value (signature "s"). Returned in the format "MCCMNC", where MCC is the three-digit ITU E.212 Mobile Country Code and MNC is the two- or three-digit GSM Mobile Network Code. e.g. "31026" or "310260".

"access-technology": A MMModemAccessTechnology value representing the generic access technology used by this mobile network, given as an unsigned integer (signature "u").

void Modem3gpp::setTimeout(int timeout)

Sets the timeout in milliseconds for all async method DBus calls. -1 means the default DBus timeout (usually 25 seconds).

See also timeout().

MMModem3gppSubscriptionState Modem3gpp::subscriptionState() const

Returns Value representing the subscription status of the account and whether there is any data remaining.

`[signal]` void Modem3gpp::subscriptionStateChanged(MMModem3gppSubscriptionState subscriptionState)

int Modem3gpp::timeout() const

Returns the current value of the DBus timeout in milliseconds. -1 means the default DBus timeout (usually 25 seconds).

See also setTimeout().

Contents