freesmartphone.org Framework DBus Interface Specification

org.freesmartphone.GSM.Network

Description

The Network interface is used to give information about the GSM service providers and this device's status with regards to to network registration and connectivity. Taxonomy note: We think in terms of (service) providers rather than (network) operators, since multiple (service) providers can use the networks from operators, however what actually matters most is the provider name, not the actual network operator the provider is using.

Namespace

org.freesmartphone.GSM.Network

Methods

Signals

Properties

None

Errors

None

Methods

Register ( )

Description: Register with any available service provider.

This maps to the GSM 07.07 command +COPS=0, see 3GPP TS 07.07 Chapter 7.3.

Unregister ( )

Description: Unregister from service provider.

GetStatus ( ) → a{sv}

Description: Get Network Status.

Returns

a{sv}: status

Network status information. Mandatory tuples are:

Optional tuples are:

GetSignalStrength ( ) → i

Description: Query the current signal strength, if registered with a service provider.

Returns

i: signal_strength

The signal strength in percent (0-100).

GetTimeReport ( ) → iiii

Description: Query the last received time report.

Returns

i: time

The current time in seconds since UNIX epoch. 0, if no time has been received.

i: timestamp

Timestamp indicating when the time report has been received from the network.

i: zone

The time zone offset in minutes based on UTC. This value is only valid, if within the interval ( -1440, 1440 ).

i: zonestamp

Timestamp indicating when the time report has been received from the network.

ListProviders ( ) → a(sssss)

Description: List available service providers.

Returns

a(sssss): providers

An array of four-tuples with the following structure:

RegisterWithProvider ( s )

Description: Register to a dedicated service provider.

Parameters

s: operator_code

The operator code.

SetCallingIdentification ( s )

Description: Set whether your subscriber number is visible during a call.

Parameters

s: status

One of the following values:

GetCallingIdentification ( ) → s

Description: Get whether your subscriber number is visible during a call.

Returns

s: status

One of the following values:

SendUssdRequest ( s )

Description: Send an Unstructured Supplementary Service Data (USSD) request to the network. Responses will be delivered via the signal IncomingUssd

This can map to the GSM 07.07 command +CUSD=1,"(request)",(code), see 3GPP TS 07.07 Chapter 7.14.

Parameters

s: request

The request to be sent to the network.

Signals

Status ( a{sv} )

Description: Sent, when the network registration status changes.

Parameters

a{sv}: status

The registration status. See GetStatus for expected values.

SignalStrength ( i )

Description: (OPTIONAL) Sent, when registered with a service provider and the network signal strength changes.

Parameters

i: signal_strength

The signal strength in percent (0-100).

TimeReport ( ii )

Description: Sent upon receiving a network time and/or zone report.

Parameters

i: time

The current time in seconds since UNIX epoch. 0, if no time has been received.

i: zone

The time zone offset in minutes based on UTC. This value is only valid, if within the interval ( -1440, 1440 ).

IncomingUssd ( ss )

Description: Sent, when an USSD result or a network initiated request arrives. This signal is usually sent in response to the method SendUssdRequest

Parameters

s: mode

The message mode. Valid values are:

s: message

The message. Only set if mode is "completed" or "useraction". "", otherwise.

CipherStatus ( ss )

Description: Sent, when the network reports a change in telephony or PDP cipher indication.

Parameters

s: telephony

The telephony cipher: "enabled", "disabled", or "unknown"

s: pdp

The PDP cipher cipher: "enabled", "disabled", or "unknown"


| Specified 2008-2012 by the Freesmartphone.org team. | Join us and discuss further drafts smartphones-standards (at) linuxtogo (dot) org