ModemManager::ModemSignal Class

class ModemManager::ModemSignal

The ModemSignal class. More...

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

Public Types

Public Functions

ModemSignal(const QString &path, QObject *parent = nullptr)
QVariantMap cdma() const
(since 6.24.0) bool errorRateThreshold() const
QVariantMap evdo() const
QVariantMap gsm() const
QVariantMap lte() const
(since 6.24.0) QVariantMap nr5g() const
uint rate() const
(since 6.24.0) uint rssiThreshold() const
void setTimeout(int timeout)
QDBusPendingReply<void> setup(uint rate)
(since 6.24.0) QDBusPendingReply<void> setupThresholds(const QVariantMap &settings)
int timeout() const
QVariantMap umts() const

Signals

void cdmaChanged(const QVariantMap &cdma)
(since 6.24.0) void errorRateThresholdChanged(bool enabled)
void evdoChanged(const QVariantMap &evdo)
void gsmChanged(const QVariantMap &gsm)
void lteChanged(const QVariantMap &lte)
(since 6.24.0) void nr5gChanged(const QVariantMap &nr5g)
void rateChanged(uint rate)
(since 6.24.0) void rssiThresholdChanged(uint threshold)
void umtsChanged(const QVariantMap &umts)

Detailed Description

This class provides access to extended signal quality information.

Member Type Documentation

ModemSignal::List

ModemSignal::Ptr

Member Function Documentation

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

QVariantMap ModemSignal::cdma() const

Returns Dictionary of available signal information for the CDMA1x access technology.

This dictionary is composed of a string key, with an associated data which contains type-specific information.

rssi The CDMA1x RSSI (Received Signal Strength Indication), in dBm, given as a floating point value (signature "d").

ecio The CDMA1x Ec/Io, in dBm, given as a floating point value (signature "d").

[signal] void ModemSignal::cdmaChanged(const QVariantMap &cdma)

[since 6.24.0] bool ModemSignal::errorRateThreshold() const

Returns whether error rate threshold reporting is enabled.

This function was introduced in 6.24.0.

[signal, since 6.24.0] void ModemSignal::errorRateThresholdChanged(bool enabled)

This function was introduced in 6.24.0.

QVariantMap ModemSignal::evdo() const

Returns Dictionary of available signal information for the CDMA EV-DO access technology.

This dictionary is composed of a string key, with an associated data which contains type-specific information.

rssi The CDMA EV-DO RSSI (Received Signal Strength Indication), in dBm, given as a floating point value (signature "d").

ecio The CDMA EV-DO Ec/Io, in dBm, given as a floating point value (signature "d").

sinr CDMA EV-DO SINR level, in dB, given as a floating point value (signature "d").

io The CDMA EV-DO Io, in dBm, given as a floating point value (signature "d").

[signal] void ModemSignal::evdoChanged(const QVariantMap &evdo)

QVariantMap ModemSignal::gsm() const

Returns Dictionary of available signal information for the GSM/GPRS access technology.

This dictionary is composed of a string key, with an associated data which contains type-specific information.

rssi The GSM RSSI (Received Signal Strength Indication), in dBm, given as a floating point value (signature "d").

[signal] void ModemSignal::gsmChanged(const QVariantMap &gsm)

QVariantMap ModemSignal::lte() const

Returns Dictionary of available signal information for the UMTS (WCDMA) access technology.

This dictionary is composed of a string key, with an associated data which contains type-specific information.

rssi The LTE RSSI (Received Signal Strength Indication), in dBm, given as a floating point value (signature "d").

rsrq The LTE RSRQ (Reference Signal Received Quality), in dB, given as a floating point value (signature "d").

rsrp The LTE RSRP (Reference Signal Received Power), in dBm, given as a floating point value (signature "d").

snr The LTE S/R ratio, in dB, given as a floating point value (signature "d").

[signal] void ModemSignal::lteChanged(const QVariantMap &lte)

[since 6.24.0] QVariantMap ModemSignal::nr5g() const

Returns Dictionary of available signal information for the NR5G access technology.

This function was introduced in 6.24.0.

[signal, since 6.24.0] void ModemSignal::nr5gChanged(const QVariantMap &nr5g)

This function was introduced in 6.24.0.

uint ModemSignal::rate() const

Returns refresh rate for the extended signal quality information updates, in seconds. A value of 0 disables the retrieval of the values.

[signal] void ModemSignal::rateChanged(uint rate)

[since 6.24.0] uint ModemSignal::rssiThreshold() const

Returns RSSI threshold used for reporting.

This function was introduced in 6.24.0.

[signal, since 6.24.0] void ModemSignal::rssiThresholdChanged(uint threshold)

This function was introduced in 6.24.0.

void ModemSignal::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().

QDBusPendingReply<void> ModemSignal::setup(uint rate)

Setup extended signal quality information retrieval.

rate refresh rate to set, in seconds. 0 to disable retrieval.

[since 6.24.0] QDBusPendingReply<void> ModemSignal::setupThresholds(const QVariantMap &settings)

Setup thresholds for extended signal quality information retrieval.

This function was introduced in 6.24.0.

int ModemSignal::timeout() const

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

See also setTimeout().

QVariantMap ModemSignal::umts() const

Returns Dictionary of available signal information for the UMTS (WCDMA) access technology.

This dictionary is composed of a string key, with an associated data which contains type-specific information.

rssi The UMTS RSSI (Received Signal Strength Indication), in dBm, given as a floating point value (signature "d").

ecio The UMTS Ec/Io, in dBm, given as a floating point value (signature "d").

[signal] void ModemSignal::umtsChanged(const QVariantMap &umts)