1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
|
Radio settings hierarchy
========================
Service org.ofono
Interface org.ofono.RadioSettings
Object path [variable prefix]/{modem0,modem1,...}
Methods dict GetProperties()
Returns all radio access properties. See the
properties section for available properties.
Possible Errors: [service].Error.InProgress
[service].Error.NotImplemented
[service].Error.Failed
void SetProperty(string name, variant value)
Changes the value of the specified property. Only
properties that are listed as readwrite are
changeable. On success a PropertyChanged signal
will be emitted.
Possible Errors: [service].Error.InProgress
[service].Error.NotImplemented
[service].Error.InvalidArguments
[service].Error.Failed
Signals PropertyChanged(string property, variant value)
This signal indicates a changed value of the given
property.
Properties string TechnologyPreference [readwrite]
The current radio access selection mode, also known
as network preference.
The possible values are:
"any" Radio access technology
selection is done automatically,
based on reception and
availability.
"gsm" Only GSM used for radio access.
"umts" Only UMTS used for radio access.
"lte" Only LTE used for radio access.
array{string} AvailableTechnologies [readonly, optional]
List of values for TechnologyPreference property
supported by the modem.
string GsmBand [readwrite, optional]
Frequency band in which the modem is allowed to
operate when using "gsm" mode. Setting this property
has an immediate effect on modem only if
TechnologyPreference is set to "gsm" or "any".
Otherwise the value is kept and applied whenever modem
uses this mode.
The possible values are:
"any" Frequency band is selected
automatically by modem.
"850" Operate only on 850 MHz.
"900P" Operate only on 900 MHz, known as
Primary GSM-900 Band
"900E" Operate only on 900 MHz, known as
Extended GSM-900 Band.
"1800" Operate only on 1800 MHz, known as DCS.
"1900" Operate only on 1900 MHz, known as PCS.
string UmtsBand [readwrite, optional]
Frequency band in which the modem is allowed to
operate when using "umts" mode. Setting this property
has an immediate effect on modem only if
TechnologyPreference is set to "umts" or "any".
Otherwise the value is kept and applied whenever modem
uses this mode.
The possible values are:
"any" Frequency band is selected
automatically by modem.
"850" Operate only on 850 MHz, known
as CLR (class V).
"900" Operate only on 900 MHz, known
as GSM (class VIII).
"1700AWS" Operate only on 1700 MHz, known
as AWS (class IV).
"1900" Operate only on 1900 MHz, known
as PCS (class II).
"2100" Operate only on 2100 MHz, known
as IMT (class I).
boolean FastDormancy [readwrite, optional]
This property will enable or disable the fast
dormancy feature in the modem. Fast dormancy
refers to a modem feature that allows the
modem to quickly release radio resources after
a burst of data transfer has ended. Normally,
radio resources are released by the network
after a timeout configured by the network.
Fast dormancy allows the modem to release the
radio resources more quickly.
Fast dormancy is a major power-saving feature
for mobile devices. Typically, fast dormancy
would be enabled when the device is not being
interactively used by a human user and only
networking applications with keep-alive
traffic are active (e.g. mail client or a
presence application). In this case it is
desirable to release radio resources quickly
after a keep-alive transaction has ended,
since typically no network traffic will occur
until the next keep-alive transaction. Fast
dormancy should not be enabled during
interactive use because the release and setup
of radio resources introduces perceivable
delay for the end user.
The fast dormancy implementation in the modem
is vendor specific. The implementation should
try to release radio resources more quickly,
when the situation allows it, but should also
take care not to increase the signalling load
on the cellular network by releasing and
re-establishing radio resources too often. The
modem should adjust its behaviour to the 3GPP
release supported by the network and the
parameters set by the operator.
Fast dormancy can be ignored for externally
powered modems such as USB sticks or PCI
devices. If the modem does not support such a
feature the property should never be exposed
to the user.
|
