freesmartphone.org GSM Call Forwarding Interface
Description
The call forwarding interface allows to access the call forwarding supplementary service according to 3GPP TS 22.082. It supports enabling and disabling different voice related call forwarding rules and to query their current status.
Namespace
org.freesmartphone.GSM.CallForwarding
Methods
Signals
Properties
None
Errors
None
Methods
DisableAll ( s )
Description: Disable all (or only conditional) call forwarding rules.
Parameters:*
s: type Type of call forwarding rules to disable. Expected values are
- “all”: disable all rules,
- “conditional”: disable only coniditonal rules (e.g. busy, not reachable, no reply).
Enable ( ssi )
Description: Enable a call forwarding rule. The corresponding properties for the specified rules will be populated with the values specified.
Parameters:*
s: rule Call forwarding rule to assign a number and timeout for. Expected values are:
- “voice unconditional”,
- “voice busy”,
- “voice no reply”,
- “voice not reachable”.
s: number Number the call should be forwarded too. Should be either in national or international format.
i: timeout Timeout after the call forwarding rule should become active. Only accepted if rule is “voice no reply”.
Disable ( s )
Description: Disable a call forwarding rule.
Parameters:*
s: rule Name of the call forwarding rule. See Enable for a list of valid values. The corresponding property for the rule will be unset.
GetStatus ( s ) → a{sv}
Description: Retrieve the current status for a call forwarding rule.
Parameters:*
s: rule Name of the call forwarding rule. See Enable for a list of valid values.
Returns:
a{sv}: status Status of the call forwarding rule. See StatusChanged for a description of the format.
Signals
StatusChanged ( sa{sv} )
Description: Sent whenver a status of a call forwarding rule has changed.
Parameters:
s: rule Name of the call forwarding rule it’s status has changed.
a{sv}: status Changed status of the call forwarding rule. Expected values are:
- “active”: boolean: Wether the rule is active or not
- “number”: string: Number for the call forwarding rule; is empty if the rule is not active.
- “timeout”: uint16: Value of the voice “no reply” timeout in seconds. Should be in a range of [1:30].