diff options
| author | Aleksander Morgado <aleksander@lanedo.com> | 2011-09-30 15:01:15 +0200 |
|---|---|---|
| committer | Aleksander Morgado <aleksander@lanedo.com> | 2011-10-01 15:23:06 +0200 |
| commit | dbc64d83ba74990af73283a4650327b21c861d60 (patch) | |
| tree | 8eaf89a257ed11541f182f60029960906c7701ca | |
| parent | e9743f4b4992321c206bb33059c1f594142d3f92 (diff) | |
api: let SignalQuality say if the given value was recently taken
Modems which only expose a single port will not be able to update the signal
quality value while in connected mode. The signal quality value reported in this
case, while the modem is connected, will be the last signal quality value read
before the connection.
The additional boolean value proposed here in the SignalQuality property will
just say if the given signal quality was recently taken (if TRUE) or cached
some time ago (if FALSE). The time to assume the value was recently taken or not
could depend on different things, for example:
* If the modem always has an AT port, even if connected, we could directly
query the current signal quality and report the value as being fresh.
* If the modem has a single port, we could report the value as not being fresh
as soon as the modem gets in connected state.
* For modems which report the signal quality updates in unsolicited messages,
we could report the value as being fresh if the update was received in the
last minute or so.
| -rw-r--r-- | new/org.freedesktop.ModemManager1.Modem.xml | 5 |
1 files changed, 3 insertions, 2 deletions
diff --git a/new/org.freedesktop.ModemManager1.Modem.xml b/new/org.freedesktop.ModemManager1.Modem.xml index f2a8d006..450a7a73 100644 --- a/new/org.freedesktop.ModemManager1.Modem.xml +++ b/new/org.freedesktop.ModemManager1.Modem.xml @@ -251,11 +251,12 @@ </tp:docstring> </property> - <property name="SignalQuality" type="u" access="read"> + <property name="SignalQuality" type="ub" access="read"> <tp:docstring> Signal quality in percent (0 - 100) of the dominant access technology the device is using to communicate with the network. Always 0 for POTS - devices. + devices. The additional boolean value indicates if the quality value + given was recently taken. </tp:docstring> </property> |