mirror of git://git.sysmocom.de/ofono
140 lines
4.6 KiB
Plaintext
140 lines
4.6 KiB
Plaintext
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.
|