---
doc/radio-settings-api.txt | 59 ++++++++++++++++++++++++++++++-------------
1 files changed, 41 insertions(+), 18 deletions(-)
diff --git a/doc/radio-settings-api.txt b/doc/radio-settings-api.txt
index f1b91ad..00eca54 100644
--- a/doc/radio-settings-api.txt
+++ b/doc/radio-settings-api.txt
@@ -44,22 +44,45 @@ Properties string TechnologyPreference [read-write]
boolean FastDormancy [read-write, optional]
- This property will enable or disable fast
- dormancy. Fast dormancy refers to UE initiated
- release of radio resources quickly after a
- burst of data transfer has ended. Normally,
+ 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
- operator. Fast dormancy allows the modem to
- release radio resources more quickly.
- Typically, fast dormancy would be enabled if
- no data transfer is predicted to occur in the
- near future, for instance, when the end user
- is not actively using the device. This is a
- major power-saving feature for mobile devices,
- but can be ignored for USB sticks or PCI
- devices.
-
- If the modem does not support such a feature
- the property should never be exposed to the
- user.
+ 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.
--
1.7.0.4
_______________________________________________
ofono mailing list
ofono@ofono.org
http://lists.ofono.org/listinfo/ofono
