Interface Channel.Interface.ServicePoint

Interface Index (Compact) | Summary | Description | Signals | Properties

Signals

ServicePointChanged ((us): Service_Point)

Properties

InitialServicePoint (us) (Service_Point) Read only
CurrentServicePoint (us) (Service_Point) Read only
Added in 0.19.UNRELEASED. (as stable API)

Description

An interface for channels that can indicate when/if they are connected to some form of service point. For example, when dialing 9-1-1 in the US, a GSM modem/network will recognize that as an emergency call, and inform higher levels of the stack that the call is being handled by an emergency service. In this example, the call is handled by a Public Safety Answering Point (PSAP) which is labeled as "urn:service:sos". Other networks and protocols may handle this differently while still using this interface.

Note that while the majority of examples given in this documentation are for GSM calls, they could just as easily be SIP calls, GSM SMS's, etc.

Signals

(Permalink)

ServicePointChanged ((us): Service_Point)

Parameters

  • Service_Point — (us) (Service_Point)
  • The new service point that is being used.

Emitted when a channel changes the service point that it's connected to. This might be a new call being connected to a service, a call connected to a service being routed to a different service (ie, an emergency call being routed from a generic emergency PSAP to a poison control PSAP), or any number of other things.

Note that this should be emitted as soon as the CM has been notified of the switch, and has updated its internal state. The CM MAY still be in the process of connecting to the new service point.

Properties

Accessed using the org.freedesktop.DBus.Properties interface.
(Permalink)

InitialServicePoint — (us) (Service_Point)

Read only

This property is used to indicate that the channel target is a well-known service point. Please note that the CM (or lower layers of the stack or network) may forward the connection to other other service points, which the CM SHOULD indicate via ServicePointChanged signal.

This property SHOULD be set for channel requests that are specifically targeting service points.

(Permalink)

CurrentServicePoint — (us) (Service_Point)

Read only
The service point that the channel is connected to. If the channel is not connected to a service point, the CM MUST set the Service_Point_Type field to None; for instance, this will be the case for ordinary calls.