Tizen Native API  5.0
Functions
Modem
Telephony Information

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 get modem information such as IMEI, but not to change the information.

Related Features

This API is related with the following feature:

  • http://tizen.org/feature/network.telephony

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

enum telephony_modem_power_status_e

Enumeration for Modem Power Status.

Since :
3.0
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.1
Privilege Level:
public
Privilege:
http://tizen.org/privilege/telephony
Remarks:
You must release imei using free() on success case.
Since 5.5, privilege level and return type are changed.
The following table shows the impact of changes:
Version 5.0 and lower 5.5 and higher Remarks
Privilege http://tizen.org/privilege/telephony http://tizen.org/privilege/securesysteminfo The required privilege is changed.
Privilege level Public Partner The application having partner level privilege can use this API
Error TELEPHONY_ERROR_NONE TELEPHONY_ERROR_PERMISSION_DENIED If the application doesn't have the required privilege, the error is returned.
The applications developed on Tizen 5.0 and lower version having only http://tizen.org/privilege/telephony privilege should check 'permission denied' error.
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.
Since 5.5, privilege level and return type are changed.
The following table shows the impact of changes:
Version 5.0 and lower 5.5 and higher Remarks
Privilege http://tizen.org/privilege/telephony http://tizen.org/privilege/securesysteminfo The required privilege is changed.
Privilege level Public Partner The application having partner level privilege can use this API
Error TELEPHONY_ERROR_NONE TELEPHONY_ERROR_PERMISSION_DENIED If the application doesn't have the required privilege, the error is returned.
The applications developed on Tizen 5.0 and lower version having only http://tizen.org/privilege/telephony privilege should check 'permission denied' error.
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
int telephony_modem_get_power_status ( telephony_h  handle,
telephony_modem_power_status_e *  status 
)

Gets the power status of the modem.

Since :
3.0
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