ModemManager::Modem3gpp Class
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
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())
Register the device to network.
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()