freesmartphone.org Framework DBus Interface Specification

org.freesmartphone.Data.World

Description

The World interface is used to query (more or less static) information about the communication world, such as countries and their timezones, mobile broadband provider apns, etc.

Namespace

org.freesmartphone.Data.World

Methods

Signals

None

Properties

None

Errors

None

Methods

GetAllCountries ( ) → a(ss)

Description: Retrieves all known country codes and their (english) name.

Returns

a(ss): countries

A list of country codes and their (english) names.

GetCountryCodeForMccMnc ( s ) → s

Description: Retrieve a country code for MCC or concatenated MCC and MNC. Raises InvalidParameter if not found.

Parameters

s: mcc_mnc

MCC or concatenated MCC and MNC.

Returns

s: country_code

The country code that owns the specified MCC (and MNC).

GetTimezonesForCountryCode ( s ) → a{ss}

Description: Retrieves the list of timezones given a country code. Raises InvalidParameter if not found.

Parameters

s: country_code

The country code.

Returns

a{ss}: timezones

A dictionary of coordinates and timezone names.

GetApnsForMccMnc ( s ) → a(ssssss)

Description: Retrieves a list of data connectivity (GPRS, EDGE, 3G) access point names for MCC or concatenated MCC and MNC. Raises InvalidParameter if not found.

Parameters

s: mcc_mnc

MCC or concatenated MCC and MNC.

Returns

a(ssssss): apns

A list of six-tuples descriping a connectivity access point. Structure is:

GetProviderNameForMccMnc ( s ) → s

Description: Retrieves the name of a provider for a supplied concatenated MCC and MNC. Raises InvalidParameter if not found.

Parameters

s: mcc_mnc

MCC or concatenated MCC and MNC.

Returns

s: provider

Name of the provider.


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