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.
If the status of the rule “voice no reply has changed” there is an additional entry:
  • “timeout”: uint16: Value of the voice “no reply” timeout in seconds. Should be in a range of [1:30].