freesmartphone.org Framework DBus Interface Specification

org.freesmartphone.GSM.PDP

Description

The Packet Data Protocol interface is used to set up binary data connections that allow you to transfer data over the TCP/IP protocol family routed via IP-based 2.5/3G provider networks.

Namespace

org.freesmartphone.GSM.PDP

Methods

Signals

Errors

Methods

ListGprsClasses ( ) → as

Description: List available GPRS device classes.

This maps to the GSM 07.07 command +CGCLASS=?, see 3GPP TS 07.07 Chapter 10.1.11.

Returns

as: classes

The available GPRS device classes.

GetCurrentGprsClass ( ) → s

Description: Retrieves the current GPRS device class mode.

This maps to the GSM 07.07 command +CGCLASS?, see 3GPP TS 07.07 Chapter 10.1.11.

Returns

s: device_class

The GPRS device class mode.

SetCurrentGprsClass ( s )

Description: Sets the current GPRS device class mode.

This maps to the GSM 07.07 command +CGCLASS=(device_class), see 3GPP TS 07.07 Chapter 10.1.11.

Parameters

s: device_class

The GPRS device class mode.

GetNetworkStatus ( ) → a{sv}

Description: Retrieves the current GPRS registration status.

This maps to the GSM 07.07 command +CGREG?, see 3GPP TS 07.07 Chapter 10.1.14.

Returns

a{sv}: status

GPRS registration status information. Mandatory tuples are:

Optional tuples are:

ActivateContext ( sss ) → i

Description: Request a PDP context activation to an IP-based network service provider and launch a ppp session.

This command might change your network default route.

Parameters

s: apn

The access point name to connect to.

s: username

The user name to authenticate with.

s: password

The password to authenticate with.

Returns

i: index

An index to identify context status changes.

DeactivateContext ( i )

Description: Cancel an ongoing ppp session and request a PDP context deactivation.

This command might change your network default route.

Parameters

i: index

The context to deactivate.

GetContextStatus ( i ) → s

Description: Retrieve the current PDP context status.

Parameters

i: index

The context to inquire.

Returns

s: status

The context status. See ContextStatus for a list of valid values.

Signals

NetworkStatus ( a{sv} )

Description: Sent whenever there is a GPRS registration status or property change.

Parameters

a{sv}: status

The new status. See GetNetworkStatus for a list of valid values.

ContextStatus ( isa{sv} )

Description: Sent whenever there is any status or property change on a pdp context in the system.

Parameters

i: id

The index of the context that changed its status or properties.

s: status

The new status of the context. Expected values are:

Further information can be part of the properties.

a{sv}: properties

An array of property values. Note that properties are optional. Expected tuples are:

Errors

NotFound

Description: Raised, if the specified PDP context is not present.


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