Tizen Native API  4.0
Modem

The Modem Information API provides functions to obtain information from the modem.

Required Header

#include <telephony.h>

Overview

The Telephony Modem Information API allows you to access, but not change the information about IMEI.

Related Features

This API is related with the following feature:

It is recommended to design feature related codes in your application for reliability.

You can check if a device supports the related features for this API by using System Information, thereby controlling the procedure of your application.

To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.

More details on featuring your application can be found from Feature Element.

Functions

int telephony_modem_get_imei (telephony_h handle, char **imei)
 Gets the IMEI (International Mobile Station Equipment Identity) of a mobile phone.
int telephony_modem_get_power_status (telephony_h handle, telephony_modem_power_status_e *status)
 Gets the power status of the modem.
int telephony_modem_get_meid (telephony_h handle, char **meid)
 Gets the MEID (Mobile Equipment Identifier) of a mobile phone (for CDMA).

Enumeration Type Documentation

Enumeration for Modem Power Status.

Since :
2.4
Enumerator:
TELEPHONY_MODEM_POWER_STATUS_UNKNOWN 

Unknown

TELEPHONY_MODEM_POWER_STATUS_ON 

Modem power ON

TELEPHONY_MODEM_POWER_STATUS_OFF 

Modem power OFF

TELEPHONY_MODEM_POWER_STATUS_RESET 

Modem power RESET

TELEPHONY_MODEM_POWER_STATUS_LOW 

Modem power LOW


Function Documentation

int telephony_modem_get_imei ( telephony_h  handle,
char **  imei 
)

Gets the IMEI (International Mobile Station Equipment Identity) of a mobile phone.

The IMEI number is used by a GSM network to identify valid devices and therefore can be used for stopping a stolen phone from accessing that network.

Since :
2.3
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Remarks:
You must release imei using free() on success case.
Parameters:
[in]handleThe handle from telephony_init()
[out]imeiThe International Mobile Station Equipment Identity
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed
int telephony_modem_get_meid ( telephony_h  handle,
char **  meid 
)

Gets the MEID (Mobile Equipment Identifier) of a mobile phone (for CDMA).

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Remarks:
You must release meid using free() on success case.
Parameters:
[in]handleThe handle from telephony_init()
[out]meidThe Mobile Equipment Identifier
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed

Gets the power status of the modem.

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Parameters:
[in]handleThe handle from telephony_init()
[out]statusThe Modem power status (0=on,1=off,2=reset,3=low)
Returns:
0 on success, otherwise a negative error value
Return values:
TELEPHONY_ERROR_NONESuccessful
TELEPHONY_ERROR_INVALID_PARAMETERInvalid parameter
TELEPHONY_ERROR_PERMISSION_DENIEDPermission denied
TELEPHONY_ERROR_NOT_SUPPORTEDNot supported
TELEPHONY_ERROR_OPERATION_FAILEDOperation failed