doc/radio-settings-api.txt

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