Mobile Services
[Telephony]

---

Detailed Description

The purpose of the Mobile Services is to offer a set of high-level telephony related services to application developers. The latests don't need to have a knowledge of the whole Telephony Mgr to perform operations such as managing calls and accessing to network information, and don't need to take care of the technology the Mobile Services rely on.

Another important benefit of the Mobile Services is to reduce the number of actual calls made to the phone module by the various applications by caching some information. The Mobile Services acts as a single client for the Telephony Mgr and as a centralized server component for applications.

Today, the Mobile Services resides on top of the Telephony Mgr, but it could be easily built on top of an emerging standard such as LiPS for instance, in the near future. And it could also rely on top of any virtual telephony technology, like SIP. This would have no impact on the developed applications because this abstraction layer hides the underlying implementation.

It exposes a set of C structures and functions that provide actual access to services, as well as callback function prototypes that must be implemented by applications in order to respond to notifications.

Modules
	Errors Code
	List the different error codes of the Mobile Services.
	Mobile Service
	This service groups the Mobile functions.
	Audio Service
	This service groups the Audio functions.
	Call Service
	This service set gives access to a call.
	Mobile Context Service
	This service set gives access to the available mobile contexts.
	Cellular Mobile Context Service
	This service groups the Cellular Mobile Context functions.
	GSM Mobile Context Service - Deprecated
	This service groups the GSM Mobile Context functions. Deprecated, see Cellular Mobile Context Service.
	Line Service
	This service set gives access to the line of a Mobile Context.
	Network Service
	This service groups the Network functions.
	GSM Network Service - Deprecated
	This service groups the GSM Network functions. Deprecated.
	Operator Service
	This service groups the Operator functions.
	Phonebook Service
	This service groups the Phonebook functions.
	Speed Dial Service
	This service groups the Speed Dial functions.
	USAT Service
	This service groups the USAT functions.
	USIM Service
	This service groups the USIM functions.
Data Structures
struct	_AlpMblObserver
Defines
#define	ALP_MBL_ACCESS_TECHNOLOGY_EDGE   ((AlpMblAccessTechnology) 4)
	EDGE access technology.
#define	ALP_MBL_ACCESS_TECHNOLOGY_GPRS   ((AlpMblAccessTechnology) 2)
	GPRS access technology.
#define	ALP_MBL_ACCESS_TECHNOLOGY_GSM   ((AlpMblAccessTechnology) 1)
	GSM access technology.
#define	ALP_MBL_ACCESS_TECHNOLOGY_HSDPA   ((AlpMblAccessTechnology) 5)
	HSDPA access technology.
#define	ALP_MBL_ACCESS_TECHNOLOGY_HSUPA   ((AlpMblAccessTechnology) 6)
	HSUPA access technology.
#define	ALP_MBL_ACCESS_TECHNOLOGY_UMTS   ((AlpMblAccessTechnology) 3)
	UMTS access technology.
#define	ALP_MBL_ACCESS_TECHNOLOGY_UNKNOW   ((AlpMblAccessTechnology) 0)
	Unknow access technology.
#define	ALP_MBL_AUDIO_SERVICE_ID   ((AlpMblServiceId) 10)
#define	ALP_MBL_CALL_SERVICE_ID   ((AlpMblServiceId) 6)
#define	ALP_MBL_LINE_SERVICE_ID   ((AlpMblServiceId) 11)
#define	ALP_MBL_MOBILE_CTX_CELL_SERVICE_ID   ((AlpMblServiceId) 3)
#define	ALP_MBL_MOBILE_CTX_SERVICE_ID   ((AlpMblServiceId) 2)
#define	ALP_MBL_MOBILE_SERVICE_ID   ((AlpMblServiceId) 1)
#define	ALP_MBL_NETWORK_SERVICE_ID   ((AlpMblServiceId) 4)
#define	ALP_MBL_NO_SERVICE_ID   ((AlpMblServiceId) 0)
#define	ALP_MBL_OPERATOR_SERVICE_ID   ((AlpMblServiceId) 5)
#define	ALP_MBL_PHONEBOOK_SERVICE_ID   ((AlpMblServiceId) 12)
#define	ALP_MBL_SPEED_DIAL_SERVICE_ID   ((AlpMblServiceId) 9)
#define	ALP_MBL_USAT_SERVICE_ID   ((AlpMblServiceId) 8)
#define	ALP_MBL_USIM_SERVICE_ID   ((AlpMblServiceId) 7)
Typedefs
typedef unsigned char	AlpMblAccessTechnology
typedef char	AlpMblAddress [64]
typedef char	AlpMblAddressScheme [32]
typedef unsigned char	AlpMblAuthType
typedef unsigned char	AlpMblCallAction
	Deprecated, do not use. Use AlpMblUsatUserConfirmation.
typedef unsigned char	AlpMblCmdId
typedef char	AlpMblCurrency [4]
	Currency: "EUR"...
typedef unsigned char	AlpMblFunctionId
typedef unsigned char	AlpMblNotificationId
typedef _AlpMblObserver	AlpMblObserver
typedef unsigned char	AlpMblServiceId
typedef unsigned char	AlpMblUsatUserConfirmation

---

Define Documentation

#define ALP_MBL_ACCESS_TECHNOLOGY_EDGE   ((AlpMblAccessTechnology) 4)

EDGE access technology.

#define ALP_MBL_ACCESS_TECHNOLOGY_GPRS   ((AlpMblAccessTechnology) 2)

GPRS access technology.

#define ALP_MBL_ACCESS_TECHNOLOGY_GSM   ((AlpMblAccessTechnology) 1)

GSM access technology.

#define ALP_MBL_ACCESS_TECHNOLOGY_HSDPA   ((AlpMblAccessTechnology) 5)

HSDPA access technology.

#define ALP_MBL_ACCESS_TECHNOLOGY_HSUPA   ((AlpMblAccessTechnology) 6)

HSUPA access technology.

#define ALP_MBL_ACCESS_TECHNOLOGY_UMTS   ((AlpMblAccessTechnology) 3)

UMTS access technology.

#define ALP_MBL_ACCESS_TECHNOLOGY_UNKNOW   ((AlpMblAccessTechnology) 0)

Unknow access technology.

#define ALP_MBL_AUDIO_SERVICE_ID   ((AlpMblServiceId) 10)

#define ALP_MBL_CALL_SERVICE_ID   ((AlpMblServiceId) 6)

#define ALP_MBL_LINE_SERVICE_ID   ((AlpMblServiceId) 11)

#define ALP_MBL_MOBILE_CTX_CELL_SERVICE_ID   ((AlpMblServiceId) 3)

#define ALP_MBL_MOBILE_CTX_SERVICE_ID   ((AlpMblServiceId) 2)

#define ALP_MBL_MOBILE_SERVICE_ID   ((AlpMblServiceId) 1)

#define ALP_MBL_NETWORK_SERVICE_ID   ((AlpMblServiceId) 4)

#define ALP_MBL_NO_SERVICE_ID   ((AlpMblServiceId) 0)

#define ALP_MBL_OPERATOR_SERVICE_ID   ((AlpMblServiceId) 5)

#define ALP_MBL_PHONEBOOK_SERVICE_ID   ((AlpMblServiceId) 12)

#define ALP_MBL_SPEED_DIAL_SERVICE_ID   ((AlpMblServiceId) 9)

#define ALP_MBL_USAT_SERVICE_ID   ((AlpMblServiceId) 8)

#define ALP_MBL_USIM_SERVICE_ID   ((AlpMblServiceId) 7)

---

Typedef Documentation

typedef unsigned char AlpMblAccessTechnology

typedef char AlpMblAddress[64]

typedef char AlpMblAddressScheme[32]

typedef unsigned char AlpMblAuthType

typedef unsigned char AlpMblCallAction

Deprecated, do not use. Use AlpMblUsatUserConfirmation.

typedef unsigned char AlpMblCmdId

typedef char AlpMblCurrency[4]

Currency: "EUR"...

typedef unsigned char AlpMblFunctionId

typedef unsigned char AlpMblNotificationId

typedef struct _AlpMblObserver AlpMblObserver

typedef unsigned char AlpMblServiceId

typedef unsigned char AlpMblUsatUserConfirmation

---

Generated on Wed Jul 30 07:06:42 2008 by Doxygen 1.4.6 for ALP SDK + Hiker Documentation

Copyright © 1999-2008 ACCESS CO., LTD. All rights reserved.